HP StoreOnce Backup System CLI Reference Guide

vtl modify drive
Description of Command Function
Modifies a drive which already exists within a library.
Command Syntax
vtl modify drive SETX LIBX DRVX [Drive Emulation
{LTO2|LTO3|LTO4|LTO5|UltriumVT}] [DrivePort <number>] [iSCSIname
<string>] [iUsername <string>] [wwpn <wwpn>] [wwnn <wwnn>]
Command Authority
Administrator
Command Object Requirements
• SET X – This required object defines the service set containing the virtual tape library that
contains the drive to be modified. 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 that contains the drive to be modified. X
is the numeric index of the library.
NOTE: This is the library object name, not the user-defined name of the library. Locate the
LIBX object name for a library using the vtl show library list command (see “vtl show
library list” (page 260) for more information).
• DRV X – This required object is the drive to be modified. X is a numeric index which uniquely
defines the cartridge.
Command Parameter Requirements
• DriveEmulation – This optional parameter defines the type of physical drive the virtual tape
drive emulates. The values are defined in the Command Syntax. If not defined, the current
value remains unchanged.
• DrivePort – This optional parameter defines which physical port on the node is used by the
virtual drive and is only valid if the library interface is Fibre Channel. If the virtual drive interface
is not Fibre Channel, defining this generates an error. The value is a number corresponding
to the ports as defined by the vtl show ports command. If not defined, the current value
remains unchanged.
• iSCSIName – This optional parameter defines the iSCSI initiator name 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 current value remains
unchanged.
• WWPN – This optional parameter defines the worldwide port name if the virtual drive uses
Fibre Channel ports. If the virtual drive interface is not Fibre Channel, defining this generates
an error. The value must be a worldwide port name. If not defined, the current value remains
unchanged.
• WWNN – This optional parameter defines the worldwide node name of the drive if the virtual
drive uses Fibre Channel ports. If the virtual drive does not use Fibre Channel, defining this
generates an error. The value must be a valid worldwide name. If not defined, the current
value remains unchanged.
Requirements for Command Execution
• The command entry must conform to command syntax.
• All object values must be valid. See object requirements for details.
• All parameter values must be valid. See parameter requirements for details.
vtl modify drive 239