+

Search Tips | Advanced Search

Installing an IBM MQ client on Linux using rpm

Installing an IBM MQ client on a 64 bit Linux system.


Before starting

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


This task describes the installation of the client, using the RPM Package Manager installer to select which components we want to install. We must install at least the Runtime and Client components. The components are listed in IBM MQ rpm components for Linux systems.


Procedure

  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. For Long Term Support before Version 9.2.0 and Continuous Delivery before Version 9.1.5, we must accept the terms of the license agreement before we can proceed with the installation. To do this run the mqlicense.sh script:
    ./mqlicense.sh

    The license agreement is displayed in a language appropriate to the environment and you are prompted to accept or decline the terms of the license.

    If possible, mqlicense.sh opens an X-window to display the license.

    If you need the license to be presented as text in the current shell, which can be read by a screen reader, type the following command, ./mqlicense.sh -text_only

  4. From Version 9.2.0, you have the option of accepting the license before or after installing the product. See License acceptance on IBM MQ for Linux for more information.
  5. If we have multiple installations on this system, we 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 our 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.

  6. Install IBM MQ. The minimum components we 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
      If we are using Ubuntu, add the --force-debian attribute. For example, to install all components to the default location use the following command: 
      rpm --force-debian -ivh MQSeries*.rpm
      We must include this option to prevent seeing warning messages from the version of RPM for the platform, which indicates that the RPM packages are not intended to be directly installed using RPM.
    • To install to a non-default location use the rpm --prefix option. For each installation, all of the IBM 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 64-bit Linux system: 
      rpm --prefix /opt/customLocation -ivh MQSeriesRuntime-V.R.M-F.x86_64.rpm
MQSeriesClient-V.R.M-F.x86_64.rpm
      where:

        V
        Represents the version of the product that we are installing

        R
        Represents the release of the product that we are installing

        M
        Represents the modification of the product that we are installing

        F
        Represents the fix pack level of the product that we are installing


What to do next

  • If we have chosen this installation to be the primary installation on the system, 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
    We 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 Linux

Parent topic: Installing IBM MQ on Linux using rpm


Related tasks

Last updated: 2020-10-04