Installing an IBM WebSphere MQ client on Linux

Installing a WebSphere® MQ client on a 32 bit or 64 bit Linux® system.

Before you begin

  • Before you start the installation procedure, make sure that you have completed the necessary steps outlined in Preparing the system.
  • If this installation is not the first installation on the system, you must ensure that you have write access to /var/tmp.

About this task

This task describes the installation of the client, using the RPM Package Manager installer to select which components you want to install. You must install at least the Runtime and Client components. The components are listed in Choosing what to install.


  1. Log in as root, or switch to the superuser using the su command.
  2. Make your current directory the location of the installation file. The location might be the mount point of the DVD, a network location, or a local file system directory.
  3. Run the script.
    If you want to view a text-only version of license, which can be read by a screen-reader, type:
    ./ -text_only
    The license is displayed.
    If want to accept the license without it being displayed, you can run the script with the -accept option.
    ./ -accept

    You must accept the license agreement before you can proceed with the installation.

  4. If this installation is not the first installation on the system, you must run crtmqpkg to create a unique set of packages to install on the system:
    1. Enter the following command:
      crtmqpkg suffix
      where suffix is a name of your choosing, that will uniquely identify the installation packages on the system. suffix is not the same as an installation name, although the names can be identical. suffix is limited to 16 characters in the ranges A-Z, a-z, and 0-9.
    2. Set your current directory to the location specified when the crtmqpkg command completes.
      This directory is a sub-directory of /var/tmp/mq_rpms, in which the unique set of packages is created. The packages have the suffix value contained within the filename.
  5. Install IBM WebSphere MQ.
    The minimum components you must install are the MQSeriesRuntime and the MQSeriesClient.
    • To install to the default location, /opt/mqm, use the rpm -ivh command to install each component that you require.
      For example, to install all components to the default location use the following command:
      rpm -ivh MQSeries*.rpm
    • To install to a non-default location use the rpm --prefix option. For each installation, all of the IBM WebSphere MQ components that you require must be installed in the same location.

      The installation path specified must either be an empty directory, the root of an unused file system, or a path that does not exist. The length of the path is limited to 256 bytes and must not contain spaces.

      For example, to install the runtime and server components to /opt/customLocation on a 32-bit Linux system:
      rpm --prefix /opt/customLocation -ivh MQSeriesRuntime-7.5.0-0.i386.rpm

What to do next

  • If you have chosen this installation to be the primary installation on the system, you must now set it as the primary installation. Enter the following command at the command prompt:
    You can have only one primary installation on a system. If there is already a primary installation on the system, you must unset it before you can set another installation as the primary installation. For more information, see Changing the primary installation .
  • You might want to set up the environment to work with this installation. You can use the setmqenv or crtmqenv command to set various environment variables for a particular installation of IBM WebSphere MQ. For more information, see setmqenv and crtmqenv.
  • For instructions on how to verify your installation, see Verifying an IBM WebSphere MQ client installation