cluster peer health show
Check peer cluster health
Description
The cluster peer health show command displays information about the health of the nodes in peer clusters from the perspective of the nodes in the local cluster. The command obtains health information by performing connectivity and status probes of each peer cluster's nodes from each node in the local cluster.
To enable quick access to remote cluster health information, remote cluster health status is periodically checked and cached. These cached results enable users and system features to quickly assess the availability of remote resources. By default, this command accesses cached results. Use the -bypass-cache true option to force a current, non-cached check of remote cluster health.
Parameters
- { [-fields <fieldname>, ...]
- If you specify the -fields <fieldname>, ... parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.
- | [-instance ]}
- If you specify the -instance parameter, the command displays detailed information about all fields.
- [-originating-node {<nodename>|local}] - Local Node
- Selects the node that matches this parameter value.
- [-destination-cluster <Cluster name>] - Peer Cluster
- Selects the cluster that matches this parameter value.
- [-destination-node <Peer Node Name>] - Peer Node
- Selects the node that matches this parameter value.
- [-destination-cluster-uuid <UUID>] - Peer UUID
- Selects the cluster that matches this parameter value.
- [-data-ping {unknown_node|internal_error|unreachable|session_reachable|interface_reachable}] - Status of Data Ping Operation
- Selects the nodes that match this parameter value.
- [-icmp-ping {unknown_node|internal_error|unreachable|session_reachable|interface_reachable}] - Status of ICMP Ping Operation
- Selects the nodes that match this parameter value.
- [-node-health {true|false}] - RDB Health of the Node
- Selects the nodes that match this parameter value (true means healthy).
- [-cluster-health {true|false}] - Cluster Health
- Selects the nodes that match this parameter value (true means healthy).
- [-availability {true|false}] - Communication Indicator
- Selects the nodes that match this parameter value (true means communicating).
- [-bypass-cache {true|false}] - Bypass Cache and Determine Health
- Bypasses cached results to determine current cluster health (true means bypass the cache). Cached results may not be current, but they are displayed more quickly.
- [-last-updated <MM/DD/YYYY HH:MM:SS>] - Last Update Time
- Selects the nodes that match this parameter value.
Examples
The following example shows typical output for this command in a cluster of two nodes that has a peer cluster of two nodes.
cluster1::> cluster peer health show
Node Cluster-Name Node-Name
Ping-Status RDB-Health Cluster-Health Availability
---------- --------------------------- --------- --------------- ------------
node1
cluster2 node3
Data: interface_reachable
ICMP: interface_reachable true true true
node4
Data: interface_reachable
ICMP: interface_reachable true true true
node2
cluster2 node3
Data: interface_reachable
ICMP: interface_reachable true true true
node4
Data: interface_reachable
ICMP: interface_reachable true true true
4 entries were displayed.
The following example shows detailed health information for node3 in cluster2 from the perspective of node1 in cluster1.
cluster1::> cluster peer health show -originating-node node1 -destination-cluster cluster2 -destination-node node3 -instance
Local Node: node1
Peer Cluster: cluster2
Peer Node: node3
Peer UUID: 5e4befb2-1f36-11d0-98c9-123476563412
Status of Data Ping Operation: interface_reachable
Status of ICMP Ping Operation: interface_reachable
RDB health of the node: true
Cluster Health: true
Communication Indicator: true
Last Update Time: 02/06 18:58:38