Installing RDQM alongside other IBM MQ installations

You can install RDQM alongside other installations of IBM® MQ although there can only be one RDQM installation.

About this task

When installing multiple instances of IBM MQ on Linux® with RPM, you must ensure that each installation is made from packages with unique names. To create unique packages, you run the crtmqpkg command:

crtmqpkg PACKAGE_SUFFIX

Where PACKAGE_SUFFIX is a string added to package files to make them unique.

To install RDQM alongside existing IBM MQ installations, you must run crtmqpkg twice, once for the main IBM MQ package and once for the RDQM component that has a separate rpm file under the Advanced/RDQM subdirectory. For both commands, you should specify the same PACKAGE_SUFFIX. When you run crtmqpkg for the RDQM package, you supply RPMDIR and SPECDIR arguments to specify where the RDQM package files reside.

Note:

By default, the crtmqpkg command writes to the /var/tmp directory. To use a different location, you can set the TMPDIR environment variable before you run the crtmqpkg command.
Before you can run the crtmqpkg command on Linux, you must have the pax and rpmbuild commands installed. These commands are not supplied as part of the product. You must get them from your Linux distribution supplier. The rpmbuild command is located in the rpm-build package.

Procedure

To create unique installation packages for RDQM:

Decompress the downloaded software to your installation directory, see Installing the first IBM MQ installation on Linux using the rpm command.
From your installation directory, create unique packages for the IBM MQ components:
```
./crtmqpkg RDQM
```
From your installation directory, create unique packages for the RDQM components:
```
RPMDIR=install_directory_path/MQServer/Advanced/RDQM SPECDIR=install_directory_path/MQServer/Advanced/RDQM/repackage ./crtmqpkg RDQM
```
Where install_directory_path is the full path to your installation directory.
Install IBM MQ with RDQM using the packages you created in this task. Note that, as you are installing an additional instance of IBM MQ, you will need to use the --prefix option with rpm to specify a non-default installation location.
1. Change to the directory containing the unique packages that were created, for example:
```
cd /var/tmp/mq_rpms/RDQM/x86_64
```
2. Install IBM MQ and RDQM:
```
rpm -ivh --prefix /opt/customLocation MQSeriesGSKit* MQSeriesServer* MQSeriesRuntime* MQSeriesRDQM*
```