vserver iscsi create

Contributors

Create a Vserver’s iSCSI service

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

Description

This command creates an iSCSI target for a specified Vserver. By default the system creates a default iSCSI target name with the status-admin set to enabled. Until you create an iSCSI service, iSCSI initiators cannot log into the Vserver.

Parameters

-vserver <Vserver Name> - Vserver

Specifies the Vserver for the iSCSI service.

[-target-name <text>] - Target Name

Specifies a iSCSI target name of a Vserver. This name is unique and is not case sensitive. The target name must conform to this format iqn.1995-08.com.example:string and the following rules:

  • Contains up to 128 bytes.

  • Contains alphanumeric characters. The period ".", hyphen "-", and colon ":" are acceptable.

  • Does not contain the underscore character "_".

[-target-alias <text>] - Target Alias

Specifies an iSCSI target alias name of a Vserver. The maximum number of characters for an alias name is 128. The alias default name is the Vserver name.

[-status-admin {down|up}] - Administrative Status

Specifies the administrative status of the iSCSI service of a Vserver. If you set this parameter to up, the command creates an iSCSI service with the administrative status of up. If you set this parameter to down, the command creates an iSCSI service with the administrative status of down.

[-max-error-recovery-level <integer>] - Max Error Recovery Level

Specifies the maximum error recovery level allowed by the iSCSI service. You can specify 0, 1, or 2, or you can accept the default. The default is zero. The actual error recovery level depends on the negotiated error recovery level between the initiator and the iSCSI target when the session is created.

  • 0 - Session failure recovery

  • 1 - Digest failure recovery

  • 2 - Connection failure recovery

[-retain-timeout <integer>] - RFC3720 DefaultTime2Retain Value (in sec)

Specifies the wait time before an active task reassignment is possible after an unexpected connection termination. For example, a value of 0 means that the connection or task state is immediately discarded by the target. The default is 20 seconds.

[-login-timeout <integer>] - Login Phase Duration (in sec)

Specifies the login phase duration. The default is 15 seconds.

[-max-conn-per-session <integer>] - Max Connections per Session

Specifies the maximum number of connections per session that a target can accept. The default is 4 connections.

[-max-ios-per-session <integer>] - Max Commands per Session

Specifies the maximum number of commands per session that a target can accept. The default is 128 commands per session.

[-tcp-window-size <integer>] - TCP Receive Window Size (in bytes)

Specifies the TCP receive window size (in bytes). The default is 131,400 bytes.

[-f, -force <true>] - Allow Non-Vendor Target Name

Force the command to accept a target name that would normally be rejected as invalid.

Examples

cluster1::> vserver iscsi create -vserver vs_1

Creates the iSCSI service for Vserver vs_1.