Managing connections with nvmeof-cli

List NVMe-oF connections by using the command-line interface (CLI).

Before you begin

Managing NVMe-oF subsystems with the CLI requires the nvmeof-cli alias setup. For more information about defining the alias, see step 1 of Defining an NVMe-oF subsystem with nvmeof-cli.

About this task

At any point, you can use the -h or --help parameters for command help.
The following parameters are interchangeable:
  • --subsystem and -n
Note: The commands here show the SUBSYSTEM_NQN with the subsystem NQN and group name, assuming that the --no-group-append was not added when adding the subsystem. For more information, see Managing subsystems with nvmeof-cli.

Procedure

Use the connection list command to view NVMe-oF subsystem connectivity.
nvmeof-cli --format FORMAT --server-address GATEWAY_IP --server-port SERVER_PORT connection list --subsystem SUBSYSTEM_NQN
For example,
[root@host01 ~]# nvmeof-cli --format json --server-address 10.172.19.01 --server-port 5500 connection list --subsystem nqn.2016-06.io.spdk:cnode1.group1