View DR/HA RDQM and HA group status
We can view the HA status and DR role of DR/HA replicated data queue managers (RDQMs).
You use the rdqmstatus command to view the status of individual RDQMs or get an overview of the status of all the RDQMs known to the HA group.
We must be a user in the mqm and haclient groups to run the rdqmstatus command. We can run the command on any of the nodes in either of the HA groups.
Procedure
-
To view the status of a node and the RDQMs that are part of the HA configuration:
rdqmstatus
The identity of the node that you ran the command on and the status of the RDQMs in the HA configuration is displayed, plus their current DR role, for example:Node: main-alice Queue manager name: RDQM1 Queue manager status: Running elsewhere HA current location: main-charlie Queue manager name: RDQM9 Queue manager status: Running elsewhere HA current location: main-bob DR role: Primary Queue manager name: RDQM7 Queue manager status: Running HA current location: This node DR role: Primary
In this example, RDQM7 and RDQM8 are both DR/HA RDQMs, while RDQM1 is an HA RDQM, which is not configured to be able to switch over to a disaster recovery site.
-
To view the status of a particular queue manager on all the nodes in the HA group, enter the
following command:
rdqmstatus -m qmname
where qmname is the name of the RDQM we want to view the status for. The status of the RDQM on the current node is displayed, followed by a summary of the status of the other two nodes from the perspective of the current node.The following table summarizes the information about the current node that can be returned by the rdqmstatus command for an RDQM.
Status attribute Possible values When displayed Node name nodename Always displayed Queue manager status state of queue manager (one of the states that are valid for dspmq command) Always displayed CPU n.nn% Only shown when RDQM is running on this node Memory nnnMB used Only shown when RDQM is running on this node Queue manager file system nnnMB used, y.yGB allocated [z%] Only shown when RDQM is running on this node HA role Primary
Secondary
UnknownAlways displayed HA status All nodes in standby
This node in standby
Remote nodes in standby
Mixed
All nodes in standby
Current node in standby
Both remote nodes in standby
Different status for each remote nodeHA control Enabled
Disabled
Unknown
Always displayed. Shows whether RDQM is under Pacemaker control HA preferred location None
This node
Unknown
nodenameAlways displayed HA floating IP interface Interface_name Always displayed HA floating IP address IPV4_address Always displayed DR role Primary
Secondary
UnknownAlways displayed DR status Normal
Synchronization in progress
Partitioned
Remote system unavailable
Inconsistent
Reverting to snapshot
Remote system not configured
Negotiation failedEverything is OK.
Synchronization is in progress.
The user has started the queue
manager on each node while the
DR replication network was
unavailable.
The connection to the other node
has been lost.
A synchronization was in progress but was interrupted.
The user has chosen to revert to
the snapshot that was taken when
the queue manager entered the
Inconsistent state.
The primary has been configured
but the secondary has not.
The initial negotiation between the primary and secondary nodes failed. This can be caused by incompatible replication types or if the secondary node is configured with a smaller filesystem size.DR status (on HA secondary node) See HA_Primary_Node Displayed on the HA secondary nodes as the DR status is only known on the HA primary node. DR port The TCP/IP port used to replicate the data for this queue manager. Always displayed. DR local IP address The local IP address this queue manager will use for DR replication Always displayed. DR remote IP address list The remote IP addresses this queue manager will use for DR replication. A comma-separated list of three IP addresses. Always displayed. DR current remote IP address The current remote IP this queue manager is connected to for DR replication. For an HA primary with an active DR connection. DR current remote IP address (on HA secondary node) See HA_Primary_Node Displayed on an HA Secondary node as the DR connection is only on the HA Primary node DR out of sync data xKB Displayed when remote node unavailable or inconsistent. DR synchronization progress y% Displayed when a synchronization is in progress. DR estimated time to completion YYYY-MM-DD HH:MM:SS Displayed when a synchronization is in progress. Snapshot reversion progress y% Displayed when DR status is "Reverting to snapshot"
Example
These examples illustrate the command rdqmstatus -m qm1 run on various nodes of the following DR/HA configuration:
Example of normal status on a node that is the DR primary and HA primary:
Node: main-alice Queue manager status: Running CPU: 0.00% Memory: 123MB Queue manager file system: 51MB used, 1.0GB allocated [5%] HA role: Primary HA status: Normal HA control: Enabled HA current location: This node HA preferred location: This node HA floating IP interface: None HA floating IP address: None DR role: Primary DR status: Normal DR port: 3000 DR local IP address: 192.168.1.1 DR remote IP address list: 192.168.2.1,192.168.2.2,192.168.2.3 DR current remote IP address: 192.168.2.1 Node: main-bob HA status: Normal Node: main-charlie HA status: NormalExample of normal status on a node that is the DR primary and an HA secondary:
Node: main-bob Queue manager status: Running elsewhere HA role: Secondary HA status: Normal HA control: Enabled HA current location: main-alice HA preferred location: main-alice HA floating IP interface: None HA floating IP address: None DR role: Primary DR status: See main-alice DR port: 3000 DR local IP address: 192.168.1.2 DR remote IP address list: 192.168.2.1,192.168.2.2,192.168.2.3 DR current remote IP address: See main-alice Node: main-alice HA status: Normal Node: main-charlie HA status: NormalExample of normal status on a node that is the DR secondary and an HA primary:
Node: dr-alice Queue manager status: Ended immediately HA role: Primary HA status: Normal HA control: Enabled HA current location: This node HA preferred location: This node HA floating IP interface: None HA floating IP address: None DR role: Secondary DR status: Normal DR port: 3000 DR local IP address: 192.168.2.1 DR remote IP address list: 192.168.1.1,192.168.1.2,192.168.1.3 DR current remote IP address: 192.168.1.1 Node: dr-bob HA status: Normal Node: dr-charlie HA status: NormalExample of normal status on a node that is the DR secondary and an HA secondary:
Node: dr-bob Queue manager status: Ended immediately HA role: Secondary HA status: Normal HA control: Enabled HA current location: dr-alice HA preferred location: dr-alice HA floating IP interface: None HA floating IP address: None DR role: Secondary DR status: See dr-alice DR port: 3000 DR local IP address: 192.168.2.2 DR remote IP address list: 192.168.1.1,192.168.1.2,192.168.1.3 DR current remote IP address: See dr-alice Node: dr-alice HA status: Normal Node: dr-charlie HA status: NormalExample of DR synchronization in progress on a node that is a DR primary and HA primary:
Node: main-alice Queue manager status: Running CPU: 0.00% Memory: 123MB Queue manager file system: 51MB used, 1.0GB allocated [5%] HA role: Primary HA status: Normal HA control: Enabled HA current location: This node HA preferred location: This node HA floating IP interface: None HA floating IP address: None DR role: Primary DR status: Normal DR port: 3000 DR local IP address: 192.168.1.1 DR remote IP address list: 192.168.2.1,192.168.2.2,192.168.2.3 DR current remote IP address: 192.168.2.1 DR synchronization progress: 11.0% DR estimated time to completion: 2018-09-06 14:55:05 Node: main-bob HA status: Normal Node: main-charlie HA status: NormalExample of DR partitioned on a node that is a DR primary and HA primary:
Node: main-alice Queue manager status: Running CPU: 0.00% Memory: 123MB Queue manager file system: 51MB used, 1.0GB allocated [5%] HA role: Primary HA status: Normal HA control: Enabled HA current location: This node HA preferred location: This node HA floating IP interface: None HA floating IP address: None DR role: Primary DR status: Partitioned DR port: 3000 DR local IP address: 192.168.1.1 DR remote IP address list: 192.168.2.1,192.168.2.2,192.168.2.3 DR current remote IP address: 192.168.2.1 DR out of sync data: 372KB Node: main-bob HA status: Normal Node: main-charlie HA status: NormalParent topic: RDQM disaster recovery and high availability
Related information