HP StoreOnce D2D4324 HP StoreOnce Backup System CLI Reference Guide (BB877-909 - Page 168

vtl modify drive, LTO2|LTO3|LTO4|LTO5|UltriumVT}] [DrivePort <number>] [iSCSIname

Page 168 highlights

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 ] [iSCSIname ] [iUsername ] [wwpn ] [wwnn ] Command Authority Administrator Command Object Requirements • SETX - 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. • LIBX - 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. You can find the LIBX object name for a library using the "vtl show library list" (page 188) command. • DRVX - 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 will emulate. 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 will be 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 will generate 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 will generate 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 will generate 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 will generate 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 the command syntax. • All object values must be valid; see the object descriptions for details. • All parameter values must be valid; see the parameter descriptions for details. Successful Command Output Upon successful completion of the command, the following is displayed: 168 Alphabetical List of Commands and Details

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196

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.
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. You can
find the LIB
X
object name for a library using the
“vtl show library list” (page 188)
command.
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 will emulate. 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 will be 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 will generate 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 will generate 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 will generate
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
will generate 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 the command syntax.
All object values must be valid; see the object descriptions for details.
All parameter values must be valid; see the parameter descriptions for details.
Successful Command Output
Upon successful completion of the command, the following is displayed:
168
Alphabetical List of Commands and Details