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 Restoring the previous maintenance level on IBM MQ on Solaris.
Restriction: On Solaris, you cannot
remove components from an installation. There is no supported method of doing this.
Important: You must stop all IBM MQ queue managers, other objects,
and applications, before you begin the process to uninstall or modify IBM MQ.
Procedure
-
Stop all IBM MQ applications associated with the
installation you are uninstalling or modifying, if you have not already done so.
-
For a server installation, end any IBM MQ activity
associated with the installation you are uninstalling:
-
Log in as a user in the group
mqm
.
-
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.
-
Display the state of all queue managers on the system. Enter the following command:
-
Stop all running queue managers associated with the installation you want to uninstall. Enter
the following command for each queue manager:
-
Stop any listeners associated with the queue managers. Enter the following command for each
queue manager:
-
Log in as root.
-
Uninstall IBM MQ using
pkgrm:
-
On a system with a single installation, enter the following command:
-
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.