Manage Media for VTLs
Use the following CLI commands to manage media for your Virtual Tape Libraries (VTLs).
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 Media Types
Display a list of media types — along with their native and maximum capacities — supported by the specified tape drive model.
Note: You can retrieve a list of supported drives using the ‑‑list drive command. The drive type can be derived from the modelnumber field returned from the list of available tape drive models.
Command
syscli ‑‑list mediatype ‑‑drive <drive_type>
Example Command
syscli ‑‑list mediatype ‑‑drive QUANTUMDLTS4
Example Output
List of media types:
Total count = 3
[mediatype = 1]
type = DLTS4
capability = RW
nativecapacity = 800 GB
maxcapacity = 6000 GB
[mediatype = 2]
type = SDLT2
capability = RW
nativecapacity = 300 GB
maxcapacity = 6000 GB
[mediatype = 3]
type = SDLT1
capability = RW
nativecapacity = 160 GB
maxcapacity = 6000 GB
Create Media
Create media for each defined VTL.
Command
syscli ‑‑add media ‑‑name <VTLname> ‑‑type <mediatype> ‑‑media <number_of_media> ‑‑barcodestart <starting_barcode> ‑‑location slot|ieslot [‑‑capacity <media_capacity_in_GB>]
Command Attributes
Review the following attribute descriptions.
‑‑add media
|
Create media for a VTL. |
|
|
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 type of media to create for this VTL. The media type can be derived from the type field returned from the --list mediatype command. |
|
|
Enter the number of media to create for this VTL. |
|
|
Enter the starting barcode to assign to the media. |
|
|
Enter the type of storage location to place the media in. |
|
|
You can optionally enter the media capacity in gigabytes. If you do not specify the media capacity, it defaults to the media type native capacity. |
List Media Attributes
This command returns a list of media on the system matching the specified criteria: partition name, barcode filter, selection window (starting index and number of entries).
Note:
This command will not list more than 61,000 media and will return an error in this situation. Options to limit the number of media returned by the command include:
- Use the
--nameand/or--filteroptions - Use the
--startand/or--countoptions
Command
syscli --list media [--name <vtlname>] [--all] { [--barcode <barcode>] | [--filter <barcode_filter> ] } [--start <start_index>] [--count <num_entries>]
Command Attributes
Review the following attribute descriptions
‑‑list media
|
Lists the media. |
|
|
VTL to list media in. This must be a valid VTL name for the system. |
|
|
This is now deprecated. |
|
|
This is now deprecated. Use the --filter option instead. |
|
|
Specifies barcode filter, which is a comma separated list of literal values, substitutions (*) and barcode ranges. Substitutions (*) must be escaped. Examples --filter "AC0145,A*45,AC*,*145,AB5150-AC0145" |
|
|
Starting index for the listing (0-based). If not specified, defaults to 0. |
|
|
Number of media to list after the starting index, but no more than 61,000. If not specified, all media to the end of selection is listed unless that is more than 61,000 media. |
Delete Media
Delete the specified media.
Command
syscli ‑‑del media [--name <vtlname>] --barcode <barcode> | --filter <barcode_filter>
Command Attributes
Review the following attribute descriptions
‑‑del media
|
Delete media. |
|
|
This is now deprecated. |
|
|
This is now deprecated. Use the |
|
|
Delete eligible media matching barcode filter, which is a comma separated list of literal values, substitutions (*) and barcode ranges. Substitutions (*) must be escaped. Examples --filter "AC0145,A*45,AC*,*145,AB5150-AC0145" |
Export Media
Export a specific media or all media within a single VTL.
Command
syscli ‑‑export media --name <vtlname> (--barcode <barcode>) | --all | --filter <barcode_filter>
Command Attributes
Review the following attribute descriptions
‑‑export media
|
Export media. |
|
|
Enter the name of the VTL in which the media to export resides. |
|
|
This is now deprecated. Use the |
‑‑all
|
Enter to export all media from the specified VTL. |
|
|
Export eligible media matching barcode filter, which is a comma separated list of literal values, substitutions (*) and barcode ranges. Substitutions (*) must be escaped. Examples --filter "AC0145,A*45,AC*,*145,AB5150-AC0145" |
Recycle Media
Recycle a specific media or all media within a single VTL.
Command
syscli ‑‑recycle media --name <vtlname> (--barcode <barcode>) | --all | --filter <barcode_filter>
Command Attributes
Review the following attribute descriptions
‑‑recycle media
|
Recycle media. |
|
|
Enter the name of the VTL in which the media to recycle resides. |
|
|
This is now deprecated. Use the |
‑‑all
|
Enter to recycle all media within the specified VTL. |
|
|
Recycle eligible media matching barcode filter, which is a comma separated list of literal values, substitutions (*) and barcode ranges. Substitutions (*) must be escaped. Examples --filter "AC0145,A*45,AC*,*145,AB5150-AC0145" |
Write-Protect Media
Write-protect media in a single VTL.
Command
syscli ‑‑writeprot media --name <vtlname> (--barcode <barcode>) | --all | --filter <barcode_filter> [--disable]
Command Attributes
Review the following attribute descriptions
‑‑writeprot media
|
Write-protect media. |
|
|
Enter the name of the VTL to write protect in. |
|
|
This is now deprecated. Use the |
‑‑all
|
Enter to write-protect all media within the specified VTL. |
|
|
Write-protect eligible media matching barcode filter, which is a comma separated list of literal values, substitutions (*) and barcode ranges. Substitutions (*) must be escaped. Examples --filter "AC0145,A*45,AC*,*145,AB5150-AC0145" |
‑‑disable
|
Enter to disable write-protect on media |
Import Media
Import all unassigned media into a single VTL.
Command
syscli ‑‑import media --name <vtlname> (--barcode <barcode> ) | --all | --filter <barcode_filter>
Command Attributes
Review the following attribute descriptions
‑‑import media
|
Import media. |
|
|
Enter the name of the VTL in which to import media. |
|
|
This is now deprecated. Use the |
‑‑all
|
Enter to import all media into a specified VTL. |
|
|
Import eligible media matching barcode filter, which is a comma separated list of literal values, substitutions (*) and barcode ranges. Substitutions (*) must be escaped. Examples --filter "AC0145,A*45,AC*,*145,AB5150-AC0145" |
Delete All Media
Delete all media in the specified VTL.
Command
syscli ‑‑deleteall media [‑‑name <vtlname>] [‑‑sure]
Command Attributes
Review the following attribute descriptions
‑‑deleteall media
|
Delete all media within a VTL. |
|
|
(Deprecated). You must enter |
‑‑sure
|
If specified, the CLI executes the command without prompting for confirmation. |
List VTL Storage Locations
List the source OR destination storage locations for a VTL. Use this command to determine the locations to/from which to move or unload media.
Command
syscli ‑‑list vtlstorage ‑‑name <vtlname> ‑‑loc source | dest [‑‑type drive | slot | ieslot]
Example output
List of VTL storage locations:
Total count = 1
[storage location = 1]
location type = I/E Slot
index = 0
address = 16
drive serial number = N/A
barcode = N/A
writeprotect = disabled
access = N/A
used = N/A
Command Attributes
Review the following attribute descriptions.
|
|
Lists VTL storage locations. |
|
|
The name of the VTL for which to list storage locations. |
|
|
The name of the source location OR destination location. |
|
|
If you include this option, only locations of the specified type are listed, either drive, slot, or I/E slot. |
Move Media
Move media between virtual storage locations.The following diagram depicts the media's movement.
Media Movement Pattern
source location and index → destination location and index
‑‑srctype slot | drive | ieslot → ‑‑desttype slot | drive | ieslot
‑‑srcindex <source_index> → ‑‑destindex
<destination_index>
Note: You can determine the location type and index from the output of the ‑‑list vtlstorage command.
Command
syscli ‑‑move media ‑‑name <VTLname> ‑‑srctype slot | drive | ieslot ‑‑desttype slot | drive | ieslot ‑‑srcindex <source_index> ‑‑destindex <destination_index> [‑‑forceunload]
Command Attributes
Review the following attribute descriptions.
|
|
Moves media between virtual storage locations. |
|
|
Enter the name of VTL for which to move media. |
|
|
Enter the medias' source location type, either slot, drive, or I/E slot. |
|
|
Enter the medias' of destination location type, either slot, drive, or I/E slot. |
|
|
Enter the index of the source element. |
|
|
Enter the index of the destination element. |
|
|
Force unload from the drive. This parameter refers to virtual drive source locations. |
Unload Media
Unload media from a virtual drive or from an import/export virtual storage location.
Command
syscli ‑‑unload media --name <vtlname> (--barcode <barcode> ) | --filter <barcode_filter> | {--loctype drive | ieslot --index <location index>} [--forceunload]
Command Attributes
Review the following attribute descriptions.
|
|
Unloads media. |
|
|
Enter the name of VTL from which to unload media. |
|
|
This is now deprecated. Use the |
|
|
Unload eligible media matching barcode filter, which is a comma separated list of literal values, substitutions (*) and barcode ranges. Substitutions (*) must be escaped. Examples --filter "AC0145,A*45,AC*,*145,AB5150-AC0145" |
|
|
Enter the type of location from which to unload media, either drive or I/E slot. |
|
|
Enter the index of the element. |
|
|
Force the unload from the drive. This parameter refers to virtual drive source locations. |
