lsnvmefabric

Use the lsnvmefabric command to display information about NVMe logins from configured hosts.

Syntax

lsnvmefabric [ { -node { node_id | node_name } [ -portport_id ] | -remotenqnnqn | -host { host_id | host_name } } ]

Parameters

-nodenode_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.
-portport_id
(Optional) Displays a concise view of all NQNs 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 1 through a maximum equal to the number of node Fibre Channel (FC) ports.
-remotenqnnqn
(Optional) Displays a list of all logins from or to the specified remote NQN. You cannot use the -remotenqn parameter with any other parameter.
-hosthost_id | host_name
(Optional) Specifies a host name or ID. Issuing the lsnvmefabric command with the -host parameter is equivalent to issuing the lsnvmefabric command for every configured NQN of the specified host. You cannot use the -host parameter with any other parameter.

Description

The lsnvmefabric command displays NVMe logins from configured hosts.

This table provides the attribute values that can be displayed as output view data.
Table 1. lsnvmefabric output
Attribute Description
remote_nqn Indicates the remote NQN of the login.
node_id Indicates the node ID on which the login is established.
node_name Indicates the node name on which the login is established.
port_id The node port ID that indicates the NVMe port that is displayed by the lstargetportfc view with the same port_id field.
state Indicates whether a login is active or inactive.
  • active - NVMe commands were issued within the last 5 minutes.
  • inactive - No transactions completed within the last 5 minutes.
Note: It might take up to 5 minutes after a command is issued for a host port to change from inactive to active.
object_type The type of object to which the login belongs to.
object_name The name of the object to which the login belongs to.

A concise invocation example

lsnvmefabric

The detailed resulting output:

remote_nqn                                                                node_id node_name port_id state  object_type object_name
nqn.2014-08.org.nvmexpress:NVMf:uuid:644f51bf-8432-4f59-bb13-5ada20c06395 1       node1     1       active host        host0
nqn.2014-08.org.nvmexpress:NVMf:uuid:644f51bf-8432-4f59-bb13-5ada20c06395 1       node1     2       active host        host0
nqn.2014-08.org.nvmexpress:NVMf:uuid:644f51bf-8432-4f59-bb13-5ada20c06395 2       node2     1       active host        host0
nqn.2014-08.org.nvmexpress:NVMf:uuid:644f51bf-8432-4f59-bb13-5ada20c06395 2       node2     2       active host        host0