IBM Support

Timeout configuration setting options in an IBM Datacap Navigator environment

Troubleshooting


Problem

There may be occasions when unexpected timeout errors begin occurring in a Datacap Navigator environment. That can happen either via pop-up error messages or timeout errors given in some form of logs. Verifying the timeout setting configuration in only one location, will not coincide with the timeout value/error being given. Hence, other timeout configuration setting locations need to be verified as well.

Resolving The Problem

The following are a few of the timeout settings to be be aware of that can affect the timeout behavior in a Datacap Navigator environment:
  1. Websphere(WAS)/ICN server session timeout value: In Websphere Administrative console default is 30 mins.
  2. In IIS, wTM application pool idle time-out is defaulted to 20 minutes.
  3. wTM session timeout value: "sessionTimeout" value in web.config default to 20 mins.
  4. WAS LTPA session timeout value defaults to 120 mins or 2 hours.
The following are recommended guidelines to follow if the above timeout settings will be manually modified:
  • The session timeout on the client side (WAS/ICN) and IIS, must be greater than or equal to the session timeout set in wTM web.config file.
  • In case of a load balancer, the load balancer must ensure that there is a session affinity based on the 'wTmId'. This means that all request contained a particular 'wTmId' MUST be directed to the WTM server which generated that 'wTmId' and not to the other WTM servers.
  • The load balancer session timeout must be greater than or equal to the session timeout set in wTM web.config file.
  • Similarly if there is load balancer between WTM and TMS, then it MUST maintain session affinity based on the IP address. https://www.ibm.com/support/knowledgecenter/en/SSZRWV_9.1.7/com.ibm.dc.install.doc/dcplb001.htm

Document Location

Worldwide

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSCQS39","label":"Datacap Navigator"},"ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
05 August 2020

UID

ibm16256884