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.

Prerequisites

You must be logged in to the operating system on the engine hosting the master metadata server to run this command.

Description

If 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.
  • Software version.
  • Timestamp when the latest software was committed.
  • Software commit status (In Progress or Not In Progress).
  • Timestamp of the last installation.
If 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 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 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 specify the –advconfig parameter, this command displays the following information in addition to the default information:
  • Maximum number of missed network heartbeats.
  • Network heartbeat interval, in milliseconds.
  • Cluster timeout, in milliseconds.
  • Maximum number of retries to client.
  • Client timeout, in milliseconds.
  • Client lease period, in seconds.
  • Client-lease-period multiplier.
  • Metadata server timeout, in milliseconds.
  • Maximum number of missed disk heartbeats.
  • Disk heartbeats interval, in milliseconds.
  • 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

===============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 reference
chadvclusterconfig
chclusterconfig
quiescecluster
resumecluster
startcluster
stopcluster
upgradecluster

Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.