Updating Properties of a Storage Policy Copy Using XML Files

Table of Contents

Overview

Once you create a storage policy copy, you can change its properties at any time. You can use following XML files to edit the properties of a storage policy copy:

  • UpdateCopy.xml -  Use this XML to edit name and type of a copy.
  • PromoteToPrimary.xml - Use this XML for making a copy as a primary copy.
  • Update_BasicRetention.xml - Use this XML for updating basic retention rules on copy.
  • Update_extendedRetention.xml - Use this XML for updating extended retention rules on copy.
  • Updatecopy_media.xml - Use this XML for editing Media related of a copy.
  • Update_DataPath.xml - Use this XML to add or delete alternate data paths for the copy.
  • Update_DataPathConfig.xml - Use this XML to specify the conditions for using an alternate data path for the copy.
  • Update_Advanced.xml - Use this XML to modify the data verification or data encryption options on the copy.
  • Update_AuxFallenBehindAlert.xml - Use this XML to modify the Auxiliary Copy fallen behind alert options on the copy.
  • Update_DDB_Settings.xml - Use this XML to modify the deduplication settings on the copy.
  • Update_SiloOptions.xml - Use this XML to modify the silo options on the copy.
  • Update_Selective.xml - Use this XML to modify the selective copy criteria on the copy.
  • Update_Provisioning - Use this XML to modify the provisioning to be used for Vault or Mirror storage provisioning.
  • client_software_compression.xml - Use this XML to enable or disable software compression on the clients.

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

Updating Name and Copy Type

  1. Download the UpdateCopy.xml file and save it on the computer from where the command will be executed.
  2. 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 -copyName Copy1 -newcopyName Copy2

    • To enable parallel copy on a storage policy copy.

      qoperation execute -af <download location>\UpdateCopy.xml -storagePolicyName SP1 -copyName Copy1 -enableParallelCopy 1

    • To enable inline copy on a storage policy copy.

      qoperation execute -af <download location>\UpdateCopy.xml -storagePolicyName SP1 -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 -copyName Copy1 -inlineAuxCopy 1 -noInlineCopyToSameLibrary 1

    • To defer Auxiliary Copy operation by 3 days.

      qoperation execute -af <downloaded location>\UpdateCopy.xml -storagePolicyName SP1 -copyName Copy1 -deferAuxiliaryCopyDays 3

    • To enable WORM copy on a storage policy copy.

      qoperation execute -af <downloaded location>\UpdateCopy.xml -storagePolicyName xxxx -copyName xxxx -wormCopy 1

    • To change the source copy on a storage policy copy.

      qoperation execute -af <download location>\UpdateCopy.xml -storagePolicyName SP1 -copyName Copy1 -sourceCopy/copyName Copy2

Enabling or Disabling Software Compression on Client

This option is applicable only for non-deduplicated primary copy.

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

Element Description Parent Element
compressionOnClients To enable or disable software compression on clients.
Valid values are:
0 (disable)
1 (enable)
2 (do not change)
extendedFlags

 

  1. Download the client_software_compression.xml file and save it on the computer from where the command will be executed.
  2. Execute the following command from the <software_installation_directory>/Base folder after substituting the parameter values.

    qoperation execute -af <download location>\client_software_compression.xml -storagePolicyName XXXX -copyName XXXX -compressionOnClients XX

    Example

    To enable software compression on a primary copy Copy1 associated to storage policy SP1.

    qoperation execute -af <download location>\client_software_compression.xml -storagePolicyName SP1 -copyName Copy1 -compressionOnClients 1

Promote the Synchronous Copy to the Primary Copy

  1. Download the PromoteToPrimary.xml file and save it on the computer from where the command will be executed.
  2. Execute the following command from the <software_installation_directory>/Base folder.

    qoperation execute -af<download location>\PromoteToPrimary.xml -storagePolicyName SP1 -copyName Copy1

    Once the selected copy is promoted as primary copy, the subsequent backup jobs of all the subclients associated to this storage policy are automatically converted to Full backup.

Updating Basic Data Retention Rules for a Copy

The following table displays the parameters you can use with the commands.

Element Description Parent Element
retainBackupDataForCycles Number of cycles to retain the data of the copy. retentionRules
retainBackupDataForDays Number of days to retain the data of the copy. retentionRules
retainArchiverDataForDays Number of days to retain the Archiver data of the copy. retentionRules
enableDataAging To enable or disable data aging on a storage policy copy.

Once disabled the data on the copy is retained for infinite time.

Valid values are: 1 (enable) and 0 (disable).

retentionFlags

You can set retention rules to specify the criteria for retaining backup data in a copy. Based on the type of backup and the security requirements of the organization, you can set different criteria for data retention.

Do not use the Update_BasicRetention.xml file to modify the retention for SnapMirror copy.

  1. Download the Update_BasicRetention.xml file and save it on the computer from where the command will be executed.
  2. Execute the following command from the <software_installation_directory>/Base folder after substituting the parameter values.
    • To disable data aging.

      qoperation execute -af<download location>\Update_BasicRetention.xml -storagePolicyName SP1 -libraryName Lib1 -mediaAgentName MA1 -copyName Copy1 -enableDataAging 0

    • To retain backup data for 10 cycles.

      qoperation execute -af <downloaded location>\Update_BasicRetention.xml -storagePolicyName SP1 -libraryName Lib1 -mediaAgentName MA1 -retainArchiverDataForDays 5 -retainBackupDataForCycles 10 -retainBackupDataForDays 5 -copyName Copy1

    • To retain backup data for 5 days.

      qoperation execute -af <downloaded location>\Update_BasicRetention.xml -storagePolicyName SP1 -libraryName Lib1 -mediaAgentName MA1 -retainArchiverDataForDays 5 -retainBackupDataForCycles 10 -retainBackupDataForDays 5 -copyName Copy1

    • To retain archiver data for 5 days.

      qoperation execute -af <downloaded location>\Update_BasicRetention.xml -storagePolicyName SP1 -libraryName Lib1 -mediaAgentName MA1 -retainArchiverDataForDays 5 -retainBackupDataForCycles 10 -retainBackupDataForDays 5 -copyName Copy1

Updating Extended Data Retention Rules on a Storage Policy Copy

The following table displays the extended data retention rule parameters you can use with the commands.

Element Description Parent Element
extendedRetentionFirst Number of cycles to retain the data of the copy. retentionFlags
enableDataAging To enable or disable data aging on the copy. When disable the data on the copy is retained for infinite period. retentionFlags
enableManagedDiskSpace To enable managed disk space option on the storage policy copy.

This option allows the free disk space on the disk media of the storage policy copy to be considered before the data on the copy is aged.

retentionFlags
selectJobsFromPreviousTier The option to select the full backup job that is designated to be retained within the previous tier's timetable. For example, if two rules are defined as weekly and monthly, this option will allow the job retained for the monthly tier to be selected from the timetable of the weekly tier. Note this option is only enabled when there are two rules defined for extended retention.

Valid values are: 1 (enable) and 0 (disable).

retentionFlags
retainFullAndLastDifferential Enable this parameter if you do not want to retain intermediate incremental and differential copies preceding a new differential. This is useful to minimize wasted disk space.

Valid values are: 1 (enable) and 0 (disable).

retentionFlags
jobBasedRetention Job based retention criteria for Snap Vault or Snap Mirror copies. retentionFlags
endDays Use this parameter to specify number of days to retain a backup data in a copy.

This parameters enable extended retention for a copy.

If you want to enable more than one rule for extended retention, ensure that the values in rules are specified in the ascending order.

endDays for extendedRetentionRuleOne < endDays for extendedRetentionRuleTwo < endDays for extendedRetentionRuleThree

extendedRetentionRuleOne

extendedRetentionRuleTwo

extendedRetentionRuleOne

graceDays Specify number of grace period. We recommend you to define the following values in the grace days parameter:
  • For EXTENDED_ALLFULL rule set the value to 0.
  • For EXTENDED_WEEK rule set between 0 - 3
  • For EXTENDED_MONTH rule set between 0 - 7
  • For EXTENDED_QUARTER rule set between 0 - 15
  • For EXTENDED_HALFYEAR rule set between 0 - 30
  • For EXTENDED_YEAR rule set between 0 -  45
extendedRetentionRuleOne

extendedRetentionRuleTwo

extendedRetentionRuleOne

isEnabled Use this parameter, to enable/disable extended retention for a copy. Valid values are:
  • 0 - Use this value to disable the parameter.
  • 1 - Use this value to enable the parameter.
  • 2 - Use this value if you do not want to change the configuration of the parameter. If the parameter is disabled, it remains disabled. If the parameter is enabled, it remains enabled.
extendedRetentionRuleOne

extendedRetentionRuleTwo

extendedRetentionRuleOne

rule Use this parameter to specify extended rule for a copy. Valid values are:
  • EXTENDED_ALLFULL, to specify extended retention rule for all full backups
  • EXTENDED_WEEK, to specify extended retention rule for weekly full backups
  • EXTENDED_MONTH, to specify extended retention rule for monthly full backups
  • EXTENDED_QUARTER, to specify extended retention rule for quarterly full backups
  • EXTENDED_HALFYEAR, to specify extended retention rule for half yearly full backups
  • EXTENDED_YEAR, to specify extended retention rule for yearly full backups
extendedRetentionRuleOne

extendedRetentionRuleTwo

extendedRetentionRuleOne

  1. Download the Update_extendedRetention.xml file and save it on the computer from where the command will be executed.
  2. Execute the following command from the <software_installation_directory>/Base folder after substituting the parameter values.

    Examples

    • To retain all full backups for 90 days.

      qoperation execute -af <download location>\Update_extendedRetention.xml -storagePolicyName 'SP1' -copyName 'Copy1' -extendedRetentionRuleOne/isenabled 1 -extendedRetentionRuleOne/endDays 90 -extendedRetentionRuleOne/graceDays 0 -extendedRetentionRuleOne/rule 'EXTENDED_ALLFULL'

    • To retain weekly full backups for 30 days and monthly full backups for 90 days.

      qoperation execute -af <download location>\Update_extendedRetention.xml -storagePolicyName 'SP1' -copyName 'Copy1' -extendedRetentionRuleOne/isenabled 1 -extendedRetentionRuleOne/endDays 30 -extendedRetentionRuleOne/graceDays 0 -extendedRetentionRuleOne/rule 'EXTENDED_WEEK' -extendedRetentionRuleTwo/endDays 90 -extendedRetentionRuleTwo/graceDays 0 -extendedRetentionRuleTwo/rule 'EXTENDED_MONTH'

Updating Media Configurations of a Copy

The following table displays the media configuration parameters you can use with the commands.

Element Description Parent Element
numberOfStreamsToCombine Specify the number to which all the source streams are combined.

For example : If one stream is specified, then the auxiliary copy operation will copy the data from all streams to one data stream.

storagePolicyCopyInfo
multiplexSourceStreams To concurrently run auxiliary copy operation of multiple data streams to the same media. copyFlags
combineStreams To enable combining source data streams during an auxiliary copy operation. copyFlags
markMediaToBeErasedAfterRecycling Enable this parameter for the storage policy copy using removable media (tape media), the media will be marked for erase, when the media is recycled. copyFlags
noAuxCopyToSameLibrary To prevent a job from being copied when the library of the source copy is same as the library of the secondary copy. copyFlags
useStreamsOverMultiplexing If enabled, the data streams are copied to each available drives first and then fills up the used up drives (spill and fill). If disabled, all the data streams are copied to one drive and once it is filled up, moves to the next drive (fill and spill).

Valid values are: 1 (enable) and 0 (disable).

copyFlags
multiplexingFactor To specify how many  data streams from this storage policy copy are to be copied concurrently to the same media. mediaProperties
  1. Download the Updatecopy_media.xml file and save it on the computer from where the command will be executed.
  2. Execute the following command from the <software_installation_directory>/Base folder after substituting the parameter values.

    Examples

    To combine data from all the source streams to 5 streams during the auxiliary copy operation for Copy1.

    qoperation execute -af <download location>\Updatecopy_media.xml -storagePolicyName SP1 -copyName Copy1 -combineStreams 1 -numberOfStreamsToCombine 5

    To enable multiplexing for Copy1.

    qoperation execute -af<download location>\Updatecopy_media.xml -storagePolicyName SP1 -copyName Copy1 -multiplexSourceStreams 1 -multiplexingfactor 5

    To prevent a job from being copied when the library of the source copy is same as the library of the Copy1.

    qoperation execute -af <download location>\sp_copycreation.xml -storagePolicyName SP1 -libraryName Lib1 -mediaAgentName MA1 -copyName Copy1 -noAuxCopyToSameLibrary 1

    To mark media of Copy1 for erase after recycling the media.

    qoperation execute -af <download location>\Updatecopy_media.xml -storagePolicyName SP1 -copyName Copy1 -markMediaToBeErasedAfterRecycling 1

Updating Alternate Data Paths for a Copy

The following table displays all the parameters you can use with the commands.

Element Description Parent Element
addDataPath To add an alternate data path for a storage policy copy.

Valid values are: 1 (enable) and 0 (disable).

operationFlags
enableDataPath To enable a data path for a storage policy copy.

Valid values are: 1 (enable) and 0 (disable).

operationFlags
removeDataPath To delete a data path for a storage policy copy.

Valid values are: 1 (enable) and 0 (disable).

operationFlags
disableDataPath To disable data path.

Valid values are: 1 (enable) and 0 (disable).

operationFlags
setDefault To update the default data path for a storage policy copy.

Valid values are: 1 (enable) and 0 (disable).

operationFlags
setScratchPool To specify scratch pool for a data path.

Valid values are: 1 (enable) and 0 (disable).

operationFlags
modifyDataPathProperties To modify data path properties.

Valid values are: 1 (enable) and 0 (disable).

operationFlags
libraryName Library name to be used as data path on a storage policy copy. library
mediaAgentName MediaAgent name to be used as data path on a storage policy copy. mediaAgent
drivePoolName Specify the drive pool name for a tape library. drivePool
chunksizeMB To change the chunk size(MB) of a data path dataPathProperties
flushBlockSizeKB To change the block size(KB) of a data path dataPathProperties
useHardwareCompression To enable or disable hardware compression on data path. Valid values are: 1 (enable) and 0 (disable) dataPathProperties
useHardwareEncryption To enable or disable hardware encryption on a data path. Valid values are:
  • NONE or 0 - Use this value to disable hardware encryption
  • 1 - Use this value to enable hardware encryption and store scrambled encryption keys on the media (Via Media Password).
  • 2 - Use this value to enable hardware encryption and not store encryption keys on the media (No Access).
dataPathProperties
scratchPoolName The scratch pool name for the tape library. scratchPool
  1. Download the Update_DataPath.xml file and save it on the computer from where the command will be executed.
  2. Execute the following command from the <software_installation_directory>/Base folder after substituting the parameter values.

    qoperation execute -af <download location>\Update_DataPath.xml

Specify Conditions for Using an Alternate Data Path

The following table displays all the parameters you can use with the commands.

Element Description Parent Element
switchIfOffline To use an alternate data path when resources are  offline. copyFlags
switchIfBusy To use an alternate data path when resources are busy. copyFlags
roundRobbinDataPath Enable to automatically load balance between all the available data paths.

If the client and MediaAgent are on the same computer, you can perform LAN free operations. In such scenario, you must set all the following parameters to 0:

  • switchIfBusy
  • switchIfOffline
  • roundRobbinDataPath
copyFlags
hours/minutes You can use alternate data path when resources in default data path are busy.

Specify the time period (hours and minutes) for which you want to wait before using the alternate data path.

resourcesOfflineWaitTimeInHoursMinutes
hours/minutes You can use alternate data path when resources in default data path are offline.

Specify the time period (hours and minutes) for which you want to wait before using the alternate data path.

resourcesBusyWaitTimeInHoursMinutes
  1. Download the Update_DataPathConfig.xml file and save it on the computer from where the command will be executed.
  2. Execute the following command from the <software_installation_directory>/Base folder after substituting the parameter values.

    Example

    • To use an alternate data path for a copy Copy1, immediately when the resources are busy.

      qoperation execute -af <download location>\Update_DataPathConfig.xml -copyName Copy1 -storagePolicyName SP01 -switchIfBusy 1 -resourcesBusyWaitTimeInHoursMinutes/hours 0 resourcesBusyWaitTimeInHoursMinutes/minutes 0

      If you want to wait for two hours when the resources are busy and then use an alternate data path for a copy Copy1.

      qoperation execute -af <download location>\Update_DataPathConfig.xml -copyName Copy1 -storagePolicyName SP01 -switchIfBusy 1 -resourcesBusyWaitTimeInHoursMinutes/hours 2 resourcesBusyWaitTimeInHoursMinutes/minutes 0

    • To use an alternate data path for a copy Copy1, immediately when the resources are offline.

      qoperation execute -af <download location>\Update_DataPathConfig.xml -copyName Copy1 -storagePolicyName SP01 -switchIfOffline 1 -resourcesOfflineWaitTimeInHoursMinutes/hours 0 resourcesOfflineWaitTimeInHoursMinutes/minutes 0

      If you want to wait for two hours when the resources are busy and then use an alternate data path for a copy Copy1.

      qoperation execute -af <download location>\Update_DataPathConfig.xml -copyName Copy1 -storagePolicyName SP01 -switchIfOffline 1 -resourcesOfflineWaitTimeInHoursMinutes/hours 2 resourcesOfflineWaitTimeInHoursMinutes/minutes 0

    • To automatically load balance between all the available data paths for a copy Copy1.

      qoperation execute -af <download location>\Update_DataPathConfig.xml -copyName Copy1 -storagePolicyName SP01 -roundRobbinDataPath 1

      To perform auxiliary copy operation using the LAN free data path, execute the following command:

      qoperation execute -af <download location>\Update_DataPathConfig.xml -copyName Copy1 -storagePolicyName SP01 -roundRobbinDataPath 0 -switchIfOffline 0 -switchIfBusy 0

Updating Data Verification Options

The following table displays data verification parameters you can use with the commands.

Element Description Parent Element
throttleNetworkBandWidthMBHR Enhancing backup performance by reducing network bandwidth overhead.

Valid values are 1 - no limit.

storagePolicyCopyInfo
allJobs All backup jobs on the storage policy copy are verified when a data verification operation is run.

Valid values are: 1 (enable) and 0 (disable).

dataVerification
allFullJobs All FULL backup jobs on the storage policy copy are verified when a data verification operation is run.

Valid values are: 1 (enable) and 0 (disable).

dataVerification
verificationExpiresAfterMonths The number of months for which the data verification is valid.

Valid values are: Number of months.

dataVerification
timeValue The backup data after the specified date is verified on the storage policy copy when a data verification operation is run.

Valid values are: yyyy-mm-dd.

jobsOnOrAfterDate
  1. Download the update_Advanced.xml file and save it on the computer from where the command will be executed.
  2. Execute the following command from the <software_installation_directory>/Base folder after substituting the parameter values.

    Example

    • To verify all jobs on a storage policy copy.

      qoperation execute -af <download location>\update_Advanced.xml -copyName Copy1 -storagePolicyName SP01 -archiveCheckAll 1 -allJobs 1

    • To verify all Full jobs on a storage policy copy.

      qoperation execute -af <download location>\update_Advanced.xml -copyName Copy1 -storagePolicyName SP01 -archiveCheckFull 1 -allFullJobs 1

    • If you have All Jobs option enabled and you want to set All Full Jobs option on the storage policy copy properties.

      qoperation execute -af <download location>\update_Advanced.xml -copyName Copy1 -storagePolicyName SP01 -archiveCheckFull 1 -allFullJobs 1 -archiveCheckAll 0 -allJobs 0

    • To verify the jobs that ran after a specific date.

      qoperation execute -af <download location>\update_Advanced.xml -copyName Copy1 -storagePolicyName SP01 -verificationExpiresAfterMonths 2014-01-01

    • To update the network bandwidth per stream value as 600 MB/HR.

      qoperation execute -af <download location>\update_Advanced.xml -copyName Copy1 -storagePolicyName SP01 -throttleNetworkBandWidthMBHR 600

Updating Data Encryption Options

The following table displays data encryption parameters you can use with the commands.

Element Description Parent Element
encryptData Enables data encryption options on the storage policy copy.

Valid values are: 1 (enable) and 0 (disable).

dataEncryption
encryptionType The cipher to use for data encryption. Valid values are:

AES / BLOWFISH / DES3 / GOST / SERPENT / TWOFISH

Values for encryptionType element are case-sensitive.

dataEncryption
encryptionKeyLength The key length to use with the cipher in the CipherType parameter. Valid values are:
  • 3-DES cipher
  • 192

AES (Rijndael), Blowfish, Serpent, and TwoFish ciphers

  • 128
  • 256
dataEncryption
reEncryptDataUsingCipher Re-encrypts the data using cipher.

Valid values are: 1 (enable) and 0 (disable).

dataEncryption
viaMediaPassword To enable direct media access via media password option.

Valid values are: 1 (enable) and 0 (disable).

dataEncryption
  1. Download the update_Advanced.xml file and save it on the computer from where the command will be executed.
  2. Execute the following command from the <software_installation_directory>/Base folder after substituting the parameter values.

    Example

    • To enable encryption with default cipher (BlowFish) and key length (128).

      qoperation execute -af <download location>\update_Advanced.xml -copyName Copy1 -storagePolicyName SP01 -encryptData 1 -encryptionType -encryptionKeyLength

    • To enable encryption with Via Media Password option.

      qoperation execute -af <download location>\update_Advanced.xml -copyName Copy1 -storagePolicyName SP01 -encryptData 1 -encryptionType -encryptionKeyLength -storeKeyOnMedia 1 -viaMediaPassword 1

    • To update encryption type to GOST.

      qoperation execute -af <download location>\update_Advanced.xml -copyName Copy1 -storagePolicyName SP01 -encryptionType GOST

Update Auxiliary Copy Fallen Behind Alert Options

The following table displays Auxiliary Copy fallen behind alert parameters you can use with the commands.

Element Description
enableAuxCopyFallenBehindAlert To enable Auxiliary Copy fallen behind alert option on the storage policy copy.

Valid values are: 1 (enable) and 0 (disable).

enableToBeCopiedDataTB To enable to be copied data over n TB option on the storage policy copy. When enabled an alert is generated when the data to be copied for this storage policy copy exceeds the specified threshold.

Valid values are: 1 (enable) and 0 (disable).

toBeCopiedDataTB The option to set the size in terabyte for to be copied data option.

Use this parameter when enableToBeCopiedDataTB is enabled.

enableDaysOldJobs To enable Jobs are not copied over n days option on the storage policy copy.

When enabled an alert is generated if the number of days that the jobs have not been copied exceeds the specified number of days.

Valid values are: 1 (enable) and 0 (disable).

daysOldJobs The option to set number of days for Jobs are not copied over n days option.

Use this parameter when enableDaysOldJobs is enabled.

enableHoursToCopyData To enable More than n hours required to copy all data option on the storage policy copy.

When enabled an alert is generated if the system predicts that the Auxiliary Copy operation exceeds the number of hours specified.

Valid values are: 1 (enable) and 0 (disable).

hoursToCopyData The option to set number of hours for More than n hours required to copy all data option.

Use this parameter when enableHoursToCopyData is enabled.

  1. Download the update_AuxFallenBehindAlert.xml file and save it on the computer from where the command will be executed.
  2. Execute the following command from the <software_installation_directory>/Base folder after substituting the parameter values.

    Example

    • To enable Auxiliary Copy Fallen Behind Alert option.

      qoperation execute -af <download location>\update_AuxFallenBehindAlert.xml -copyName Copy1 -storagePolicyName SP01 -enableAuxCopyFallenBehindAlert 1

    • To generate an alert when the data to be copied for this storage policy copy exceeds 100 TB.

      qoperation execute -af <download location>\update_AuxFallenBehindAlert.xml -copyName Copy1 -storagePolicyName SP01 -enableAuxCopyFallenBehindAlert 1 -enableToBeCopiedDataTB 1 -toBeCopiedDataTB 100

    • To generate an alert when the number of days that the jobs have not been copied exceeds the 10 days.

      qoperation execute -af <download location>\update_AuxFallenBehindAlert.xml -copyName Copy1 -storagePolicyName SP01 -enableAuxCopyFallenBehindAlert 1 -enableDaysOldJobs 1 daysOldJobs 10

    • To generate an alert if the system predicts that the Auxiliary Copy operation exceeds the 15 hours.

      qoperation execute -af <download location>\update_AuxFallenBehindAlert.xml -copyName Copy1 -storagePolicyName SP01 -enableAuxCopyFallenBehindAlert 1 -enableHoursToCopyData 1 -hoursToCopyData 15

Modifying Deduplication Options

The following table displays deduplication parameters you can use with the commands.

Element Description Parent Element
copyName Name of the storage policy copy. StoragePolicyCopy
storagePolicyName Name of the storage policy. StoragePolicyCopy
useDDBPrimingOption Use this parameter if you want to refer previously sealed DDBs to identify and use existing data blocks to prime the baseline for the current DDB. dedupeFlags
temporarilyDisableDeduplication Option to temporarily suspend deduplication. Valid values are: 1 (enable) and 0 (disable). dedupeFlags
enableClientSideDedup Option to enable Source-Side deduplication. Valid values are: 1 (enable) and 0 (disable). dedupeFlags
backupSiloEnabled Option to enable creation of Silo copy. Valid values are: 1 (enable) and 0 (disable). dedupeFlags
isSilosToBeKeptInCache Enables number of silos to be kept in the cache option on the Silo copy. Valid values are: 1 (enable) and 0 (disable). dedupeFlags
enableDASHFull Reduce CPU and disk I/O usage by using Accelerated Synthetic Full (DASH Full). Valid values are: 1 (enable) and 0 (disable). dedupeFlags
enableSiloDiskSpaceManagement Option to enable Silo space management on the disk media. Valid values are: 1 (enable) and 0 (disable). dedupeFlags
pauseAndRecoverCurrentDDB Option to recover an offline DDB by manually reconstructing the DDB. If an offline active DDB is detected, all jobs on that copy are paused until the DDB is manually reconstructed. Valid values are: 1 (enable) and 0 (disable). dedupeFlags
automaticallyPauseAndRecoverDDB Option to automatically restore the DDB from the last completed DDB backup which was backed up using DDB subclient.

Valid values are: 1 (enable) and 0 (disable).

dedupeFlags
createNewDDBeveryXdays To create a new DDB based on the time interval in days. createNewDDBOptions
days Provide the interval in number of days. createNewDDBOptions
createNewDDBeveryXtb To create a new DDB based on the disk volume. createNewDDBOptions
tb Provide the volume size in TB createNewDDBOptions
createNewDDBeveryXmonths To create a new DDB based on the time interval in months. createNewDDBOptions
months Provide the interval in months. createNewDDBOptions
timeValue Provide starting date for DDB creation. startingFromDate
mediaAgentName Name of the MediaAgent where deduplication database is located. <DDBPartitionInfo> / <maInfoList> / <mediaAgent>
diskFreeThresholdMB The total amount of free space that must be available at all times in the volume in which the DDB is configured. subStoreList
diskFreeWarningThreshholdMB The amount of free space in the volume in which the DDB is configured at which a warning must be generated. If the amount of free space falls below the specified amount, the system generates an event message and generates the MediaAgents (Disk Space Low) alert, if configured. subStoreList
path DDB Location on a MediaAgent. accessPath
mediaAgentName MediaAgent name hosting the DDB. mediaAgent
copyName Name of the silo copy. sidbStoreInfo
enableNumberOfSilosToBeKeptInCache Use this parameter to enable number of silos to be maintained in the local cache. sidbStoreInfo
numberOfSilosToBeKeptInCache Number of recently moved silos to be maintained in the local system cache. sidbStoreInfo
enableSoftwareCompression Use this parameter to enable software compression for a copy. sidbStoreFlags
  1. Download the Update_DDB_Settings.xml file and save it on the computer from where the command will be executed.
  2. Execute the following command from the software_installation_directory/Base folder after substituting the parameter values.

    Example

    • To create a new DDB when the DDB size reaches to 100 TB.

      qoperation execute -af <download location>\Update_DDB_Settings.xml -copyName Copy1 -storagePolicyName SP01 -createNewDDBeveryXtb 1 -tb 100

    • To temporarily disable deduplication.

      qoperation execute -af <download location>\Update_DDB_Settings.xml -copyName Copy1 -storagePolicyName SP01 -temporarilyDisableDeduplication 1

    • To set a 10 GB as minimum free space such that an event message is generated when the free space of a DDB volume falls below the specified space requirement.

      qoperation execute -af <download location>\Update_DDB_Settings.xml -copyName Copy1 -storagePolicyName SP01 -diskFreeWarningThreshholdMB 10

Updating Silo Options

The following table displays silo parameters.

Element Description
isSilosToBeKeptInCache Enables number of silos to be kept in the cache option on the Silo copy.

Valid values are: 1 (enable) and 0 (disable).

enableSiloDiskSpaceManagement Use this parameter to enable Silo space management on the disk media.

Valid values are: 1 (enable) and 0 (disable).

  1. Download the Update_SiloOptions.xml file and save it on the computer from where the command will be executed.
  2. Execute the following commands from the software_installation_directory/Base folder after substituting the parameter values.

    qoperation execute -af <download location>\Update_SiloOptions.xml -storagePolicyName xxx -copyName xxx

Updating Selective Copy Options

The following table displays selective copy parameters.

Element Description Parent Element
storagePolicyName Name of the storage policy StoragePolicyCopy
copyName Name of the storage policy copy. StoragePolicyCopy
selectiveRule Option to specify selective copy rules. Valid values are:
  • SELECTIVE_ALLFULL
  • SELECTIVE_DAY
  • SELECTIVE_WEEK
  • SELECTIVE_MONTH
  • SELECTIVE_QUARTER
  • SELECTIVE_HALFYEAR
  • SELECTIVE_YEAR
  • SELECTIVE_ADVANCED
selectiveCopyRules
weekDayStartsOn Specify the starting day of the week in which data is eligible to be copied to the selective copy for Weekly Full rule.

Valid values are: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday or Sunday.

selectiveCopyRules
monthStartsOn Specify the starting day of the month data is to be copied to the selective copy for a monthly full rule.

Valid values are: 1 - 31.

selectiveCopyRules
everyXCycles Specify that the full backup after the specified number of cycles to be picked to copy. selectiveCopyRules
everyXHours Specify that the full backup after the specified number of hours to be picked to copy. selectiveCopyRules
everyXDays Specify that the full backup after the specified number of days to be picked to copy. selectiveCopyRules
everyXWeeks Specify that the full backup after the specified number of weeks will be picked to copy. selectiveCopyRules
everyXMonths Specify that the full backup after the specified number of months will be picked to copy. selectiveCopyRules
lastFull Option to specify that the last full backup of the selected time period will be copied from the source copy to this copy. copyFlags
lastFullWait Option to specify that the last full backup after the end of the specified time period will be copied from the source copy to this copy. copyFlags
doNotAutomaticallySelectJobs Option to disable automatic selection of jobs to copy. When enabled no backups will be copied to the storage policy copy selectiveCopyRules
moveJobSelectionStartTime Option to modify the starting time of the selection period. selectiveCopyRules

Refer to the following table for valid values

Selective Copy Type Valid Values
First full backup lastFull = 0, lastFullWait = 0
Last full backup with most recent job if there are no more full backup schedules in current time period lastFull = 1, lastFullWait =0
Last full backup and wait until the current period is over before selecting a backup for this time period lastFull = 1, lastFullWait =1

Examples

  • To update the selective copy with the first full backup for the week.

    qoperation execute -af <download location>\Update_Selective.xml -lastfull 0 -lastFullWait 0 -copyname Copy1 -storagePolicyName SP1 -selectiveRule SELECTIVE_WEEK -weekDayStartsOn XXXXX

  • To update the selective copy with the last full backup with most recent job if there are no more full backup schedules for the month.

    qoperation execute -af <download location>\Update_Selective.xml -lastfull 1 -lastFullWait 0 -copyname Copy1 -storagePolicyName SP1 -selectiveRule SELECTIVE_MONTH -monthStartsOn XXXX

  • To update the selective copy with the last full backup and wait until the current period is over before selecting a backup for the month.

    qoperation execute -af <download location>\Update_Selective.xml -lastfull 1 -lastFullWait 1 -copyname Copy1 -storagePolicyName SP1 -selectiveRule SELECTIVE_MONTH -monthStartsOn XXXX

  • Disable automatic selection of jobs to be copied to a selective copy.

    qoperation execute -af <download location>\Update_Selective.xml -copyName Copy1 -storagePolicyName SP01 -doNotAutomaticallySelectJobs 1

  1. Download the Update_Selective.xml file and save it on the computer from where the command will be executed.
  2. Execute the following commands from the software_installation_directory/Base folder after substituting the parameter values.

    qoperation execute -af <download location>\Update_Selective.xml -storagePolicyName xxx -copyName xxx

Updating Provisioning Policy and Resource Pools

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
provisioningPolicyName Provisioning Policy Name storagePolicyCopyInfo
resourcePoolName Name of the resource pool available in the OnCommand Unified Manager server resourcePoolList
resourcePoolOperation The operation for the resource pool list. resourcePoolList

Updating Provisioning Policy Name and Copy Type

  1. Download the Update_Provisioning.xml file and save it on the computer from where the command will be executed.
  2. 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>\Update_Provisioning.xml -copyName Primary_vault -storagePolicyName SP1 -provisioningPolicyName Provisioning1

Updating Resource Pools

  1. Download the Update_Provisioning.xml file and save it on the computer from where the command will be executed.
  2. Execute the following command from the software_installation_directory/Base folder after substituting the parameter values.
    • To add resource pools.

      qoperation execute -af <download location>\Update_Provisioning.xml -storagePolicyName SP1 -provisioningPolicyName Provisioning1 -resourcePoolsList/operation 'ADD' -resourcePoolsList/resourcePoolName 'xxxxx'

Deleting a Storage Policy Copy

  1. Download the Delete_SP_copy.xml file and save it on the computer from where the command will be executed.
  2. Execute the following commands from the software_installation_directory/Base folder after substituting the parameter values.

    qoperation execute -af <download location>\Delete_SP.xml -storagePolicyName xxx -copyName xxx

    For example: To delete a copy Copy1 of storage policy SP1, execute the following command:

    qoperation execute -af <download location>\Delete_SP.xml -storagePolicyName SP1 -copyName Copy1