Updating Storage Policy Copy Name and Copy Type

The following table displays the parameters you can use with the commands. To add a parameter to your command, use the following syntax: (A example is provided at the end of the table.)

qoperation execute -af $[template XML file] -$[parameter name] $[value]

Element	Description	Parent Element
newCopyName	To change the name of the storage policy copy	App_UpdateStoragePolicyCopyReq
deferAuxiliaryCopyDays	Number of days to defer Auxiliary Copy operations on the storage policy copy.	storagePolicyCopyInfo
inlineAuxCopy	To convert a storage policy copy into an inline copy.	copyFlags
enableParallelCopy	To enable parallel copy option on the storage policy copy. Valid values are: 1 (enable) and 0 (disable).	copyFlags
wormCopy	Enables WORM copy on the storage policy copy. Valid values are: 1 (enable) and 0 (disable). Once you enable WORM copy option, you cannot disable this option on a storage policy copy.	copyFlags
overRideGACPEncryption	Overrides the encryption settings of the global secondary copy policy and allows to configure different settings for a copy dependent on the global secondary copy policy. Valid values are: 1 (enable) and 0 (disable).	extendedFlags
chunkLevelAuxCopy	If enabled, when an auxiliary copy job is performed during a backup job, the data available on the primary copy is picked for copy by the running auxiliary copy job. This option causes the auxiliary copy operation to create the secondary copy faster. This option saves time for the auxiliary copy operation, especially when the backups running are huge. Valid values are: 1 (enable) and 0. Notes: For this option to work, enable the feature of replication of backup jobs completed during an auxiliary copy operation and specify the time interval to check for completed backup jobs. For instructions, see Enabling Frequent (Timely) Replication of Backup Jobs Completed during an Auxiliary Copy Operation. This option is supported only for synchronous copies. This option is not supported for inline copy, snapshot copy, selective copy and silo copy. This option is not supported for auxiliary copy operations that process Edge backup data. This option is supported only when the source copy is on a disk or a cloud library.	extendedFlags

Procedure

Download the UpdateCopy.xml file and save it on the computer from where the command will be executed.

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

To change the name of a copy:

qoperation execute -af $[download location]\UpdateCopy.xml -storagePolicyName $[SP1] -StoragePolicyCopy/copyname $[Copy1] -newcopyName $[Copy2]

To disable an active copy:

qoperation execute -af $[download location]\UpdateCopy.xml -storagePolicyName $[SP1] -StoragePolicyCopy/copyname $[Copy1] -active $[0]

To enable an inactive copy:

qoperation execute -af $[download location]\UpdateCopy.xml -storagePolicyName $[SP1] -StoragePolicyCopy/copyname $[Copy1] -active $[1]

To enable parallel copy on a storage policy copy:

qoperation execute -af $[download location]\UpdateCopy.xml -storagePolicyName $[SP1] -StoragePolicyCopy/copyname $[Copy1] -enableParallelCopy $[1]

To enable inline copy on a storage policy copy:

qoperation execute -af $[download location]\UpdateCopy.xml -storagePolicyName $[SP1] -StoragePolicyCopy/copyname $[Copy1] -inlineAuxCopy $[1]

To convert the secondary copy into an inline copy Copy1 and prevent a job from being copied when the library of the primary copy is same as the library of the Copy1:

qoperation execute -af $[download location]\UpdateCopy.xml -storagePolicyName $[SP1] -StoragePolicyCopy/copyname $[Copy1] -inlineAuxCopy $[1] -noInlineCopyToSameLibrary $[1]

To defer Auxiliary Copy operation by 3 days:

qoperation execute -af $[download location]\UpdateCopy.xml -storagePolicyName $[SP1] -StoragePolicyCopy/copyname $[Copy1] -deferAuxiliaryCopyDays $[3]

To enable WORM copy on a storage policy copy:

qoperation execute -af $[download location]\UpdateCopy.xml -storagePolicyName $[SP1] -StoragePolicyCopy/copyname $[Copy1] -wormCopy $[1]

To change the source copy on a storage policy copy:

qoperation execute -af $[download location]\UpdateCopy.xml -storagePolicyName $[SP1] -StoragePolicyCopy/copyname $[Copy1] -sourceCopy/copyName $[Copy2]

To enable network optimization for a deduplicated copy:

qoperation execute -af $[download location]\UpdateCopy.xml -storagepolicyname '$[SP1]’ -StoragePolicyCopy/copyname '$[Copy1]' -DedupeFlags/enableClientSideDedup $[0]  -DedupeFlags/enableDASHFull $[1]

To enable read optimization for a deduplicated copy:

qoperation execute -af $[download location]\UpdateCopy.xml -storagepolicyname '$[SP1’] -StoragePolicyCopy/copyname '$[Copy1]' -DedupeFlags/enableClientSideDedup $[1]  -DedupeFlags/enableDASHFull $[0]

To override the encryption settings of the global secondary copy policy and configure different settings for a copy dependent on the global secondary copy policy:
```
qoperation execute -af $[download location]\UpdateCopy.xml -storagepolicyname '$[SP1]’ -StoragePolicyCopy/copyname '$[Copy1]' -overRideGACPEncryption $[1]
```