Uninstalling IBM MQ on Solaris

On Solaris, you can uninstall the IBM® MQ server or client using the pkgrm command.

Before you begin

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

Restriction: On Solaris, you cannot remove components from an install. There is no supported method of doing this.

Procedure

Stop all IBM MQ applications associated with the installation you are uninstalling.
For a server installation, end any IBM 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
```
  where MQ_INSTALLATION_PATH refers to the location where IBM MQ is installed.
3. Display the state of all queue managers on the system. Enter the following command:
```
dspmq
```
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
```
Log in as root.
Uninstall IBM MQ using pkgrm:
1. On a system with a single installation, enter the following command:
```
pkgrm mqm
```
2. On a system with multiple installations:
```
pkgrm mqm-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. The first installation on the system does not have a suffix, and is uninstalled using the same method as for a single installation.
If a package has a dependency on mqm, pkgrm returns the name of the package. Uninstall the dependent packages first.

Results

After uninstallation, certain files under the directory trees /var/mqm and /etc/opt/mqm are not removed. These files contain user data and remain so subsequent installations can reuse the data. Most of the remaining files contain text, such as INI files, error logs, and FDC files. The directory tree /var/mqm/shared contains files that are shared across installations, including the executable shared library libmqzsd.so.

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 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, including the file libmqzsd.so. Deleting these directories destroys all queue managers and their associated data.