lsengine

Displays a list of storage engines and their attributes.

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

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

>--+--------------+--+-----+--+-----------------+--------------><
   |      .-off-. |  +- -l-+  | .-------------. |
   '- -v--+-on--+-'  '- -s-'  | V             | |
                              +---engine_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   Engine IP      Boot State   Temp      Fans     Voltage
=============================================================
ST0    129.42.16.99   In POST      Warning   Normal   Normal
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, lsengine -fmt delim ',' st0 would display output in the following format:
ST0,129.42.16.99,In POST,Warning,Normal,Normal
xml
Specify this value to display output using XML format, for example:
<IRETURNVALUE>
<INSTANCE CLASSNAME="STC_ComputerSystem">
<PROPERTY NAME="CurrentState" TYPE="uint32"><VALUE TYPE="uint32">1
</VALUE></PROPERTY>
<PROPERTY NAME="Name" TYPE="string"><VALUE TYPE="string">ST0</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 the default information for each engine. This is the default.
–s
Displays only the IP address and name of each engine.
engine_name
Specifies the names of one or more engines to display. If not specified, this command displays information for all engines.
Specifies that in single-shot command mode you want this command to receive from the input stream (stdin) the names of one or more engines to display.

Description

When you issue this command on a three-node cluster, command processing can take up to three minutes to complete.

If you specify the –s listing parameter, this command displays the IP address and name of each engine.

If you do not specify a listing parameter or if you specify the –l listing parameter, this command displays the following information for each engine:
  • Engine IP address.
  • Engine name.
  • Boot state. Possible values are:
    Before POST
    The engine is powered on but has not started the power-on self test (POST).
    Booted Flash
    The engine has read the System BIOS but has not started loading the operating system.
    Booting OS
    The engine has stated but not completed loading the operating system.
    CPUs Held in Reset
    The engine has been reset after a hardware fault.
    In POST
    The engine is running the POST.
    In OS
    The engine is running in the normal state.
    Stopped in POST (error detected)
    The engine is powered on but has not completed the POST due to an error.
    Unknown / Power Off
    The boot state is unknown. The engine could be powered off.
  • Temperature state. Possible values are:
    The temperature thresholds are not set.
    Normal
    The temperatures of all components in all engines are below the Warning threshold.
    Warning
    The temperature of one or more engine components are above the Warning threshold.
    Error
    The temperature of one or more engine components is higher than the Soft Shutdown threshold.
    Unknown
    The RSA card could not be accessed.
  • Fan state. Possible values are:
    Normal
    All fans are operating above 15% of its fan-speed capacity.
    Warning
    One or more fans are operating below 15% of its fan-speed capacity.
    Error
    The RSA card could not be accessed.
  • Voltage state. Possible values are:
    The voltage thresholds are not set.
    Normal
    The voltages of all components in all engines are above the Warning Low Voltage threshold and below the Warning High Voltage threshold.
    Warning
    The voltage of one or more engine components is below the Warning Low Voltage threshold or above the Warning High Voltage threshold.
    Error
    The RSA card could not be accessed.

Example

List engines The following example displays information about two engines, ST0 and ST1:
sfscli> lsengine ST0 ST1

Name   Engine IP      Boot State   Temp      Fans     Voltage
=============================================================
ST0    129.42.16.99   In POST      Warning   Normal   Normal
ST1    129.42.16.98   In OS        Normal    Normal   Normal

Parent topic: Administrative commands

Related tasks
Listing engines

Related reference
restartengine
startengine
statengine
stopengine

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