This topic introduces the QoreStor CLI commands that allow you to manage the virtual tape library (VTL) containers you have created for your system, which include:
- vtl --show [options]
- vtl --update_carts [options]
- vtl --import_cart [options]
- vtl --activate --name [options]
- vtl --deactivate --name
- vtl --rescan --name [options]
- vtl --set_rw [options]
- vtl --show_replstate --name
- vtl --help
Description
This command allows you to see the status of a specified virtual tape library (VTL). It displays detailed information about VTL, such as media type, vendor, model, generic device information, serial number, library size, and tape status information. The first example below shows the result information for Container vtl1 of type VTL with an NDMP connection. The second example shows Container iscsi-vtl1 of type VTL with an iSCSI connection.
Syntax
vtl --show [--verbose] [--name <name>]
Where
--verbose Display more details.
--name Name of a valid VTL container
Result
-----------------------------------------------------------------
Type Vendor Model Serial Info ID
_________________________________________________________________
medi DELL DR_L700 81BL3T_00 10 10GB 10
tape IBM ULT3580-TD4 81BL3T_01 Not loaded 11
tape IBM ULT3580-TD4 81BL3T_02 Not loaded 12
tape IBM ULT3580-TD4 81BL3T_03 Not loaded 13
tape IBM ULT3580-TD4 81BL3T_04 Not loaded 14
tape IBM ULT3580-TD4 81BL3T_05 Not loaded 15
tape IBM ULT3580-TD4 81BL3T_06 Not loaded 16
tape IBM ULT3580-TD4 81BL3T_07 Not loaded 17
tape IBM ULT3580-TD4 81BL3T_08 Not loaded 18
tape IBM ULT3580-TD4 81BL3T_09 Not loaded 19
tape IBM ULT3580-TD4 81BL3T_10 Not loaded 20
-----------------------------------------------------------------
Type Vendor Model Serial Info ID
_________________________________________________________________
medi DELL DR_L700 NQ9VL5_00 110 100GB 30
tape IBM ULT3580-TD4 NQ9VL5_01 Not loaded 31
tape IBM ULT3580-TD4 NQ9VL5_02 Not loaded 32
tape IBM ULT3580-TD4 NQ9VL5_03 Not loaded 33
tape IBM ULT3580-TD4 NQ9VL5_04 Not loaded 34
tape IBM ULT3580-TD4 NQ9VL5_05 Not loaded 35
tape IBM ULT3580-TD4 NQ9VL5_06 Not loaded 36
tape IBM ULT3580-TD4 NQ9VL5_07 Not loaded 37
tape IBM ULT3580-TD4 NQ9VL5_08 Not loaded 38
tape IBM ULT3580-TD4 NQ9VL5_09 Not loaded 39
tape IBM ULT3580-TD4 NQ9VL5_10 Not loaded 40
Description
This command allows you to create additional tapes for a library specified in the --name option. Each library is initially created with 10 slots housing 60 tape media. Additional tapes can be added to the library as needed using this command. A library can only contain tapes of the same size. For example, if the library was originally created with 60 tapes of size 10G, additional tapes of size 10G can only be added.
Syntax
vtl --update_carts --name <name> --add --no_of_tapes <number>
Where
--name Name of a valid VTL container
--add Add more cartridges to the tape
--no_of_tapes Number of Tapes to be created
Result
Description
This command activates a replica VTL.
Syntax
vtl --activate --name <name> [--force <yes|no>]
Where
--name Name of a valid VTL container
--force Force activation
Result
Enter reserialization code for replica [ 00 (no op), 01 - 99 ]: 00
VTL processes will be started for container, VTL1_Test ...