Removing a fix pack from IBM MQ

Follow these instructions to remove a fix pack, for example IBM MQ Version 9.1.0, Fix Pack 1, from IBM MQ on UNIX platforms.

Before starting

Important: We must stop all IBM MQ queue managers, other objects, and applications, before you begin the process to modify IBM MQ.

About this task

The IBM MQ product for UNIX platforms uses two different directory trees that are mutually exclusive:

• A directory tree for the executable libraries and shared libraries.
  • In AIX it is /usr/mqm
  • In the other UNIX platforms it is /opt/mqm.

• A directory tree for the data for the queue managers and other configuration files.

  For all UNIX platforms it is var/mqm.

Because the directory trees are mutually exclusive, when you apply or remove maintenance only the files in usr/mqm or opt/mqm are affected.

We must uninstall IBM MQ in the reverse order of installation. That is, remove any fix pack you have applied and then remove the base version of the product.

Procedure

1. Stop all IBM MQ queue managers and clients associated with the installation we are modifying, if you have not already done so. For example, issue the following command:

   $ endmqm -i TEST_91

   You receive a message that the queue manager TEST_91 is ending (that is, shutting down), followed by another message when shutdown is complete.
2. Issue the following command:

   $ ps -ef | grep -i mq

   You receive a message similar to this:

   mqm 5492 5103 0 16:35 pts/0 00:00:00 ps -ef

   Now that there is no IBM MQ activity on the system, we can uninstall the product.Note: The following instructions apply to a Linux Ubuntu system.
3. Login as root and issue the a command similar to the following, to find out the file sets for IBM MQ Version 9.2.0, Fix Pack 1.

   +++ROOT+++ ubuntumq1.fyre.ibm.com: /root
   # apt list "ibmmq-*-u9201*"
   Listing... Done
   ibmmq-amqp-u9201/unknown,now 9.2.0.1 amd64 [installed]
   ibmmq-ams-u9201/unknown,now 9.2.0.1 amd64 [installed]
   …
   ibmmq-web-u9201/unknown,now 9.2.0.1 amd64 [installed]
   ibmmq-xrservice-u9201/unknown,now 9.2.0.1 amd64 [installed]

   Note the presence in each line of the following text, unknown, now.
4. Use the following Debian command to uninstall the product. This command removes the product, but leaves the package definition cached.

   # apt remove "ibmmq-*-u9201*"

   You receive messages similar to the following:

   …
   0 upgraded, 0 newly installed, 34 to remove and 78 not upgraded.
   After this operation, 974 MB disk space will be freed.
   Do we want to continue? [Y/n]
   Y
   …
   Removing ibmmq-runtime-u9201 (9.2.0.1) ...
   Entering prerm for "ibmmq-runtime-u9201" remove
   Entering postrm for "ibmmq-runtime-u9201" remove

5. List the installed file sets again by issuing the command:

   # apt list "ibmmq-*-u9201*"
   

   You receive messages similar to the following:

   ibmmq-amqp-u9201/unknown,now 9.2.0.1 amd64 [residual-config]
   ibmmq-ams-u9201/unknown,now 9.2.0.1 amd64 [residual-config]
   …
   ibmmq-web-u9201/unknown,now 9.2.0.1 amd64 [residual-config]
   ibmmq-xrservice-u9201/unknown,now 9.2.0.1 amd64 [residual-config]

   Note the following statement at the end of each line, residual-config
6. Issue the following command to purge the cached definition of the product:

   # apt purge "ibmmq-*-u9201*"

   You receive messages similar to the following:

   0 upgraded, 0 newly installed, 34 to remove and 78 not upgraded.
   After this operation, 0 B of additional disk space will be used.
   Do we want to continue? [Y/n]
   Y
   …
   Purging configuration files for ibmmq-fttools-u9101 (9.2.0.1) ...
   Entering postrm for "ibmmq-fttools-u9201" purge

7. List the installed file sets again by issuing the command:

   # apt list "ibmmq-*-u9201*"
   

   You receive messages similar to the following:

   # apt list "ibmmq-*-u9201*"
   Listing... Done
   ibmmq-amqp-u9201/unknown 9.2.0.1 amd64
   ibmmq-ams-u9201/unknown 9.2.0.1 amd64…
   ibmmq-web-u9201/unknown 9.2.0.1 amd64
   ibmmq-xrservice-u9201/unknown 9.2.0.1 amd64

   Note the presence in each line of the following text, unknown instead of unknown, now.
8. Issue the command dspmqver and you see that the version is

   # dspmqver
   Name: IBM MQ Version: 9.2.0.0

Results

We have successfully uninstalled IBM MQ Version 9.2.0, Fix Pack 1.

What to do next

We can uninstall the base product if required. Parent topic: Uninstalling or modifying IBM MQ on Linux