Troubleshooting session related errors
To keep track of sessions, the mid tier uses session ID cookies. Every user that connects with the mid tier is assigned a session ID. A session ID remains the same for duration for the duration the user is connected with the mid tier.
The Mid tier runs a few checks when receiving an HTTP request. One of these checks is to determine if the HTTP session has a valid session ID.
The Mid tier checks if the session ID is present or not. If the session ID is present and is recognized by the mid tier, the session ID is routed to the specific user. If the session ID is not present or is not recognized by the mid tier, a 9201 Session is invalid error is returned to the user.
A session time-out can occur due to following reasons:
- Valid session timeout (90 minutes – default)
When the user does not perform any activity in the browser window for the span of the session timeout interval.
- The session ID is not sent as a cookie, which is part of the HTTP request.
- The load balancer does not direct the user to the same mid tier during the current session.
- A non-administrator user logs into the mid tier in a browser window. If the user opens another browser tab, the session timer continues on the first browser tab even if an activity is in progress on the second browser tab.
- A non-administrator user logs into the mid tier in a browser window. The user opens another browser tab and logs in again. In this case, the authentication through the first browser tab becomes invalid.
When a session times out, the license release depends on the mid tier version:
- Version 9.1.04 and earlier — License is automatically released on a session time-out.
- Version 9.1.04.002 — License is not released on a session time-out.
- Version 18.05 and later — License is not released on a session time-out. However, on the next login, the previous session is logged out you log in to the new session. This prevents license release problem for a new session.
- ARERR 9201 is displayed.
- Seems to be random as user can work for a while but then gets the error.
All users can experience problem.
Perform the following steps to troubleshoot the mid tier session related issues:
|1||Try to bypass the load balancer|
Bypass the load balancer and validate if the same problem occurs.
For example, The load balancer "examplelb" front ends two mid tiers, midtier1 and midtier2. These mid tiers are running Tomcat on HTTP port 8080.
When you access mid tier through the load balancer, the example URL is as follows:
When you directly access the mid tier, without load balancer, the example URL is as follows:
For more information, see the knowledge article
Determine the frequency of the error
Analyze the following:
Enable logs and reproduce the problem.
The network capture records the error. Examine the requests and perform the following checks:
In Remedy Mid Tier 19.08, logging surrounding the session has been enhanced to make it easier to troubleshoot. For more information, see Troubleshooting the ARERR 9201 error.
|4.||Disable the logging|
To disable the logging, use similar steps as described in Enabling logs for Remedy Mid Tier troubleshooting.
Remember to disable the logs from each mid tier and AR System server for which logging was enabled.
Collect the logs
Copy the logs to another location where you can review them so that they do not get overwritten.
The logs may be large depending on volume of activity during the logging period.
Collecting mid tier and tracelogger logs
Zip up all the logs in the log location specified on the Log Settings page of Remedy Mid Tier Configuration Too.
C:\Program files\BMC Software\ARsystem\midtier\logs f
For Linux, the default location is as follows:
Collecting Network capture
Create a BMC Support Case
Collect and send logs and detailed information when creating a case with BMC Support:
|8||Analyze the logs|
You can review the logs and identify error messages or behaviors.
Use the table below to troubleshoot based on your symptoms and error messages.
After you determine a specific symptom or error message, use the following table to identify the solution:
ARERR 9201 occurs when you perform an action after a delay
|Mid tier 9.x or later|
Check the Session Timeout Interval on the General Settings page of Remedy Mid Tier Configuration Tool
If the problem is specific to one user, then check the user's AR System User Preference record.
See the knowledge article
ARERR 9201 Session Timeout
When user transitions to another browser tab causes a license release
|Mid tier 8.1.02||Upgrade the mid tier to version 9.1 or later.||Knowledge article: ARERR 9201 Session Timeout when user transitions to another window or Tab in the Mid Tier client which causes a License Release|
|ARERR 9201 related to proxy server redirection||Mid tier 9.x or later||Configure load balancer to use a Cookie based session affinity rather than IP.|
See the knowledge article
|ARERR 9201- Mid tier page does not load. Network capture shows 9201 error.||Only specific users|
This might cause because of the high value in the Session Timeout in Minutes field on the AR System User Preference record for the specific user.
Perform the following steps to resolve the issue:
See the Knowledge article