Skip to main content
Command reference

vserver nvme subsystem show

Suggest changes

Display NVMe target subsystems

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

Description

The vserver nvme subsystem show command displays information for NVMe subsystems.

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-vserver <Vserver Name>] - Vserver Name

Use this parameter to display the NVMe subsystems that match the Vserver that you specify.

[-subsystem <text>] - Subsystem

Use this parameter to display the NVMe subsystem that matches the name that you specify.

[-ostype {aix|linux|vmware|windows}] - OS Type

Use this parameter to display the NVMe subsystems that match this parameter value.

[-comment <text>] - Comment

Use this parameter to display the NVMe subsystems that match this parameter value.

[-target-nqn <text>] - Target NQN

Use this parameter to display the NVMe subsystems that match this parameter value.

[-serial-number <text>] - Serial Number

Use this parameter to display the NVMe subsystems that match this parameter value.

[-default-io-queue-count <integer>] - Default Number of Host I/O Queue Pairs

Specifies the IO queue count inherited by hosts added to this subsystem. The actual value used when a connection is established may vary depending on the host and transport protocol used.

[-default-io-queue-depth <integer>] - Default Host I/O Queue Depth

Specifies the IO queue depth inherited by hosts added to this subsystem. The actual value used when a connection is established may vary depending on the host and transport protocol used.

[-uuid <UUID>] - UUID

Use this parameter to display the NVMe subsystems that have UUIDs matching the parameter value.

[-delete-on-unmap {true|false}] - Delete on Unmap (privilege: advanced)

Specifies whether the subsystem should be deleted automatically when it is no longer mapped to a namespace.

[-vendor-uuids <UUID>,…​] - Vendor UUIDs (privilege: advanced)

Use this parameter to display the NVMe subsystems that have vendor-specific UUIDs that match the parameter value.

[-peer-vserver-name <text>] - Peer Vserver Name

Selects the subsystems that match this parameter value. The peer-vserver-name is the local name of the peer Vserver, as reported by the vserver peer show -fields peer-vserver command. When set, the subsystem and its hosts and maps to namespaces are replicated to the peer cluster.

[-replication-error <text>] - Replication Error

Selects the subsystems that match this parameter value. This field provides information about asynchronous errors encountered while replicating this subsystem. Subsystems within a peering relationship are replicated in the same stream, so the error reported here might be related to this subsystem or a prior replicated subsystem that is now blocking the replication of this subsystem. Both the error information and the subsystem encountering the error are reported. If the error is configuration related, it can be corrected on the referenced subsystem. The replication is retried using exponential backoff up to a maximum of one retry every 5 minutes. Every operation on the same stream triggers an immediate retry and restarts the exponential backoff starting with a 1 second delay. If the error is system related, the retries should correct the error when the system enters a healthy state.

[-replication-error-subsystem <text>] - Replication Error Subsystem

Selects the subsystems that match this parameter value. The name of the subsystem encountering the error reported by the 'replication-error' field.

Examples

cluster1::*> vserver nvme subsystem show -vserver vs_1
Vserver Subsystem    Target NQN
------- ------------ --------------------------------------------------------
vs_1
        ss1          nqn.1992-08.netapp.com:sn.ccb5a7d5d9d311e7924e005056b45113:subsystem.ss1
        ss2          nqn.1992-08.netapp.com:sn.ccb5a7d5d9d311e7924e005056b45113:subsystem.ss2
2 entries were displayed.