lsfabric
Use the lsfabric command to generate a report that displays the Fibre Channel (FC) connectivity between nodes, controllers, and hosts.
Syntax
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.
- -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. - -node node_name | node_id
- (Optional) Displays the output for all ports for the specified node. The only parameter that you can specify with the -node parameter is the -port parameter.
- -port port_id
- (Optional) Displays a concise view of all worldwide port names (WWPNs) that are logged into the specified port ID and node. The -port parameter must be specified with only the -node parameter. A valid port_id value is from a minimum of one through a maximum equal to the number of node Fibre Channel (FC) I/O ports. It specifies the port number in the vital product data (VPD) or the hexadecimal WWPN of the local port.
- -wwpn wwpn
- (Optional) Displays a list of all ports that have a login to the specified WWPN. You cannot use the -wwpn parameter with any other parameter.
- -host host_id_or_name
- (Optional) Specifies a host name or ID. Issuing the lsfabric command with the -host parameter is equivalent to issuing the lsfabric wwpn wwpn command for every configured WWPN of the specified host. For example, a host with two ports that are zoned to one port of every node in an eight-node system produces 16 lines of output. You cannot use the -host parameter with any other parameter.
- -controller controller_id_or_name
- (Optional) Specifies a controller ID or name. You cannot use the -controller parameter with any other parameter in this command. Issuing the lsfabric command with the -controller parameter is equivalent to issuing the lsfabric wwpn wwpn command for every configured WWPN of the specified controller. For example, a controller with four ports that are connected to an eight node system with two counterpart SANs produces 64 lines of output.
- -cluster cluster_id_or_name
- (Optional) Specifies a system ID or name. You cannot use the
-cluster parameter with any other parameter. Issuing the
lsfabric command with the -cluster parameter
is equivalent to issuing the lsfabric wwpn
wwpn command for every known WWPN in the specified system. Output is
sorted by remote WWPNs and then system WWPNs. This parameter can be used to check the
state of connections within the local system or between the local and remote system.
When the local system ID or name is specified, each node-to-node connection is listed
twice: once from each end. For example, an eight-node system with two counterpart SANs
produces eight nodes, which are multiplied by seven other nodes, which are multiplied by
two SANs, multiplied by four point-to-point logins, equals 448 lines of output.
Note: The system must be configured in a remote copy partnership with the local system. It must appear in the lssystem view.
- -bytes
- (Optional) Displays all capacities as bytes.
Description
The lsfabric command can be issued with any of the parameters to display a limited subset of information. If the command is issued without any parameters, it provides output for every node.
Remember: The value of the
local_port
field is the number of the
node's Fibre Channel (FC) port.Values for the Type and
State columns are:
- state active
- The meaning of this value depends on the object that it applies to, as follows:
- host or controller
- Small Computer System Interface (SCSI) commands were issued within the last 5 minutes.
- node
- Node ports can see other ports.
- state inactive
- No transactions completed within the last 5 minutes.Note: It can take up to 10 seconds after a command for a controller port to change from inactive to active. It can take up to 5 minutes after a command for a host port to change from inactive to active.
- state blocked
-
The meaning of this value depends on the object that it applies
to, as follows:
host
- Host ports that are blocked due to the host's port mask settings or the current N_Port ID Virtualization (NPIV) status in the I/O group.node
- Node ports that are blocked due to the system's port mask settings. - type
- One of the following values is displayed:
- host
- node
- controller
- unknown
- nas
You can issue this command to view all the information about the connections that are available to your system.
Remember: The lsfabric
command is limited to displaying 16,384 entries. If you have a large system configuration
that exceeds these limits you must filter the output (for example, by node or node port) to
view all fabric login records.
An invocation example by using a delimiter
lsfabric -delim :
The resulting output, in which each row of output contains the following colon-separated columns:
remote_wwpn:remote_nportid:id:node_name:local_wwpn:
local_port:local_nportid:state:name:cluster_name:type
An invocation example for a WWPN being used by a FlashSystem 9100 node
lsfabric wwpn port
The resulting output:
remote_wwpn remote_nportid id node_name local_wwpn local_port local_nportid state name cluster_name type
5005076801305160 011B00 1 node1 500507680140506A 1 011600 active node1 def110774 node
10000000C95A01E7 011C00 1 node1 500507680130506A 2 011700 active nas
An invocation example that shows unused (because the system's mask settings are blocked) node logins
lsfabric -delim :
The resulting output:
remote_wwpn:remote_nportid:id:node_name:local_wwpn:local_port:local_nportid:state:name:cluster_name:type
500507680304D190:021700:5:nodeA:500507680304A100:1:020300:active:node4:Cluster_9.115.2:node
500507680304D190:021700:2:nodeB:500507680308A101:2:021800:active:node4:Cluster_9.115.2:node
500507680304D190:021700:3:nodeC:500507680308190D:2:020A00:active:node4:Cluster_9.115.2:node
500507680308D190:011700:5:nodeA:500507680308A100:2:011000:blocked:node4:Cluster_9.115.2:node
500507680308D190:011700:2:nodeB:500507680304A101:1:010D00:blocked:node4:Cluster_9.115.2:node
500507680308D190:011700:3:nodeC:500507680304190D:1:011200:blocked:node4:Cluster_9.115.2:node
An invocation example that shows internal connectivity for node
1
lsfabric -internal -delim : -node 1
The resulting output:
remote_wwpn:remote_nportid:id:node_name:local_wwpn:local_port:local_nportid:state:name:cluster_name:type
500507680C520034:010E00:1:node1:500507680C210033:5:010200:active:node2:Cluster_9.19.88:node
500507680C520034:010E00:1:node1:500507680C220033:6:010F00:active:node2:Cluster_9.19.88:node
500507680C520034:010E00:1:node1:500507680C510033:9:010A00:active:node2:Cluster_9.19.88:node
500507680C520034:010E00:1:node1:500507680C520033:10:010B00:active:node2:Cluster_9.19.88:node
500507605EBFEA91:010900:1:node1:500507680C210033:5:010200:active:::expansion
500507605EBFEA91:010900:1:node1:500507680C220033:6:010F00:active:::expansion
500507605EBFEA91:010900:1:node1:500507680C510033:9:010A00:active:::expansion
500507605EBFEA91:010900:1:node1:500507680C520033:10:010B00:active:::expansion
500507605E828601:010100:1:node1:500507680C210033:5:010200:active:::expansion
500507605E828601:010100:1:node1:500507680C220033:6:010F00:active:::expansion
500507605E828601:010100:1:node1:500507680C510033:9:010A00:active:::expansion
500507605E828601:010100:1:node1:500507680C520033:10:010B00:active:::expansion
500507605E828611:010700:1:node1:500507680C210033:5:010200:active:::expansion
500507605E828611:010700:1:node1:500507680C220033:6:010F00:active:::expansion
500507605E828611:010700:1:node1:500507680C510033:9:010A00:active:::expansion
500507605E828611:010700:1:node1:500507680C520033:10:010B00:active:::expansion
500507680C210034:010000:1:node1:500507680C210033:5:010200:active:node2:Cluster_9.19.88:node
500507680C210034:010000:1:node1:500507680C220033:6:010F00:active:node2:Cluster_9.19.88:node
500507680C210034:010000:1:node1:500507680C510033:9:010A00:active:node2:Cluster_9.19.88:node
500507680C210034:010000:1:node1:500507680C520033:10:010B00:active:node2:Cluster_9.19.88:node
500507605EBFEAB1:010400:1:node1:500507680C210033:5:010200:active:::expansion
500507605EBFEAB1:010400:1:node1:500507680C220033:6:010F00:active:::expansion
500507605EBFEAB1:010400:1:node1:500507680C510033:9:010A00:active:::expansion
500507605EBFEAB1:010400:1:node1:500507680C520033:10:010B00:active:::expansion
500507680C510034:010D00:1:node1:500507680C210033:5:010200:active:node2:Cluster_9.19.88:node
500507680C510034:010D00:1:node1:500507680C220033:6:010F00:active:node2:Cluster_9.19.88:node
500507680C510034:010D00:1:node1:500507680C510033:9:010A00:active:node2:Cluster_9.19.88:node
500507680C510034:010D00:1:node1:500507680C520033:10:010B00:active:node2:Cluster_9.19.88:node
500507605EBFEA82:010500:1:node1:500507680C210033:5:010200:active:::expansion
500507605EBFEA82:010500:1:node1:500507680C220033:6:010F00:active:::expansion
500507605EBFEA82:010500:1:node1:500507680C510033:9:010A00:active:::expansion
500507605EBFEA82:010500:1:node1:500507680C520033:10:010B00:active:::expansion
500507605EBFEAA2:010600:1:node1:500507680C210033:5:010200:active:::expansion
500507605EBFEAA2:010600:1:node1:500507680C220033:6:010F00:active:::expansion
500507605EBFEAA2:010600:1:node1:500507680C510033:9:010A00:active:::expansion
500507605EBFEAA2:010600:1:node1:500507680C520033:10:010B00:active:::expansion
500507680C220034:010C00:1:node1:500507680C210033:5:010200:active:node2:Cluster_9.19.88:node
500507680C220034:010C00:1:node1:500507680C220033:6:010F00:active:node2:Cluster_9.19.88:node
500507680C220034:010C00:1:node1:500507680C510033:9:010A00:active:node2:Cluster_9.19.88:node
500507680C220034:010C00:1:node1:500507680C520033:10:010B00:active:node2:Cluster_9.19.88:node
500507605E828631:010800:1:node1:500507680C210033:5:010200:active:::expansion
500507605E828631:010800:1:node1:500507680C220033:6:010F00:active:::expansion
500507605E828631:010800:1:node1:500507680C510033:9:010A00:active:::expansion
500507605E828631:010800:1:node1:500507680C520033:10:010B00:active:::expansion
500507605E828621:010300:1:node1:500507680C210033:5:010200:active:::expansion
500507605E828621:010300:1:node1:500507680C220033:6:010F00:active:::expansion
500507605E828621:010300:1:node1:500507680C510033:9:010A00:active:::expansion
500507605E828621:010300:1:node1:500507680C520033:10:010B00:active:::expansion
An invocation example
lsfabric -host 0
The resulting output:
remote_wwpn remote_nportid id node_name local_wwpn local_port local_nportid state name cluster_name type
10000090FADD2049 01C000 1 node1 500507680C514C3B 1 01C780 blocked host0 host
10000090FADD2049 01C000 1 node1 500507680C524C3B 2 01C600 active host0 host
10000090FADD2049 01C000 2 node2 500507680C5118A7 1 01D400 blocked host0 host
10000090FADD2049 01C000 2 node2 500507680C5218A7 2 01D580 inactive host0 host
10000090FADD204A 01C080 1 node1 500507680C514C3B 1 01C780 blocked host0 host
10000090FADD204A 01C080 1 node1 500507680C524C3B 2 01C600 inactive host0 host
10000090FADD204A 01C080 2 node2 500507680C5118A7 1 01D400 blocked host0 host
10000090FADD204A 01C080 2 node2 500507680C5218A7 2 01D580 inactive host0 host