Installing RDQM (replicated data queue managers)
Installation tasks associated with RDQM are grouped in this section. RDQM is available on RHEL 7.6 and onwards on x86-64, and on RHEL 8.2 and onwards on x86-64.
Before you begin
RDQM requires that the
mqm user has the same UID on each node and that the
mqm group has the same GID on each node. You should create the
IDs before running the installation procedure, using the groupadd and
useradd commands to set the UID and GID the same on each node. See Setting up the user and group on Linux.
Pacemaker is one of the prerequisites for RDQM. Pacemaker requires that certain Linux packages are installed on the system. The list for supported levels of RHEL 7 assumes that a minimal set of system packages has been installed that includes of all the mandatory and default packages from the @core package group and mandatory packages from the @base package group. The list for supported levels of RHEL 8 assumes that a minimal set of system packages has been installed that includes the mandatory and default packages from the mandatory groups of the Server environment group.
These packages in turn have their own requirements (which are not listed here). When Pacemaker is installed, it reports any missing packages that also need to be installed before installation can complete successfully.
haclusterand a group named
haclient. By default, these use a uid and gid of 189, although it is possible to specify a different uid and gid if required. The installation of Pacemaker creates the user and group if they do not exist.
About this task
- Install DRBD on each node.
- Install Pacemaker on each node.
- Install IBM MQ on each node.
- Install RDQM on each node.
exclude=cluster* corosync* drbd kmod-drbd libqb* pacemaker* resource-agents*
For supported levels of RHEL 7, the components are found under the Advanced/RDQM/PreReqs/el7/ directory. For supported levels of RHEL 8, components are found under the Advanced/RDQM/PreReqs/el8/ directory.
modprobe: ERROR: could not insert 'drbd': Required key not available
rpm --import https://packages.linbit.com/package-signing-pubkey.asc
Without this step, an RPM install of these packages issues the following warnings:
warning: rpm-name: Header V4 DSA/SHA1 Signature, key ID 282b6e23: NOKEY"
You can have multiple IBM MQ installations on each server, but only one of these installations should be an RDQM installation.
Complete the following steps on each node:
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.
- Change into the directory containing the installation image.
Determine which DRBD kernel module is needed for the system on which RDQM is being installed.
See https://ibm.biz/mqrdqmkernelmods for up-to-date
kernel module information. Helper scripts are provided in the kmod-drbd-9
directories. For example, on a RHEL 8.2 system, running the helper script
Advanced/RDQM/PreReqs/el8/kmod-drbd-9/modver returns the following information,
identifying the kernel module that you need to install:
Install the appropriate DRBD kernel module that you identified in step 1. For example, for RHEL
8.2 you run the following command:
yum install Advanced/RDQM/PreReqs/el8/kmod-drbd-9/kmod-drbd-9.0.23_4.18.0_193-1.x86_64.rpm
Install the required DRBD utilities. For example, for RHEL 8.2 you run the following
yum install Advanced/RDQM/PreReqs/el8/drbd-utils-9/*
Install Pacemaker. For example, for RHEL 8.2 you run the following command:
The Pacemaker installer reports any missing packages that also need to be installed before the install can complete successfully.
yum install Advanced/RDQM/PreReqs/el8/pacemaker-2/*
Accept the IBM MQ license:
Install IBM MQ. This is like a standard IBM MQ install. At the minimum, you must install the
yum install MQSeriesGSKit* MQSeriesServer* MQSeriesRuntime*
yum install Advanced/RDQM/MQSeriesRDQM*