lssasfabric

Use the lssasfabric command to see which canisters are visible to a node, and the order of these canisters.

Syntax

lssasfabric [ -filtervalue attribute_value ] [ -nohdr ] [ -delim delimiter ] [ -filtervalue? ]

Parameters

-filtervalueattribute=value

(Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are displayed.

Note: Some filters allow the use of a wildcard when you enter the command. The following rules apply to the use of wildcards:

The wildcard character is the asterisk (*).
The command can contain a maximum of one wildcard.
When you use a wildcard, enclose the filter entry within double quotation marks (""): lssasfabric -filtervalue status

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

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

-filtervalue?

(Optional) Displays the valid filter attributes for the -filtervalue parameter:

enclosure_id
canister_id
canister_port_id
control_enclosure_id
node_canister_id
node_canister_port_id
position
IO_group_id
IO_group_name
node_id
node_name

Description

Use this command to see which canisters are visible to a node, and the order of these canisters. Table 1 describes possible outputs.

Table 1. lssasfabric output
Attribute	Description
enclosure_id	The identity of the enclosure the strand goes to.
canister_id	The canister in the enclosure that the strand goes to.
canister_port_id	The canister port that the strand goes to.
control_enclosure_id	The identity of the enclosure the strand comes from.
node_canister_id	The identity of the canister the strand comes from.
node_canister_port_id	The node canister port the strand is from. This should be the same as the chain ID.
position	The position in the strand or chain.
IO_group_id	The I/O group the strand belongs to. This should be the same as the enclosure IO group.
IO_group_name	The I/O group the strand belongs to. This should be the same as the enclosure IO group.
node_id	The identity of the node that the strand is from. This is the same physical object as the node_canister
node_name	The name of the node that the strand is from. This is the same physical object as the node_canister.

An invocation example with three enclosures

Enclosure 1 is the control enclosure, Enclosure 2 is on chain 1 (node canister port 1) using canister port 1 as its connector, and Enclosure 3 is on chain 2 (node canister port 2) using canister port 2 as its connector.

lssasfabric

Note: In this guide, the following output is split into two parts. This is for illustrative purposes; the output will not appear in two parts when you run this command.

This is the first part of the resulting output:

enclosure_id  canister_id  canister_port_id  control_enclosure_id   node_canister_id  
           1            1                 1                     1                  1
           1            2                 1                     1                  2
           2            1                 1                     1                  1
           2            2                 1                     1                  2
           3            1                 2                     1                  1
           3            2                 2                     1                  2

This is the second part of the resulting output:

node_canister_port_id     position  IO_group_id  IO_group_name  node_id  node_name
                    2            0            0       io_grp0         1       node1
                    2            0            0       io_grp0         2       node2
                    1            1            0       io_grp0         1       node1
                    1            1            0       io_grp0         2       node2
                    2            1            0       io_grp0         1       node1
                    2            1            0       io_grp0         2       node2

An invocation example with two enclosures

This examples shows the output when using this command for a pair of expansion enclosures that are wired correctly to a set of nodes.

lssasfabric

The resulting output:

enclosure_id canister_id canister_port_id control_enclosure_id node_canister_id node_canister_port_id position IO_group_id IO_group_name node_id node_name
1            1           1                                                      1                     1        0           io_grp0       1       node1
2            1           1                                                      2                     1        0           io_grp0       1       node1
1            2           1                                                      1                     1        0           io_grp0       2       node2
2            2           1                                                      2                     1        0           io_grp0       2       node2

[edit]