cluster peer ping
Initiate intercluster connectivity test
Availability: This command is available to cluster administrators at the admin privilege level.
Description
The cluster peer ping
command displays the status of the network mesh used by the peering relationship. The command checks the network connection to each remote IP address known by the cluster. This includes all intercluster addresses. It is possible for a known address to be not present during the ping. These addresses are not checked, but the absence is temporary.
The most useful parameters for diagnosing problems are -count
and -packet-size
. Use the -count
and -packet-size
parameters to diagnose problems similarly to how you use them with the standard ping utility.
To display network connection status within a cluster, use the network ping command.
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}]
- Node that Initiates Ping-
Use this parameter to send the ping from the node you specify.
[-destination-cluster <Cluster name>]
- Cluster to Ping-
Use this parameter to specify the peer cluster you want to ping.
[-destination-node <Peer Node Name>]
- Node to Ping in Destination Cluster-
Use this parameter to specify a specific node in the destination cluster to ping.
[-ip-address <IP Address>]
- Active IP Address-
Use this parameter to specify the active IP address you want to ping.
[-count <integer>]
- Ping Count-
Use this parameter to specify the number of requests to be sent to the destination.
[-status {unknown_node|internal_error|unreachable|session_reachable|interface_reachable}]
- Status of Ping Operation-
Use this parameter to display only ping results that have the status you specify.
[-timeout <integer>]
- Ping Timeout in Seconds-
Use this parameter to specify a timeout value in seconds for the ping operation.
[-packet-size <integer>]
- Size of Packet-
Use this parameter to specify the number of data bytes to be sent in the ping packet.
[-ttl <integer>]
- Time to Live/ Number of Hops-
Use this parameter to specify the maximum number of network hops a packet may make before it is considered a failure.
[-response-time <double>]
- Response Time (ms)-
Use this parameter to display only nodes that have the response time (in milliseconds) that you specify. This parameter is most useful when specified with a range of values, such as
>500
[-destination-node-uuid <UUID>]
- Node to Ping in Destination Cluster-
Use this parameter to specify a specific node's dblade UUID in the destination cluster to ping.
Examples
This example shows a ping of cluster1 and cluster2 from cluster2. All nodes are reachable.
cluster2::> cluster peer ping Node: node1 Destination Cluster: cluster2 Destination Node IP Address Count TTL RTT(ms) Status ---------------- ---------------- ----- ---- ------- ------------------------- node1 10.98.228.230 1 255 0.209 interface_reachable node2 10.98.228.234 1 255 0.42 interface_reachable Node: node2 Destination Cluster: cluster2 Destination Node IP Address Count TTL RTT(ms) Status ---------------- ---------------- ----- ---- ------- ------------------------- node1 10.98.228.230 1 255 0.358 interface_reachable node2 10.98.228.234 1 255 0.17 interface_reachable Node: node1 Destination Cluster: cluster1 Destination Node IP Address Count TTL RTT(ms) Status ---------------- ---------------- ----- ---- ------- ------------------------- node3 10.98.229.22 1 255 0.336 interface_reachable node4 10.98.229.29 1 255 0.354 interface_reachable Node: node2 Destination Cluster: cluster1 Destination Node IP Address Count TTL RTT(ms) Status ---------------- ---------------- ----- ---- ------- ------------------------- node3 10.98.229.22 1 255 0.354 interface_reachable node4 10.98.229.29 1 255 0.336 interface_reachable 6 entries were displayed.