Uninstalling IBM WebSphere MQ on Linux

On Linux®, you can uninstall theIBM® WebSphere® MQ server or client using the rpm command.

Before you begin

If any updates have been applied, remove them before starting this uninstallation procedure. For more information, see Linux: Restoring the previous maintenance level on IBM WebSphere MQ Version 7.5 .

Procedure

  1. Stop all IBM WebSphere MQ applications associated with the installation you are uninstalling.
  2. For a server installation, end any IBM WebSphere MQ activity associated with the installation you are uninstalling:
    1. Log in as a user in the group mqm.
    2. Set up your environment to work with the installation you want to uninstall. Enter the following command:
      . MQ_INSTALLATION_PATH/bin/setmqenv -s
      where MQ_INSTALLATION_PATH refers to the location where IBM WebSphere MQ is installed.
    3. Display the state of all queue managers on the system. Enter the following command:
      dspmq -o installation
    4. Stop all running queue managers associated with the installation you want to uninstall. Enter the following command for each queue manager:
      endmqm QMgrName
    5. Stop any listeners associated with the queue managers. Enter the following command for each queue manager:
       endmqlsr -m QMgrName
  3. Log in as root.
  4. Uninstall IBM WebSphere MQ using the rpm command:
    1. On a system with a single installation:
      1. Find out the names of the packages (components) currently installed on your system, by entering the following command:
        rpm -qa | grep MQSeries
        
      2. Remove all the components at the same time by appending all the package names to the rpm command arguments. For example, to remove the runtime, Server and SDK components enter the following command:
        rpm -ev MQSeriesRuntime MQSeriesServer MQSeriesSDK
      Tip: To list the packages, and uninstall them in one go, use a command like the following one:
      rpm -qa | grep MQSeries | xargs rpm -ev
    2. On a system with multiple installations:
      1. Find out the names of the packages (components) currently installed on your system, by entering the following command:
        rpm -qa | grep suffix
        
        where suffix is the unique name given to the packages when crtmqpkg was run at installation time. suffix is included in each of the package names that belong to a particular installation.
      2. Remove all the components at the same time by appending all the package names to the rpm command arguments. For example, to remove the runtime, Server and SDK components for an installation with the suffix MQ71, enter the following command:
        rpm -ev MQSeriesRuntime-MQ71 MQSeriesServer-MQ71 MQSeriesSDK-MQ71

Results

You might find that certain files remain after uninstalling IBM WebSphere MQ. For example, mqinst.ini remains after uninstallation. This is to enable information to be reused by subsequent installs. See below for more information.

What to do next

  • If the product successfully uninstalled, you can delete any files and directories contained in the installation directory.
  • If there are no other IBM WebSphere MQ installations on the system, and you are not planning to reinstall or migrate, you can delete the /var/mqm and /etc/opt/mqm directory trees. Deleting these directories destroys all queue managers and their associated data.