Skip to main content

cluster peer connection show

Show current peering connections for a cluster

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

Description​

The cluster peer connection show command displays information about the current TCP connections and how they are supporting the set of peering relationships.

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-name <text>] - Remote Cluster
Selects the connections associated with the named peered cluster.
[-node {<nodename>|local}] - Node
Selects the connections hosted by the given node.
[-connection-type {mgmt-client|mgmt-server|data}] - Cluster Peering Connection Type
Selects the connections of the named type. This parameter can have one of three different values:
  • Mgmt-client - Management-plane client connections, created so that this node may make management-plane requests of other nodes.
  • Mgmt-server - Management-plane server connections, over which this node services requests made by other nodes' mgmt-client connections.
  • Data - Connections made between data-planes of different nodes.
[-index <integer>] - Index of Connection
Selects the connections with the given index value.
[-cluster-uuid <UUID>] - Cluster UUID (privilege: advanced)
Selects the connections to the cluster with the given cluster UUID.
[-auth-status-admin {no-authentication|revoked|use-authentication}] - Authentication Status Administrative
Selects connections to the peered clusters whose intended authentication matches this parameter value.
[-auth-status-operational {ok|absent|pending|expired|revoked|declined|refused|ok-and-offer|absent-but-offer|revoked-but-offer|key-mismatch|intent-mismatch|incapable}] - Authentication Status Operational
Selects connections to the peered clusters whose authentication state matches this parameter value.
[-authenticated {true|false}] - Authenticated
Selects connections that have been authenticated, or not, according to this parameter value.
[-port <integer>] - Network Port
Selects the connections whose port matches this parameter value.
[-idle <[<integer>h][<integer>m][<integer>s]>] - Idle Time
Selects the connections whose idle times match this parameter value.
[-address <IP Address>] - Remote Network Address
Selects the connections that have this parameter value as the remote network address.
[-psk-algorithm {akep2|jpake}] - PSK Algorithm
Selects the connections for clusters whose PSKs were generated by the named algorithm. This parameter can have one of two different values:
  • akep2 - The original algorithm, PBKDF2 followed by AKEP2.
  • jpake - Newer algorithm: J-PAKE.

Examples​

This example shows the output of the cluster peer connection show command. 

cluster1::> cluster peer connection show
Cluster Node               Connection Type  Auth  Encrypt Idle  Remote Address
------- -----------------  ---------------  ----- ------- ----  --------------
cluster2                      Authentication: ok
        node1
                                      data  true  true   6s    10.10.10.100
                                      data  true  true   7s    10.10.10.100
                                      data  true  true   20s   10.10.10.100
                                      data  true  true   11s   10.10.10.100
                                      data  true  true   7s    10.10.10.100
                                      data  true  true   7s    10.10.10.100
                                      data  true  true   11s   10.10.10.200
                                      data  true  true   11s   10.10.10.200
                                      data  true  true   48s   10.10.10.200
                                      data  true  true   48s   10.10.10.200
                                      data  true  true   37s   10.10.10.200
                                      data  true  true   37s   10.10.10.200
12 entries were displayed.