Manage VTLs for a DXi System
Use the following CLI commands to manage Virtual Tape Libraries (VTLs) for your DXi system.
Note: VTL is only available on certain DXi models. To see if VTL is enabled for your system, check the Utilities > License Keys page in the remote management console. To use VTL commands, at least one Fibre Channel card must be installed in the DXi. (Exception: You can always use VTL failback commands, even when no Fibre Channel card is installed.)
List VTLs
Display a list of all existing VTLs and their attributes on the DXi system. If you specify a VTL name in the option value, only that VTL and its attributes are listed.
Command
syscli ‑‑list vtl [‑‑name <VTL_name>]
Example output
List of all existing VTL's:
Total count = 1
[vtl = 1]
name = myvtl
mode = offline
model = DXi6900
drivemodel = QUANTUMDLTS4
drives = 2
media = 2
slots = 12
ieslots = 12
serial = 123456XYZ
dedup = enabled
autoexport = no
replication = disabled
List Available Library Models
Display a list of the available library models.
Command
syscli ‑‑list library
Example output
List of all available library models:
Total count = 3
[library = 1]
productid = DL1500
description = EMC Disk Library
[library = 2]
productid = Scalar 100
description = ADIC Scalar 100
[library = 3]
productid = Scalar i2000
description = ADIC Scalar i2000
List Supported Tape Drives
Display a list of the available virtual tape drive models
Command
syscli ‑‑list drive
Example output
List of all available drive models:
Total count = 2
[drive = 1]
modelnumber = QUANTUMDLTS4
description = Quantum DLT-S4
[drive = 2]
modelnumber = QUANTUMSDLT320
description = Quantum SDLT320
Add a VTL
Add a VTL partition.
Command
syscli ‑‑add vtl ‑‑name <vtlname> ‑‑model <modelname> ‑‑slots <number_of_slots> ‑‑drivemodel <tape_drive_model> ‑‑drives <number_of_drives> [‑‑dedup] [‑‑backupwindow] ‑‑autoexport yes | no
Command Attributes
Review the following attribute descriptions.
‑‑add vtl
|
Adds a new VTL parition. |
|
|
Enter the name of the VTL partition. The name must be alphanumeric, and it must begin with a letter. Do not use an underscore ( _ ) in the name of the VTL partition. |
|
|
Enter the VTL model to create. A list of supported library models can be retrieved using the |
|
|
Enter the number of storage slots for the VTL. Up to 240 Import/Export (I/E) slots are created based on the number of storage slots. |
|
|
Enter the drive model to create for this VTL. A list of supported drives can be retrieved using the |
|
|
Enter the number of virtual tape drives attached to the VTL. |
|
|
Enter this option to enable deduplication. By default, the VTL will be created with deduplication disabled. When the partition is created, the data deduplication state cannot be changed. |
|
|
Specify whether auto-export is enabled for the VTL. When a tape is exported by the backup application, it is placed in a virtual I/E slot. After this, one of the following actions occurs:
|
Edit a VTL
Edit an existing VTL partition.
Command
syscli ‑‑edit vtl ‑‑name <vtlname> [‑‑model <modelname>] [‑‑slots <number_of_slots>] [‑‑drivemodel <tape_drive_model>] [‑‑drives <number_of_drives>] [‑‑autoexport yes | no]
Command Attributes
Review the following attribute descriptions.
‑‑edit vtl
|
Edits an existing VTL partition. |
|
|
Enter the name of the VTL partition to edit. The name must be alphanumeric, and it must begin with a letter. You cannot change the VTL name. |
|
|
Edit the model name of the partition. |
|
|
Edit the number of storage slots for the VTL. Up to 240 I/E slots are created based on the number of storage slots. |
|
|
Enter the drive model of the partition to edit. You can change the tape drive model only if the VTL has just been recovered and no drive model is configured. A list of supported drives can be retrieved using the |
|
|
Edit the number of virtual tape drives attached to the VTL. |
|
|
Specify whether auto-export is enabled for the VTL. When a tape is exported by the backup application, it is placed in a virtual I/E slot. After this, one of the following actions occurs:
|
Delete a VTL
Delete an existing VTL by specifying its name in the command. When you delete a VTL, the system removes all scheduled replications. Before using this command, the VTL needs to be offline and all media should be removed from the VTL.
Command
syscli ‑‑del vtl ‑‑name <VTL_name>
Place VTLs Online
Place one or more VTLs online OR place all VTLs online.
Command
syscli ‑‑online vtl (‑‑name <VTL_name>) | ‑‑all
Command Attributes
Review the following attribute descriptions
‑‑online VTL
|
Place VTL online. |
|
|
Enter the name of the VTL to place online. You can enter multiple VTLs to place online, as needed. |
‑‑all
|
Enter to place all VTLs online. |
Take VTLs Offline
Take one or more VTLs offline OR take all VTLs offline.
Note: A VTL needs to be offline before you can edit or delete it.
Command
syscli ‑‑offline vtl (‑‑name <VTL_name>) | ‑‑all
Command Attributes
Review the following attribute descriptions
‑‑offline VTL
|
Take VTL online. |
|
|
Enter the name of the VTL to take offline. You can enter multiple VTLs to take offline, as needed. |
‑‑all
|
Enter to take all VTLs offline. |
List Targets
Display a list of targets on the system. The output lists the node, alias (FC port), and world wide port name (WWPN).
Command
syscli ‑‑list target
Example output
List of targets:
Total count = 1
[target = 1]
node = 1
alias = FC3
wwpn = 214108001bc08278
List VTL Devices
Display a list of devices on a VTL. The output includes the device type (VMC or VTD), serial number, and name of the VTL housing the device.
Command
syscli ‑‑list device ‑‑name <VTL_name>
Example output
List of devices:
Total count = 3
[device = 1]
type = VMC
serial = VL01SV0825BVA04501
[device = 2]
type = VTD
serial = VL01SV0825BVA04501
[device = 3]
type = VTD
serial = VL01SV0825BVA04501
Reset VTL Target Ports
Reset VTL target ports.
Command
syscli ‑‑reset targetport [(‑‑name <portname>)] [‑‑sure]
Command Attributes
Review the following attribute descriptions.
‑‑reset targetport
|
Resets VTL target ports. |
|
|
Enter the name of the port(s) to reset. You can enter one or multiple ports to reset. If you do not specify a port, all ports are reset. |
|
|
If specified, the CLI executes the command without prompting for confirmation. |
