Skip to main content

cluster ring show

Contributors
Suggest changes
PDFs

Display cluster node member's replication rings

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

Description

The cluster ring show command displays a cluster's ring-replication status. Support personnel might ask you to run this command to assist with troubleshooting.

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 ] (privilege: advanced) }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-node {<nodename>|local}] - Node (privilege: advanced)

Selects the rings that match this parameter value.

[-unitname {mgmt|vldb|vifmgr|bcomd|crs|availd}] - Unit Name (privilege: advanced)

Selects the rings that match this parameter value. Possible values are:

  • mgmt - The management application

  • vldb - The volume location database

  • vifmgr - The virtual-interface manager

  • bcomd - The SAN management daemon

  • crs - The configuration replication service

[-online {master|secondary|offline}] - Status (privilege: advanced)

Selects the rings that match this parameter value.

[-epoch <integer>] - Epoch (privilege: advanced)

Selects the rings that match this parameter value.

[-master <nodename>] - Master Node (privilege: advanced)

Selects the rings that match this parameter value.

[-local <nodename>] - Local Node (privilege: advanced)

Selects the rings that match this parameter value.

[-db-epoch <integer>] - DB Epoch (privilege: advanced)

Selects the rings that match this parameter value.

[-db-trnxs <integer>] - DB Transaction (privilege: advanced)

Selects the rings that match this parameter value.

[-num-online <integer>] - Number Online (privilege: advanced)

Selects the rings that match this parameter value.

[-rdb-uuid <UUID>] - RDB UUID (privilege: advanced)

Selects the rings that match this parameter value.

Examples

The following example displays information about all replication rings in a two-node cluster:

cluster1::*> cluster ring show
Node      UnitName Epoch    DB Epoch DB Trnxs Master    Online
--------- -------- -------- -------- -------- --------- ---------
node0     mgmt     1        1        1068     node0     master
node0     vldb     1        1        98       node0     master
node0     vifmgr   1        1        350      node0     master
node0     bcomd    1        1        56       node0     master
node0     crs      1        1        88       node0     master
node1     mgmt     1        1        1068     node0     secondary
node1     vldb     1        1        98       node0     secondary
node1     vifmgr   1        1        350      node0     secondary
node1     bcomd    1        1        56       node0     secondary
node1     crs      1        1        88       node0     secondary
10 entries were displayed.