Install RDQM (replicated data queue managers)

Installation tasks associated with RDQM are grouped in this section. RDQM is only available on RHEL 7.x on x86-64.


Before you begin

Pacemaker is one of the prerequisites for RDQM that you install as part of this task. Pacemaker requires that the following Linux packages are installed on the system:

  • OpenIPMI-modalias.x86_64
  • OpenIPMI-libs.x86_64
  • libyaml.x86_64
  • PyYAML.x86_64
  • libesmtp.x86_64
  • net-snmp-libs.x86_64
  • net-snmp-agent-libs.x86_64
  • openhpi-libs.x86_64
  • libtool-ltdl.x86_64
  • perl-TimeDate.x86_64


To install support for RDQM (replicated data queue managers), you run two scripts that perform the following tasks:

  1. Install IBM MQ on each node.
  2. Install DRBD and Pacemaker on each node.
  3. Install RDQM on each node.
  4. Configure the firewall 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.

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"

The same installation location should be used on all three servers that are the nodes in the HA group, or both servers in a DR pair. We can have multiple IBM MQ installations on each server, but only one of these installations should be an RDQM installation.

The following installation script is supplied in the Advanced/RDQM directory of the installation media. You must run the script as root:

    installRDQMsupport

    By default, installs the IBM MQ runtime, server, samples, client, and RDQM RPM packages. Also installs the DRBD and Pacemaker RPM packages. (We can edit this file, if required, to add additional RPM packages to install; see IBM MQ rpm components for Linux systems for a list of available RPM packages.)

A script for configuring the firewall for HA RDQM is supplied in the IBM MQ samples directory, you must run the script as root:

    MQ_INSTALLATION_PATH/samp/rdqm/firewalld/configure.sh
    Adds the following permanent firewallD service rules for DRBD, Pacemaker, and IBM MQ:

    • MQ_INSTALLATION_PATH/samp/rdqm/firewalld/services/rdqm-drbd.xml allows TCP ports 7000-7100.
    • MQ_INSTALLATION_PATH/samp/rdqm/firewalld/services/rdqm-pacemaker.xml allows UDP ports 5404-5407
    • MQ_INSTALLATION_PATH/samp/rdqm/firewalld/services/rdqm-mq.xml allows TCP port 1414 (you must edit the script if you require a different port)

For DR RDQM you specify the replication port when you create a DR RDQM, so must configure your firewall to add firewallD service rules accordingly.

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

To install RDQM support, on each node:

  1. Run the script installRDQMsupport to install IBM MQ, RDQM support, DRBD, and Pacemaker.
  2. Run the script MQ_INSTALLATION_PATH/samp/rdqm/firewalld/configure.sh to configure the firewall for HA RDQM operation.


What to do next

We can now configure the Pacemaker cluster and replicated data queue managers, see RDQM high availability. Or we can configure disaster recovery replicated data queue managers, see RDQM disaster recovery.