Troubleshooting
Problem
You are experiencing Web Services (HTTP, HTTPS) problems with WebSphere Message Broker (WMB) or IBM Integration Bus (IIB) on UNIXes and Linux. This mustgather document explains how to troubleshoot this problem by yourself, how to generate diagnostic data when the problem is happening, how to collect the available data from your system, and how to share that data with IBM support.
Environment
These instructions are for WebSphere Message Broker or IBM Integration Bus on AIX, HP-UX, Linux, and Solaris systems.
Return to the WebSphere Message Broker MustGather index for other systems.
Resolving The Problem
- Consider Using the Test Client in trace and debug mode.
- A user level trace is intended to assist users with understanding how their ESQL is processed.
It will also show a high level view of the message flow behavior. - Check for known issues:
Dynamic guide to help troubleshooting Message Broker
Implementing WebService security in WMB
Run the WebServices samples
WebSphere Message Broker support site
- mqsidc
See: mqsidc usage instructions
- This command line tool is only available for WMB 7.0.0.5+, WMB 8.0.0.1+, and IIB 9.0.
- When running the tool, select the option for 'Broker Collector', when prompted.
- Project Interchange files for the problematic flow/set/ESQL/model
- You can export your Message Flow and Message Set project(s) into an archive file for easy transmission to IBM Support.
See: Exporting files from the Workbench
- You can export your Message Flow and Message Set project(s) into an archive file for easy transmission to IBM Support.
- Traces
If the problem occurs during a runtime test or with the Toolkit test facility, WMB execution group traces can be used to gain a better understanding of the problem.
- A service level trace is intended to be provided to IBM Support to assist in the diagnosis of your issue.
- SSL trace for HTTPS problems only
- SOAP debug trace when using SOAP nodes with http (not https)
- General Broker information
If the mqsidc tool was not run, then capture this information manually- Record the IBM Integration Bus or WebSphere Message Broker version, release, and maintenance level.
This can be captured using the command 'mqsiservice -v'.. - Record the operating system version, release, and maintenance level.
- Record the version, release, and maintenance level of any related products and components for the problematic application.
- Collect the local error log. On UNIX and Linux systems, the local error log is the syslog. The location of your syslog is configured in the syslog daemon.
See: Configuring the syslog daemon - Collect the Standard Output/Error logs.
WMB writes information to both STDOUT and STDERR. These files are located under the Message Broker workpath.
See: Standard System Logs - Additional information
- Output of command: mqsilist -r -d2
- Is IIB/WMB acting as service provider or service consumer?
- Record the IBM Integration Bus or WebSphere Message Broker version, release, and maintenance level.
ATTENTION: A good problem description is one of the most important tools IBM needs to analyze your data!
When sending data to IBM, be sure to update your PMR or send a note with the following information:
- Use IBM Service Request to open or view a problem record with IBM.
- Send your data to IBM for further analysis.
Please see the IBM Software Support Handbook for more information on working with IBM support.
Product Synonym
WMB MB WebSphere Message Broker MQ Integrator WBIMB WBI-MB MQSI WMQI
Was this topic helpful?
Document Information
Modified date:
23 March 2020
UID
swg21299823