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 |