HP StoreOnce Backup System CLI Reference Guide

vtl add drive
Description of Command Function
Adds a drive to an existing virtual tape library. The interface type (FC, iSCSI, etc.) of the drive
must be the same as the virtual library into which the drive is being added.
Command Syntax
vtl add drive [SETX] LIBX [DriveEmulation
{LTO2|LTO3|LTO4|LTO5|UltriumVT}] [DrivePort <number>] [iSCSIname
<string>] [iUsername <string>] [iPassword <string>] [tUsername <string>]
[tPassword <string>] [wwpn <string>] [wwn <string>]
Command Authority
Administrator
Command Object Requirements
• SET X – This object defines the service set containing the virtual tape library into which the
drive is added. X is the numeric index of the service set. It is optional on a single-node system
but must be defined on a multi-node system. If used on a single-node system, the object must
be defined as SET1.
• LIB X – This required object is the virtual tape library into which the drive is added. X is the
numeric index of the library.
• DRV X – This object is not used within the command sequence. It represents the virtual drive
created by the command. X is a numeric index which uniquely identifies the object.
Command Parameter Requirements
• DriveEmulation – This optional parameter defines the type of physical drive the virtual tape
drive emulates. The value is defined as a text word (valid words are defined in the Command
Syntax). If the parameter is not defined, the default value corresponds to the default drive type
defined by the library object’s emulation type.
• DrivePort – If the VTL interface is Fibre Channel, this optional parameter defines which physical
port on the node is used by the virtual drive. The port is defined by an integer value. If the
VTL’s interface is iSCSI, defining this generates an error. If not defined, the value is defined
by the drive port value of the library object to which the drive is being added. A value of zero
indicates that no port should be assigned to the Fibre Channel interface.
• iSCSIName – This parameter defines the iSCSI initiator name and is required if the interface
is iSCSI. If the VTL’s interface is not iSCSI, defining this generates an error. The value is a text
string with a maximum of 224 characters. If not defined, the default is a null string.
• iUserName – This optional parameter defines the initiator user name for the CHAP (challenge
handshake authentication protocol) and is only valid if the interface is iSCSI. If the VTL’s
interface is not iSCSI, defining this generates an error. The value is a text string with a maximum
of 224 characters. If not defined, the CHAP protocol is not supported.
• iPassword – This optional parameter defines the initiator password for the CHAP (challenge
handshake authentication protocol) and is only valid if the interface is iSCSI. If the VTL’s
interface is not iSCSI, defining this generates an error. The value is a text string with a maximum
of 17 characters. If not defined, the CHAP protocol is not supported.
• tUserName – This optional parameter defines the target user name for the CHAP (challenge
handshake authentication protocol) and is only valid if the interface is iSCSI. If the VTL’s
interface is not iSCSI, defining this generates an error. The value is a text string with a maximum
of 224 characters. If not defined, the CHAP protocol is not supported.
• tPassword – This optional parameter defines the target password for the CHAP (challenge
handshake authentication protocol) and is only valid if the interface is iSCSI. If the VTL’s
214 Alphabetical List of Commands and Details