Skip to main content
Top
Review meshIQ Products (G2.com)

How to Configure the Maximum Session Lifetime for Manage (Navigator) and Secure (navXwsm)

You can enforce a maximum session lifetime for Manage (Navigator) and Secure (navXwsm) by setting the session.expiration.time system property on the VM where each application is running.

  • The value is specified in minutes.

  • Sessions are automatically logged out when this limit is reached, even if the user is active.

  • For compliance, configure the value to 720 minutes (12 hours) or less. Users must log in again after the session expires.

If the property is not set, the default maximum session lifetime is 12 hours.

Set session.expiration.time on Linux

On Linux deployments, you must configure the session expiration separately for Manage and Secure, because Manage runs on Tomcat, while Secure REST APIs run under WGS.

Configure Manage (Navigator)

  1. Create or update the file:
    apache-tomcat/bin/setenv.sh

  2. Add the following lines:

    #!/bin/sh
CATALINA_OPTS="$CATALINA_OPTS -Dsession.expiration.time=<minutes>"

  3. Replace <minutes> with the session lifetime in minutes (for example, 720).

Configure Secure (navXwsm)

Secure REST APIs run under WGS, so Tomcat startup scripts do not apply to Secure. Instead,

  1. Open the ATPNODE.lax file from [AUTOPILOT_HOME]/localhost

  2. Locate the property line starting with:
    lax.nl.java.option.additional=

  3. Append the following:
    -Dsession.expiration.time=<minutes>

  4. Replace <minutes> with the session lifetime in minutes (for example, 720).

Restart Tomcat (for Manage) and the CEP (for Secure) to apply the new setting.

Set session.expiration.time on Windows

Perform these steps on the machine where Manage or Secure is installed.
If they run on different servers, configure the variable on each server.

  1. Search for “Edit the system environment variables” in Windows and click it.
    image (4).png

  2. The System Properties dialog opens. Go to the Advanced tab and click Environment Variables…
    image (3).png

  3. The Environment Variables dialog opens. In the System variables section, click New…. 
    image (2).png

  4. The New System Variable dialog opens.
     image (5).png

  5. In the Variable name, enter:

    • session.expiration.time

  6. In the Variable value, enter the session lifetime in minutes:

    • For example, 720 for 12 hours, 480 for 8 hours

    • Use a value no greater than 720 minutes

  7. Click OK to close the New System Variable dialog.

  8. Click OK again to close the Environment Variables dialog, and OK to close System Properties.

  9. Restart Tomcat for the Manage application and WGS for the Secure application.