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. Remote copy includes Metro Mirror, Global Mirror, and HyperSwap®. 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
- This value shows connections that are
blockeddue 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 IBM Spectrum Virtualize 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:nodeAn invocation example that shows internal connectivity for node 1
lsfabric -internal -delim : -node 1The 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 