lsenclosurecanister

Use the lsenclosurecanister command to view a detailed status for each canister in an enclosure.

Syntax

lsenclosurecanister [ -filtervalueattribute_value ] [ -filtervalue? ] [ -delimdelimiter ] [ [ -canistercanister_id ] enclosure_id ]

Parameters

-filtervalueattribute=value
(Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are returned. If a capacity is specified, the units must also be included.
Note: Some filters allow the use of a wildcard when you enter the command. The following rules apply to the use of wildcards when using the CLI:
  • The wildcard character is an asterisk (*).
  • The command can contain a maximum of one wildcard.
  • When using a wildcard, you must enclose the filter entry within double quotation marks (""), as follows:
    lsenclosurecanister -filtervalue "node_name=node*"
-filtervalue?
(Optional) Displays a list of valid filter attributes for the -filtervalueattribute=value parameter:
  • enclosure_id
  • canister_id
  • node_id
  • node_name
  • status
  • type
-delimdelimiter
(Optional) By default in a concise view, all columns of data are space-separated. The width of each column is set to the maximum possible width of each item of data. In a detailed view, each item of data has its own row, and if the headers are displayed, the data is separated from the header by a space. The -delim parameter overrides this behavior. Valid input for the -delim parameter is a one-byte character. If you enter -delim : on the command line, the colon character (:) separates all items of data in a concise view; for example, the spacing of columns does not occur. In a detailed view, the data is separated from its header by the specified delimiter.
-canistercanister_id
Valid only when the enclosure_id is specified. Provides a detailed view of the canister for the specified enclosure.
enclosure_id
Lists the canisters for the specified enclosure.

Description

This command enables you to view a detailed status for each canister in an enclosure. Table 1 shows the possible outputs:
Table 1. lsenclosurecanister output
Attribute Description
enclosure_id The identity of the enclosure that contains the canister.
canister_id Identifies which of the canisters in the enclosure this is.
status The status of the canister:
  • online: the canister is present and working normally.
  • degraded: the canister is present but not working normally
  • offline: the canister could not be detected.
type The type of canister:
  • node
  • expansion
node_id The node that corresponds to this canister; blank if the canister is not a node, or if the node is offline or not part of the clustered system.
node_name The node that corresponds to this canister; blank if the canister is not a node, or if the node is offline or not part of the clustered system.
temperature The temperature of the canister in degrees centigrade.
identify_LED The status of the identify_LED. The values are on, off, or slow-flashing.
fault_LED The status of the fault_LED. The values are on, off, or slow-flashing.
SES_status The SCSI status of the connection between the device and the canister. The values are online and offline.
FRU_part_number The field-replaceable unit (FRU) part number of the canister.
FRU_identity The 11S number that combines the manufacturing part number and the serial number.
WWNN The Fibre Channel worldwide node name (WWNN) of the canister (node canisters only).
temperature (0 to 245) The temperature of the canister (in degrees Celsius). If the temperature goes below 0, s0 is displayed.
Remember: The temperature value is not an ambient temperature value. It is an internal temperature sensor value.
fault_LED The state of the combined fault and identify light-emitting diodes (LEDs):
  • off: no fault
  • slow_flashing: identify mode
    Note: When the LED is in identify mode, it conceals whether there is a fault present, because it always flashes. When you remove it from identity mode, the LED will become on or off.
  • on: fault
error_sequence_number Indicates the error log number of the highest priority error for this object. This is typically blank; however, if there is a problem (for example, the status is degraded), then it contains the sequence number of that error.
SAS_port_1_status Indicates if there is damage to the cable between SAS ports:
  • online
  • offline
  • excluded (meaning logged in but cannot communicate with the canister)
  • degraded (meaning the SAS cable is not fully functional)
  • Blank (which can appear on control canisters; see lsportsas)
SAS_port_2_status Indicates if there is damage to the cable between SAS ports:
  • online
  • offline
  • excluded (meaning logged in but cannot communicate with the canister)
  • degraded (meaning the SAS cable is not fully functional)
  • Blank (which can appear on control canisters; see lsportsas)
firmware_level The firmware level of the Small Computer System Interface (SCSI) Enclosure Services (SES) code, or canister firmware version, running on the canister.
firmware_level_2 The version of the first other microcode image (canister bootloader version) installed on the canister.
firmware_level_3 The version of the second other microcode (canister complex programmable logic device, or CPLD, version) image installed on the canister.
firmware_level_4 The version of the third other microcode image (canister flash configuration version) installed on the canister.
firmware_level_5 The version of the canister metadata (canister VPD version) installed on the canister.

A concise invocation example

lsenclosurecanister -delim :

The resulting output:

enclosure_id:canister_id:status:type:node_id:node_name
1:1:degraded:expansion:1:node1

A detailed invocation example

lsenclosurecanister -canister 1 1

The detailed resulting output:

enclosure_id 1
canister_id 1
status online
type node
node_id 1
node_name node1
FRU_part_number AAAAAAA
FRU_identity 11S1234567Y12345678901
WWNN 5005076801005F94
firmware_level XXXXXXXXXX
temperature 23
fault_LED flashing
SES_status online
error_sequence_number 
SAS_port_1_status online
SAS_port_2_status online
firmware_level_2 0501
firmware_level_3 14
firmware_level_4 B69F66FF
firmware_level_5 5C2A6A44
Parent topic: Enclosure commands