Skip to main content
Command reference

vserver nvme subsystem host add

Suggest changes
PDFs

Add a host to a subsystem

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The vserver nvme subsystem host add command adds an NVMe host to an NVMe subsystem on a Vserver.

Parameters

-vserver <Vserver Name> - Vserver Name

Specifies the Vserver.

-subsystem <text> - Subsystem

Specifies the NVMe target subsystem.

-host-nqn <text> - Host NQN

Specifies the NVMe subsystem host NQN.

[-priority {regular|high}] - Host priority

Specifies the host priority.

[-dhchap-host-secret-key <text>] - Authentication Host Secret

Specifies the NVMe DH-HMAC-CHAP in-band authentication host secret.

[-dhchap-controller-secret-key <text>] - Authentication Controller Secret

Specifies the NVMe DH-HMAC-CHAP in-band authentication controller secret.

[-dhchap-hash-function {sha-256|sha-512}] - Authentication Hash Function

Specifies the NVMe DH-HMAC-CHAP in-band authentication hash function.

[-dhchap-dh-group {none|2048-bit|3072-bit|4096-bit|6144-bit|8192-bit}] - Authentication Diffie-Hellman Group

Specifies the NVMe DH-HMAC-CHAP in-band authentication Diffie-Hellman group size.

{ [-tls-configured-psk <text>] - TLS Configured PSK

Specifies the configured pre-shared key (PSK) for the host.

| [-tls-generated-psk <true>] - Use a Generated PSK }

Set this field to true to configure TLS authentication using a generated pre-shared key (PSK).

NOTE:

  • The -dhchap-host-secret-key is required when -tls-generated-psk is set true .

  • The -dhchap-dh-group should not be set to None .

  • If the -dhchap-dh-group is not provided, then DH group size of 2048-bit is considered by default.

[-proximal-vservers <text>,…​] - Proximal Vserver Names

Select Vservers configured as proximal to the specified host.

Examples

cluster::*> vserver nvme subsystem host add -vserver vs1 -subsystem ss1 -host-nqn nqn.2001-01.com.example:nvme-host1 -proximal-vservers vs1

Adds a host with the specified NQN to the NVMe subsystem ss1 on Vserver vs1 that is proximal to Vserver vs1 .

cluster::*> vserver nvme subsystem host add -vserver vs1 -subsystem ss1 -host-nqn nqn.2001-01.com.example:nvme-host1 -dhchap-host-secret-key DHHC-1:00:9EOar0LpPQbWqQbrQuhN4oYtFXsX0S5VXyJjrxrX8FYzGJe0 -dhchap-dh-group 2048-bit -tls-generated-psk

Adds a host with the specified NQN to the NVMe subsystem ss1 on Vserver vs1 , configuring TLS authentication using a generated pre-shared key (PSK).