Stub Pruning

You can prune stubs from the source disk. When the stubs are pruned from the source disk, you can continue to restore the associated files. When the subclient retention criteria and the storage policy retention criteria are met, the data associated with the stubs are pruned from the media and the secondary storage space is reclaimed.

By default, Stub pruning occurs with an incremental backup job every 30 days.

When Does Stub Pruning Happen?

The Stub pruning operation is time- and resource-intensive because, the reparse data of the stub must be read to identify if it is a classic archiver stub or a file archiver stub, the AFile validity must be checked.

For this reason, Commvault performs stub pruning with true-up jobs, when possible. Otherwise, Commvault performs stub pruning with incremental jobs. For more information about true-up jobs, see Backup Reconciliation.

When an archive job performs a stub pruning operation, the backup job takes a long time to complete.

Note

If the backup retention is set using disk cleanup rules or if a synthetic full job has already run, AFile validity based stub pruning does not occur for file archiver stubs.

Retention Period

AFile Validity

Stub Pruning Options On the Disk Cleanup Tab

Stub Pruning Occurs With

Job Based Retention - Retain jobs indefinitely

Not supported for stubs created using the File archiver feature.

Yes, if configured from the CommCell Console

Incremental backup job every 30 days, by default. You can modify the number of days using the nStubPruningIntervalInDays additional setting on the client computer.

Job Based Retention - Retain Jobs for n years, n months, and n days

Yes

Yes, if configured from the CommCell Console

Incremental backup job every 30 days, by default. You can modify the number of days using the nStubPruningIntervalInDays additional setting on the client computer.

Applicable to: Service Pack 15 and earlier service packs

Object Based Retention with the Minimum retention based on file modification time check box selected and Deleted item retention values

No

Yes, if configured from the CommCell Console

True-up job

Applicable to: Service Pack 15 and earlier service packs

Object Based Retention (Deleted item retention area) - Retain objects for n years, n months, n days

No

Yes, if configured from the CommCell Console

True-up job

Applicable to: Service Pack 15 and earlier service packs

Object Based Retention (Deleted item retention area) - Retain objects indefinitely

No

Yes, if configured from the CommCell Console

True-up job

Use Cases

Review Pruning Stubs Archived Using Another Subclient

Loading...