Skip to main content

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