lsenclosurecanister

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

Syntax

 lsenclosurecanister    [  -nohdr  ]   [  -filtervalue  attribute_value  ]   [  -filtervalue?  ]   [  -delim  delimiter  ]   [ [  -canister  canister_id ] enclosure_id ]

Parameters

-nohdr
(Optional) By default, headings are displayed for each column of data in a concise style view, and for each item of data in a detailed style view. The -nohdr parameter suppresses the display of these headings.
Note: If there is no data to be displayed, headings are not displayed.
-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 you use the CLI:
  • The wildcard character is an asterisk (*).
  • The command can contain a maximum of one wildcard.
  • When you use 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
 -delim delimiter
(Optional) By default in a concise view, all columns of data are space-separated. The width of each column is set to the maximum 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 1-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.
 -canister canister_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 displays a detailed status for each canister in an enclosure. lsenclosurecanister output shows the possible outputs:
Table 1. lsenclosurecanister output
Attribute Description
enclosure_id Indicates the enclosure that contains the canister.
canister_id Indicates which of the canisters in the enclosure it is.
status Indicates the status of the canister. The values are:
  • online indicates that the canister is present and working normally.
  • degraded indicates that the canister is present but not working normally
  • offline indicates that the canister could not be detected.
type Indicates the type of canister. The values are node or expansion.
node_id Indicates 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 Indicates 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 Indicates the temperature of the canister in degrees centigrade.
identify_LED Indicates the status of the identify_LED. The values are on, off, or slow-flashing.
fault_LED Indicates the status of the fault_LED. The values are on, off, or slow-flashing.
SES_status Indicates the Small Computer System Interface (SCSI) status of the connection between the device and the canister. The values are online and offline.
FRU_part_number Indicates the field-replaceable unit (FRU) part number of the canister.
FRU_identity Indicates the 11S number that combines the manufacturing part number and the serial number.
WWNN Indicates the Fibre Channel (FC) worldwide node name (WWNN) of the canister (node canisters only).
temperature Indicates thehe temperature of the canister (in degrees Celsius). If the temperature goes below 0, s0 is displayed. The value must be in the range 0 - 245.
Remember: The temperature value is not an ambient temperature value. It is an internal temperature sensor value.
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 whether 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 whether 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 Indicates 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 Indicates the version of the first other microcode image (canister bootloader version) installed on the canister.
firmware_level_3 Indicates the version of the second other microcode (canister PSoC version) image that is installed on the canister.
firmware_level_4 Indicates the version of the third other microcode image (canister CPLD 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