IBM Support

Updating LTPA timeout in Manage

How To


Summary

How do I increase the LTPA token timeout value in Manage?

Objective

Using IBM Maximo Application Suite (MAS), Manage users will receive an error message saying to reload the application after 2 hours, even while actively working.
This 2-hour timeout default is when the LTPA token in Manage expires, and is redirecting the user back to the login page for MAS.

Steps

The LTPA timeout can be increased by modifying the server.xml. The server.xml is part of the manage pods.
If you are using server bundles, this modification can be done only on the UI bundle, as this bundle is where it affects users.
  1. Log in to the MAS application with the mas admin user (or the user with permission to modify the deployment configuration for Manage).
  2. Access to the MAS admin console. For example,
    https://admin.mastest.apps.ltpatimeoutexample.ibm.com
  3. Select workspace -> Manage.
  4. In the drop-down menu labeled Actions, select Update Manage Configuration.
  5. Select the edit icon for Server Bundles.
  6. Click system managed (if checked).
  7. Click View for Additional Properties.
  8. Under the section Additional Server Config, place the following XML. Substituting the wanted timeout value, time is in minutes.
<server>
   <ltpa expiration="480" />
</server>
After adding this XML to the Additional Properties, select Save and then Apply Changes.
This change triggers the Manage deployment to rebuild and restart the pods. Since the pods are restarted, this restart causes downtime during the startup, so be sure to plan this downtime with users.

Additional Information

This creates a server-custom.xml under each of the pods in the bundle that the change was applied to.
You can verify the server.xml has the correct reference to this file and that the changes reflect there.
This change adds to the server.xml this section:
 <include optional="true" location="/config/manage/serverxml/server-custom.xml" /> 
You can find details on the include function in Liberty here:
https://www.ibm.com/docs/en/was-liberty/base?topic=files-using-include-elements-in-configuration

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB59","label":"Sustainability Software"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSRHPA","label":"IBM Maximo Application Suite"},"ARM Category":[{"code":"a8m3p000000hAeaAAE","label":"Maximo Application Suite-\u003EMAS Applications-\u003EManage"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
25 November 2022

UID

ibm16841623