You can use XML to associate one or more storage policy copies to a key management server.
-
Use the qlogin command to log on to the CommServe computer.
-
Download the Associate_Copies_to_KMS.xml file and save it on the computer where the command is run.
-
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
-
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.