Associating Storage Policy Copies to a Key Management Server

You can use XML to associate one or more storage policy copies to a key management server.

  1. Use the qlogin command to log on to the CommServe computer.

  2. Download the Associate_Copies_to_KMS.xml file and save it on the computer where the command is run.

  3. The following table displays the parameters you can use with the command.

    Attribute

    Description

    Parent element

    copyName

    The name of the storage policy copy.

    StoragePolicyCopy

    storagePolicyName

    The name of the storage policy.

    StoragePolicyCopy

    keyProviderName

    The name of the key provider.

    A copy is associated with Commvault key management server by default. You can associate the copy to a third-party key management server. You can also change the association from one third-party to another third-party key management server. However, to change the association from a third-party key management server to the default Commvault server, you require an authorization code to perform the operation.

    dataEncryption

    rotateMasterKey

    Used to rotate the master key.

    The value is set to 1 by default. Do not change the value.

    dataEncryption

  4. Execute the following command from the <software_installation_directory>/Base folder after substituting the parameter values.

    qoperation execute -af <downloaded location>\Associate_Copies_to_KMS.xml -copyName xxxxx -storagePolicyName xxxx -keyProviderName xxx

    Example:

    Execute the following command to associate a storage policy copy with name "Copy1" and storage policy "SP1" with the key provider "Safenet":

    qoperation execute -af <downloaded location>\Associate_Copies_to_KMS.xml -copyName Copy1 -storagePolicyName SP1 -keyProviderName Safenet

    Click here to see sample output.

Loading...