[IBM MQ Advanced][Linux]

Installing RDQM (replicated data queue managers)

[MQ 9.2.0 Jul 2020]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 mqm 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.

[MQ 9.2.2 Mar 2021]The prerequisites for supported levels of RHEL 7 (Pacemaker 1) are:
  • cifs-utils
  • libcgroup
  • libtool-ltdl
  • lm_sensors-libs
  • lvm2
  • net-snmp-agent-libs
  • net-snmp-libs
  • nfs-utils
  • perl-TimeDate
  • psmisc
  • redhat-lsb-core
[MQ 9.2.0 Jul 2020]The prerequisites for supported levels of RHEL 8 (Pacemaker 2) are:
  • cifs-utils
  • libtool-ltdl
  • libxslt
  • net-snmp-libs
  • nfs-utils
  • perl-TimeDate
  • psmisc
  • python36
  • python3-lxml

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.

Note: The Pacemaker component of RDQM requires a user named hacluster and 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

To install support for RDQM (replicated data queue managers), you complete the following tasks:
  1. Install DRBD on each node.
  2. Install Pacemaker on each node.
  3. Install IBM MQ on each node.
  4. Install RDQM on each node.
The DRBD and Pacemaker RPM packages are supplied on the IBM MQ media. You should install the versions supplied with IBM MQ. Do not download your own versions. To ensure that the packages supplied with RDQM are used, add the following line to the definition of any yum repository that could supply alternatives, such as the AppStream repository in RHEL 8:
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.

Attention: If you are using UEFI secure boot, you might need to enroll the key for the DRBD kernel module. See https://linbit.com/drbd-user-guide/drbd-guide-9_0-en/#s-linbit-packages. If UEFI secure boot is in use and the key is not enrolled, you will see the following error message.
modprobe: ERROR: could not insert 'drbd': Required key not available
The DRBD and Pacemaker packages are signed with the LINBIT GPG key. Use the following command to import the public LINBIT GPG key:
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.

Attention: You should retain the installation media, in case there is a need to revert to this level, after upgrading to a later level.

Procedure

Complete the following steps on each node:

  1. 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. Change into the directory containing the installation image.
  3. 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:
    kmod-drbd-9.0.23_4.18.0_193-1.x86_64.rpm
  4. 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
  5. Install the required DRBD utilities. For example, for RHEL 8.2 you run the following command:
    yum install Advanced/RDQM/PreReqs/el8/drbd-utils-9/*
  6. Install Pacemaker. For example, for RHEL 8.2 you run the following command:
    yum install Advanced/RDQM/PreReqs/el8/pacemaker-2/*
    The Pacemaker installer reports any missing packages that also need to be installed before the install can complete successfully.
  7. Accept the IBM MQ license:
    ./mqlicense.sh
  8. Install IBM MQ. This is like a standard IBM MQ install. At the minimum, you must install the following:
    yum install MQSeriesGSKit* MQSeriesServer* MQSeriesRuntime*
  9. Install RDQM:
    yum install Advanced/RDQM/MQSeriesRDQM*

What to do next

You can now configure the Pacemaker cluster and replicated data queue managers, or you can configure disaster recovery replicated data queue managers. See RDQM high availability or RDQM disaster recovery.