blockhost create

This command adds a block client host to VMS, enabling the host to be identified and associated with block storage volumes created on the cluster. The host must first be configured as an NVMe-over-TCP client.

Usage

blockhost create --tenant-id ID
                 --name NAME
                 --nqn NQN
                [--tags TAGS]

Required Parameters

--tenant-id ID

Specifies on which tenant to create the host definition.

Specify ID as an integer.

--name NAME

Specifies the host name.

--nqn NQN

Specifies the host's NVM Express Qualified Name (NQN).

The NQN is a unique identifier string that you can retrieve from the host.

Notice
Host NQN must be unique on the tenant.
On clusters newly installed with VAST Cluster 5.3.2, host NQN must be unique on the cluster, across all tenants.
In multi-tenant VAST Cluster 5.3.2 clusters, it is possible to leverage unique host NQN enforcement to resolve the target tenant of client requests according to the requested host NQN. For details of this feature, see Block Storage and Multi-Tenancy.

Options

--tags TAGS

Adds specified key-value pairs to tag the host, for the purpose of categorizing and organizing block hosts.

Specify TAGS as a comma separated list of pairs of strings in the format KEY=VALUE.

For example: --tags owner=John,department=research

Example

vcli: admin> blockhost create --tenant-id 1 --name h11 --nqn nqn.2015-18.org.nvmexpress:uuid:3c4c4545-004e-3210-804d-c6c04f4b3234