mmimportnvmeof command

Imports information about NVMe over fabrics (NVMe-oF) connection on IBM Storage Scale client nodes.

Synopsis

mmimportnvmeof --target-node {Node[,Node...] | NodeFile | NodeClass}
  [--allow-import-self] [--connect-options 'opt ...']
  [--reset] [-N {Node[,Node...] | NodeFile | NodeClass}]

Availability

Available on all IBM Storage Scale editions.

Description

The mmimportnvmeof command imports information about the NVMe-oF target connection from target nodes and updates the /etc/nvme/discovery.conf file on a specified node.

Parameters

--target-node {Node[,Node...] | NodeFile | NodeClass}
Specifies individual nodes to import NVMe-oF target connection information.
--allow-import-self

Imports the native target connection information.

--connect-options 'opt ...'

Specifies additional options for the nvme connect-all command.

--reset
Resets the /etc/nvme/discovery.conf file before you update it.
-N {Node[,Node...]
Specifies individual nodes to update the /dev/nvme/discovery.conf file.

Exit status

0
Successful completion.
nonzero
A failure has occurred.

Security

You must have root authority to run the mmimportnvmeof command.

The node on which the command is issued must be able to execute remote shell commands on any other node in the cluster without the use of a password and without producing any extraneous messages. For additional details, see the following IBM Storage Scale RAID: Administration topic: Requirements for administering IBM Storage Scale RAID.

Example

  1. Import the NVMeOF connection. 
    # mmimportnvmeof --target-node nc1 --connect-options '-l 60' --reset -N Node1
    A sample output is as follows:
    Wed Jun 26 06:30:14 EDT 2024: mmimportnvmeof: Finished
  2. Check the /etc/nvme/discovery.conf file on Node1 for updates.
    cat /etc/nvme/discovery.conf
-t tcp -a 11.1.49.83 -s 4420 -l 60
-t tcp -a 11.1.49.85 -s 4420 -l 60
-t tcp -a 11.1.49.91 -s 4420 -l 60
-t tcp -a 11.1.49.93 -s 4420 -l 60
-t tcp -a 11.1.49.81 -s 4420 -l 60
  3. Connect to the NVMeOF target.
    nvme connect-all
  4. List all NVMe target connections. 
    nvme list
    Sample output is as follows:
    
Node            Generic       SN                   Model   Namespace  Usage                      Format
-------------   ------------  -------------------- ------- ---------- -------------------------- --------------
/dev/nvme5n3    /dev/ng5n3    76fa68e77f07cf523b92 Linux   0x3        299.00  GB / 299.00  GB    512   B +  0 B
/dev/nvme5n2    /dev/ng5n2    76fa68e77f07cf523b92 Linux   0x2        299.00  GB / 299.00  GB    512   B +  0 B
/dev/nvme5n1    /dev/ng5n1    76fa68e77f07cf523b92 Linux   0x1        299.00  GB / 299.00  GB    512   B +  0 B
/dev/nvme4n3    /dev/ng4n3    15c3da9559b92177f35b Linux   0x3        299.00  GB / 299.00  GB    512   B +  0 B
/dev/nvme4n2    /dev/ng4n2    15c3da9559b92177f35b Linux   0x2        299.00  GB / 299.00  GB    512   B +  0 B
/dev/nvme4n1    /dev/ng4n1    15c3da9559b92177f35b Linux   0x1        299.00  GB / 299.00  GB    512   B +  0 B
/dev/nvme3n3    /dev/ng3n3    4bde9987e49bf855856d Linux   0x3        299.00  GB / 299.00  GB    512   B +  0 B
/dev/nvme3n2    /dev/ng3n2    4bde9987e49bf855856d Linux   0x2        299.00  GB / 299.00  GB    512   B +  0 B
/dev/nvme3n1    /dev/ng3n1    4bde9987e49bf855856d Linux   0x1        299.00  GB / 299.00  GB    512   B +  0 B
/dev/nvme2n3    /dev/ng2n3    84ef3085ad2d8265c4ca Linux   0x3        299.00  GB / 299.00  GB    512   B +  0 B
/dev/nvme2n2    /dev/ng2n2    84ef3085ad2d8265c4ca Linux   0x2        299.00  GB / 299.00  GB    512   B +  0 B
/dev/nvme2n1    /dev/ng2n1    84ef3085ad2d8265c4ca Linux   0x1        299.00  GB / 299.00  GB    512   B +  0 B
/dev/nvme1n3    /dev/ng1n3    b0eccb3c41ae64ac8901 Linux   0x3        299.00  GB / 299.00  GB    512   B +  0 B
/dev/nvme1n2    /dev/ng1n2    b0eccb3c41ae64ac8901 Linux   0x2        299.00  GB / 299.00  GB    512   B +  0 B
/dev/nvme1n1    /dev/ng1n1    b0eccb3c41ae64ac8901 Linux   0x1        299.00  GB / 299.00  GB    512   B +  0 B

See also

See also the following IBM Storage Scale RAID: Administration topics:

Location

/usr/lpp/mmfs/bin