lsfabric

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

Syntax

Parameters

-delim delimiter: (Optional) Specify a delimiter to separate data in the output.
-nohdr: (Optional) Suppress the headings in the output.

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

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) IO port.

This table provides the attribute values that can be displayed as output view data.

Table 1. lsfabric output
Attribute	Description
remote_wwpn	Indicates the ports that have a login to the specified WWPN
remote_nportid	Indicates the port identifier on the remote.
id	Indicates the node ID on which the login is established
node_name	Indicates the node name on which the login is established
local_wwpn	Indicates the ports that have a login to the specified WWPN
local_port	Indicates a concise view of all NQNs that are logged into the specified port ID and node
local_nportid	Indicates the port identifier on the local.
state	Indicates whether a login is active, inactive or blocked. 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 `blocked` due to the system's port mask settings. The meaning of this value depends on either of the following: Node ports that are blocked due to the system's port mask settings. Logins are blocked due to violating portset membership between the host and the Fibre Channel IO port where host has logged in. The Fibre Channel IO port is not added to the portset which the host is a part of. Host IO will not be allowed from this login path for the host.
name	Indicates the name of the FC connectivity between nodes, controllers, and hosts.
fdmi_host_name	Indicates the host name for the remote WWPN discovered through FDMI discovery.
remote_port_speed	Indicates the current port speed of the remote WWPN.
local_port_speed	Indicates the current port speed of the local WWPN.

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.