Uninstalling or modifying IBM MQ on HP-UX

On HP-UX, we can uninstall the IBM MQ server or client using the swremove command. We can also modify an IBM MQ installation by uninstalling selected IBM MQ components.

Before you begin

If any updates have been applied, remove them before starting the uninstallation procedure. For more information, see Restoring the previous maintenance level on IBM MQ on HP-UX. 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

1. Stop all IBM MQ applications associated with the installation you are uninstalling or modifying, if we have not already done so.
2. For a server installation, end any IBM MQ activity associated with the installation you are uninstalling or modifying:
   1. Log in as a user in the group mqm.
   2. Set up your environment to work with the installation you want to uninstall or modify. 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 -o installation
      

   4. Stop all running queue managers associated with the installation you want to uninstall or modify. 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 MQ using swremove:
   • To uninstall all IBM MQ components, enter the following command:

     swremove MQSERIES,l= MQ_INSTALLATION_PATH
     

     where MQ_INSTALLATION_PATH is the path where IBM MQ is installed.
   • To modify an IBM MQ installation and uninstall selected IBM MQ components, enter the following command:

     swremove componentname,l= MQ_INSTALLATION_PATH
     

     where componentname is the name of the component to uninstall, and MQ_INSTALLATION_PATH is the path where IBM MQ is installed. For example:
     • To uninstall the client component, from an installation in /opt/myLocation, enter the following command:

       swremove MQSERIES.MQM-CL-HPUX,l=/opt/myLocation
       

     • To uninstall the client and the telemetry client components, from an installation in /opt/myLocation, enter the following command:

       swremove MQSERIES.MQM-CL-HPUX,l=/opt/myLocation MQSERIES.MQM-TXCLIENT,l=/opt/myLocation
       

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 libraries libmqzsd.so and libmqzsd_r.so.

What to do next

• If the product successfully uninstalled, we 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, we can delete the /var/mqm and /etc/opt/mqm directory trees, including the files libmqzsd.so and libmqzsd_r.so. Deleting these directories destroys all queue managers and their associated data.