statserver

Displays status, configuration, and workload information for a specific metadata server in the cluster, if the command is issued from the master metadata server. Lists status, configuration, and workload information for the local metadata server, if the command is issued from a subordinate metadata server.

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

>--+-------------+--server_name--------------------------------><
   '- -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 specified metadata server.
–workstats
Displays statistical information for the local metadata server.
–advconfig
Displays advanced settings, which require a reboot when changed, for the specified metadata server.
server_name
Specifies the metadata server to display. If you issue this command from a subordinate metadata server, this must be the name of the local metadata server.

Description

If you run this command from an engine hosting a subordinate metadata server, you can display information about only the local metadata server. If you run this command from the engine hosting the master metadata server, you can display information about any metadata server.

The server_name parameter must be specified. If you do not specify the –netconfig, –workstats, or –advconfig parameter, the following statistics are displayed:
  • Metadata server name.
  • Role of the metadata server (Master or Subordinate).
  • Pending software version.
If you specify the –netconfig parameter, the following statistics are displayed in addition to the default statistics:
  • Master metadata server name.
  • Metadata server-to-metadata server transport protocol (UDP)
  • Client-to-metadata server transport protocol (TCP)
  • IP address.
  • Cluster port number.
  • Heartbeat port number.
  • Client-server port number.
  • Administrative port number.
If you specify the –workstats parameter, the following statistics are displayed in addition to the default statistics:
  • Number of file-system-update transactions that involve creating, modifying, and deleting system objects.
  • Number of file-system transactions that involve reading, creating, modifying, and deleting objects. The system objects include storage pools, filesets, volumes, policies, and engines.
  • Number of buffers that contain data awaiting I/O to disk (dirty buffers).
  • Number of buffers that contain data but are available for reuse (clean buffers).
  • Number of buffers that are not in use (free buffers).
  • Total number of available buffers.
  • Number of session locks held by the engine hosting the metadata server. Clients acquire session locks to perform file management operations.
  • Number of data locks held by the engine hosting the metadata server. Clients hold data locks to cache data pages and attributes of files and to cache read-only attributes and contents of directories and links.
  • Number of byte-range locks held by the engine hosting the metadata server. Clients use byte-range locks to implement POSIX, SYSV and Berkeley lock system calls.
If you specify the –advconfig parameter, the following statistics are displayed in addition to the default statistics:
  • File-space reclamation process limit.
  • Synchronous commit mode:
    sync
    Metadata changes are written to disk immediately.
    async
    Schedules and buffers metadata changes instead of performing an immediate write.
  • List of current profile parameters being used.
  • List of current trace parameters being used as output.
  • Time interval, in seconds, at which the user and system-time statistics are gathered. A value of 0 indicates that this property is disabled.

Example

List information about the metadata server The following example displays all information about the server:
sfscli> statserver -netconfig ST1

Server                                  ST1
Server Role                             Subordinate
Most Current Software Version           V1.003
===================Network Configuration===================
Master Server                           ST4
Server-to-Server Transport Protocol     UDP
Client-to-Server Transport Protocol     TCP
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 metadata server statistics

Related reference
addserver
chserverconfig
dropserver
lsautorestart
lsserver
setautorestart
setport
startautorestart
startserver
stopautorestart
stopserver

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