IBM Support

Collect WebSphere MQ MustGather data to solve install and uninstall problems on HP NonStop Server

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:




  1. 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:

    1. Listing installation files in the current directory


      osh> ls -al > WMQ.installfiles.txt


  2. For uninstall problems or fix pack problems, list the contents of the MQ installation directory tree. For example:

    1. Listing installed MQ files


      osh> ls -alR /usr/ibm/wmq > WMQ.installedfiles.txt


  3. 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:

    1. Logging a WebSphere MQ install to a file


      osh> script WMQ.install.txt
      osh> instmqm
           ...
      osh> exit



Step 2: Collect Data


  1. Record the MQ version and maintenance level currently on the system or identify the version you are attempting to install.


  2. Record the operating system version and maintenance level.


  3. 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


  1. Send your data to the IBM ECuRep repository by email to websphere_support@ecurep.ibm.com, or by standard or secure HTTP or FTP.


  2. 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.



  3. 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.

[{"Product":{"code":"SSFKSJ","label":"WebSphere MQ"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Problem Determination","Platform":[{"code":"PF010","label":"HP-UX"}],"Version":"5.3.1;5.3","Edition":"All Editions","Line of Business":{"code":"LOB45","label":"Automation"}}]

Product Synonym

WebSphere MQ WMQ

Document Information

Modified date:
22 June 2018

UID

swg21179309