Viewing the status of a disaster recovery queue manager

You can view the status of a queue manager in a disaster recovery configuration by using the status command on the command line, or by using the IBM® MQ Console.

About this task

The status command returns information about the operational status of a specified queue manager in the disaster recovery configuration. The status can include the following information:
  • The disaster recovery role of the queue manager (reported as Primary or Secondary).
  • Whether asynchronous or synchronous replication is used.
  • The current disaster recovery status:
    Normal
    The appliances in the disaster recovery configuration are operating normally.
    Synchronization in progress
    This status can mean that initial replication is completing, or there has been a failure of the disaster recovery replication network and the queue manager has switched into synchronization mode to catch up as quickly as possible.
    Partitioned
    Queue manager data on the appliances is out of step, and cannot be automatically resolved. The makedrprimary and makedrsecondary commands must be used to resolve the situation. When this status is displayed on one of the appliances in a disaster recovery pair, the other appliance might display the remote appliance unavailable status, because the connection was lost before it detected the partitioned status.
    Paused
    In a DR/HA configuration, this status occurs if the DR replication link detects the need for a catch-up synchronization but neither DR node is currently primary (due to a failure having just occurred). This is most likely caused by demoting the primary at the same moment as the need for a synchronization is detected. This situation can be resolved by re-promoting the recently demoted appliance and waiting for the synchronization to complete.
    Remote appliance(s) unavailable
    The status means that the connection to the other appliance in the disaster recovery configuration has been lost.
    Inactive
    The queue manager is in the secondary role on both appliances.
    Inconsistent
    This status is shown only when the queue manager is in the secondary role and an in-progress synchronization has been interrupted. If you use the makedrprimary command on a queue manager that is in this state, the queue manager reverts to the snapshot of its data that was taken before it entered the inconsistent state.
    Reverting to snapshot
    This status is shown when the queue manager is in the secondary role, and the makedrprimary command is issued when the queue manager is in the Inconsistent state. The queue manager is reverted to the current snapshot of its data such that it can run.
    Remote appliance(s) not configured
    This status is shown when the crtdrprimary command has been run, to specify that a queue manager has the primary role, but no crtdrsecondary command has been run on the other appliance in the disaster recovery pair.
    Failed negotiation
    This status is shown if the replication type is not consistent for the DR primary and the DR secondary (that is, one is configured to use synchronous replication and the other is configured to use asynchronous replication).
  • The percentage complete of a synchronization operation. This information is shown only when the status is Synchronization in progress.
  • The estimated time at which a synchronization will complete. This information is shown only when the status is Synchronization in progress.
  • The amount of out-of-sync data that exists on this instance of the queue manager. This is the amount of data written to this instance of the queue manager since it last synchronized. This information is shown only when the status is Partitioned, Inconsistent, or Remote appliance(s) unavailable.
  • The time and date that the data was last in sync. This is displayed whenever data is out of sync.
  • The percentage complete of a reversion to snapshot operation. This information is shown only when the status is Reverting to snapshot.
If the queue manager is part of both an HA and a DR configuration, then both HA and DR information is displayed, with the additional fields:
DR local IP address
The IP address of the recovery interface (usually eth20) of the local appliance.
DR remote configuration
Indicates if the remote configuration is an HA pair, set to either High availability group or Single appliance.
DR remote IP address list
If the remote configuration is an HA group, lists the two IP addresses used by the two appliances in the group.
DR current remote IP address
The IP address of the current recovery interface (usually eth20) of the remote appliance.

Procedure

  • To view the DR status of a queue manager by using the command line interface:
    1. Enter the IBM MQ administration mode by entering the following command:

      mqcli

    2. View the status of a DR queue manager by entering the following command from one of the appliances:

      status QMgrName

      Where:
      QMgrName
      Specifies the name of the DR queue manager that you want to view the status of.
    3. Exit the IBM MQ administration mode by entering the following command:

      exit

  • To view the DR status of a queue manager by using the IBM MQ Console:
    1. Open the console and go to the Manage view.
    2. Click the Disaster recovery tab. The status of the DR queue manager is shown in the DR status column.