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.
| |
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. |
| |
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 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. |
| |
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.
| |
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. |
| |
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). |
| |
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.
|
Block level Deduplication factor | Determines the block factor used for deduplication. |
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. |
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. |
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. |
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. |
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: |
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. |
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.