Skip to main content

cluster peer connection show

Contributors
Suggest changes

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>d][<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.