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

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

  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.

    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

Loading...