tank lscluster

Displays the cluster definition from a system master volume when the metadata servers are not running.

Read syntax diagramSkip visual syntax diagram
>>-tank--lscluster---------------------------------------------><

Prerequisites

This task must be performed only by trained service technicians.

This command can be run in any cluster state.

Description

Note: This command is run from the shell prompt. It is not run inside of sfscli.

This command is used in disaster recovery situations, while troubleshooting the system, or to inspect the cluster definition.

This command is located in the /usr/tank/server/bin directory.

This command displays the following information:
  • Master state of the state machine in the cluster services component.
  • Subordinate state of the state machine in the cluster services component.
  • Transport protocol used for group services. The value defaults to UDP and cannot be changed. Note that the group services includes cluster services.
  • Transition state, which indicates whether a cluster transition is in progress at the time this command is issued.
  • Started state, which indicates whether the group services subsystem was started.
  • Joining state, which indicates whether the metadata server attempted to join the cluster.
  • Forming state, which indicates whether the metadata server is attempting to reform the cluster as the master metadata server.
  • Dynamic group ID, which identifies the subset of the cluster that is alive and well.
  • Time when the cluster was last reformed (committed).
  • Size of the current dynamic group. This is affected when the cluster or a metadata server starts, stops, crashes, or aborts.
  • Size of the entire static cluster. This is affected by the addserver and dropserver commands.
  • Cluster identifier, which is initialized at installation time.
  • Cluster name (sanfs).
  • Time of the installation.
  • Timeout value used by group services.
  • IP address of the network used by the cluster.
  • Netmask used by the cluster.
  • Current active version of the cluster boot record. Two copies are maintained. This value will be A or B.
  • Identifier of the engine hosting the metadata server where this command was issued.
  • A list of all engines in the cluster and attributes for each. The attributes include:
    • Engine identifier.
    • IP address.
    • Group services port number (gs)
    • SAN File System protocol port number (stp).
    • Heartbeat port number (hb).
    • Administrative port number (adm)
    • Administrative agent port number (agent)
    • Metadata server/engine name.
    • Last committed software version.

Example

Lists the static cluster definition The following example lists the static cluster definition before running the tank resetcluster command:
tank lscluster
Group information:
mast_state:          Microkernel
sub_state:           Invalid
protocol:            udp
in transition:       no
b_started:           0
b_joining:           0
b_forming:           0
group_id:            9
group commit time:   Jun 25, 2003 9:47:53 PM
group size:          4
cluster size:        4
cluster id:          1234
cluster name:        sanfs
install time:        Jun 25, 2003 4:23:45 PM
installation id:     835407414733488113
gs_timeout:          1000 (millisecs)
ip network:          0.0.0.0 (interfaces: )
netmask:             0.0.0.0
active set:          B
this node id:        0

      id   ip addr         gs      stp     hb      gdm     agent   
NODE: 0    192.168.10.88   11003   11001   11004   11002   5989    
NODE: 1    192.168.11.88   11003   11001   11004   11002   5989    

stnode name   SW Version
GR ST0        1.0.1
GR ST1        1.0.1

Parent topic: Service commands and utilities

Library | Support | Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.
IBM TotalStorage SAN File System v2.2