Index  |  Top  -  Up Data ONTAP 8.3

cluster peer show

Display peer cluster information

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

Description

The cluster peer show command displays information about the peering relationships between the current cluster and other clusters. Cluster peering enables independent clusters to coordinate and exchange data.

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.

[-cluster <text>] - Peer Cluster Name

Selects the peered clusters that match this parameter value.

[-cluster-uuid <UUID>] - Cluster UUID (privilege: advanced)

Selects the peered clusters that match this parameter value.

[-peer-addrs <Remote InetAddress>, ...] - Remote Intercluster Addresses

Selects the peered clusters that match this parameter value (remote-host name or IP address).

[-availability <availability>] - Availability of the Remote Cluster

Selects the peered clusters that match this parameter value. This parameter can have four different values: Note: If one or more nodes in the local cluster are offline or unreachable, then those nodes are not used to determine the availability status for the remote nodes.

[-rcluster <text>] - Remote Cluster Name

Selects the peered clusters that match this parameter value.

[-ip-addrs <Remote InetAddress>, ...] - Active IP Addresses

Selects the peered clusters that match this parameter value.

[-serialnumber <Cluster Serial Number>] - Cluster Serial Number

Selects the peered clusters that match this parameter value.

[-remote-cluster-nodes <text>, ...] - Remote Cluster Nodes

Selects the peered clusters that match this parameter value.

[-remote-cluster-health {true|false}] - Remote Cluster Health

Selects the peered clusters that match this parameter value.

[-unreachable-local-nodes <text>, ...] - Unreachable Local Nodes

Selects the peered clusters that match this parameter value.

[-timeout <integer>] - Operation Timeout (seconds) (privilege: advanced)

Selects the peered clusters that match this parameter value.

[-address-family {ipv4|ipv6}] - Address Family of Relationship

Selects the peered clusters that have a relationship established using this protocol.

[-auth-status-admin <cluster_peer_authnstate>] - Authentication Status Administrative

Selects the peered clusters that match this parameter value, which must be chosen from the following values.

[-auth-status-operational <cluster_peer_authnshow>] - Authentication Status Operational

Selects the peered clusters that match this parameter value, which must be one of the following values.

[-rpc-connect-timeout <integer>] - Timeout for RPC Connect (privilege: advanced)

Selects the peered clusters that match this parameter value.

[-update-ping-timeout <integer>] - Timeout for Update Pings (privilege: advanced)

Selects the peered clusters that match this parameter value.

[-last-updated <MM/DD/YYYY HH:MM:SS>] - Last Update Time

Selects the peered clusters that match this parameter value.

Examples

This example shows the output of the cluster peer show command when all nodes in the local cluster are able to contact all nodes in the remote peer cluster. Additionally, the peer relationship is authenticated and operating correctly.

cluster1::> cluster peer show
Peer Cluster Name         Cluster Serial Number Availability   Authentication
------------------------- --------------------- -------------- --------------
cluster2                  1-80-123456           Available      ok
Detailed information for this scenario is shown below.
cluster1::> cluster peer show -instance

                   Peer Cluster Name: cluster2
       Remote Intercluster Addresses: cluster2-d2, 10.98.234.246
  Availability of the Remote Cluster: Available
                 Remote Cluster Name: cluster2
                 Active IP Addresses: 10.98.234.246, 10.98.234.243
               Cluster Serial Number: 1-80-123456
                Remote Cluster Nodes: cluster2-01, cluster2-02
               Remote Cluster Health: true
             Unreachable Local Nodes: -
      Address Family of Relationship: ipv4
Authentication Status Administrative: use-authentication
   Authentication Status Operational: ok
                    Last Update Time: 02/05 21:05:41
    

This example shows the output of the cluster peer show command when some nodes in the local cluster are not able to contact some or all of the nodes in the remote peer cluster.

cluster1::> cluster peer show
Peer Cluster Name         Cluster Serial Number Availability   Authentication
------------------------- --------------------- -------------- --------------
cluster2                  1-80-123456           Available      ok
Detailed information for this scenario is shown below.
cluster1::> cluster peer show -instance

                   Peer Cluster Name: cluster2
       Remote Intercluster Addresses: cluster2-d2, 10.98.234.246
  Availability of the Remote Cluster: Partial
                 Remote Cluster Name: cluster2
                 Active IP Addresses: 10.98.234.246, 10.98.234.243
               Cluster Serial Number: 1-80-123456
                Remote Cluster Nodes: cluster2-01, cluster2-02
               Remote Cluster Health: false
             Unreachable Local Nodes: -
      Address Family of Relationship: ipv4
Authentication Status Administrative: use-authentication
   Authentication Status Operational: ok
                    Last Update Time: 02/05 21:05:41
    

This example shows the output of the cluster peer show command when some nodes in the local cluster cannot be contacted from the node where the command is executed, but all the other nodes including node on which command is executed are able to contact all nodes in the remote peer cluster.

cluster1::> cluster peer show
Peer Cluster Name         Cluster Serial Number Availability   Authentication
------------------------- --------------------- -------------- --------------
cluster2                  1-80-123456           Available      ok
Detailed information for this scenario is shown below.
cluster1::> cluster peer show -instance

                   Peer Cluster Name: cluster2
       Remote Intercluster Addresses: cluster2-d2, 10.98.234.246
  Availability of the Remote Cluster: Available
                 Remote Cluster Name: cluster2
                 Active IP Addresses: 10.98.234.246, 10.98.234.243
               Cluster Serial Number: 1-80-123456
                Remote Cluster Nodes: cluster2-01, cluster2-02
               Remote Cluster Health: true
             Unreachable Local Nodes: cluster1-01
      Address Family of Relationship: ipv4
Authentication Status Administrative: use-authentication
   Authentication Status Operational: ok
                    Last Update Time: 02/05 21:05:41   
    

This example shows the output of the cluster peer show command when some nodes in the local cluster cannot be contacted from the node where the command is executed, and the node on which command is executed is also not able to contact the remote peer cluster.

cluster1::> cluster peer show
Peer Cluster Name         Cluster Serial Number Availability   Authentication
------------------------- --------------------- -------------- --------------
cluster2                  1-80-123456           Unavailable    ok
Detailed information for this scenario is shown below.
cluster1::> cluster peer show -instance

                   Peer Cluster Name: cluster2
       Remote Intercluster Addresses: cluster2-d2, 10.98.234.246
  Availability of the Remote Cluster: Unavailable
                 Remote Cluster Name: cluster2
                 Active IP Addresses: 10.98.234.246, 10.98.234.243
               Cluster Serial Number: 1-80-123456
                Remote Cluster Nodes: cluster2-01, cluster2-02
               Remote Cluster Health: -
             Unreachable Local Nodes: cluster1-01
      Address Family of Relationship: ipv4
Authentication Status Administrative: use-authentication
   Authentication Status Operational: ok
                    Last Update Time: 02/05 21:05:41
    

This example shows the output of the cluster peer show command when all the nodes in the local cluster are not able to contact any nodes in the remote peer cluster.

cluster1::> cluster peer show
Peer Cluster Name         Cluster Serial Number Availability   Authentication
------------------------- --------------------- -------------- --------------
cluster2                  1-80-123456           Unavailable    ok
Detailed information for this scenario is shown below.
cluster1::> cluster peer show -instance

                   Peer Cluster Name: cluster2
       Remote Intercluster Addresses: cluster2-d2, 10.98.234.246
  Availability of the Remote Cluster: Unavailable
                 Remote Cluster Name: cluster2
                 Active IP Addresses: 10.98.234.246, 10.98.234.243
               Cluster Serial Number: 1-80-123456
                Remote Cluster Nodes: cluster2-01, cluster2-02
               Remote Cluster Health: -
             Unreachable Local Nodes: -
      Address Family of Relationship: ipv4
Authentication Status Administrative: use-authentication
   Authentication Status Operational: ok
                    Last Update Time: 02/05 21:05:41
    

This example shows the output of the cluster peer show command while the system is creating in-memory health data.

cluster1::> cluster peer show
Peer Cluster Name         Cluster Serial Number Availability   Authentication
------------------------- --------------------- -------------- --------------
cluster2                  1-80-123456           Pending        ok
Detailed information for this scenario is shown below.
cluster1::> cluster peer show -instance

                   Peer Cluster Name: cluster2
       Remote Intercluster Addresses: cluster2-d2, 10.98.234.246
  Availability of the Remote Cluster: Pending
                 Remote Cluster Name: cluster2
                 Active IP Addresses: 10.98.234.246, 10.98.234.243
               Cluster Serial Number: 1-80-123456
                Remote Cluster Nodes: -
               Remote Cluster Health: -
             Unreachable Local Nodes: -
      Address Family of Relationship: ipv4
Authentication Status Administrative: use-authentication
   Authentication Status Operational: ok
                    Last Update Time: 02/05 21:05:41
    


Index  |  Top  -  Up Data ONTAP 8.3

Copyright © 1994-2015 NetApp, Inc. Legal Information