Installing a later version of IBM MQ side-by-side to an earlier version.

How you install IBM® MQ 9.1 side-by-side to the existing version of the product on the same machine. The IBM MQ 9.0 installation will not be designated as the primary installation.

Before you begin

Ensure IBM MQ 8.0 is installed on your system. Use the following instructions, Installing the IBM MQ server on Windows, to install the product if IBM MQ 8.0 is not installed.

You need to have selected the Custom option so that you can explicitly select the Client. See Installation methods for Windows for more information.

Also you need to have invoked the setmqenv command with the -n parameter to have set the installation name to Installation1. It is helpful if you use a batch file to invoke the command.

About this task

All the queue manager data is stored in a common directory structure. Even though the executable code for each version of IBM MQ is stored in a different directory structure, the data for all the queue managers, regardless of the version, is stored in: MQ_DATA_PATH=C:\ProgramData\IBM\MQ.

To install IBM MQ 9.1:

Procedure

  1. Login as an administrator.
    IBM MQ 9.1 will be installed in the default directory C:\Program Files\IBM\MQ.
  2. Go to the directory where the download file is located, for example, C:\downloads\mq9100.
  3. Unzip the downloaded file.
    The files are extracted into a new subdirectory called MQServer.
  4. Switch to the new directory and issue the command setup.exe to start the installer.
    1. Click on Software Requirements to check that your enterprise has the requisite software installed.
      See Checking requirements on Windows for more information. In this scenario, the system has the requisite requirements.
    2. Click on Network Configuration.
      In this scenario, the machine is not part of a Domain, so there is no need to indicate a domain user and the answer to the question is No.
    3. Click on IBM MQ Installation.
    4. Click on Launch IBM MQ Installer.
      The installer detects that there are other installations on the system and displays the message:
      Upgrade or install
      Upgrade the existing installation or install the new version alongside it
      For this scenario, leave the other installations intact, so select the first entry Install leaving the existing installation(s) untouched.
    5. Click Next and accept the license.
    6. Select Custom for the installation option.
      See Installation methods for Windows for more information.
    7. Click Next.
      In the
      Installation Details
      Define the installation details
      you see:
      Installation Name
      Installation2
      Installation folder for program files
      C:\ProgramFiles\IBM\MQ
      The list of features to be installed is shown. Note that some items:
      • Are not installed by default
      • Need to be selected if you want to install them.

        For this scenario select MQI client, and you should select this option anyway.

    8. Click Next.
      In the screen entitled Ready to Install IBM MQ you see the summary of the Installation Name, location, components to install, and so on.
    9. Click Install to proceed.
      Copying of the files into the installation directory structure begins. After copying the files, the following dialog appears: The IBM MQ Installation Wizard has successfully installed IBM MQ.
    10. Click Finish.
      After the installation, you see the following dialog: Welcome to the Prepare IBM MQ Wizard.
      Because this scenario is not using a Windows Domain, accept the default of No.
      Accept to launch the IBM MQ Explorer 9.1, and unless you have a very specific reason, you can accept the default setting of Start MQ Explorer with a new workspace.

Results

You have successfully installed another version of IBM MQ for Windows alongside an existing version of the product.

What to do next

You need to run the setmqenv command to use the commands on either version. See Using the setmqenv command to run with both versions of IBM MQ for details.