lsfabric

Use the lsfabric command to generate a report that displays the Fibre Channel (FC) connectivity between nodes, controllers, and hosts.

Syntax

 lsfabric  [  -delim  delimiter  ]   [  -nohdr  ]   [ {  -node  node_id_or_name   [  -port  port_id  ] |  -wwpn  wwpn  |  -host  host_id_or_name  |  -controller  controller_id_or_name  |  -cluster  cluster_id_or_name  } ] [  -bytes  ]  

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 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.
-node node_id_or_name
(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.
-portport_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.
-wwpnwwpn
(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.
-hosthost_id_or_name
(Optional) Specifies a host name or ID. Issuing the lsfabric command with the -host parameter is equivalent to issuing the lsfabric wwpnwwpn 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 a eight-node clustered system (system) produces 16 lines of output. You cannot use the -host parameter with any other parameter.
-controllercontroller_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 wwpnwwpn command for every configured WWPN of the specified controller. For example, a controller with 4 ports connected to a 8 node system with 2 counterpart SANs produces 64 lines of output.
-clustercluster_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 wwpnwwpn 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, multiplied by seven other nodes, 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 have 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 shows connections 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 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 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