Installing IBM MQ server on Linux using rpm

We can install an IBM MQ server on a 64-bit Linux system.

Before starting

CAUTION:The instructions in this topic do not apply to Linux Ubuntu or Linux on POWER Systems - Little Endian. For information about these platforms, see Installing IBM MQ on Linux Ubuntu using Debian.
If we install a copy of IBM MQ server for Linux using Electronic Software Download, obtained from Passport Advantage, we need to decompress the tar.gz file by using the gunzip command:
```
gunzip IBM_MQ_V9.0_TRIAL_FOR_LINUX_ML.tar.gz
```
and extract the installation files from the tar file:
```
tar -xvf IBM_MQ_V9.0_TRIAL_FOR_LINUX_ML.tar
```
Important: We must use GNU tar (also known as gtar) to unpack any tar images.
Before starting the installation procedure, ensure that we have completed the necessary steps outlined in Preparing the system on Linux.
If this installation is not the first installation on the system, we must ensure that the crtmqpkg command can write to a temporary location. By default, the crtmqpkg command will write to the /var/tmp directory. To use a different location, we can set the TMPDIR environment variable before you run the crtmqpkg command.
To run the crtmqpkg command used in this task, we must have the pax command or rpmbuild installed. Attention: pax and rpmbuild are not supplied as part of the product. You must obtain these from the Linux distribution supplier.

From IBM MQ Version 9.2.0 you have the option to accept the license before or after product installation. See License acceptance on IBM MQ for Linux for more information.

About this task

Install the server by using the RPM Package Manager installer to select the components we want to install. The components and package names are listed in IBM MQ rpm components for Linux systems.

Attention: Unless you install the packages using the wildcard character, that is, using the command rpm -ivh MQ*.rpm, install the packages in the following order:

MQSeriesRuntime
MQSeriesJRE
MQSeriesJava
MQSeriesGSKit
MQSeriesServer
MQSeriesWeb
MQSeriesFTBase
MQSeriesFTAgent
MQSeriesFTService
MQSeriesFTLogger
MQSeriesFTTools
MQSeriesAMQP
MQSeriesAMS
MQSeriesXRService
MQSeriesExplorer
MQSeriesClient
MQSeriesMan
MQSeriesMsg
MQSeriesSamples
MQSeriesSDK
MQSeriesSFBridge
MQSeriesBCBridge

Procedure

Log in as root, or switch to the superuser by using the su command.
Set your current directory to the location of the installation file. The location might be the mount point of the server DVD, a network location, or a local file system directory.
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
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.
If this installation is not the only installation of IBM MQ on the system, we must run the crtmqpkg command to create a unique set of packages to install on the system. To run the crtmqpkg command to run on Linux, we must install the pax command and rpmbuild, which is located in the rpm-build package. Note: The crtmqpkg command is required only if this is not the first installation of IBM MQ on the system. If we have earlier versions of IBM MQ installed on the system, then installing the latest version works correctly if you install it in a different location.
To run the crtmqpkg command on a Linux system:
1. Enter the following command:
```
./crtmqpkg suffix
```
  where suffix is a name of our 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. 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. We must ensure that the system has enough free space before you run this command. To use a different location, we can set the TMPDIR environment variable before you run the crtmqpkg command. For example:
```
$ TMPDIR=/test ./crtmqpkg suffix
```
2. Set your current directory to the location specified when the crtmqpkg command operation completes successfully. This directory is a subdirectory of the /var/tmp/mq_rpms directory, in which the unique set of packages is created. The packages have the suffix value contained within the file name. For example, using a suffix of "1":
```
./crtmqpkg 1
```
  means there is a subdirectory named /var/tmp/mq_rpms/1/x86_64. The packages are renamed according to the subdirectory, for example:
```
From: MQSeriesRuntime-8.0.0-0.x86_64.rpm
To: MQSeriesRuntime-1-8.0.0-0.x86_64.rpm
```
Install IBM MQ. To support the running of a queue manager, we must install at least the the MQSeriesRuntime and the MQSeriesServer components.
- To install to the default location, /opt/mqm, use the rpm -ivh command to install each component that you require. For example, to install the runtime and server components to the default location, use the following command:
```
rpm -ivh MQSeriesRuntime-*.rpm MQSeriesServer-*.rpm
```
  To install all components that are available in your current location on the installation media to the default location, use the following command:
```
rpm -ivh MQSeries*.rpm
```
  Important: The components that we need to install might not all be in the same folder on the installation media. Some components might be under the /Advanced folder. For more information about installing IBM MQ Advanced components, see Installing IBM MQ Advanced for Multiplatforms.
- 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 be either 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, enter the following installation path to install the runtime and server components to the /opt/customLocation directory on a 64-bit Linux system:
```
rpm --prefix /opt/customLocation -ivh MQSeriesRuntime-*.rpm
MQSeriesServer-*.rpm
```

Results

You installed IBM MQ on the Linux system.

What to do next

If required, we can now set this installation to be the primary installation. Enter the following command at the command prompt:
```
 MQ_INSTALLATION_PATH/bin/setmqinst -i -p MQ_INSTALLATION_PATH
```
where MQ_INSTALLATION_PATH represents the directory where IBM MQ is installed.

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.
To confirm that the installation was successful, we can verify your installation. See Verify an IBM MQ installation on Linux, for more information.
Only a user with a UID that is a member of the mqm group can issue administration commands. To enable users to issue administration commands, they must be added to the mqm group. For more information, see Set up the user and group on Linux and Authority to administer IBM MQ on UNIX, Linux, and Windows systems.

Installing the IBM MQ server silently on Linux
We can carry out a non-interactive installation of the IBM MQ server. A non-interactive installation is also known as a silent, or unattended installation.

Installing IBM MQ server on Linux using rpm

Before starting

About this task

Procedure

Results

What to do next

Related concepts

Related tasks

Related information