Creating Storage Policy Copies Using XML Files

Table of Contents

Overview

A storage policy copy provides the means to make additional copies of the data. Copies can be created by performing an auxiliary copy operation.  The primary copy is automatically created by the system when a storage policy is created. All backup operations that use a given storage policy use the primary copy. The primary copy carries all data that is directed to its parent storage policy. You can configure secondary copies of the data directed to a storage policy. The following section explains various command line options available for configuring secondary copies of the data.

Available XML Attributes for Storage Policy Copy Creation

The following table displays XML parameters that need to be provided before running the qoperation command. To add a parameter to your command, use the following syntax: (An example is provided at the end of the table.)

qoperation execute -af <template XML file> -<parameter name> <value>

If a parameter is an option, you will use following values to enable or disable the option:

  • 0 - Use this value to disable the option.
  • 1 - Use this value to enable the option.
  • 2 - Use this value if you do not want to change the configuration for an option. If the option is disabled, it remains disabled. If the option is enabled, it remains enabled.
Element Description Parent Element
copyName Name of the storage policy copy to be created App_CreateStoragePolicyCopyReq
copyType Type of the storage policy copy. Valid values are:
  • SILO - to create Silo copy
  • SELECTIVE - to create selective copy.
  • Secondary SILO - to create secondary silo copy.
storagePolicyCopyInfo
active Used to enable or disable the storage policy copy. Valid values are:
  • 0 - Use this value to disable the copy.
  • 1 - Use this value to enable the copy. This is the default value of the parameter.
  • 2 - Use this value if you do not want to change the configuration for the parameter. If the parameter is disabled, it remains disabled. If the parameter is enabled, it remains enabled.
storagePolicyCopyInfo
isSnapCopy To create a snapshot copy. storagePolicyCopyInfo
isMirrorCopy To create a snap mirror copy. storagePolicyCopyInfo
deferAuxiliaryCopyDays To defer the Auxiliary Copy operation by 'n' days. storagePolicyCopyInfo
hardWareCompression To enable hardware compression when the library associated with the storage policy is tape library. storagePolicyCopyInfo
provisioningPolicyName To specify the name of the Provisioning Policy that you want to use for Storage Provisioning. storagePolicyCopyInfo
vFilerName Specify the name of the vFiler. storagePolicyCopyInfo
throttleNetworkBandWidthMBHR Enhancing backup performance by reducing network bandwidth overhead.

Valid values are 1 - no limit.

storagePolicyCopyInfo
storagePolicyName Name of the storage policy copy. StoragePolicyCopy
multiplexSourceStreams Use this parameter if you want to concurrently run Auxiliary Copy operation of multiple data streams to the same media. copyFlags
combineStreams Use this parameter to enable combining source data streams during an Auxiliary Copy operation. copyFlags
switchIfOffline Use alternate data path when a resource is offline. copyFlags
switchIfBusy Use alternate data path when all the drives in the library attached to the preferred MediaAgent are busy. copyFlags
markMediaToBeErasedAfterRecycling If you enabled 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
roundRobbinDataPath Automatically load balance between all the available data paths. copyFlags
inlineAuxCopy Enables inline copy on a storage policy copy.

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

copyFlags
enableParallelCopy Enables parallel copy on a storage policy copy.

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

copyFlags
autoAddDataPaths Automatically adds the alternate data paths for a shared library. copyFlags
noInlineCopyToSameLibrary Prevents a job from being copied when the library of the primary copy is same as the library of the inline copy.

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

copyFlags
noAuxCopyToSameLibrary Prevents a job from being copied when the library of the source copy is same as the library of the secondary copy.

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

copyFlags
siloCopy Option to enable creation of Silo Copy.

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

copyFlags
auxCopyReencryptData Re-encrypts data using selected cipher. 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
enableMediaRefresh Use this parameter to enable media refresh for the 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
secondarySiloCopy To create secondary silo copy.

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

extendedFlags
libraryName Name of the default library where primary copy is created.

You must use drivePoolName and the spareMediaGroupName when creating storage policy copies for Plug and Play libraries.

library
mediaAgentName Name of the MediaAgent that is used to create the primary copy. mediaAgent
drivePoolName Specify the drive pool name for a tape library. drivePool
libraryName Library name to be used as data path on a storage policy copy. spareMediaGroup
spareMediaGroupName Specify the scratch pool name for a tape library. spareMediaGroup
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
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:

  • DES3
  • AES
  • Blowfish
  • GOST
  • Serpent
  • TwoFish
dataEncryption
encryptionKeyLength The key length to use with the cipher in the CipherType parameter.

Valid values for:

  • 3-DES cipher
    • 192
  • AES (Rijndael), GOST, 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
retainBackupDataForDays Number of days to retain the data of the copy. retentionRules
retainBackupDataForCycles Number of cycles to retain the data of the copy. retentionRules
retainArchiverDataForDays Number of days to retain the Archiver data of the copy. retentionRules
jobs Number of jobs that needs to be retained for Snapshot or Snap Vault or Snap Mirror copies. retentionRules
extendedRetentionFirst To use extended retention.

Valid values are:

1 - To retain first full backup job of the time period.

0 - To retain last full backup job of the time period.

retentionFlags
enableDataAging To disable data aging. The Data Aging is enabled by default. If you disable data aging, data in the copy is retained for infinite time. retentionFlags
enableManagedDiskSpace Enables managed disk space threshold for the copy. retentionFlags
selectJobsFromPreviousTier The option to select the jobs from previous tier.

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. retentionFlags
jobBasedRetention Job based retention criteria for Snapshot or 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 parameter enables extended retention for a copy.

For infinite retention set value as -1.

Note: 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

extendedRetentionRuleThree

graceDays Specify number of grace period. Valid values are:
  • 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

extendedRetentionRuleThree

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

extendedRetentionRuleThree

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

extendedRetentionRuleThree

monthStartsOn The days on month to use the EXTENDED_MONTH rule.

Valid values are: 1 - 31.

financialCalendarXML
weekStartsOn Valid values are: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY and SUNDAY. financialCalendarXML
multiplexingFactor Value for multiplexing factor when multiplexing is enabled on the copy. mediaProperties
numberOfStreamsToCombine Specifies 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.

mediaProperties
percentage Option to specify the media capacity in percentage. Media with data less than or equal to this capacity will be picked up for refresh. mediaRefreshProperties
enableMediaRetirementThreshold Option to refresh media that exceeded the retirement threshold.

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

refreshFlags
months Option to specify the number of months for media refresh. Media that were not written in the specified number of months will be picked up for refresh. monthsAfterMediaWritten
months Option to specify the number of months for data aging. Media with specified number of months or more before aging will be picked up for refresh. monthsBeforeMediaAged
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.

Note: You cannot use lastFull and lastFullWait elements together.

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
enableAuxCopyFallenBehindAlert To enable Auxiliary Copy fallen behind alert option on the storage policy copy.

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

auxCopyFallenBehind
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).

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

Use this parameter when enableToBeCopiedDataTB is enabled.

auxCopyFallenBehind
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).

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

Use this parameter when enableDaysOldJobs is enabled.

auxCopyFallenBehind
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).

auxCopyFallenBehind
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.

auxCopyFallenBehind
copyName Specify source copy name for Silo copy. sourceCopy
storagePolicyName Specify storage policy name on which the Silo copy needs to be created. sourceCopy
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
mediaAgentName The source MediaAgent that is used to perform the silo restore. mediaAgentForSiloRestores
mediaAgentName The client name of the destination MediaAgent to which the silo disk volumes are restored. destinationClientForSiloRestores
resourcePoolName Name of the resource pool available in the OnCommand Unified Manager server. resourcePoolsList

Creating a Storage Policy Copy

To create a storage policy copy for an existing storage policy using xml, the copy name, library name and MediaAgent name are specified under the storagePolicyCopyInfo tag. The retention rules are defined within the retentionRules tag.

To create a storage policy copy using xml:

  1. Download the sp_copycreation.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 <downloaded location>\sp_copycreation.xml -storagePolicyName 'xxxxx' -libraryName 'xxxxx' -mediaAgentName 'xxxxx' -retainArchiverDataForDays xx -retainBackupDataForCycles xx -retainBackupDataForDays xx -copyName 'xxxxx'

    Example

    The data in the copy is retained for 5 days and 10 backup cycles. The archiver data is retained for 5 days. We recommend to use different libraries for a secondary copy and primary copy.

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

Creating a Parallel Copy

You can create multiple copies of the data concurrently instead of sequentially. The data is read from the source media (only once) and written to different copies. Therefore, multiple copies are written in parallel by reading the source media only once.

  1. Download the sp_copycreation.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 <downloaded location>\sp_copycreation.xml -storagePolicyName 'xxxxx' -libraryName 'xxxxx' -mediaAgentName 'xxxxx' -retainArchiverDataForDays xx -retainBackupDataForCycles xx -retainBackupDataForDays xx -copyName 'xxxxx' -enableParallelCopy 1

    Example

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

Creating an Inline Copy

An Inline Copy allows you to create additional copies of data at the time of backup. An Auxiliary Copy operation is not required to replicate the data from the primary copy to secondary copy. An Inline copy enables efficient utilization of the media drives and reduces the delay in the offsite storage of the data.

  1. Download the sp_copycreation.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 <downloaded location>\sp_copycreation.xml -storagePolicyName 'xxxxx' -libraryName 'xxxxx' -mediaAgentName 'xxxxx' -retainArchiverDataForDays xx -retainBackupDataForCycles xx -retainBackupDataForDays xx -copyName 'xxxxx' -inlineAuxCopy 1

    Example

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

    If you want to create 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, execute the following command:

    qoperation execute -af <downloaded location>\sp_copycreation.xml -storagePolicyName 'SP1' -libraryName 'Lib1' -mediaAgentName 'MA1' -retainArchiverDataForDays 5 -retainBackupDataForCycles 10 -retainBackupDataForDays xx -copyName 'Copy1' -inlineAuxCopy 1 -noInlineCopyToSameLibrary 1

Creating a Deferred Copy

Deferred Copy allows you to defer Auxiliary Copy operations on the copy. You can specify the number of days by which the copy can be deferred once data becomes available on the source copy.

  1. Download the sp_copycreation.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 <downloaded location>\sp_copycreation.xml -storagePolicyName 'xxxxx' -libraryName 'xxxxx' -mediaAgentName 'xxxxx' -retainArchiverDataForDays xx -retainBackupDataForCycles xx -retainBackupDataForDays xx -copyName 'xxxxx' -deferAuxiliaryCopyDays xx

    Example

    qoperation execute -af <downloaded location>\sp_copycreation.xml -storagePolicyName 'SP1' -libraryName 'Lib2' -mediaAgentName 'MA2' -retainArchiverDataForDays 5 -retainBackupDataForCycles 10 -retainBackupDataForDays 5 -copyName 'Copy1' -deferAuxiliaryCopyDays 5

Creating a WORM Copy

WORM Copy is an option that prevents the deletion of data that is not qualified for aging. The expiration date for the read-only lock is set to match the data retention time established in the storage policy copies. These archive files cannot be modified or deleted by any user or application until the specified retention date. Once the retention expires, the system deletes the archives as part of Data Aging.
  • 1 - Use this value to enable the WORM copy option.
  • 2 - Use this value if you do not want to change the configuration for the WORM copy option. If the option is disabled, it remains disabled. If the option is enabled, it remains enabled.

Once you enable the WORM copy option, you cannot reset it.

  1. Download the sp_copycreation.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 <downloaded location>\sp_copycreation.xml -storagePolicyName 'xxxxx' -copyName 'xxxxx' -wormCopy 1

    Example

    qoperation execute -af <downloaded location>\sp_copycreation.xml -storagePolicyName 'SP1' -copyName 'Copy1' -wormCopy 1

Creating a Snapshot Copy

A Snapshot Copy is the secondary copy created for a SnapProtect backup. The snapshot copy stores the meta data information related to the SnapProtect backup. The SnapProtect backup enables you to create a point-in-time snapshot of the data. It provides an effective way to backup live data.

If you want to perform the snap vault or snap mirror operations using NetApp filers, you must create a primary snap copy in a storage policy. When you create a storage policy associated with a OnCommand Unified Manager, the primary snapshot copy is automatically created. A primary snapshot copy can also be created for a storage policy that is not associated a OnCommand Unified Manager. Use the following steps to create a primary snapshot copy:
  1. Download the sp_copycreation.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.

    Primary Snapshot Copy

    qoperation execute -af <downloaded location>\sp_copycreation.xml -storagePolicyName 'xxxxx' -copyName 'xxxxx' -libraryName 'xxxxx' -mediaAgentName 'xxxxx' -isSnapCopy 1

    Vault Copy

    qoperation execute -af <downloaded location>\sp_copycreation.xml -storagePolicyName 'xxxxx' -copyName 'xxxxx' -libraryName 'xxxxx' -mediaAgentName 'xxxxx' -resourcePoolsList/operation 'ADD' -resourcePoolsList/resourcePoolName 'xxxxx' -provisioningPolicyName 'xxxxx' -sourceCopy/copyName 'primary' -isSnapCopy 1

    Mirror Copy

    qoperation execute -af <downloaded location>\sp_copycreation.xml -storagePolicyName 'xxxxx' -copyName 'xxxxx' -libraryName 'xxxxx' -mediaAgentName 'xxxxx' -resourcePoolsList/operation 'ADD' -resourcePoolsList/resourcePoolName 'xxxxx' -provisioningPolicyName 'xxxxx' -sourceCopy/copyName 'primary' -isSnapCopy 1 -isMirrorCopy 1

Creating a Selective Copy

  1. Download the sp_copycreation.xml file and save it on the computer from where the command will be executed.
  2. Before running the command, review the Available XML Attributes for Storage Policy Copy Creation.
  3. Execute the following command from the software_installation_directory/Base folder after substituting the parameter values.

    qoperation execute -af <downloaded location>\sp_copycreation.xml -storagePolicyName 'xxxxx' -copyName 'xxxxx' -copyType 'SELECTIVE' -selectiveRule 'xxxxx' -libraryName 'xxxxx' -mediaAgentName 'xxxxx'

    Example

    To create a selective copy with all full backups rule.

    qoperation execute -af <downloaded location>\sp_copycreation.xml -storagePolicyName 'SP1' -copyName 'Selective Copy' -copyType 'SELECTIVE' -selectiveRule 'SELECTIVE_ALLFULL' -libraryName 'Lib1' -mediaAgentName 'MA1'

Creating a Silo Copy

  1. Download the sp_copycreation.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 <downloaded location>\sp_copycreation.xml -storagePolicyName 'xxxxx' -copyname 'xxxx' -copytype SILO -silocopy 1 -libraryName 'xxxxx' -mediaAgentName 'xxxxx' -drivePoolName 'xxxx' -spareMediaGroupName 'xxxxx' -multiplexingFactor 3 -sourcecopy/copyname Primary -sourcecopy/storagepolicyname 'xxxxx' -isSilosToBeKeptInCache 0 -enableSiloDiskSpaceManagement 1 -dedupeFlags/backupsiloenabled 1 -multiplexSourceStreams 1

    Example

    qoperation execute -af <downloaded location>\sp_copycreation.xml -storagepolicyname 'Silo_sp' -copyname 'Silo_copy' -copytype SILO -silocopy 1 -libraryName 'CommVault silo 254' -mediaAgentName 'testmmcs' -drivePoolName 'DrivePool(idctestmmcs)259' -spareMediaGroupName 'Default Scratch' -multiplexingFactor 3 -sourcecopy/copyname Primary -sourcecopy/storagepolicyname 'Silo_sp' -isSilosToBeKeptInCache 0 -enableSiloDiskSpaceManagement 1 -dedupeFlags/backupsiloenabled 1 -multiplexSourceStreams 1

Creating a Secondary Silo Copy

  1. Download the sp_copycreation.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 <downloaded location>\sp_copycreation.xml -storagepolicyname 'xxxxx' -copyname 'xxxx' -copytype 'Secondary SILO' -libraryName 'xxxxx' -mediaAgentName 'xxxxx' -drivePoolName 'xxxxx' -spareMediaGroupName 'xxxxx' -multiplexingFactor 4 -sourcecopy/copyname 'xxxxx' -sourcecopy/storagepolicyname 'xxxxx' -enableSiloDiskSpaceManagement 1 -dedupeFlags/backupsiloenabled 1 -multiplexSourceStreams 1 -secondarysilocopy 1 -combineStreams 1

    Example

    qoperation execute -af <downloaded location>\sp_copycreation.xml -storagepolicyname xml1 -copyname Silo_copy_sec1 -copytype 'Secondary SILO' -libraryName CommVault silo1 5 -mediaAgentName testdedupe -drivePoolName 'DrivePool(testdedupe)4' -spareMediaGroupName 'Default Scratch' -multiplexingFactor 4 -sourcecopy/copyname Silo_copy -sourcecopy/storagepolicyname xml1 -enableSiloDiskSpaceManagement 1 -dedupeFlags/backupsiloenabled 1 -multiplexSourceStreams 1 -secondarysilocopy 1 -combineStreams 1

Examples

The following example shows how to add a parameter for a command and creation of storage policy copy that has:

Tape library

qoperation execute -af <download location>\sp_copycreation.xml -storagePolicyName 'SP1' -libraryName 'Lib1' -mediaAgentName 'MA1' -drivePoolName 'driame' -spareMediaGroupName 'Default Scratch' -copyName Copy1

Disabled data aging

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

Managed disk space threshold

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

Retain only the full and latest differential backups

This is useful to minimize wasted disk space

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

Number of cycles to retain the data of the copy

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

Number of days to retain the data of the copy

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

Number of days to retain the Archiver data of the copy

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

Extended retention

qoperation execute -af <downloaded location>\sp_copycreation.xml -storagePolicyName SP1 -retainArchiverDataForDays 5 -retainBackupDataForCycles 10 -retainBackupDataForDays 5 -copyName Copy1 -extendedRetentionRuleOne/isenabled 1 -extendedRetentionRuleOne/rule EXTENDED_MONTH -extendedRetentionRuleOne/endDays 1825 -extendedRetentionRuleOne/graceDays 1

Retain monthly full backups for 1825 days on a copy

qoperation execute -af <downloaded location>\sp_copycreation.xml -storagePolicyName SP1 -retainArchiverDataForDays 5 -retainBackupDataForCycles 10 -retainBackupDataForDays 5 -copyName Copy1 -extendedRetentionRuleOne/isenabled 1 -extendedRetentionRuleOne/rule EXTENDED_MONTH -extendedRetentionRuleOne/endDays 1825 -extendedRetentionRuleOne/graceDays 1

Retain monthly full backups for 1825 days and grace days as 1

qoperation execute -af <downloaded location>\sp_copycreation.xml -storagePolicyName SP1 -retainArchiverDataForDays 5 -retainBackupDataForCycles 10 -retainBackupDataForDays 5 -copyName Copy1 -extendedRetentionRuleOne/isenabled 1 -extendedRetentionRuleOne/rule EXTENDED_MONTH -extendedRetentionRuleOne/endDays 1825 -extendedRetentionRuleOne/graceDays 1

Extended retention rule for weekly full backups (90 days) and week starts on Wednesday

qoperation execute -af <downloaded location>\sp_copycreation.xml -storagePolicyName SP1 -retainArchiverDataForDays 5 -retainBackupDataForCycles 10 -retainBackupDataForDays 5 -copyName Copy1 -extendedRetentionRuleOne/isenabled 1 -extendedRetentionRuleOne/rule EXTENDED_WEEK -extendedRetentionRuleOne/endDays 90 1 -extendedRetentionRuleOne/weekDayStarts Wednesday

Retain monthly full backups for 1825 days in Copy1 and month starts on 20th

qoperation execute -af <downloaded location>\sp_copycreation.xml -storagePolicyName SP1 -retainArchiverDataForDays 5 -retainBackupDataForCycles 10 -retainBackupDataForDays 5 -copyName Copy1 -extendedRetentionRuleOne/isenabled 1 -extendedRetentionRuleOne/rule EXTENDED_MONTH -extendedRetentionRuleOne/endDays 1825 -extendedRetentionRuleOne/monthStartsOn 20

Combine source data streams

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

Multiplexing

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

Prevent a job from being copied when the library of the source copy is same as the library of the secondary copy

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

Mark media for erase after recycling the media

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

Media Refresh

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

Disable storage policy copy

qoperation execute -af <downloaded location>\sp_copycreation.xml -storagePolicyName 'SP1' -copyName 'Copy1' -active 0