V11 SP8

Converting Disk Library to Cloud Library

You can convert a disk library to a cloud library using the following steps.

Before You Begin

  • Contact your Software Provider and obtain the authorization code for converting a disk library to a cloud library.
  • 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.


  1. Open CommCell Console and disable the following activities in the CommCell.
    • Data Management
    • Scheduling
    • Activities on the Deduplication Database (DDB)

    For more information on disabling activities, see Enabling or Disabling CommCell Activities.

    For a list of activities that you can control in the CommCell, see List of CommCell Activities.

  2. 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 Traditional License - Monitoring Usage.

    • 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.
  3. Login to the CommServe computer.
  4. Open the command prompt and navigate to the following folder:

    <Software Installation Directory>/Base

  5. Run the following command to log on to the CommServe:

    qlogin -cs <commserve name> -u <user name>

  6. Run the following command to migrate the library:

    qoperation execscript -sn DiskLibMigration -si <LIBRARY_ALIAS_NAME> -si <DEVICE_TYPE> -si <authentication_code>


    • <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

    • <authentication_code> is the authorization code obtained from your Software Provider.

    For example:

    qoperation execscript -sn DiskLibMigration -si 'MagLib1' -si 'Amazon S3' -si 123

  7. 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 should be displayed as Ready (Disabled for Write).
  8. Provide the access information for the cloud storage.

    For more information on modifying the access information for a cloud library, see Modify the Access Information.

    Repeat this step on all the MediaAgents that share this mount path.

  9. Copy the mount-path folder from the current location to cloud storage.

    For example:

    • If the mount path is D:\DL01\Folder_06.13.2016_16.17, and the bucket is amazons3storage
    • Copy Folder_06.13.2016_16.17 under amazons3storage.

    Note: Depending on the size of the data on the disk, the copy operation from disk to cloud may take some time.

  10. Create a new mount path for the library for write operations.

    For more information on how to create a mount path, see Adding an Additional Mount Path.

  11. Test your setup
    • Perform Data Verification job to verify the data.

      For more information on performing a Data Verification, see Data Verification - Getting Started.

    • Run a restore.

      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.