Making IBM MQ Version 9.2 the primary installation

Before you start any queue managers in the new IBM MQ Version 9.2 installation, we can, optionally, make IBM MQ Version 9.2 the primary installation.

On systems that support multiple installations of IBM MQ, the primary installation is the one to which IBM MQ system-wide locations refer. For IBM WebSphere MQ Version 7.1 or later, having a primary installation is optional, but convenient. However, if you have an installation of IBM WebSphere MQ Version 7.0.1 on the system, this installation is automatically the primary installation and we cannot change the primary installation while Version 7.0.1 is installed.

When you follow the side-by-side migration method described in this scenario, because you uninstall the earlier version before starting any queue managers in the later release, we can assign your installation of the later version of the product to be the primary installation.

For more information about the primary installation, see Primary installation.

Procedure

1. Check the current primary installation by entering the dspmqinst command into the command prompt. The command prompt displays the details of any current installations. The current primary installation has the following line Primary: Yes .
2. Use the setmqinst command to change the current primary installation. In the command prompt, enter:

   setmqinst -x -n Installation_Name
   

   where Installation_Name> is the name of the current primary installation. If the command is successful, the command prompt displays the message 'Installation_Name' (Filepath) has been unset as the Primary Installation.
3. Use the setmqinst command to set the new IBM MQ Version 9.2 installation as the primary installation. In the command prompt, enter:

   setmqinst -i -n V9_Installation
   

   where V9_Installation is the name of the Version 9.2 installation.

   If the command is successful, the command prompt displays the message 'V9_Installation' (Filepath) has been set as the primary installation. You must restart the operating system to complete the update.

   Note: As directed in the success message, we must restart the operating system to complete the update.

What to do next

You are ready to associate the migrated queue managers with the new IBM MQ Version 9.2 installation as described in Associating the queue managers with IBM MQ Version 9.2.