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 to provide to IBM Support for analysis.

Resolving The Problem

  1. Enable JSSE tracing for a particular Integration Server:
    mqsichangeproperties {Int.Node} -e {Int.Server} -o ComIbmJVMManager -n jvmSystemProperty -v"-Djavax.net.debug=true"
    (Note there is no space between '-v' and the first double quotation mark!)
  2. Restart the Int.Server or Int.Node to cause the changed jvmSystemProperty to be loaded.
  3. Re-create the behavior.
  4. Disable JSSE tracing:
    mqsichangeproperties {Int.Node} -e {Int.Server} -o ComIbmJVMManager -n jvmSystemProperty -v ""
    (Note there is a space between '-v' and the first double quotation mark!)
  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 Integration Node work path:
    (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. Re-create the behavior.
  6. Disable JSSE tracing by updating the script or 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 work path:
(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}/httplistener
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":"LOB45","label":"Automation"}}]

Document Information

Modified date:
20 September 2021

UID

swg21300238