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

>>-tank--lscluster---------------------------------------------><
Prerequisites
This
task must be performed only by trained service technicians.
The cluster
must be offline.
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