rmcdomainstatus Command

Edit online

Purpose

Displays the status of the node in management domain and peer domain.

Syntax

rmcdomainstatus -s ctrmc [-a ip|IP]

Description

When you run the rmcdomainstatus command in a node, the output displays the node status in the management domain and peer domain that contains the node. If the output is not displayed, the node is not a member of any peer domain or management domain.

The output of the rmcdomainstatus command is displayed in the following format:
Domain status
<Token 1 of node status> <Token 2 of node status> <Node ID> <Internal node number> <Node name 
| IP address | IP address of the specified MCP> <PD_name>/<PD_status> (n)

The following information fields are displayed in the rmcdomainstatus command output:

Domain status
Displays the current state of domain. The domain status can be displayed in the following ways:
Peer Domain Status
Displays the current state of peer domain.
Management Domain Status: Managed Nodes
Displays the current state of all the managed nodes that are managed by the node in the management domain.
Management Domain Status: Management Control Points (MCP)
Displays the current state of all the Management Control Points (MCPs) that are managing the node in the management domain.
Note: The output might contain more than one section depending on the current state of the node. That is, if the node is a member of both peer domain and management domain, the output contains two separate sections of information.
Token 1 of node status
Specifies the node status that indicates one of the following conditions:
S
Indicates that text in the output is for current node in the peer domain.
I
In a management domain, this value indicates that the node is in the Up state, which is determined by the Resource Monitoring and Control (RMC) heartbeat mechanism. In a peer domain, this value indicates that the RMC daemon in the specified node is a member of the rmc_peers Group Services group and the node is online in the peer domain.
i
In a management domain, this value indicates that the node is in the Pending Up state. Communication is established between two RMC daemons but the initial handshake is not completed.
Note: The i token is displayed only for management domains.
O
In a management domain, this value indicates that the node is in the Down state, which is determined by the RMC heartbeat mechanism. In a peer domain, this value indicates that the RMC daemon in the specified node is no longer a member of the rmc_peers Group Services group.
X
In a management domain, this value indicates that a communication problem is discovered, and the RMC daemon has suspended communication with the RMC daemon that is in the specified node.
Z
Indicates that the RMC daemon has suspended communication with the RMC daemon that is in the specified node because the Up or Down state of the node is changing quickly.
Token 2 of node status
Specifies the node status that indicates one of the following conditions:
S
Indicates that text in the output is for current node in the peer domain.
A
Indicates that the messages are not queued for the specified node.
a
Indicates the same meaning as the A value, except that the specified node is running a version of the RMC daemon that is at a lower level than the local RMC daemon.
R
Indicates that the messages are queued for the specified node.
r
Indicates the same meaning as the R value, except that the specified node is running a version of the RMC daemon that is at a lower level than the local RMC daemon.
Node ID
Specifies the 64-bit node ID that is created when RSCT is installed on the node.
Internal node number
Specifies the internal node number that is used by the RMC daemon.
Node name or IP address
Specifies the name of the node that is identified by the RMC subsystem.
Note: This value is displayed only if the node is a member of a peer domain or a management domain.
IP address of the specified MCP
Specifies the first configured IP address of the specified MCP.
Note: This value is displayed only if the node is an MCP.
PD_name/PD_status (n)
Specifies the peer domain name and peer domain status as received from the managed node when the -a flag is not used.
Note: This value is displayed only if the node is an MCP.
The PD_name attribute is the name of the peer domain of which the managed node is an online member. The PD_status attribute is the status of the peer domain.

If the managed node is offline, the PD_name/PD_status attributes are set as !/-, and the (n) attribute is not present. If the peer domain status is received from the managed node, the PD_name attribute is set as +. The n attribute is the number of online nodes in the peer domain of which the specified managed node is a member.

Flags

-s ctrmc
Specifies the RSCT daemon name. For RMC, the RSCT daemon name is ctrmc.
-a IP|ip
Lists the IP addresses that are configured on the node. The valid values that can be specified with the -a flag are as follows:
IP
Lists all the configured and harvested IP addresses.
ip
Lists the IP addresses that are configured in the ctrmc.srcntbl file (for peer domain) and in the ctrmc.mntbl or ctrmc.mcptbl file (for management domain).

Implementation specifics

This command is part of the Reliable Scalable Cluster Technology (RSCT) fileset for AIX®, Linux®, and other operating systems.

Location

/opt/rsct/bin/rmcdomainstatus

Examples

  1. To check the node status in the peer domain and management domain, run the following command:
    rmcdomainstatus -s ctrmc

    If the output is not displayed, the node is not a member of a peer domain or a management domain.

    If the node is a member of a peer domain, an output that is similar to the following example is displayed:
    Peer Domain Status
   I A  0x09898b3065189db6  0002  test1.ppd.pok.ibm.com
   S S  0x07e7287425d0becd  0001  test2.ppd.pok.ibm.com
    If the node is an MCP, an output that is similar to the following example is displayed:
    Management Domain Status: Managed Nodes
   I a  0xbf1fb04e5b7d0b06  0001  test1 !/+
   I a  0x3a75dd6c235c428e  0002  test2  masMMtest/+ (1)
   I A  0x07e7287425d0becd  0003  test3  masfive/+ (2)
   I A  0x09898b3065189db6  0004  test4  masfive/+(2)
    If the node is a managed node, an output that is similar to the following example is displayed:
    Management Domain Status: Management Control Points
   I A  0xef889c809d9617c7 0001  9.xx.xx.xxx
  2. To display the configured and harvested IP addresses in the current node status, run the following command:
    rmcdomainstatus -s ctrmc -a IP
    An output that is similar to the following example is displayed:
    Peer Domain Status
  I A  0x4313b01f7aae13d9  0002  myrsct1.in.ibm.com
  S S  0xa15313e0cc675d54  0001  myrsct2.in.ibm.com

Management Domain Status: Management Control Points
  I A  0x128a32b77a5d91cb  0001  10.xx.xx.xx (C)