Skip to main content

This article applies to Cloud.

Other available versions:

Version 6 | Version 5 | Version 4icon.qnmark.png

Available in:

StandardPremiumEnterprise
Small Business
Code42 Support

Archive maintenance

This article applies to Cloud.

Other available versions:

Version 6 | Version 5 | Version 4icon.qnmark.png

Available in:

StandardPremiumEnterprise
Small Business

Overview

Archive maintenance is a regularly scheduled task that runs on each backup destination. The purpose is to maintain archive integrity and optimize the size of the archives. When archive maintenance runs, it will:

  • Check backup archives for corrupted files and repair any detected corruption.
  • Prune file versions and remove deleted files according to the frequency and version settings.
  • Purge files that are no longer selected for backup.

Archive maintenance in depth

The major operations that archive maintenance performs are defined and described below.

Prune

Pruning is the process that removes files and versions as defined by the frequency and version settings.

prune

  Item Description
1 Block data files  Files stored in the archive as blocks of data.
2 Unused block data files Pruning marks blocks as unused. Think of these blocks as "holes" that still take up space in the block data file until they are compacted.

Compact

Compacting is the process that frees up space on the file system after pruning.

compact

  Item Description
1 Unused block data files  Blocks marked as unused by the pruning process.
2 New block data file The system rewrites the relevant block data file and omits the "holes" described in the previous section. The new block data file is smaller than the original.

Validate and heal

Archive maintenance performs the critical task of validating the health of the backup archive and checking for data corruption.Validate and heal

  Item Description
1 Archive maintenance

The process of archive maintenance.

2 Validation If archive maintenance finds bad blocks of data, the destination self-heals the archive by re-requesting the affected data blocks from the source device.
3 Healing The source device sends new blocks of data to heal the archive.

Types of archive maintenance

The following table summarizes the differences between shallow and deep maintenance:

  Prunes files Validates files and heals corruption Verifies block checksums Compacts archives Resource intensive Default interval
Shallow maintenance Yes Yes No No No 7 days
Deep maintenance Yes Yes Yes Yes Yes 60 days

Shallow maintenance

During shallow maintenance, the process will:

  • Check for data corruption by making sure all files have valid versions and valid block lists.
  • Prune file versions and deleted files based on the device's frequency and version settings.
  • Prune deselected files and data excluded by file exclusions.

Shallow maintenance runs on an archive every seven days. The shallow maintenance interval is not configurable for cloud destinations.

Deep maintenance

During deep maintenance, the process will:

  • Check for data corruption by making sure all files have valid versions and valid block lists.
  • Prune file versions and deleted files based on the device's frequency and version settings.
  • Prune deselected files and data excluded by file exclusions.
  • Validate block checksums for the entire archive.
  • Compact archives to reclaim disk space.

Deep maintenance runs each time the last deep maintenance was more than 60 days ago, or if there is an error related to the archive. 

Maintenance queue

All maintenance jobs get placed into a queue. This applies to shallow and deep maintenance jobs initiated by the user or the administrator.

There are two different maintenance queues—user and system:

  • User: Archive maintenance initiated by a user, either by clicking Compact in the 4.x Code42 app or Run maintenance in the 5.x and later Code42 app, or clicking Maintain archive from Device Details > Archive action menu Archive Options button in the administration console. All jobs in the user queue undergo deep maintenance.
  • System: Archive maintenance initiated by the system according to the configured maintenance interval, or in response to a detected error in the archive.

Add a job to the archive maintenance queue

Follow these steps to manually add a job to the archive maintenance queue from the administration console:

  1. Open the administration console.
  2. Go to Devices > Active.
  3. Select the device for which you want to start archive maintenance.
  4. From the device details, select the Archive Options icon Archive Options.
  5. Select Maintain Archive...
    Your job is added to the queue.