lssasfabric

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

Syntax

lssasfabric [ -filtervalueattribute_value ] [ -nohdr ] [ -delimdelimiter ] [ -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 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.
-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. This table describes possible outputs:
Table 1. lssasfabric output
Attribute Description
enclosure_id Indicates the identity of the enclosure the strand goes to.
canister_id Indicates the canister in the enclosure that the strand goes to.
canister_port_id Indicates the canister port that the strand goes to.
control_enclosure_id Indicates the identity of the enclosure that the strand comes from.
node_canister_id Indicates the identity of the canister the strand comes from.
node_canister_port_id Indicates the node canister port that the strand is from. This must be the same as the chain ID.
position Indicates the position in the strand or chain.
IO_group_id Indicates the I/O group that the strand belongs to. This must be the same as the enclosure IO group.
IO_group_name Indicates the I/O group the strand belongs to. This must be the same as the enclosure IO group.
node_id Indicates 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. 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 does 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 example shows the output when you use 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]