Installing an IBM MQ client on Windows

This topic describes how to install IBM MQ client on Windows systems. This procedure can be used for installing a first or a subsequent installation.


Before starting

To install an IBM MQ client, we must be logged on to Windows as an administrator.


Follow these instructions to perform an interactive compact, typical, or custom installation of IBM MQ. To view all the installation types and the features that are installed with each option consult Features installed with each type of interactive installation.

Attention: From IBM MQ Version 9.0, if we are using msiexec to install the client, the installation is automatically set to be the primary installation.


Procedure

  1. Access the IBM MQ installation image.

    The location might be the mount point of the server DVD (if we are using the client image on the server DVD), or a network location, or a local file system directory. See Where to find downloadable installation images.

  2. Locate setup.exe in the Windows directory of the IBM MQ installation image.

    • From the server DVD, this location might be E:\Windows\setup.exe
    • From a network location, this location might be m:\instmqs\Windows\setup.exe
    • From a local file system directory, this location might be C:\instmqs\Windows\setup.exe

  3. Start the installation process.

    Either run setup.exe from a command prompt, or double-click setup.exe from Windows Explorer.

    Note: If we are installing on a Windows system with UAC enabled, accept the Windows prompt to allow the launchpad to run as elevated. During installation, you might also see Open File - Security Warning dialog boxes that list International Business Machines Limited as the publisher. Click Run to allow the installation to continue. The IBM MQ Installation window is displayed.
  4. Follow the instructions on screen.


Results

A new sample IBM MQ MQI client configuration file is created in the IBM MQ installation directory (for example C:\Program Files\IBM\MQ\, by the IBM MQ MQI client package, during installation, but only if this file does not exist. This file contains the ClientExitPath stanza. An example mqclient.ini file is shown in Configure a client using a configuration file.

Note:

If we are using a common configuration file for multiple clients, either in the IBM MQ installation directory or in another location using the MQCLNTCF environment variable, we must grant read access to all user identifiers under which the IBM MQ client applications run. If the file cannot be read, the failure is traced and the search logic continues as if the file had not existed.


What to do next

  • If we have chosen this installation to be the primary installation on the system, when using setup.exe, we must now set it as the primary installation. Enter the following command at the command prompt:
     
    MQ_INSTALLATION_PATH\bin\setmqinst -i -p MQ_INSTALLATION_PATH
    
    You can have only one primary installation on a system. If there is already a primary installation on the system, we must unset it before we can set another installation as the primary installation. For more information, see Change the primary installation.
  • We might want to set up the environment to work with this installation. We can use the setmqenv or crtmqenv command to set various environment variables for a particular installation of IBM MQ. For more information, see setmqenv and crtmqenv.
  • For instructions on how to verify your installation, see Testing communication between a client and a server on Windows.

Parent topic: Install and uninstall IBM MQ on Windows


Related concepts


Related tasks