The following table displays the extended data retention rule parameters you can use with the commands.
|
Element |
Description |
Parent Element |
|---|---|---|
|
extendedRetentionFirst |
Use this parameter to retain the first full backup of each extended retention rule. Valid values are:
|
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:
|
extendedRetentionRuleOne extendedRetentionRuleTwo extendedRetentionRuleOne |
|
isEnabled |
Use this parameter, to enable/disable extended retention for a copy. Valid values are:
|
extendedRetentionRuleOne extendedRetentionRuleTwo extendedRetentionRuleOne |
|
rule |
Use this parameter to specify extended rule for a copy. Valid values are:
|
extendedRetentionRuleOne extendedRetentionRuleTwo extendedRetentionRuleOne |
-
Download the Update_extendedRetention.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.
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/isenabled 1 -extendedRetentionRuleTwo/graceDays 0 -extendedRetentionRuleTwo/rule 'EXTENDED_MONTH'
-