Troubleshooting
Problem
WebSphere MQ or one of its fix packs is failing to install or uninstall properly, and you need to collect MustGather data to find a solution.
Environment
These instructions apply only to WebSphere MQ V5.3.1 and V5.3 on HP NonStop Server. Refer to the IBM MQ Read First page for instructions on other operating systems:
Resolving The Problem
Please answer these questions about the problem and then follow the steps below:
- What are you trying to install or uninstall?
- What account are you using to perform the installation or uninstallation?
Step 1: Generate Data
It is important to gather information from the system when the install or uninstall problem is happening in order to identify the cause:
- For install problems, list the contents of the directory containing the install image or fix pack. Guardian users should run the osh TACL command to switch to the OSS environment first. For example:
- For uninstall problems or fix pack problems, list the contents of the MQ installation directory tree. For example:
- Save the output of any errors reported by the install or uninstall process. Take a screen shot of the error, or log the install or uninstall process to capture the error. For example:
Listing installation files in the current directory
osh> ls -al > WMQ.installfiles.txt
Listing installed MQ files
osh> ls -alR /usr/ibm/wmq > WMQ.installedfiles.txt
Logging a WebSphere MQ install to a file
osh> script WMQ.install.txt
osh> instmqm
...
osh> exit
Step 2: Collect Data
- Record the MQ version and maintenance level currently on the system or identify the version you are attempting to install.
- Record the operating system version and maintenance level.
- Use the sdcp script to package your files for IBM, including files containing the output from the commands listed in Step 1 and 2. For new install problems you can simply send the list of installation files (WMQ.installfiles.txt) and the installation log (WMQ.install.txt) to IBM.
Step 3: Send Data to IBM
- Send your data to the IBM ECuRep repository by email to websphere_support@ecurep.ibm.com, or by standard or secure HTTP or FTP.
- While the data is transferring, send an email or use the IBM Service Request tool to update your PMR with your description of the problem and of the data you are sending.
- Contact your country representative if you need to speak to an IBM technical support representative, or in the US call 1-800-IBM-SERV. Refer to the IBM Software Support Handbook for more information on working with IBM.
A good description of the problem and the data is the most important information you can provide to IBM. Please do not send data without providing a description!
Product Synonym
WebSphere MQ WMQ
Was this topic helpful?
Document Information
Modified date:
22 June 2018
UID
swg21179309