Configuring a Virtual Tape Library

Click on the "Virtual Libraries" menu to get a list of the currently configured VTLs as shown in the figure below

VTL list

Click on the "View" link to view the configuration of a specific VTL

Click on the "Add VTL" button to add a new VTL. A form is displayed as shown in the figure below

Add a VTL

In the above form

VTL Name is the name of the VTL. A valid name can only contain alphabets and numbers

Library Type is the type of tape library to emulate

VDrive Type is the type of tape drives to emulate. Currently a VTL can only have a single type of tape drive emulation. (Mixed mode libraries are not supported)

Number of VDrives specify the number of tape drives to emulate

Number of VSlots specify the number of storage slots to emulate

The number of Import/Export slots are fixed at 4. Currently only standalone VTLs are supported

Click on submit.

For the VTL extended edition software the form shown is slightly different as seen in the figure below


Changing the Library Vendor will display the libraries emulated for the vendor.

Number of IE Ports specify the number of changer access ports to emulate. This can be between 0 to 200

The number of storage slots can be upto a maximum of 60000

Drive Start Address specifies the starting element address to report for the tape drives. Similarly for the storage slots the Slot Start Address and for the I/E port the IE Start Address.

In the next page as shown below you will be able to add additional virtual drives.

Add Additional VDrives

Click on the "Add VDrives(s)" button to add additional virtual drives. These drives can be of a different type as shown in the figure below

Additonal VDrives

Click on "Submit" to take you back to the "Add VTL" configuration page. If you wish to cancel adding additional drives click on Cancel.

Click on the "Add VTL" button to create the VTL configuration

On a successful addition the VTL configuration of the newly added VTL is displayed as shown in the figure below

VTL configuration

NOTE: If LTO 5/6 drives are configured and are accessed by TSM 6.2 and above, ensure that CHECKTAPEPOS is set to TSMOnly (SETOPT CHECKTAPEPOS TSMOnly). This option is described in

To delete a VTL click on "Virtual Libraries" and then "View" for that VTL and then click on the "Delete VTL" button

Configuring virtual cartridges

To add a vcartridge click on the "Add VCartrige" button. A form is displayed as shown in the figure below

Add a VCartridge

Select the storage pool to which the vcartridge(s) will belong. Specify the number of vcartridges to create. Select WORM if WORM property needs to be enabled for the vcartridges created

If the number of vcartridges is greater than one then the label will be of the following format



If for example the number of vcartridges is 2 then the labels for the newly created cartridges will be LTO000L6, LTO001L6 etc. If WORM were selected then the labels for the newly created cartridges for our example will be LTO000LU, LTO0001LU etc.

If the number of vcartridges is one then the label can be any length upto 32 characters.

Only alphabets a-z, A-Z and numbers 0-9 are accepted for a label/prefix

Click on Submit to add the specified number of vcartridges. The specified number of vcartridges will be created as shown below

VCartridge list

To delete a vcartridge click on the delete Delete VCartridge icon icon for that vcartridge. Newer versions of the extended edition allows deletion of upto 64 vcartridges at at time by selecting the checkbox for a vcartridge and clicking on the "Delete VCartridge" button

Custom VCartridge size

Depending on the type of vcartridge that is to be created, the size of the vcartridge is determined. For example a LTO 1 vcartridge will have have a size of 100 GB. It should be noted that space for vcartridge is only allocated when needed in 64 MB chunks. This behavior can be changed by specifying a MaxVCartSize in /quadstorvtl/etc/quadstor.conf.

For example the following line in /quadstorvtl/etc/quadstor.conf will create new vcartridges with size of 8 GB


The MaxVCartSize can range from 1 to 1600. If MaxVCartSize is specified it takes precedence over the predetermined size based on the vcartridge type. MaxVCartSize is checked for before creating a vcartridge. Therefore there is no need to restart the quadstor service after adding/modifying this value

NOTE: A backup application may estimate the available capacity based on the cartridge type.

VCartridge Locations

In the figure shown above there are two columns "Element" and "Address" which describe the location of a VCartridge in the VTL

"Import/Export" under the "Element" column indicates that the VCartridge is placed in a "Import/Export" element (a.k.a mailslot)

"Slot" indicates that the VCartridge is placed in a storage slot and "Drive" will indicate that it is placed in a tape drive

By default a new VCartridge is placed in a free Import/Export element. If there are no empty Import/Export elements then it is placed in a free slot. This behavior can be changed to add a new VCartridge into any available storage slot first by adding the following line to /quadstorvtl/etc/quadstor.conf


A quadstorvtl service restart is not required when changing the above property. Each time a VCartridge is added the value of this property is checked

Exporting a VCartridge

NOTE: For the extended edition also refer

Exporting is performed in two steps

1. In the backup application move the VCartridge to a free Import/Export element

2. Refresh the VTL configuration in the HTML page. This triggers a check for any newly exported VCartridges. This step isn't needed for the extended edition of the software. Refer

At this point the VCartridge is removed from the active list for the VTL. An inventory of the VTL by the application will no longer list the VCartridge.

Reloading an exported VCartridge

Once a VCartridge has been exported, to move the VCartridge back into the VTL, click on the 'reload' link for the VCartridge. Reloading the VCartridge will fail if there are no available free storage or import/export slots