V11 SP8
Loading...

Retention Options for OnePass

Important: This topic applies to new clients on Commvault version 11 software. If you upgrade the client from the previous version, and the client still operates on indexing version 1, then do not complete the procedure below. Instead, see Retention Options for OnePass.

Retention options, which you define at the subclient level, determine when storage policy retention begins for archived or deleted items. You can retain items indefinitely, or you can begin retaining items after a delay. Before you run a synthetic full backup, users can browse and restore items from the most recent backup cycle. Synthetic full backup operations manage the application of subclient retention options.

Subclient retention settings determine when storage policy copy retention starts for archived or deleted items. Storage policy copy retention can start immediately or be delayed for a specified period of time. The following table summarizes the retention options available for OnePass subclients:

Use Only Archiver Retention

Retention Options Users Implications Examples
Select the Archiver Retention check box
  • Days-based retention users
  • Cloud-based storage users
  • Classic Archiver users
  • Tape-based users
  • You cannot perform synthetic full backup operations.
  • Between storage policy copy retention and archiver retention, the type of retention that retains items for the longest period takes precedence. Retention is only considered for copies that contain the job.

    If you specify storage policy copy retention as x days and y cycles, then the Commvault software compares the x days to the number of days you specify for Archiver Retention and keeps the items for the longest number of days specified.

  • If you select the Extend retention indefinitely option, the jobs are retained indefinitely in the storage media and you cannot select the Archiver Retention and Backup Retention check boxes concurrently.
Set the archiver retention to 25 days. There are  3 storage policy copies (A, B, and C). The retention of A, B, and C is as follows:
  • A: 45 days 3 cycles
  • B: 17 days 4 cycles
  • C: 91 days 2 cycles

Only copies A and B contain the backup job. Copy A has a longer retention time period than copy B and than the subclient archiver retention options. Thus, the backup jobs will be available for 45 days.

Use Only Backup Retention

Retention Options Users Implications Examples
Select the Backup Retention check box
  • File system users
  • Laptop users
  • You can perform synthetic full backup operations and incremental backup operations.
  • If you select the After deletion keep items indefinitely option then the deleted items are retained in the backup cycle indefinitely.
The storage policy copy retention is 10 days and 2 cycles. The subclient retention is 30 days.

The stub was deleted on January 10. You run the following backup operations:

  • An incremental backup operation on January 11
  • A synthetic full backup operation on January 15

The 30 days for the deleted stub starts on January 11 when the incremental backup was performed. Thus, the deleted stub is retained in the most recent backup cycle until the next synthetic full back up operation after February 9.

After the synthetic full backup operation, the file is dropped from the latest backup cycle and is still available for restore for 10 days and 2 cycles, as specified in the storage policy copy retention options.

Use Both Archive Retention and Backup Retention

Retention Options Users Implications Examples
Select the following check boxes:
  •  Archiver Retention
  • Backup Retention
Existing OnePass users
  • You can perform synthetic full backup operations and incremental backup operations.
  • Synthetic full backups are allowed. The file is retained for the number of days specified in the Archiver Retention. If the modified time of the file exceeds the number of days you specify in the Extend retention for n years, n days, and n months box, then depending on whether the file is deleted, the file is retained based on the backup retention criteria. 

    If the file is not deleted, it stays in the storage media indefinitely. If the file is deleted then the file is available in the latest backup cycle for the number of days you specify in the Backup Retention. After the backup retention time periods, the deleted file is retained as defined in the storage policy retention options.

Set the archiver retention to 1 year and 10 days. Set the backup retention to 3 years and 8 days.

The file is initially retained for 1 year and 10 days after the file was modified. After the archiver retention period, the file, depending on whether the file is deleted, is retained based on the backup retention criteria.

If the file is not deleted, it stays in the storage media indefinitely. If the file is deleted then the file is carried forward for 3 years and 8 days after which the deleted file is retained as defined in the storage policy retention options.

Use Cases

Archive Data That is 5 Years Old and Remove the Data From the Media After 2 Years

In this use case, the data that is less than 5 years old does not qualify for archiving and is not backed up. After 2 years, when a data aging operation runs, the operation prunes the data and removes it from the storage media.

Before you perform the backup operation, complete the following steps to configure retention options.

  1. From the CommCell Browser, expand Client Computers > client > File System > backup_set.
  2. Right-click the subclient for which you want to modify retention options, and then click Properties.

    The Subclient Properties dialog box appears.

  3. On the Content tab, select the Only backup files that qualify for archiving check box.

    A Warning dialog box appears.

  4. Click OK on the Warning dialog box.
  5. Click Advanced.

    The Advanced Subclient Properties dialog box appears.

  6. On the Retention tab,  complete the following steps:
    1. Select the Extend storage policy retention check box.
    2. Select the Archiver retention check box.
    3. In the Extend retention for n years n months and n days box, enter 2 years, 0 months, and 0 days.
    4. Click OK.
  7. On the Disk Cleanup tab, in the File modified time older than box, enter 1825 days.
  8. Click OK.

Archive All Data and Stub Only Data That is 5 Years Old and Remove Stubs From Media After 2 Years

Create a separate subclient for archiving and back up data.

For the archiving subclient, complete the following steps:

  1. From the CommCell Browser, expand Client Computers > client > File System > backup_set.
  2. Right-click the archiving, and then click Properties.

    The Subclient Properties dialog box appears.

  3. On the Content tab, select the Only backup files that qualify for archiving check box.

    A Warning dialog box appears.

  4. Click OK on the Warning dialog box.
  5. Click Advanced.

    The Advanced Subclient Properties dialog box appears.

  6. On the Retention tab, and select the Extend storage policy retention check box.
  7. Select the Archiver retention check box.
  8. In the Extend retention for n years n months and n days box, enter 2 years, 0 months, and 0 days.
  9. Click OK.
  10. Click the Disk Cleanup tab and in the File modified time older than box, enter 1825 days.
  11. Click OK.

For backup subclient, use the following steps:

  1. Right-click the backup subclient and click Properties.

    The Subclient Properties dialog box appears.

  2. Click Advanced.

    The Advanced Subclient Properties dialog box appears.

  3. On the Retention tab.
  4. On the Retention tab, and select the Extend storage policy retention check box.
  5. Select the Archiver retention check box.
  6. In the Extend retention for n years n months and n days box, enter 2 years, 0 months, and 0 days.
  7. Click OK.

Archive Data That is 5 years Old But Do Not Create Stubs and Remove the Data After 2 Years

  1. On the Content tab, select the Only backup files that qualify for archiving check box.

    A Warning dialog box appears.

  2. Click OK on the Warning dialog box.
  3. Click Advanced.

    The Advanced Subclient Properties dialog box appears.

  4. On the Retention tab, select the Extend storage policy retention check box.
  5. Select the Archiver retention check box and in the Extend retention for n years n months and n days box, enter a value of 2 years, 0 months, and 0 days.
  6. Click OK.
  7. On the Disk Cleanup tab, in the File modified time older than box, enter 1825 days.
  8. In the After Archiving area, select the Delete the file option.
  9. Click OK.

Stub Data and Delete Stubs After 1 Year but Keep the Corresponding Data for 2 years From the Time the File Was Archived

  1. From the CommCell Browser, expand Client Computers > client > File System > backup_set.
  2. Right-click the archiving, and then click Properties.

    The Subclient Properties dialog box appears.

  3. On the Content tab, select the Only backup files that qualify for archiving check box.

    A Warning dialog box appears.

  4. Click OK.
  5. Click Advanced.

    The Advanced Subclient Properties dialog box appears.

  6. On the Retention tab, and select the Extend storage policy retention check box.
  7. Select the Archiver retention check box.
  8. In the Extend retention for n years n months and n days box, enter 2 years, 0 months, and 0 days.
  9. Click OK.
  10. On the Disk Cleanup tab, in the File modified time older than box, define a rule to stub the files.
  11. Select the Stub Pruning check box.
  12. In the Remove stubs with file modification time older than n days box, enter 365 days.

    For more information on Pruning Stubs Based on File Access Time, File Modification Time, or Stub Creation Time.

Stub Data and Delete Stubs After 1 Year But Keep the Corresponding Data for 2 Years Based on the Modified Time of the File

  1. From the CommCell Browser, expand Client Computers > client > File System > backup_set.
  2. Right-click the archiving, and then click Properties.

    The Subclient Properties dialog box appears.

  3. On the Content tab, select the Only backup files that qualify for archiving check box.

    A Warning dialog box appears.

  4. Click OK on the Warning dialog box.
  5. Click Advanced.

    The Advanced Subclient Properties dialog box appears.

  6. On the Retention tab, and select the Extend storage policy retention check box.
  7. Select the Archiver retention check box and in the Extend retention for n years n months and n days box, enter a value of 2 years, 0 months, and 0 days.
  8. Select the Backup retention check box and in the After deletion keep items for x years x months and x days, enter a value of 0 years, 0 months, and 0 days.
  9. Click OK.
  10. On the Disk Cleanup tab, in the File modified time older than box, define a rule to stub the files.
  11. Select the Stub Pruning check box.
  12. In the Remove stubs with file modification time older than n days, enter 365 days.

    For more information on Pruning Stubs Based on File Access Time, File Modification Time, or Stub Creation Time.

Keep Two Versions of the File for 3 Years

  1. From the CommCell Browser, expand Client Computers > client > File System > backup_set.
  2. Right-click the archiving, and then click Properties.

    The Subclient Properties dialog box appears.

  3. On the Content tab, select the Only backup files that qualify for archiving check box.

    A Warning dialog box appears.

  4. Click OK on the Warning dialog box.
  5. Click Advanced.

    The Advanced Subclient Properties dialog box appears.

  6. On the Retention tab, and select the Extend storage policy retention check box.
  7. Select the Archiver Retention check box.
  8. In the Extend retention for n years n months and n days box, enter 3 years.
  9. In the Older file versions area, select the Keep n versions option, and then enter a value of 2.
  10. Click OK.
  11. On the Disk Cleanup tab, in the File modified time older than box, enter the required value.
  12. In the After Archiving area select the Delete the file option.
  13. Click OK.