IBM Support

Using the MAX-AGE HTTP caching mechanism

Question & Answer


Question

How should the MAX-AGE mechanism be implemented to improve network performance high network latency

Cause

Minimal documentation

If a client pings the Maximo application server and has a round trip time higher than 50 milliseconds, user may experience slow screen refreshes and perceived poor performance from the Maximo application.

Answer

IBM Maximo Asset Management implements an HTTP filter that can be used to modify expiration date of objects stored in each client browser cache. Local objects are stored in the client browser cache for the time period specified by the MAX-AGE setting in the file:
<maximo_root>/applications/maximo/maximouiweb/webmodule/WEB-INF/web.xml

<filter>
   <filter-name>HttpMaxAgeFilter</filter-name>
   <filter-class>psdi.webclient.system.filter.HttpMaxAgeFilter</filter-class>
   <init-param>
      <param-name>Cache-Control</param-name>
      <param-value>max-age=2764800</param-value>
   </init-param>
   <init-param>
      <param-name>Pragma</param-name>
      <param-value>max-age=2764800</param-value>
   </init-param>
 </filter>

MAX-AGE is a parameter created by the Maximo development team to provide a value for the expiration of browser cached objects. The default value for this parameter is 3600 (measured in seconds), or one hour. One hour after an object is transferred from the web application server to the browser client, it will need to be transferred again. In high latency networks, the more often an object must be transferred, the more often the client will wait for that transfer to complete. In some cases, IBM Support has recommended setting this value to 86400, or one day.

There are positive and negative features when configuring this setting such as this. The positive results of setting a high value is improved response time in high latency environments. The negative results are that changes in pages will not be realized by cached users until the cache expires or is manually cleared. This negative may be more prevalent in the developmental and implementation stages of Maximo.

Manually clearing the cache by browser:

Microsoft Internet Explorer

  1. Select Tools (via the Gear Icon) > Safety > Delete browsing history....
  2. NOTE: You can also access this menu by holding Ctrl + Shift + Delete.
  3. Uncheck Preserve Favorites website data and check both Temporary Internet Files and Cookies then click Delete.
  4. You will get a confirmation at the bottom of the window once it has successfully cleared your cache and cookies.

Mozilla Firefox
  1. From the 'Hamburger' menu, select Options.
  2. On the left, click on Advanced
  3. Select Network from the item bar.
  4. Under Cached Web content, click on the Clear Now button. You may have to do this several times to get it to 0.
  5. On the left, click on Privacy
  6. You may want to clear your recent history, or remove some or all cookies.

Apple Safari (Mac only)
  1. Click Safari in the upper left hand side of your screen.
  2. In the menu that appears, click Preferences.
  3. In the window that appears, click the Privacy tab.
  4. Click the button Remove All Website Data....
  5. Click Remove Now in the pop up window that appears.

Microsoft Edge
  1. Click the Hub icon.
  2. Click the History icon.
  3. Click the link labeled Clear all history.
  4. Check the boxes for each item you want to clear.
  5. Click the Clear button.

[{"Product":{"code":"SSLKT6","label":"IBM Maximo Asset Management"},"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Component":"System Related","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"Version Independent","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSLKTY","label":"Maximo Asset Management for IT"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSWK4A","label":"Maximo Asset Management Essentials"},"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSKTXT","label":"Tivoli Change and Configuration Management Database"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SS6HJK","label":"Tivoli Service Request Manager"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSWT9A","label":"IBM Control Desk"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSLKT6","label":"IBM Maximo Asset Management"},"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Document Information

Modified date:
13 April 2021

UID

swg21292557