+

Search Tips | Advanced Search

Migrating HA RDQMs

Follow this sequence of steps to upgrade all the RDQM nodes in an HA group and so migrate the replicated data queue managers (RDQMs).


About this task

You should upgrade all the nodes in an HA group in the same sequence to avoid operating with the nodes in the group at different levels.

If we have configured your HA group such that one node acts as a primary for all RDQMs, with the other two nodes as secondaries, you should upgrade the secondary nodes first and leave the primary node until last.

The sequence in which you upgrade, and the nodes that are marked as preferred and second preferred locations for RDQMs, affect where the RDQMs fail over to as you upgrade. During the migration sequence, while nodes are running different levels, the options for failing over are limited. An RDQM running on a lower level node can fail over to a higher level node but, once a queue manager has been started at the new level, it cannot fail over to a lower level node. You should choose an upgrade sequence and use preferred and second preferred locations settings to keep queue managers running on the lower level nodes for as long as possible. You should make changes to preferred and second preferred location settings before you suspend nodes, to ensure that the changes are effective immediately.

If you are also running DR RDQMs on any of the nodes, you should deal with these queue managers at the same time by following the instructions in Migrating DR RDQMs.


Procedure

  1. To upgrade the first node in the HA group:
    1. Suspend the node from the HA group by running the following command: 
      rdqmadm -s
      Any RDQMs currently running on the node move to another node in the HA group (their second preference, if one is defined for that RDQM).
    2. Run the uninstall script to uninstall IBM MQ and RDQM. 
      MQ_INSTALLATION_PATH/Advanced/RDQM/uninstallRDQMsupport
      The script can take some time to run, without indication that it is still running.
    3. Accept the license for the new version by running the mqlicense script.
    4. Run the installation script from the /Advanced/RDQM directory of your installation media, accepting the license when prompted: 
      installRDQMsupport
      The installRDQMSupport script installs only the default MQ components, for example:

      • MQSeriesClient.x86_64
      • MQSeriesRDQM.x86_64
      • MQSeriesRuntime.x86_64
      • MQSeriesSamples.x86_64
      • MQSeriesServer.x86_64

      If you require any other component (for example, AMQP, MFT, AMS and so on), then these components must be installed manually.

    5. If required, set this installation as the primary IBM MQ installation, using the setmqinst command. See setmqinst (set IBM MQ installation).
    6. Resume the node in the HA group by entering the following command: 
      rdqmadm -r
      Any RDQMs that have this node as their preferred location will resume running on this node.
  2. Repeat the steps for the second node in the HA group. (Use the same path as you did on the first node.)
  3. Repeat the steps for the third node in the HA group. (Use the same path as you did on the first node.)


What to do next

Verify that the installation on all three nodes matches by checking the RDQM configuration in the qm.ini files.