Installing IBM MQ on Linux Red Hat using yum

From IBM® MQ 9.2.0 you can install IBM MQ on Linux® Red Hat® by using the yum installer.

1. Optional: Log in as root, or with sufficient authority to run the following commands.

   You can do this by adding sudo before the commands, or by changing to the root user in the shell with the su command. For more information, see Exploring the differences between sudo and su commands in Linux.

2. Optional: If your installation media is a downloadable installation image, obtained from Passport Advantage, you must decompress the tar.gz file and extract the installation files from the tar file:
   1. For example, if you download part number CC7K6ML, you decompress the file by using the following command:

      gunzip CC7K6ML.tar.gz

   2. Similarly, extract the installation files from the tar file by using the following command:

      tar -xvf CC7K6ML.tar

      Important: You must use GNU tar (also known as gtar) to unpack any tar images.
3. Optional: If this is not the first installation on the system, or if you want to install IBM MQ to a non default location, run the crtmqpkg to create a unique set of packages to install on the system:

   ./crtmqpkg suffix installationPath

   where:

   • suffix specifies a name of your choosing that uniquely identifies 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.
   • installationPath specifies the path where you want to install IBM MQ.

   Note: This command creates a full copy of the installation packages in a temporary directory. By default, the temporary directory is located at /var/tmp. You must ensure that the system has enough free space before you run this command. To use a different location, you can set the TMPDIR environment variable before you run the crtmqpkg command. For example:

   $ TMPDIR=/test ./crtmqpkg suffix installationPath

4. Set your current directory to the location of the installation packages. If you used the crtmqpkg command, this directory is the location that is specified when the crtmqpkg command operation completes successfully.
5. Configure the yum repository:

   A sample repository file is available in the MQServer directory of the installation packages. You can use this sample to assist you in configuring the yum repository.

   1. Create or update the repository:
      • If this is the first IBM MQ installation on the system, create a file with the suffix .repo, for example, IBM_MQ.repo, in the /etc/yum.repos.d directory.
      • If this is an additional IBM MQ installation on the system, append the details of the additional installation to the appropriate .repo file in the /etc/yum.repos.d directory.
   2. Add the following contents to the repository file:

      [IBM-MQ-v.r.m-architecture]
      name=IBM MQ v.r.m architecture
      baseurl=file:///installationFilesLocation
      enabled=1
      gpgcheck=0

   3. Replace the installationFilesLocation variable with the location of the installation files.
   4. Replace the v.r.m variable with the version, release, and modification number for the version of IBM MQ that you want to install.
   5. Replace the architecture variable with the architecture of the system you are installing on. This value is one of the following values:
      • x86_64
      • ppc64le
      • s390x
   6. Optional: Enable gpg key verification.
      Replace gpgcheck=0 with gpgcheck=1 and add an additional gpgkey=<uri> line pointing to the certificate provided, for example:

      gpgcheck=1
      gpgkey=file:///directory/to/ibm_mq_public.pgp
      

   7. Optional: If you appended contents to the repository file, clear the repository cache by using the following command:

      yum clean all

   8. Check that the IBM MQ repository is available by using the following command:

      yum repolist

6. From IBM MQ 9.2.0, you have the option of accepting the license before or after installing the product. To accept the license before installing, run the mqlicense.sh script. The license agreement is displayed in a language appropriate to your environment and you are prompted to accept or decline the terms of the license:
   • To display the license agreement in the default manner, which uses an X-window where possible, use the following command:

     ./mqlicense.sh

   • To display the license agreement as text in the current shell, which can be read by a screen reader, use the following command:

     ./mqlicense.sh -text_only 

   See Accepting the license on IBM MQ for Linux for more information about license acceptance.
7. Install IBM MQ:
   • To install all available components in the default location, use the following command:

     yum -y install MQSeries*

   • To install all available components in a non default location, use the following command:

     yum -y install MQSeries*suffix*

     where suffix specifies the suffix that was chosen when you ran crtmqpkg in step 3.
   • To install a subset of components, specify the components that you want to install. Any dependencies are automatically installed. To support the running of a queue manager, you must install at least the MQSeriesRuntime and the MQSeriesServer components. For example, to install the server component in the default location, use the following command:

     yum -y install MQSeriesServer*

   • To install an older version of IBM MQ when multiple versions are available in the repository file, use the following command:

     yum -y install MQSeries*-v.r.m-f

     where v.r.m-f specifies the version, release, modification, and fix pack level to install.