IBM Support

MustGather: Sessions and session management problems in WebSphere Application Server



Collecting data for problems with the IBM WebSphere Application Server sessions and session management component. Gathering this MustGather information before calling IBM support will help you understand the problem and save time analyzing the data.

Resolving The Problem

Sessions and Session Management specific MustGather information:
The first step in solving a problem with your HTTPSession in Application Server is to reproduce the problem with session tracing enabled. Adding debug code to the application simplifies the task of identifying the problem.

Instructions for setting up the trace:

  1. In the WebSphere Application Server administrative console, expand the Troubleshooting section and click Logs and Trace.
  2. Click the link for your server.
  3. Click Diagnostic Trace.
  4. Make sure Enable Log is checked, Maximum File Size is 100MB, Historical Files is 10, and specify a File Name. You may have to select different values for Maximum File Size and Historical Files as per the frequency of the problem or as suggested by support team.
  5. Click OK.
  6. Click on Change Log Level Details.
  7. In the text box for Trace Specification, enter the following string (type without spaces) depending on the method that you persist session data:
    • If you use memory-to-memory persistence:***=all

    • If you use database persistence:**=all:WAS.j2c=all:RRA=all
    • If you do not use any persistence:**=all
8. Click apply and save your configuration.
9. Stop the Application Server.
10. Enable a plug-in trace by changing the LogLevel attribute from Error to Trace in the plugin-cfg.xml file. This file is located in the following directory:


For more information on capturing plug-in trace, refer MustGather document for plug-in.
11. Stop the Web server.
12. Clear all logs for the Application Server:
  • trace.log
  • SystemOut.log
  • SystemErr.log
13. Start the Application Server.
14. Start the Web server.
15. Reproduce your problem.
16. Capture the cookie information from the browser by typing the following text in the address bar:
17. Collect the following:
  • Trace file from the diagnostic trace.
  • All files in the following directory:
  • All files in the following directory:
  • The server.xml file located in the following directory:
  • The http_plugin.log file.
  • The sessionID that encountered the problem or was captured in step 16.
  • historyReport.html generated by running the tool genHistoryReport.bat or, located in the install_root/bin directory; historyreport.html is generated in the working directory of where the genHistoryReport tool is run.
18. Follow instructions to send diagnostic information to IBM support.

For a listing of all technotes, downloads, and educational materials specific to the Session and Sessions Management component, search the WebSphere Application Server support site.

Related information
Submitting information to IBM support
Steps to getting support for WebSphere Application Server
MustGather: Read first for WebSphere Application Server
Troubleshooting guide for WebSphere Application Server

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"Component":"Sessions and Session Management","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"9.0;8.5;8.0;7.0","Edition":"Base;Express;Network Deployment","Line of Business":{"code":"LOB36","label":"IBM Automation"}},{"Product":{"code":"SS7JFU","label":"WebSphere Application Server - Express"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Java SDK","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSNVBF","label":"Runtimes for Java Technology"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":null,"Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
25 February 2019