Collect and analyze WebSphere MQ data to solve problems with software installation or uninstallation

Technote (troubleshooting)


Problem(Abstract)

You are having difficulty installing or uninstalling WebSphere MQ software and you need to collect data to find a solution. This document explains how to generate diagnostic data during the failed installation or uninstallation, how to collect the available data from the system, and how to analyze that data and share it with IBM support.

Environment

These instructions are for WebSphere MQ on AIX, HP-UX, IBM i, Linux, Solaris, and Windows systems. Return to the WebSphere MQ MustGather index for other systems.

Resolving the problem




Step 1: Generate Data

Follow these steps to generate more information about the software installation or uninstallation failure.


    AIX

    1. If you are installing WebSphere MQ, list the contents of the directory containing the WebSphere MQ installation files on your system, for example:

      sh> ls -alR /path/to/install/files > /tmp/wmq-install-files.txt

    2. List any WebSphere MQ software already on the system:

      sh> lslpp -R ALL -ha "mqm.*" > /tmp/wmq-installed-software-before.txt


    3. Enable extra debugging by setting the environment variable shown below: then retry the installation or uninstallation:

      sh> export INST_DEBUG=1


    4. Retry the installation or uninstallation using SMIT or installp.
    5. Disable the additional debugging:

      sh> unset INST_DEBUG

    6. List any WebSphere MQ software on the system:

      sh> lslpp -R ALL -ha "mqm.*" > /tmp/wmq-installed-software-after.txt




    HP-UX

    1. If you are installing WebSphere MQ, list the contents of the directory containing the WebSphere MQ installation files on your system, for example:

      sh> ls -alR /path/to/install/files > /tmp/wmq-install-files.txt

    2. List any WebSphere MQ software already on the system:

      sh> /usr/sbin/swlist -l fileset MQSERIES > /tmp/wmq-installed-software-before.txt

    3. Enable extra debugging by creating two files, as shown below:

      sh> touch /tmp/AMQ_DEBUG_SW_SCRIPTS
      sh> echo "2" > /tmp/wmq_debug_install


    4. Retry the install or uninstall using swinstall or swremove. Take note of the "jobid" value which is printed when swinstall and swremove start, for example:

      08/19/13 12:42:19 EST  BEGIN remove AGENT SESSION (pid=9826)
              (jobid=yourhost.example.com-0123)

    5. Disable the additional debugging:

      sh> rm -f /tmp/AMQ_DEBUG_SW_SCRIPTS /tmp/wmq_debug_install

    6. If you did not see the jobid, run the following command to list the recent jobs:


      sh> /usr/sbin/swjob

    7. Once you have the jobid, run the following command to get a copy of the log for that job. Use your actual jobid and hostname instead of the examples given here:


      sh> /usr/sbin/swjob -a log yourhost.example.com-1234 @ yourhost.example.com > /tmp/wmq-install-log.txt

    8. List any WebSphere MQ software on the system:

      sh> /usr/sbin/swlist -l fileset MQSERIES > /tmp/wmq-installed-software-after.txt



    IBM i

    1. List the software already on the system, for example by running the following command and then using WRKSPLF Option 5 to view the output:

      ===> DSPSFWRSC OUTPUT(*PRINT)

    2. Perform the installation or uninstallation, using the OUTPUT(*PRINT) option on the RSTLICPGM or DLTLICPGM command, for example:

      ===> RSTLICPGM LICPGM(5724H724) DEV(OPT01) OPTION(*BASE) OUTPUT(*PRINT)

    3. List the software on the system again:

      ===> DSPSFWRSC OUTPUT(*PRINT)


    Linux

    1. If you are installing WebSphere MQ, list the contents of the directory containing the WebSphere MQ installation files on your system, for example:

      sh> ls -alR /path/to/install/files > /tmp/wmq-install-files.txt

    2. List any WebSphere MQ software already on the system:

      sh> rpm -qai "MQSeries*" > /tmp/wmq-installed-software-before.txt

    3. Run the "script" command to start logging all screen output to a file:

      sh> script /tmp/wmq-install-log.txt

    4. Retry the installation or uninstallation, adding the -vv flag to all rpm commands to get verbose output.
    5. Run the "exit" command to stop logging your screen output:

      sh> exit
    6. List any WebSphere MQ software on the system:

      sh>rpm -qai "MQSeries*" > /tmp/wmq-installed-software-after.txt




    Solaris

    1. If you are installing WebSphere MQ, list the contents of the directory containing the WebSphere MQ installation files on your system, for example:

      sh> ls -alR /path/to/install/files > /tmp/wmq-install-files.txt
    2. List any WebSphere MQ software already on the system:

      sh> pkginfo | grep mqm > /tmp/wmq-installed-software-before.txt

    3. For each package found in the previous command, list the package details and save it to a file, for example:

      sh> pkgparam mqm CLASSES >> /tmp/wmq-installed-software-details-mqm.txt
      sh> pkgparam mqm_inst2 CLASSES >> /tmp/wmq-installed-software-details-mqm_inst2.txt

    4. Run the "script" command to start logging all screen output to a file:

      sh> script /tmp/wmq-install-log.txt

    5. Retry the installation or uninstallation, adding the -v flag to all pkgadd or pkgrm commands to get verbose output.
    6. Run the "exit" command to stop logging your screen output:

      sh> exit
    7. List any WebSphere MQ software on the system:

      sh> pkginfo | grep mqm > /tmp/wmq-installed-software-after.txt




    Windows

    Note that %TEMP% refers to the temporary directory of the user attempting the installation. The following command will show the location of the temporary directory:

    C:\> ECHO %TEMP%

    1. If you are installing WebSphere MQ, list the contents of the directory containing the WebSphere MQ installation files on your system, for example:

      C:\> DIR /A /S C:\PATH\TO\INSTALL\FILES > %TEMP%\wmq-install-files.txt
    2. List the software already on the system:

      C:\> wmic product get | findstr IBM > %TEMP%\wmq-installed-software-before.txt
    3. Save the WebSphere MQ registry keys to a file:

      C:\> %SYSTEMROOT%\system32\reg EXPORT HKLM\SOFTWARE\Wow6432Node\IBM\MQSeries > %TEMP%\wmq-registry64.txt
      C:\> %SYSTEMROOT%\system32\reg EXPORT HKLM\SOFTWARE\IBM\MQSeries > %TEMP%\wmq-registry32.txt
    4. Retry the installation or uninstallation.
    5. List any WebSphere MQ software on the system:

      C:\> wmic product get | findstr IBM > %TEMP%\wmq-installed-software-after.txt










Step 2: Collect Data

Manually collect the following information from your system, if it is available, for the WebSphere MQ install or uninstall problem:


    AIX

    /smit.log
    /tmp/wmq-install-files.txt
    /tmp/wmq-installed-software-before.txt
    /tmp/wmq-installed-software-after.txt


    HP-UX

    /tmp/wmq-install-log.txt
    /tmp/wmq-install-files.txt
    /tmp/wmq-installed-software-before.txt
    /tmp/wmq-installed-software-after.txt


    IBM i

    The joblog from DSPSFWRSC before the install or uninstall attempt.
    The joblog from RSTLICPGM or DLTLICPGM showing the error.
    The joblog from DSPSFWRSC after the install or uninstall attempt.


    Linux

    /tmp/wmq-install-log.txt
    /tmp/wmq-install-files.txt
    /tmp/wmq-installed-software-before.txt
    /tmp/wmq-installed-software-after.txt


    Solaris

    /tmp/wmq-install-log.txt
    /tmp/wmq-install-files.txt
    /tmp/wmq-installed-software-before.txt
    /tmp/wmq-installed-software-details-*.txt
    /tmp/wmq-installed-software-after.txt


    Windows

    %TEMP%\MQv*.*
    %TEMP%\amqicsdn.txt
    %TEMP%\amqidotn.log
    %TEMP%\amqisenv.log
    %TEMP%\amqisoap.log
    %TEMP%\amqt*.log
    %TEMP%\wmq-registry32.txt
    %TEMP%\wmq-registry364.txt
    %TEMP%\wmq-install-files.txt
    %TEMP%\wmq-installed-software-before.txt
    %TEMP%\wmq-installed-software-after.txt






Step 3: Analyze Data

You can now analyze WebSphere MQ data with IBM Support Assistant tools such as IBM Support Assistant Team Server. Using a web browser, you can see an overview of your system based on the data you collected, review problem symptoms found in the data, and search IBM's Global Knowledge Base for relevant Fix Packs, APARs and Technotes. Follow these steps until you find a solution for your install or uninstall problem:

  1. Review the IBM Support Assistant findings.
  2. Check for similar issues on the WebSphere MQ Support Portal.
  3. Use IBM Service Request to open a problem record with IBM.
  4. Send your data to IBM for further analysis.



  • Tell us what errors you saw, where you saw them, and what time they happened
  • Let us know if you made any changes to WebSphere MQ or the system before the problem
  • Share any other observations which you think will help us to better understand the problem





Please see the IBM Software Support Handbook for more information on working with IBM support.

Product Alias/Synonym

WMQ MQ

Rate this page:

(0 users)Average rating

Document information


More support for:

WebSphere MQ
Install / Migration

Software version:

5.3, 6.0, 7.0, 7.1, 7.5

Operating system(s):

AIX, HP-UX, Linux, Solaris, Windows, iSeries

Software edition:

All Editions

Reference #:

1648991

Modified date:

2013-09-18

Translate my page

Machine Translation

Content navigation