VirtualLibraryTool Utility | 1

©1999-2009 CommVault Systems, Inc. All rights reserved.

CommVault, CommVault and logo, the “CV” logo, CommVault Systems, Solving Forward, SIM,Singular Information Management, Simpana, CommVault Galaxy, Unified Data Management,QiNetix, Quick Recovery, QR, CommNet, GridStor, Vault Tracker, InnerVault, QuickSnap, QSnap,Recovery Director, CommServe, CommCell and ROMS are trademarks or registered trademarks ofCommVault Systems, Inc. All other third party brands, products, service names, trademarks, orregistered service marks are the property of and used to identify the products or services of theirrespective owners. All specifications are subject to change without notice.

CommVault Technical Reference Library

The Information in this Document Is Subject to Change without Notice

VirtualLibraryTool Utility | 1

Contents

Usage Notes

Creating a direct-attached library

Creating and Adding Virtual Tape to a Library

Creating a Shared Tape Library

Creating a Dynamic/SAN Tape library

Creating a Stand-alone Library

Option 1

Option 2

Creating a pooled Stand-alone Library

Exporting Virtual Media

Moving Virtual Media between Library Shelves

Error Simulation

CommVault Technical Reference Library

The Information in this Document Is Subject to Change without Notice

VirtualLibraryTool Utility | 1

Usage Notes

  • The VirtualLibraryTool.exe file is located in the <CommVault Installation directory>\Galaxy\Base directory. Recommend creating a shortcut on the desktopfor the tool.
  • The VirtualLibraryTool can create direct-attached (single MediaAgent), dynamic/SAN (multiple MediaAgents), NDMP, and shared (split between multiple MediaAgent) Tape or Magnetic-Optical libraries.
  • Mixed Media Libraries can be configured by selecting different drive types for each drive or subset of drives.
  • NDMP Library can be created by first using the Library and Drive configuration tool to add a pseudo NDMP server with prefix "#CVNAS” for virtual host name. This NAS server then becomes available in the VirtualLibraryTool to add libraries and drives.
  • Blind Libraries can be configured via the Library & Drive configuration tool by clearing the Barcode reader option.
  • StandAlone libraries can be created via the Library & Drive configuration by creating multi-drive library; selecting un-configured drive; and selecting task option to create standalone library. Multiple standalone libraries can be created and pooled together.
  • Virtual media can be created and manually imported from a “shelf” to a library. Virtual media can be automatically or manually exported back to a shelf. It can also be deleted, or moved to another library shelf.
  • Data send to Virtual tape mediacan optionally be written to disk. Virtual Tapes that are write-enabled will have an 8 character barcode name with a WW suffix. By default, write-enabled Virtual Tapes will save data in the CommVault Installation directory>\Simpana\LibEmulator\Data directory. To change write destination, add the HKLM\SOFTWARE\ CommVault Systems\....\MediaManager\sVirtualTapeDirectory string registry value to the CommServe®host. Set the value’s data to the desired path (e.g. E:\TapeLibrary). A UNC Path can be used if CommVault Communication Service (CVD) User is changed to a domain user with network access. Note that the destination directory must exist. It will not be created.
  • Virtual Disc media for Magnetic-Optical libraries cannot be enabled to write backup data.
  • Virtual tape will hold 4GB compressed. This capacity can be changed by adding the HKLM\SOFTWARE\CommVault Systems\....\MediaManager\sVirtualTapeSizeMB string registry value to the CommServe host. Set the value’s data to the desired tape size in MegaBytes. Keep in mind chunk sizes when adjusting Virtual Tape size.
  • Libraries created by the utility are actually XML files which are saved in the <CommVault Installation directory>\Galaxy\LibEmulator directory. To change directory (e.g. clustered CommServe), add the HKLM\SOFTWARE\ CommVault Systems\....\MediaManager\ sVirtualLibXMLDirectory string registry value to the CommServe host. Set the Value’s data to the desired directory path. It could be the shared File system disk group or network UNC path. If using UNC path, the CommVault Communications (CVD) Service must run the user account with permissions to access the shared resource.Note that the destination directory must exist. It will not be created.

Creating a direct-attached library

1 / Start the VirtualLibraryTool utility.
In the Virtual Library Tool window, right-click on the Libraries object level and select “Add New Library” from the shortcut menu
The Select MediaAgents for Device window will open. /
2 / In the Select MediaAgents for Device window, select the MediaAgent that will control the library.
Click “OK” to close the MediaAgent selection window and open the Library Properties window. /
3 / In the Library Properties window, set the Drive Count, Slot Count, and I/E Port Count values. To emulate a specific vendor library, you can also set the Model and Firmware values.
Base Address values are for advanced use. Do not edit.
When you have set all values click on the “Drive Identifiers” button to open the Drive Identifiers window. /
4 / In the Drive Identifiers window, right-click on any drive and select the “Add Drive Identifier and Drive for All Drives” option.
The Select Drive Type window will open. /
5 / In the Select DriveType window, select one of the following Virtual Drive Types:
OpticalDrive
VirtualDrive
VirtualDrive1
VirtualDriveX1
VirtuaDriveX2
Click “OK” to close the Select Drive Type Window. /
6 / In the Select MediaAgents/NAS Servers for Device window, select the MediaAgent that will control all the drives.
Click “OK” to close the MediaAgent selection window.
Click “OK” to close the Drive Identifier window.
Click “OK” to close the Library Properties Window. /
7 / The newly created library should appear in the Libraries tab of the Virtual Library Tool window
Click on the Drives tab and verify that the number of drives specified for that library are listed.
Both the library and all drives should have a serial number next to their description.
Click “Close” to exit the Virtual Library Tool.
You have successfully created a virtual tape library. /

Creating and Adding Virtual Tape to a Library

1 / Start the VirtualLibraryTool utility.
In the Virtual Library Tool window, right-click on the Libraries object level and select “Element Status” from the shortcut menu
The Element Status window will open. /
2 / In the Element Status window, click on the “Add tapes to Shelf” button.
Enter a Barcode Prefix (optional); a starting barcode number; and the number of virtual tapes to create.
Enable the Write to Hard Drive option if you want to actually save data.
Click “OK” to create the tapes. The tapes will appear in the Shelf window on the right. /
3 / Use the shift key and mouse, highlight the number of tapes in the Shelf window that you want to import.
Drag the selected tapes into the I/E Port window or Slot Addresses.
If importing through the I/E Port window, DO NOT import more tapes then the number of I/E Ports available. /
4 / If planning to export media using I/E Ports, enable the option to “Auto Move Media from I/E Port to Shelf in every ## Seconds. /
5 / Additional media can be added at anytime by repeating the above steps.
Do not duplicate barcodes.
Tapes will move from the I/E ports into library slots within 60 seconds. Click the Refresh button or enable the Auto Refresh option and set the refresh interval. /

Creating a Shared Tape Library (Single Control)

1 / Start the VirtualLibraryTool utility.
In the Virtual Library Tool window, right-click on the Libraries object level and select “Add New Library” from the shortcut menu
The Select MediaAgents for Device window will open. /
2 / In the Select MediaAgents for Device window, there should be at least two MediaAgents. Select the MediaAgent that will control the library.
Click “OK” to close the MediaAgent selection window and open the Library Properties window. /
3 / In the Library Properties window, set the Drive Count, Slot Count, and I/E Port Count values. To emulate a specific vendor library, you can also set the Model and Firmware values.
Base Address values are for advanced use. Do not edit.
When you have set all values click on the “Drive Identifiers” button to open the Drive Identifiers window. /
4 / In the Drive Identifiers window, right-click on first drive and select the “Add New Drive Identifier and New Drive” option.
The Select Drive Type window will open. /
5 / In the Select DriveType window, select one of the following Virtual Drive Types:
OpticalDrive
VirtualDrive
VirtualDrive1
VirtualDriveX1
VirtuaDriveX2
Click “OK” to close the Select Drive Type Window. /
6 / In the Select MediaAgents for Device window, select which one of the available MediaAgents will control that the drive.
Click “OK” to close the MediaAgent selection window
Repeat steps 4 and 5 for each drive, selecting which one of the available MediaAgents will control each drive.
Click “OK” to close the Drive Identifier window.
Click “OK” to close the Library Properties Window. /
7 / The newly created library should appear in the Libraries tab of the Virtual Library Tool window.
Click on the Drives tab and verify that the number of drives specified for that library are listed.
Both the library and all drives should have a serial number next to their description.
Click “Close” to exit the Virtual Library Tool.
You have successfully created a shared virtual tape library. /

Creating a Dynamic/SAN Tape library

  1. Follow all steps in the procedure for creating a direct-attached library except select all Media Agents that will see the library and all the Media Agents that will see the drives.

Creating a Stand-alone Library

Option 1

  1. Follow all steps in the procedure for creating a direct-attached library. The Library should have at least 2 drives plus as many drives as you expect to make stand-alone libraries. Create media. Virtual stand-alone libraries must be manually loaded with a virtual tape.
  2. In the Library & Drive Config tool, right-click on a drive of the newly created library and select “Create Stand-alone Library”. Note that you can create many stand-alone libraries in this manner. However, there must be at least two drives left in the source library.
  3. If you intend to pool the stand-alone libraries, do not configure them at this point.
  4. Right-click on the library and configure the library and all drives.

Option 2

  1. Follow all steps in the procedure for creating a direct-attached library. The Library should have 1 drive – no slots and no import/export mail slots. You do not need to create media. Virtual stand-alone libraries will be automatically loaded with a virtual tape.
  2. Using notepad, open the LibEmulator/<library>.xml file. Look for the tag <ScsiDeviceType>8</ScsiDeviceType>. Change the 8 to a 4 and save the file.
  3. In the Library & Drive Config tool, discover the new stand-alone library. Right-click on the library and configure the library and all drives.

Creating a pooled Stand-alone Library

  1. See Creating a Stand-alone Library to create multiple stand-alone libraries.
  2. If you used option 1 to create stand-alone libraries, use one un-configured stand-alone library as the target and drag the drive pool from each of the other un-configured stand-alone library into the target. Right-click and configure
  3. If you used option 2 to create stand-alone libraries, detecting the standalone libraries should automatically pool them.

Exporting Virtual Media

  1. You can export virtual tapes using the standard export tasks or you can export using VaultTracker. In either case, the VirtualLibraryTool must be running.
  2. If you have enabled the option to “Auto Move Media from I/E Port to Shelf in every ## Seconds, exported Media will appear in the I/E port or, if using Virtual Mail slots, they will appear in the designated virtual mail slot(s) and range. IMPORTANT. The Element Status window must remain open for this to work.
  3. To manually export virtual media, open the VirtualLibraryTool; right-click on the library in question, and select “Element Status”
  4. Locate the exported media; highlight; and drag to the shelf. The changed status will be reflected back to the CommCell® Console within 60 seconds

Moving Virtual Media between Library Shelves

  1. You can move virtual tapes from one library shelf to another.
  2. Open the VirtualLibraryTool; right-click on the source library and select “Element Status”
  3. Select tapes on the shelf and drag them down to the Library Icon (cube shape icon next to Refresh button)
  4. In the Select Library window that appears, select the target library. Click “OK”.
  5. Close the Element status window; right-click on the target library; and select “Element Status”. Move the tapes from the shelf into the destination library slots or I/E Ports.

Error Simulation

One of the primary purposes of the VirtualLibraryTool is for product testing. As such, an ability to simulate errors has been included. Adding the following DWORD registry values on the MediaAgent host under the HKLM\SOFTWARE\ CommVault Systems\....\MediaAgent Registry Key will generate the corresponding error:

nVirtualLibraryMoveErrorFrequency - moving count per LibHandler on the MediaAgent

nVirtualLibraryMoveDelaySecond - delay for moving medium in seconds

nVirtualTapeLoadErrorFrequency - loading count for the tape drives on the MediaAgent

nVirtualTapeUnloadErrorFrequency - unloading count for the tape drives on the MediaAgent

nVirtualTapeCRCErrorFrequency - read/write count for the tape drives on the MediaAgent

nVirtualTapeCleaningFrequency - loading count for the tape drives on the MediaAgent

nVirtualTapeLoadDelaySecond - delay for loading tape in seconds

nVirtualTapeSeekDelaySecond - delay for rewinding/forwarding tape in seconds

CommVault Technical Reference Library

The Information in this Document Is Subject to Change without Notice