Making IBM MQ 9.4 the primary installation

Before you start any queue managers in your new installation of the later version of IBM® MQ, you can, optionally, make the later version the primary installation.

About this task

On systems that support multiple installations of IBM MQ, the primary installation is the one to which IBM MQ system-wide locations refer. Having a primary installation is optional, but convenient.

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, you 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

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 .
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.
Use the setmqinst command to set the new IBM MQ 9.4 installation as the primary installation.
In the command prompt, enter:
```
setmqinst -i -n V9_Installation
```
where V9_Installation is the name of the IBM MQ 9.4 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, you must restart the operating system to complete the update.

What to do next

You are ready to associate the migrated queue managers with the later version of IBM MQ as described in Associating the queue managers with IBM MQ 9.4.