statcluster

Displays status, network, workload, and configuration information about the cluster.

Read syntax diagramSkip visual syntax diagram
>>-statcluster--+--------+--+-------------+--+-------------+---->
                +- -?----+  '- -netconfig-'  '- -workstats-'
                +- -h----+
                '- -help-'

>--+----------+--+-------------+-------------------------------><
   '- -config-'  '- -advconfig-'

Parameters

–? | –h | –help
Displays a detailed description of this command, including syntax, parameter descriptions, and examples. If you specify a help option, all other command options are ignored.
–netconfig
Displays network configuration information for the cluster.
–workstats
Displays workload statistics related to the total number of transactions, updates, and buffers for the master metadata server.
–config
Displays cluster configuration settings.
–advconfig
Displays advanced cluster configuration settings.

Description

If you run this command from an engine hosting a subordinate metadata server, this command displays only the following information:
  • Name of the cluster.
  • IP address of the master metadata server.
  • Cluster port number of the master metadata server.
  • Heartbeat port number of the master metadata server.
  • Client-metadata server port number of the master metadata server.
  • Administrative port number of the master metadata server.
If you run this command from the engine hosting the master metadata server and you do not specify a parameter, this command displays the following default information:
  • Name of the cluster.
  • ID of the cluster.
  • Current state of the cluster. See Cluster states for a description for possible values.
  • Target state to which the cluster is switching.
  • Timestamp of the last current state change.
  • Timestamp of the last state change.
  • Number of metadata servers in the cluster.
  • Number of metadata servers that are actively participating in the cluster (in the offline, online, or quiescent state).
  • Committed software version - the currently installed version of the software.
  • Software version - the version of the software at which the cluster is currently operating.
  • Timestamp when the latest software was committed.
  • Software commit status (In Progress or Not In Progress).
  • Timestamp of the last installation.
  • Progress of an active metadata check, expressed in terms of 0 to 100 percent. A dash (-) indicates that there is not a metadata check in progress.
If you run this command from the engine hosting the master metadata server and you specify the –netconfig parameter, this command displays the following information in addition to the default information:
  • Name of the master metadata server.
  • IP address.
  • Cluster port number.
  • Heartbeat port number.
  • Client-metadata server port number.
  • Administrative port number.
If you run this command from the engine hosting the master metadata server and you specify the –workstats parameter, this command displays the following information in addition to the default information:
  • Number of system-update transactions involving the creation, modification, and deletion of system objects.
  • Number of system-object transactions, involving the creation, modification, and deletion of objects. The system objects include storage pools, filesets, volumes, policies, and engines.
  • Current number of buffers, which are used for system metadata activity, that contain data but are available for reuse (clean buffers).
  • Current number of buffers, which are used for system metadata activity, that contain data awaiting I/O to disk (dirty buffers).
  • Current number of buffers, which are used for system metadata activity, that are not in use (free buffers).
  • Current total number of buffers for system metadata activity.
If you run this command from the engine hosting the master metadata server and you specify the –config parameter, this command displays the following information in addition to the default information:
  • Pool-space reclamation interval, in minutes.
  • List of clients with root or administrative privileges.
  • Remote Supervisory Adapter (RSA) user ID.
  • RSA password. The password appears as asterisks, with one asterisk per character in the password.
  • Size, in 4-KB pages, of the master metadata server buffer.
  • Size, in pages, of the subordinate metadata server buffer.
  • Administrative process limit.
  • Metadata server workload process limit.
If you run this command from the engine hosting the master metadata server and you specify the –advconfig parameter, this command displays the following information in addition to the default information:
  • Maximum number of missed network heartbeats before a metadata server detects that it has lost communication with another metadata server in the cluster. When a metadata server detects this situation, it logs the occurrence in the cluster log and attempts to recover from the fault. The value can be from 1 to 100. The default value is 40.
  • Network heartbeat interval, in milliseconds for periodic pings among metadata servers in the cluster. The value can be from 200 to 10 000. The default value is 500.
  • Cluster timeout, in milliseconds.
  • Maximum number of retries to client. This is the maximum number of times a send can be attempted from the metadata server to the client before declaring the client's session lease to be expired. The value can be from 1 to 100. The default value is 5.
  • Client timeout, in milliseconds.
  • Client lease period, in seconds. This is the amount of time that a SAN File System internal lock is leased to a client when the metadata server grants a lock. The defined value is 20. This value may be adjusted only by service representatives.
  • Client-lease-period multiplier. This multiplier accommodates possible networking delays between the time a message gets sent from the client until it is received by the metadata server. The defined value is 2. This value may be adjusted only by service representatives.
  • Metadata server timeout, in milliseconds.
  • Maximum number of missed disk heartbeats before the metadata server is dropped from the cluster. The value can be from 1 to 100. The default value is 4.
  • Disk heartbeats interval, in milliseconds, for periodic pings among metadata servers in the cluster. The value can be from 200 to 10 000. The default value is 500.
  • Available languages.
  • Current languages.

Example

List network information for the cluster The following example displays the default and network information for the cluster:
sfscli> statcluster -netconfig
Name                          sanfs
ID                            2802
State                         ONLINE
Target State                  FULLY QUIESCENT
Last State Change             Sep 24, 2003 3:31:52 PM
Last Target State Change      Sep 24, 2003 2:40:20 PM
Servers                       4
Active Servers                3
Committed Software Version    1.1.4.2
Software Version              1.00
Last Software Commit          Jan 3, 2003 1:40:20 PM
Software Commit Status        In Progress
Installation Date             Jan 3, 2003 4:56:59 PM
MDC Scan Progress             32%

===============Network Configuration===============
Master Server                 ST1
IP                            128.0.0.1
Cluster Port                  1737
Heartbeat Port                1738
Client-Server Port            1700
Admin Port                    1800

Parent topic: Administrative commands

Related tasks
Viewing SAN File System component statistics
Listing cluster configuration
Viewing cluster details
Viewing cluster statistics
Viewing the cluster software version

Related reference
chadvclusterconfig
chclusterconfig
quiescecluster
resumecluster
startcluster
stopcluster
upgradecluster

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