lsserver

Displays a list of all metadata servers in the cluster and their attributes if issued from the master metadata server, or displays attributes about the local metadata server if issued from a subordinate metadata server.

Read syntax diagramSkip visual syntax diagram
>>-lsserver--+--------+--+-----------------------------+-------->
             +- -?----+  |        .-default----------. |
             +- -h----+  '- -fmt--+-delim--character-+-'
             '- -help-'           '-xml--------------'

>--+--------------+--+----------------+--+-------------+-------->
   |      .-off-. |  |        .-on--. |  '- -r--number-'
   '- -p--+-on--+-'  '- -hdr--+-off-+-'

>--+--------------+--+-----+------------------------------------>
   |      .-off-. |  +- -l-+
   '- -v--+-on--+-'  '- -s-'

>--+-----------------------------------------------+------------>
   '- -state--+-failedinit---+-- -role--+-master-+-'
              +-fullq--------+          '-sub----'
              +-initializing-+
              +-joining------+
              +-notadded-----+
              +-notrunning---+
              +-offline------+
              +-online-------+
              +-partq--------+
              '-unknown------'

>--+-----------------+-----------------------------------------><
   | .-------------. |
   | V             | |
   +---server_name-+-+
   '- - -------------'

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.
–fmt
Specifies the format of the output. You can specify one of the following values:
default
Specify this value to display output in a tabular format using spaces as the delimiter between the columns. This is the default value. For example:
Name   State    Relationship   Filesets   Last Boot
====================================================================
ST1    ONLINE   Subordinate    3            Dec. 31, 2002 5:00:34 PM
delim character
Specify this value to display output in a tabular format using the specified character to separate the columns. If you use a shell metacharacter (for example, * or \t) as the delimiting character, enclose the character in single quotation mark (') or double quotation mark ("). A blank space is not a valid character. For example, lsserver -fmt delim ';' would display output in the following format:
ST1;ONLINE;Subordinate;3;Dec. 31, 2002 5:00:34 PM
xml
Specify this value to display output using XML format, for example:
<IRETURNVALUE>
<INSTANCE CLASSNAME="STC_TankService">
<PROPERTY NAME="CurrentState" TYPE="uint32"><VALUE TYPE="uint32">1
</VALUE></PROPERTY>
<PROPERTY NAME="LastBootUpTime" TYPE="datetime"><VALUE TYPE="datetime">
20031231050034&#46;000000&#45;420</VALUE></PROPERTY>
<PROPERTY NAME="SystemName" TYPE="string"><VALUE TYPE="string">
DEFAULT_POOL</VALUE>ST1</PROPERTY>
<PROPERTY NAME="IsMaster" TYPE="boolean"><VALUE TYPE="boolean">false
</VALUE></PROPERTY>
<PROPERTY NAME="NumberOfFilesets" TYPE="uint32"><VALUE TYPE="uint32">3
</VALUE></PROPERTY>
</INSTANCE>
</IRETURNVALUE>
–p
Specifies whether to display one page of text at a time or all text at once.
off
Displays all text at one time. This is the default value when the sfscli command is run in single-shot mode.
on
Displays one page of text at time. Pressing any key displays the next page. This is the default value when the sfscli command is run in interactive mode.
–hdr
Specifies whether to display the table header.
on
Displays the table header. This is the default value.
off
Does not display the table header.
–r number
Specifies the number of rows per page to display when the –p parameter is on. The default is 24 rows. You can specify a value from 1 to 100.
–v
Specifies whether to enable verbose mode.
off
Disables verbose mode. This is the default value.
on
Enables verbose mode.
–l
Displays additional information about the metadata servers.
–s
Displays only the name of each metadata server. This is the default.
–state
Lists information for only those metadata servers that match the specified state:
failedinit
Displays information for metadata servers with the state Failed Initialization. A fatal error occurred during initialization and the metadata server is suspended. The metadata server remains suspended so you can correct the problem that occurred during initialization.
fullq
Displays information for metadata servers with the state Fully Quiescent. The metadata server suspends all current client sessions and prevents new client sessions from being started. All file-data and metadata activity is suspended. The metadata server flushes all dirty cached pages and commits them to disk. This state is used to produce self-consistent LUN-based backups from a known point-in-time.
initializing
Displays information for metadata servers with the state Initializing. The metadata server is running, but has not yet opened its communication ports.
joining
Displays information for metadata servers with the state Joining. The metadata server is joining the cluster.
notadded
Displays information for metadata servers with the state Not Added. The metadata server is not part of the cluster. Because the master metadata server does not know about metadata servers that are not part of the cluster, this state is only available by logging in to that metadata server.
notrunning
Displays information for metadata servers with the state NOT RUNNING. The metadata server is part of the cluster but is not running and cannot perform any functions.
offline
Displays information for metadata servers with the state OFFLINE. The metadata server ends all current client sessions and prevents new client sessions from being started. This state allows all metadata server I/O to continue. This state restricts the metadata server from client access.
online
Displays information for metadata servers with the state ONLINE. The metadata server has fully initialized all of its subsystems, is a member of the cluster, and is serving client requests.
partq
Displays information for metadata servers with the state PARTLY QUIESCENT. The metadata server prevents new client sessions from being started but allows file I/O to continue for existing clients. The metadata server suspends clients making file metadata updates (such as changing permissions or creating new files) and system metadata activity. The metadata server also flushes any dirty metadata pages in the client and metadata server caches. This state allows you to produce dirty LUN-based backups without requiring clients and applications to stop. You can back up applications using direct I/O (such as database servers) (no caching) in this state.
unknown
Displays information for metadata servers with the state UNKNOWN.
–role master | sub
Displays only information for those metadata servers that match the specified role:
master
Displays information for the master metadata server.
sub
Displays information for subordinate metadata servers.
server_name
Specifies the name of one or more names of metadata servers to display. If this parameter is not specified and if this command is issued from the master metadata server, this command lists information about all metadata servers in the cluster.
Specifies that in single-shot command mode you want this command to receive from the input stream (stdin) the names of one or more of the metadata servers to display.

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.

When you specify multiple parameters in this command, these behaviors apply:
  • Flags work as AND coordinators.
  • Objects work as OR coordinators.
  • When flags and objects are combined, the they are listed in this manner:

    WHERE flag_1 AND flag_2 AND ... AND flag_n AND (object_1 OR object_2 OR ... OR object_m)

  • When flags or objects are not required and not specified, this command searches all possible values unless a default overrides this rule.
For example, if you specify –state, –role, and two metadata server names, the search would be performed in the following manner:

WHERE state AND role AND (server_name_1 OR server_name_2)

If you do not specify a listing parameter, this command displays the following default information for each metadata server:
  • Name of the metadata server.
  • State of the metadata server.
  • Role of the metadata server (master or subordinate).
  • Number of filesets that are hosted by the metadata server.
  • Timestamp of the last boot.
If you specify the –l listing parameter, this command displays the following information in addition to the default information for each metadata server:
  • Timestamp of the last status change.
  • State to which the metadata server changed.
  • Timestamp of the last target state change.
  • Current time.
  • Most current software version - the version of the software that is currently installed.

Example

Display online metadata servers The following example lists the default attributes of all the metadata servers with the state ONLINE:
sfscli> lsserver -state online

Name   State    Server Role    Filesets   Last Boot
====================================================================
ST1    ONLINE   Subordinate    3            Dec. 31, 2002 5:00:34 PM
ST2    ONLINE   Master         2            Dec. 31, 2002 5:00:24 PM

Parent topic: Administrative commands

Related tasks
Restoring SAN File System metadata
Listing metadata servers
Viewing metadata server details

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

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