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`, s`0` 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