lsautorestart

Displays a list of metadata servers and the automatic-restart settings for each.

Read syntax diagramSkip visual syntax diagram
>>-lsautorestart--+----------+---------------------------------->
                  +- –?----+
                  +- –h----+
                  '- –help-'

>--+-------------------------------+--+----------------+-------->
   |          .-default----------. |  |        .-off-. |
   '- –fmt--+-delim--character-+-'  '- –p--+-on--+-'
              '-xml--------------'

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

>--+----------------+--+-------+--+-----------------+----------><
   |        .-off-. |  +- –l-+  | .-------------. |
   '- –v--+-on--+-'  '- –s-'  | 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  Service State  Last Probe State   Last Probe                Probes
=====================================================================
ST1   Running        Live Server        Feb 11, 2003 9:35:47 AM   218690

Highest Retries
===============
              2
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 marks (') or double quotation marks ("). A blank space is not a valid character. For example:
ST1,Running,Live Server,Feb 11, 2003 9:35:47 AM,218690,2
xml
Specify this value to display output using XML format, for example:
<IRETURNVALUE>
<INSTANCE CLASSNAME="STC_TankWatchdog">
<PROPERTY NAME="ServiceName" TYPE="string"><VALUE TYPE="string">ST1
</VALUE></PROPERTY>
<PROPERTY NAME="State" TYPE="uint32"><VALUE TYPE="uint32">1</VALUE>
</PROPERTY>
<PROPERTY NAME="ProbeState" TYPE="uint32"><VALUE TYPE="uint32">2</VALUE>
</PROPERTY>
<PROPERTY NAME="LastProbeTimeStamp" TYPE="datetime"><VALUE 
TYPE="datetime">20030211093547&#46;000009&#45;420</VALUE></PROPERTY>
<PROPERTY NAME="TotalProbes" TYPE="uint64"><VALUE TYPE="uint64">218690
</VALUE></PROPERTY>
<PROPERTY NAME="RetriesHWM" TYPE="uint32"><VALUE TYPE="uint32">2</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 default information about the metadata servers.
server_name
Specifies the names of one or more metadata servers to display. If not specified, settings for all metadata servers are displayed.
Specifies that you want to read the names of one or more metadata servers to display from stdin (for example, – << /work/server_list.txt).

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.

If you do not specify a listing parameter, this command displays the following default information for each metadata server:
  • Name of the metadata server in the cluster.
  • State of the metadata server restart service. Possible states are:
    Off
    The metadata server restart service is not running.
    Failed
    The metadata server restart service is running but has failed to restart the metadata server after several attempts.
    Running
    The metadata server restart service is running and ready to restart the metadata server if it fails.
    Standby
    The metadata server restart service is running, but the metadata server has been manually shut down. You must manually restart metadata server to return the metadata server restart service to the running state.
    Unknown
    The metadata server restart service is in an unknown state because the metadata server could not be reached.
  • Probed metadata server status. Possible status values are:
    Absent Server
    The metadata server restart service could not find the metadata server and attempts to restart the metadata server.
    Live Server
    The metadata server restart service found the metadata server and it is up and running. There is no need to restart the metadata server.
    Not Probed
    The metadata server restart service has not started probing the metadata server because it is either in the off or standby state.
    Probing
    The metadata server restart service has started probing the metadata servers for status.
    Unknown
    The metadata server restart service cannot determine whether the metadata server is live or absent.

    It is possible for the probe state to be unknown when the metadata server is live.

    Example: If the metadata server fails, the metadata server restart service determines that the metadata server is absent, and restarts it. If the metadata server is slow to start, on the next probe cycle, the metadata server is neither live nor absent. When it is probed again, the metadata server is live.

    Example: If the local disk is full, and the metadata server restart service tries to restart the metadata server but cannot write to its log file. The metadata server crashes, and the metadata server restart service tries to restart it again. On the next probe cycle, the state of the metadata server is absent or unknown.

  • Timestamp when the metadata server was last probed for status.
  • Total number of probes that the metadata server restart service performed.
  • Highest number of times that the metadata server restart service has attempted to restart the metadata server.
If you specify the –l listing parameter, this command displays the following information in addition to the default information for each metadata server:
  • Timestamp when the automatic-restart service started on the metadata server.
  • Amount of time, in seconds, between each probe.
  • Current number of times that the automatic-restart service has attempted to restart the metadata server.
  • Total number of times that the automatic-restart service has attempted to restart the metadata server.
  • Maximum number of times that the automatic-restart service attempts to restart the metadata server.
  • Lowest number of times that the automatic-restart service has attempted to restart the metadata server.
  • Total number of times that a probe for a live metadata server has taken longer than the test timeout interval.
  • Maximum amount of time, in milliseconds, to wait for a metadata server to respond before declaring it down.
  • Amount of time, in seconds, used the last time the metadata server was probed to see if it is running.
  • Highest amount of time, in milliseconds, taken to determine if the metadata server is running.
  • Lowest amount of time, in milliseconds, taken to determine if the metadata server is running.
  • Number of times the watchdog probed the metadata server to determine if it is absent.
  • Amount of time, in milliseconds, used the last time the metadata server was probed to determine if it is absent.
  • Highest amount of time, in milliseconds, taken to determine if the metadata server is absent.
  • Lowest amount of time, in milliseconds, taken to determine if the metadata server is absent.
  • Amount of time to wait for the metadata server to restart before the metadata server is declared dead. If the metadata server restart timeout or the retry limit is exceeded, the automatic restart service is disabled.

Example

Displays the automatic-restart settings The following example displays the automatic-restart settings and additional information for all metadata servers in the cluster:
sfscli> lsautorestart ST1

Name  Service State  Last Probe State  Last Probe             Probes
=====================================================================
ST1   Running        Live Server       Feb 11, 2003 9:35:47 AM     5

Highest Retries
===============
              2

Parent topic: Administrative commands

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

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