HP StoreOnce Backup System CLI Reference Guide

vtl create library
Description of Command Function
Creates a virtual tape library. In addition, a virtual tape cartridge is created in every slot in the
virtual library.
Command Syntax
vtl create library [SETX] [name <string>] [interface {iSCSI|FC}] [
LibEmulation {Generic|MSL2X24|MSL4X48|MSL8X96|EML|ESL|TBM-TS3500}]
[DriveEmulation {LTO2|LTO3|LTO4|LTO5|UltriumVT|IBM-LTO3}] [NoOfSlots
<number>] [CartSize {10|25|50|100|200|400|800|1000|1200|1400|1600|3200}]
[NoOfDrives <number>] [Port <number> [,<num>]] [iSCSIname <string>]
[iAuthenticationEnable {yes|no}] [iUsername <string>] [iSecret <string>]
[tAuthenticationEnable {yes|no}] [tUsername <string>] [tSecret <string>]
[BarcodeLength {6|8}] encrypt {true|false} [dedupe {yes|no}]
Command Authority
Administrator
Command Object Requirements
• SET X – This object defines the service set into which virtual tape library 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 object is not used within the command sequence; it is created by the command.
The object represents the virtual tape library created by the command. X is a numeric index.
Command Parameter Requirements
• name – This optional parameter is used to create a human readable label for the virtual tape
library created by this command. The value is a text string of up to 30 characters. If the value
contains spaces, the value must be enclosed within quotations. If not included in the command,
the label is defined by the text, Library, followed by the numeric index X defined for the
LIBX object created by this command.
• Interface – This optional parameter defines the physical interface to be used by the virtual
library created by this command. The value is either FC or iSCSI.For single-node products,
if the parameter is not defined, the default below is used:
Default InterfaceStoreOnce System Type
FCmulti-node
iSCSIsingle-node
• LibPort – This optional parameter is a placeholder to allow different port ranges to be assigned
to the robotic arm and virtual drives and is only valid if the library interface is Fibre Channel.
It defines the physical Fibre Channel ports through which robotic arm commands to the virtual
library are transmitted. The value is defined by a number or a set of numbers corresponding
to the ports as defined by the vtl show ports command. More than one port can be
defined by separating the with commas. If not defined, the value is the set of all Fibre Channel
ports available to the service set (all the ports listed by the vtl show ports command). A
value of zero indicates that no port should be assigned to the Fibre Channel interface.
• LibEmulation – This optional parameter defines the type of physical library to be emulated by
the virtual tape library created by this command. The values are defined in the Command
220 Alphabetical List of Commands and Details