How to create a Virtual Tape Library (VTL) via CLI


All Software Releases licensed for VTL

DDOS 4.9 and above

VTL Protocol


This article shows how a VTL is created on DD side via the Command Line Interface (CLI).



The general help for the "vtl" CLI command can be shown with:

# help vtl


General: Please be aware that the names are case sensitive. Test-Pool and test-pool would be two different pools, for example.


  1. Verify if VTL license is added:  # license show If the license is not showing in this add the license via:# license add [License]
  2. Verify that VTL is enabled:  # vtl status If VTL is not enabled, enable it via:# vtl enable
  3. Create the library
    • # vtl add [library-name] model [model] slots [num-slots] caps [num-caps]
    • library-name

      Name can be from 1 to 32 alphanumeric characters

      model supported

      A tape library model name. The current model names are L180, RESTORER-L180, and TS3500 (not supported for GDA). See the Data Domain technical note for your backup software for the model name that you should use. If using RESTORER-L180 as the model name, your backup software may require an update.


      The number of slots in the library. You cannot add more drives than the number of configured slots. The maximum number of slots for all VTLs on a Data Domain system is 20,000. The default is 20 slots.


      The number of cartridge-access ports. The default is 0 (zero) and the maximum is 100 per library or 1000 per system.

    • Example:
      • # vtl add Test-Library model L180 slots 100 caps 1
    • Verify the created library:
      • # vtl show config [library-name]
  4. Next step is to create the Tape Drives
    • # vtl drive add [library-name] count [num drives] model [model]
    • vtlThe virtual tape library name.
      num drivesThe number of drives to add. The maximum number of drives across all VTLs is 64 to 256, depending on the memory installed in your Data Domain system. Systems with 4 G of memory (DD4xx, DD510 and DD530) can have a maximum of 64 drives. Systems with 8 GB to 38 GB (DD580, DD660, and DD690) can have a maximum of 128 drives. Systems with 39 GB or more (DD880 and later) can have a maximum of 256 drives.
      modelOne of IBM-LTO-1, IBM-LTO-2, or IBM-LTO-3. The default drive type is IBM-LTO-3.
    • Example:#
      • vtl drive add Test-Library count 10 model IBM-LTO-3
    • Verify the created drives via:
      • # vtl show config [library-name]
  5. Now we need to create the Tape Pool
    • # vtl pool add [pool-name]
    • Example:
      • # vtl pool add Test-Pool
    • Verify the created drives via:
      • # vtl pool show [pool-name] or# vtl pool show all
  6. At last we create now the tapes
    • # vtl tape add [barcode] capacity [capacity] count [count] pool [pool-name]
    • barcodeAn eight-character identifier that must start with six numeric or upper-case alphabetic characters (that is, 0-9 and A-Z), and end in a two-character tag of L1, L2, L3, LA, LB, or LC for the supported LT0-1, LT0-2, and LT0-3 tape type.
      • L1 represents a tape of 100 GiB capacity.
      • L2 represents a tape of 200 GiB capacity.
      • L3 represents a tape of 400 GiB capacity.
      • LA represents a tape of 50 GiB capacity.
      • LB represents a tape of 30 GiB capacity.
      • LC represents a tape of 10 GiB capacity.
      These capacities are the default sizes that get used if you omit the capacity option when you create the tape cartridge. If you specify capacity , that value overrides the two-character tag.
      capacityThe number of GibiBytes for each tape created. This value overrides the barcode tag capacities. The upper limit is 800. For the efficient reuse of Data Domain system disk space after data becomes obsolete (and the Data Domain system cleaning process marks data for removal), Data Domain recommends setting capacity to 100 or less.
      countThe number of tapes to create. The default is 1 (one).
      pool-nameAssociate the tapes with the specified pool. The pool name is Default if you do not specify a name. The pool that you specify must already exist.
    • Example:
      • # vtl tape add 000001L1 capacity 100 count 100 pool Test-Pool
    • Verify the created tapes via:
      • # vtl tape show pool [pool-name]
  7. As the tapes are now still in the "vault" do we have to import these to the slots/drives. This can be done via:
    • # vtl import [library-name] barcode [barcode] count [count] pool [pool-name] [element {drive | cap | slot}] [address addr]
    • vtl name

      The VTL to use.


      The identifier for a virtual tape.


      The number of tapes to import.


      The name of the pool, which is required if the tapes are in a pool.


      The destination element. The default is slot.


      The address. The default is 1.

    • Example:
      • # vtl import Test-Library barcode 000001L1 count 100 pool Test-Pool
    • Verify the location of the moved tapes via:
      • # vtl tape show pool [pool-name]
  8. After creating the tape library and importing the tapes into the slots we have to create an access group to make the tapes available for the backup appliance.



EMC Support Solution Number: 181043

Creating an Access Group via CLI 181041