IBM Support

Collecting "JSSE" trace for IBM Integration Bus

Troubleshooting


Problem

IBM Integration Bus (IIB) uses Java™ Secure Socket Extension (JSSE) for the HTTP listeners and the HTTPRequest and SOAPRequest nodes.
Use this process to capture a trace of JSSE for the purpose of providing to IBM Support for analysis.

Resolving The Problem

  1. Enable JSSE tracing for a particular Int.Server:
    mqsichangeproperties {Int.Node} -e {Int.Server} -o ComIbmJVMManager -n jvmSystemProperty -v"-Djavax.net.debug=true"
    (Note that there is no space between '-v' and the first double quote!)
  2. Restart the Int.Server or Int.Node to cause the changed jvmSystemProperty to be loaded.
  3. Recreate the behavior.
  4. Disable JSSE tracing:
    mqsichangeproperties {Int.Node} -e {Int.Server} -o ComIbmJVMManager -n jvmSystemProperty -v ""
    (Note that there is a space between '-v' and the first double quote!)
  5. Restart the Int.Server or Int.Node to cause the empty jvmSystemProperty to be loaded.
  1. Locate the 'profiles' subdirectory in the 'config' directory in the Int.Node workpath:
    (Int.Node) {MQSI_WORKPATH}/config/{Int.Node}/profiles
    (Int.Server) {MQSI_WORKPATH}/config/{Int.Node}/{Int.Server}/profiles
  2. Create a new script file (Unix) or batch file (Windows).
  3. Update the script file to contain this line:
    (Unix) export IBM_JAVA_OPTIONS=-Djavax.net.debug=true
    (Windows) set IBM_JAVA_OPTIONS=-Djavax.net.debug=true
  4. Restart the Int.Server or Int.Node.
  5. Recreate the behavior.
  6. Disable JSSE tracing by updating the script/batch file, changing true to false, and restarting the Int.Server or Int.Node.
Output location
JSSE trace is written to the Java standard out location in the Int.Node workpath:
(Int.Node) {MQSI_WORKPATH}/components/{Int.Node}/
(Int.Server) {MQSI_WORKPATH}/components/{Int.Node}/{Int.Server_UUID}/
(Int.Node Listener) {MQSI_WORKPATH}/components/{Int.Node}/biphttplistener
On Unix, the file is named 'stdout'.
On Windows, the file is named 'console.txt'.

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSNQK6","label":"IBM Integration Bus"},"ARM Category":[{"code":"a8m50000000CiCJAA0","label":"IIB2->Security"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"10.0.0;9.0.0","Line of Business":{"code":"LOB15","label":"Integration"}}]

Document Information

Modified date:
02 November 2020

UID

swg21300238