cluster peer health show

Check peer cluster health

Availability: This command is available to cluster administrators at the admin privilege level.

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