lsfabric

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

Syntax

lsfabric [ { -nodenode_id_or_name [ -portport_id ] | -wwpnwwpn | -hosthost_id_or_name | -controllercontroller_id_or_name | -clustercluster_id_or_name } ]

Parameters

-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.

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