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 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

-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 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.

-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 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`, s`0` is displayed. 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 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 PSoC version) image installed on the canister.
firmware_level_4	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