Commvault

Reference Tables

Quick Links to Topics:



Storage Policy Settings

This section describes all available options set on a storage policy or its storage policy copies. Note that the list of options is as of Version 11 Service Pack 7.


General Tab


Storage Policy Name

This defines the name of the storage policy. It should be descriptive and state key configurations for the policy. It can be changed at any time to reflect modifications to key settings for the policy.

Device Streams

This defines the number of concurrent write operations that the storage policy allows. This number should match the number of tape drives or disk writers for the library.

Enable stream randomization for backup /archiver jobs

When conducting auxiliary copy jobs, stream randomization improves performance by randomly selecting source streams during the auxiliary copy job. This results in a more balanced stream of data when multi-streaming auxiliary copy jobs.

Distribute data evenly among multiple streams for offline read operation

This option is for auxiliary copy-based jobs which include content indexing and data verification. This option distributes data across multiple job streams for better performance. Basically, the system breaks large incoming client streams into smaller streams in the primary copy to facilitate the auxiliary copy of those streams.

Keep Resource reservations cached for jobs on this storage policy

For large application servers conducting frequent transaction log backups, the keep resource reservations cached option improves performance by eliminating the step for the CommServe® server to contact the MediaAgent to reserve storage resources each time a job is run. It is recommended to use this feature when the client is writing to a dedicated library where all resources are exclusive to the client, such as in client/MediaAgent LAN-Free backups.

Disable Storage Policy for Backups

If a policy is no longer active you can hide the policy which will prevent it from being displayed in the Storage Policy list or the Storage Device drop-down box in the subclient properties. You can choose to display hidden policies by going to Control Panel



Description

Use this space to describe details of the storage policy.
 

Incremental Storage Policy

Specify if this storage policy will link to a separate policy to run incremental, differential, and log backups.

Enable this Storage Policy for Legal Holds

When using Commvault eDiscovery feature, storage policies can be enabled for legal hold. This will allow compliance auditors the ability to select specific objects through a web interface and apply a legal hold retention policy to them. The legal hold retention policy is determined by the legal hold enabled storage policy they select.
 

Erase Data

By enabling this option, the storage policy will be an erase data enabled policy. This means end users or Commvault administrators can mark specific data to be erased resulting in the data not to be discoverable during browse or find operations. For all media written to an erase enabled policy, the data cannot be recovered using Media Explorer, Catalog Media, or Restore by Job operations.


Copy Precedence

Copy precedence determines policy copy order that Commvault® software uses when browsing and recovering data. Setting precedence at the storage policy level defines the default order the software uses. These options can be changed when performing browse and restore operations.


Associated Subclients

This tab can be used to display all subclients associated with a storage policy. It can also be used to change subclient associations to other policies.





Content Indexing


Content Indexing provides an extremely powerful information management tool to manage data based on contents of the data. Content Indexing works with production data and protected data. The following explains configuration options for Content Indexing settings. This is visible only if at least one Search Engine has been deployed in the environment.


 
General
 


Enable Content Indexing

This enables the storage policy as a Content Indexing policy.
 

Select the Search Engine

If multiple Search Engines are available, select the appropriate engine. Multiple engines provide great flexibility in distributed environments. Placing engines local to where the data resides makes indexing more efficient by processing the data locally.
 

Subclient Association

Specific subclients can be selected to be indexed. This allows the storage policy to manage all associated subclients based on normal retention policies, and selectively choose which subclients to index. You can also use this to retroactively index subclients at the point an investigation is being conducted.
 

Source Copy

This allows you to select the storage policy copy you want to use as the source location for data to be indexed. Commvault strongly recommends specifying a disk library as the source location.
 

Enable Entity Extraction

Custom definitions for specific data strings such as phone number, social security number or credit card number can be configured using the Entities tab. This will allow the characters to be normalized and searched during content search operations by choosing the entity you want to search for. Basically, this will normalize the data in the expected format (e.g., SSN xxx-xx-xxxx). Custom entities can be designed by consulting Commvault Professional Services.

Defer Content Indexing for

This allows you to defer Content Indexing operations for a specified number of days. Be careful when setting this option. If an active investigation is being conducted and relevant data has not been indexed the investigators results may not have all information required.
 

Backups on and After

Allows you to specify the starting date in which data will be indexed from.
 

Sync up Active Directory information

By default, the user directory (GUID) are updated in the CommServe database every 24 hours or whenever the CommServe services are restarted. However, if a new user is added to the domain and you content index the new user's data before the directory is synchronized with the CommServe database, the search returns results with missing user details (example, the user's mail id does not appear in the search result). To prevent such cases, you can enable the user directory synchronization before each content indexing job.

 
File Filter
 


Include Global Filters

Global filters defined in the Control Panel can optionally be included in filtering objects from being indexed. This option can be configured to On or Off.
 

Include / Exclude the following file types for Content Indexing

Filters can be configured to exclude or include all filtered objects defined in the file type list.

Add new file pattern
 

Allows you to add or remove file types to the file type list.

File Sizes

The default maximum file size that will be indexed is 50MB. This option should not be increased for performance reasons. Often PST files will grow considerably larger than 50MB in size. The recommended method for ingesting and indexing PST files is to use the Commvault mailbox agent to ingest the PST files and then index the mailbox agent subclient contents.
 

 
Retention
 


Retention rules for Content Index

The default rules for content index retention is to keep the indexes based on the longest retention setting within all storage policy copies. This option can be used to specify how long indexes will be kept.


 

 
Content Index Fallen Behind Alert
 


Enable Content Index Fallen Behind Alert
 

Enables an alert to be sent when the criteria for content indexing jobs are matched for the storage policy.

To be content indexed data is over <n> GB

Select to send an alert when the amount of data to be content indexed in the storage policy is above a defined size.

Jobs that are over <n> days old and have not yet been fully indexed

Select to send an alert when backup jobs older than a defined number of days have not been fully content indexed.


Security

Determines which user groups have rights to manage the storage policy.




Snapshot


This tab is related to IntelliSnap® hardware snapshot integration. This tab appears only if a snap copy was created for the storage policy.


 
Backup Copy - General
 


Enable Backup Copy

For IntelliSnap enabled storage policies, this option will enable the backup and indexing of snapshots managed by the Commvault® software through the IntelliSnap feature.
 

Snapshot created on or after

Determine the start data in which snapshots will be backed up.
 

Defer backup copy

Will defer snapshot backups for specified period of days. The use of that option has to be carefully planned as it might result in data not being fully protected.
 

Job Selection rule

Allows you to select all snapshots, manually select snapshots, or choose snapshot backup frequency such as daily, weekly or monthly.
 

Source Snap Copy

Specifies the source copy to be used for backup operations.
 


Backup Copy – Associations


Associations

By default, all subclient associated to a storage policy with the IntelliSnap feature enabled are part of the backup copy unless specified in the Associations tab.

Full, Incremental, Differential IntelliSnap jobs

When you select this option, all snaps specified in the backup selection rule are baked up. This setting is applicable only for NAS and Virtual Server Agents (VSAs).


Deferred Catalog - General
 


Enable Deferred Snap Cataloging

If you select this option, the snapshots are NOT cataloged as part of the snap backup job. To catalog the snapshots, run the 'Run Snapshot Cataloging' operation from the selected storage policy.

Snapshots Created On or After

When selected, specifies snapshots created on or after the specified date are used for deferred cataloging operation.

Defer Snapshot Cataloging for

When selected, specifies that a snapshot can be catalogued only after the specified number of days after the snapshot was created.

Job Selection Rules

Allows you to select all snapshots, manually select snapshots, or choose snapshot frequency such as daily, weekly or monthly to be catalogued.

Source Snap Copy

Specifies the source copy to be used for cataloguing operations.
 

Full, Incremental, Differential IntelliSnap jobs

When you select this option, all snap backups specified in the backup selection rule are cataloged. This setting is applicable only for NAS and Virtual Server Agents.



Advanced


Prevent multiple copies of job across selective copies

This option is valid for time based selective copies.
Select this option to prevent the same set of backups to be copied across different selective copies.
For example:
The storage policy has the following configured:

  • 1 daily copy (first full)
  • 1 weekly copy (first full – week begins on Monday)
  • 1 monthly copy (first full – month begins on 1st)

    Full backup Job1 runs on the first day of the month, which is Monday. This job qualifies for all the 3 configurations:
  • First full of the day
  • First full of the week
  • First full of the month

Block level Deduplication factor

Determines the block factor used for deduplication.
If the storage policy is managing data and this setting is changed, the current store will be sealed the DDB will be closed and a new store and DDB will be created. This will have a negative effect on dedupe ratios until data from the old store has exceeded retention and is pruned.
All store policies linked to a deduplication policy MUST use the same block size setting.
 

Enable Storage Policy level Media Password

When selected the CommCell level Media Password will be ignored and the storage policy level media password will be used. The Media Password is used when using the Media Explorer utility tool or when using the catalog media option in the CommCell console.



 

Time Zone Settings

This determines which time zone will correspond to data aging operations performed for the storage policy. The default time zone is the CommServe® server's time zone. If you have locations in other time zones set this to correspond to the proper zone to ensure aging happens locally at the same predefined time.
Setting can be the CommServe or the client.



Primary Copy Properties

General

Most of the options defined in the General tab are specified during the Storage Policy Wizard. The Copy Name can be changed at any time without having a negative effect on your environment. A copy can be designated as a WORM copy if you have hardware that supports this option. Although the data path cannot be altered in the General tab, you can add additional data paths in the Data Path tab and change the default path to use any path specified. As a result, you do not have to recreate a storage policy if a data path ever changes.


Retention


Enable Data Aging

Deselecting this option will prevent data from aging and retain all data associated with this storage policy copy.

Enable Managed Disk Space

Enabling managed disk will allow data to remain on disk media beyond the basic retention settings. Data will be pruned when the upper threshold setting is reached in the disk library configurations

Do not retain intermediate incrementals and differentials before new differential.

If you are running extended cycles such as monthly full, weekly differential, and daily incremental, this option will prune any backups prior to the most recent differential back to the full backup at the start of the cycle. This can reclaim disk space during extended cycles when there is a high incremental rate of change in an environment.

Spool Copy (Non dedupe storage policies only)

For disk media, this option will spool data to disk, copy to secondary media using auxiliary copy, then delete data from the disk. Use this option when you have limited disk space but want to take advantage of fast disk write speeds.

Basic Retention

Configure Cycles and Days settings for standard retention.

Extended Retention

Extend basic retention for backup frequency of: all backups, weekly, monthly, quarterly, half year, and yearly backups. Up to three additional extended retention settings can be applied. This option is not recommended for deduplicated storage policy copies.
 Grace Days: In the event that the designated full backup that qualifies for extended retention fails, an alternate full backup will be picked prior to the date of the failed full as long as full backup exists within the grace days specified.
Select Job from Previous Tier: If multiple extended retention rules have been defined, this option will allow a full to be chosen from another tier if the full that qualifies for extended retention fails.



Data Paths


Add

Allows you to add a new data path for the storage policy. If the storage policy is associated with a global deduplication storage policy, this option will not be available. Data paths need to be added in the primary copy of the global policy.

Delete

Allows you to remove a data path for the storage policy. If the storage policy is associated with a global deduplication storage policy, this option will not be available. Data paths are deleted in the primary copy of the global policy.

Set Default

Determines the default path data will use. The default path is the path that LAN based backups will use.

Properties

Allows you to configure specific data path properties:

 Hardware Compression

Enable this option when writing to a tape library that supports hardware compression before enabling this option, determine if the data being written has already been compressed. Note that by default, when using Commvault deduplication, compression is enabled in the storage policy and data will be compressed at the client. In this case compressing to tape is not recommended.

 Hardware Encryption

Use Hardware Encryption For LTO tape drives that support hardware encryption (currently LTO4 and LTO5), use this option to enable encryption on the drive. 'Via Media Password' option will place the encryption keys on the media allowing data to be decrypted in the event if the CommServe database is not available at the time of restore. 'No Access' option will not put the keys on the media and can only be restored if a CommServe server is running. Note that encryption keys are kept in the CommServe database.

 Chunk Size

Sets the chunk size at the data path level for tape or disk media. Setting the Use specified value will override the global settings for chunk size in Control Panel.

 Block Size

Specifies the block size used to write data to media. The default is 64KB.
Note that altering block size can improve performance but it also must be supported by ALL hardware in your environment. If you intend on changing this value ensure that all hardware in your production and DR environment supports the higher setting.



Data Path Configuration Tab


Automatically Add New Data Path

This will automatically add new data paths when using a shared library.

Use Alternate Data Paths

Configure data path failover. Offline option is used if a library or MediaAgent is unavailable. Resource busy can be used if all drives in a drive pool are being used.

Round Robin between Data Paths

This option will round robin data protection operations between multiple MediaAgents. Note that this will not round robin individual streams for a job.

Use preferred data path

This is configured for LAN-Free data paths. Any jobs that do not have a LAN-Free path available will use the default path configured in the Data Paths tab.



Media


Enable Multiplexing

Determines the multiplexing factor. It is recommended to only set multiplexing when writing to removable media.

Enable Media refresh

This allows jobs to be copied from existing media to new media. This is especially beneficial for ensuring data is kept on newer media or when transitioning from an old drive type to a new type. It is recommended that data protection jobs are refreshed to new media every 5-7 years.





Secondary Copy Settings


General Tab


Primary Copy

This can be used to promote a secondary synchronous copy to a primary copy. When the synchronous copy is promoted the primary copy will be demoted to a secondary synchronous copy. All data associated with each copy will still be available for recovery

Selective Copy

Designates this copy as a selective copy and enables the Selective Copy Configuration tab.

Active

Designates the copy as active. If unselected data will not be copied. Any source data associated with the copy will ignore the associations and will prune when retention is exceeded.

Enable Inline Copy

This designates that a backup to the primary will also be written to secondary copies at the same time. Data from the client to the MediaAgent can be written to multiple storage policy copies simultaneously.

Do not make inline copy to same library:

If an alternate library path exists in the storage policy copy that shares the same MediaAgent and this option is selected, the alternate library will be used.

Enable Parallel copy

When two secondary copies are defined in a storage policy, they can be run concurrently by enabling this option.

Defer Auxiliary Copy

This setting sets the number of days to wait before running the secondary copy. This setting should be used with caution as the wait interval will cause source data to remain on media the number of days the copy is being deferred regardless of the source data retention.

WORM Copy
 

A copy can be designated as a WORM copy if you have hardware that supports this option.

Calendar for Selective Copy

If custom calendars are defined this option will be available allowing you to select which calendar to use in regard to extended retention or selective copies. This is especially important when selecting time frequency to create copies such as monthly, quarterly, or yearly.

Default Destination

This is where the data path is defined: Library, MediaAgent, Drive Pool, and scratch Pool. Once defined all options will be static except for the scratch pool which can be changed.





Retention


Enable Data Aging

Deselecting this option will prevent data from aging and retain all data associated with this storage policy copy.

Enable Managed Disk Space

Enabling managed disk will allow data to remain on disk media beyond the basic retention settings. Data will be pruned when the upper threshold setting is reached in the disk library configurations.

Do not retain intermediate incrementals and differentials before new differential.

If you are running extended cycles such as monthly full, weekly differential, and daily incremental, this option will prune any backups prior to the most recent differential back to the full backup at the start of the cycle. This can reclaim disk space during extended cycles when there is a high incremental rate of change in an environment.

Spool Copy (Non dedupe storage policies only)

For disk media this option will spool data to disk, copy to secondary media using auxiliary copy then delete data from the disk. Use this option when you have limited disk space but want to take advantage of fast disk write speeds.

Basic Retention

Configure Cycles and Days settings for standard retention.

Extended Retention

Extend basic retention for backup frequency of: all backups, weekly, monthly, quarterly, half year, and yearly backups. Up to three additional extended retention settings can be applied. This option is not available for deduplicated storage policy copies.
Grace Days: In the event that the designated full backup that qualifies for extended retention fails, an alternate full will be picked prior to the date of the failed full as long as full exists within the grace days specified.
Select Job from Previous Tier: If multiple extended retention rules have been defined, this option will allow a full to be chosen from another tier if the full that qualifies for extended retention fails.



Copy Policy


Backup Selection

Determines the date that the secondary copy will begin generating copies. By default, when a synchronous copy is configured it will attempt to make additional copies of all jobs that are currently retained. Setting backups on or after sets a start date which can avoid retroactive generations of previously run jobs. If using selective copy, this option must be set to the specific date you want to start generating copies.

Source Copy

Specifies the source location for the secondary copy. By default, the primary location will be used as the source. A secondary synchronous copy can be selected to create other synchronous or selective copies. A selective copy can only be specified as a source for another selective copy.





Data Paths


Add

Allows you to add a new data path for the storage policy. If the storage policy is associated with a global deduplication storage policy, this option will not be available. Data paths need to be added in the primary copy of the global policy.

Delete

Allows you to remove a data path for the storage policy. If the storage policy is associated with a global deduplication storage policy, this option will not be available. Data paths are deleted in the primary copy of the global policy.

Set Default

Determines the default path data will use. The default path is the path that LAN based backups will use.

Properties

Allows you to configure specific data path properties:
Hardware Compression: Enable this option when writing to a tape library that supports hardware compression. Before enabling this option determine if the data being written has already been compressed. Note: by default when using Commvault deduplication, compression is enabled in the storage policy and data will be compressed at the client. In this case compressing to tape is not recommended.
Use Hardware Encryption: For LTO tape drives that support hardware encryption (currently LTO4 and LTO5) use this option to enable encryption on the drive. 'Via Media Password' option will place the encryption keys on the media allowing data to be decrypted in the event if the CommServe database is not available at the time of restore. 'No Access' option will not put the keys on the media and can only be restored if a CommServe is running. Note that encryption keys are kept in the CommServe database.
Chunk Size: Sets the chunk size at the data path level for tape or disk media. Setting the Use specified value will override the global settings for chunk size in Control Panel.
Block Size: Specifies the block size used to write data to media. The default is 64KB. Note that altering block size can improve performance but it also must be supported by ALL hardware in your environment. If you intend on changing this value ensure that all hardware in your production and DR environment supports the higher setting.

Data Path Configuration


Use Alternate Data Paths

Configure data path failover. Offline option is used if a library or MediaAgent is unavailable. Resource busy can be used if all drives in a drive pool are being used.

Round Robin between Data Paths

This option will round robin data protection operations between multiple MediaAgents. Note that this will not round robin individual streams for a job.

Use preferred data path

This is configured for LAN-Free data paths. Any jobs that do not have a LAN-Free path available will use the default path configured in the Data Paths tab.



Selective Copy


Automatically Select Full Backups at Frequency

Determines at what time interval full backups will be selected for copy. All fulls, weekly, monthly, quarterly, half year, and yearly fulls can be selected.
Advanced: The advanced option provides the ability to select a copy based on number of cycles, days, weeks, or months. To use the advanced option set the 'Automatically select full backups' option to Advanced and use the Advanced button to configure the settings.

For each time period copy the:

Determines whether the first or last of time period will be selected. If selecting the last you can choose to select the most recent full backup that is scheduled or you can wait until the period is over before selecting a full. This can be useful when full backups must be performed when normal full backups are not scheduled such as the last business day of the quarter.

Do not automatically select fulls

This allows the manual selection of full backups for the selective copy. You can use this with the select most recent full backup when auxiliary copy starts option in the General tab of the auxiliary copy settings. This allows you to select full backups based on scheduling of auxiliary copies rather than period based through the selective copy configuration.



Associations

The Associations tab is used to determine which subclient will be managed by the secondary copy. Several important notes should be considered here:

  • By default, all subclients are selected.
  • To ensure all subclients for a specific backup/archive set will be included in the copy select associations at the backup/archive set level.
  • If a source copy is another secondary copy you can only select subclients that are associated with the source secondary copy.


Media 


Combine source data streams to

Determines the number of streams that will be used for the secondary copy. This will consolidate backup streams from all subclients associated with the copy and sequentially place the streams on backup media.

Multiplex source streams
 

If the source streams are on a disk library with multiple mount paths, Multiplexing can be used to increase auxiliary copy performance. The storage policy property 'Enable Stream Randomization' should be selected. This option is turned on by default.

Write to a Different Library Compared to Source Copy

Click to prevent a job from being copied to the same library during auxiliary copy operations.

Mark media to be erased after recycling
 

Marks media to be erased after all data has aged from the media. This will only work if the Erase Spare Media option is enabled.

Enable Media Refresh
 

This allows jobs to be copied from existing media to new media. This is especially beneficial for ensuring data is kept on newer media or when transitioning from an old drive type to a new type. It is recommended that data protection jobs are refreshed to new media every 5-7 years.


  Advanced 


Data Verification

Determines settings for data verification which is used to verify chunk integrity on the media.

Data Encryption

Determines settings for data encryption. You can choose which algorithm and key length (where applicable) for the copy. You can also determine if you want to place the encryption keys on the media so data can be recovered using the Media Explorer tool.






Copyright © 2021 Commvault | All Rights Reserved.