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 |
enableSIDBArchive |
Option to delete the DDB once a DDB is sealed. The software deletes the DDB physically from the MediaAgent computer. The DDB will still appear in the CommCell Console till the DDB is removed by macro pruning. 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 |
enableSourceSideDiskCache |
Option to enable source side disk cache. Valid values are: 1 (enable) and 0 (disable). |
dedupeFlags |
allowJobsToRunWithoutAllPartitions |
Option to enable resiliency i.e. allow the jobs to run to the storage policy copy when a few partitions of the deduplication database are offline. Valid values are: 1 (enable), 0 (disable) and 2 (do not change). When you enable this parameter, configure the number of partitions in minimumNumberOfPartitionsForJobsToRun parameter. |
dedupeFlags |
spaceOptimizedAuxCopy |
By default, the deduplication percentage is low on the storage policy copy compared to the percentage on the primary copy, because multiple streams are used for high-speed data transfer. If you enable this option, the storage policy copy achieves an optimized deduplication percentage during auxiliary copy operations. With this option, the auxiliary copy operation achieves a higher deduplication percentage by first copying full backups or synthetic full backups, followed by incremental backups or differential backups. Valid values are: 1 (enable) and 0 (disable) |
extendedFlags |
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 |
minimumNumberOfPartitionsForJobsToRun |
If you enabled the allowJobsToRunWithoutAllPartitions parameter, then configure the minimum number of partitions that must be available to run any jobs to the storage policy copy. Specify a value less than the total number of partitions available in the deduplication database. |
storagePolicyCopyInfo |
-
Download the Update_DDB_Settings.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 create a new DDB when the DDB size reaches to 100 TB.
qoperation execute -af <download location>\Update_DDB_Settings.xml -copyName xxx -storagePolicyName xxx -createNewDDBeveryXtb 1 -tb 100
-
To temporarily disable deduplication.
qoperation execute -af <download location>\Update_DDB_Settings.xml -copyName xxx -storagePolicyName xxx -temporarilyDisableDeduplication 1
-
To delete the DDB once a DDB is sealed
qoperation execute -af <download location>\Update_DDB_Settings.xml -copyName xxx -storagePolicyName xxx -enableSIDBArchive 1
-
To set 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 xxx -storagePolicyName xxx -diskFreeWarningThreshholdMB 10240
-
To set the number of days to not deduplicate against objects older than 365 days.
qoperation execute -af <download location>\Update_DDB_Settings.xml -copyName xxx -storagePolicyName xxx -oldestEligibleObjArchiveTime 365
-
To enable space optimization for auxiliary copy operations.
qoperation execute -af <download location>\Update_DDB_Settings.xml -copyName xxx -storagePolicyName xxx -spaceOptimizedAuxCopy 1
-