Converting a Disk Library to Cloud Library

You can convert a disk library to a cloud library. The following procedure is recommended when you have very large amount of data available on a disk library and/or you may not have sufficient network bandwidth to migrate the entire data to a cloud storage.

However, you can also perform an Auxiliary Copy operation to copy the contents of a disk library to a cloud library if you have sufficient network bandwidth.

Before You Begin

Verify that you have Commvault Software version v11 Service Pack 5 (or higher) installed on the CommServe and MediaAgent computers.
Obtain the necessary credentials for accessing the cloud library.
- Access information may vary depending on the cloud vendor. For a list of required information for each vendor, see the Access Information section in Cloud Storage - Online Help.
- For a list of supported cloud products, see Supported Devices.

Note

Once the mount path is migrated to the cloud library, the mount path status in the cloud library will be marked as Disabled for Write. This means that the data will be read-only and can be used for restore purposes. (This is explained in step 7.)
If you plan to use the mount path for write operations (Backup / Auxiliary Copy) you must create a new mount path. (This is explained in step 9.)

Procedure

Enable the Mark Library Offline for Maintenance check box on the library for maintenance so no read/write operations like backups can use this library.

For more information, see Mark Library Offline for Maintenance.
Disable pruning on the Disk library mount path.

For more information, see Enable or Disable Pruning of Aged Data.
Verify that you have a Cloud Storage license consumed by the MediaAgent to which the cloud library will be attached.

For more information on verifying the licenses, see Managing Commvault Licensing Mechanisms.
- If a license is not consumed by the MediaAgent, create a dummy Cloud Storage library using this MediaAgent . (The dummy library can be deconfigured after the conversion.)
- Disable the mount path on this dummy library to protect accidental write operations on this library.
Using the tool provided by the vendor for copying data, copy the base folder from the mount path location to the cloud storage under the bucket or container.

For example:

If the mount path is D:\DL01\Folder_06.13.2016_16.17, and the bucket or container is MyStorage:

Then copy Folder_06.13.2016_16.17 under MyStorage.

Note

Depending on the size of the data on the disk, the copy operation from disk to cloud may take some time.
From the CommServe computer, open the command prompt and log on to the CommServe using qlogin.
Run the following command to convert the disk library to cloud library:
```
qoperation execscript -sn DiskLibMigration -si <LIBRARY_ALIAS_NAME> -si <DEVICE_TYPE>
```
Where:
- <LIBRARY_ALIAS_NAME> is the name of the disk library.
- <DEVICE_TYPE> is the name of the cloud vendor.
  
  Run the following command to obtain the device type/vendor information.
```
qoperation execscript -sn DiskLibMigration -help
```
Example:
```
qoperation execscript -sn DiskLibMigration -si 'MyMagLib' -si 'MyDevice'
```
From the CommCell Console , navigate to Storage Resources and refresh the Libraries node.
- You will notice that the library icon gets updated from Disk to Cloud.
- To refresh, press the <F5> key or from the CommCell Console ribbon , click the View tab, and then click Refresh.
- The mount path Status is displayed as Ready (Disabled for Write).
Provide the access information for the cloud storage library. For more information, see Modify the Access Information.
- Repeat this step on all the MediaAgents that share this mount path.
- Pruning will be disabled on the converted mount path. To enable pruning, on the mount path, select the Enable pruning of aged data and Enable Micro Pruning options.
  
  For more information, see Enable or Disable Pruning of Aged Data and Configuring Micro Pruning on Cloud Storage.
Create a new mount path in the library for write operations.

For more information on how to create a mount path, see Adding an Additional Mount Path.
Disable the Mark Library Offline for Maintenance check box for the cloud storage library.

For more information, see Mark Library Offline for Maintenance.
Test your setup.
- Run one or more restore jobs.
  
  For more information on performing a Restore, see Restore Backup Data.
- Perform backup that will write to the new mount path.
  
  For more information on performing a Backup, see Backup Overview.