lssasfabric

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

Syntax

lssasfabric [ -filtervalueattribute_value ] [ -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
-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]

An invocation example

This example shows a system with an expansion enclosure on each external chain.

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                     0        0           io_grp0       1       node1
2            1           1                1                    1                1                     1        0           io_grp0       1       node1
3            1           1                1                    1                2                     1        0           io_grp0       1       node1
1            2           1                1                    2                0                     0        0           io_grp0       2       node2
2            2           1                1                    2                1                     1        0           io_grp0       2       node2
3            2           1                1                    2                2                     1        0           io_grp0       2       node2
Parent topic: Enclosure commands