Archiving or deleting checkpoints

To reduce clutter and free up disk space, we might need to archive or delete old checkpoints periodically. The number of checkpoints stored to disk especially adds up when automatic delta checkpoints are enabled and checkpoint depth is high. The product automatically deletes delta checkpoints when the number of checkpoints reaches the checkpoint depth. To preserve delta checkpoints, you must archive checkpoints before they are automatically deleted.

You have full or delta checkpoints stored to file system locations and want to archive checkpoints to save the configurations or delete checkpoints that you no longer need.

The product does not have an automated function for archiving. However, we can archive checkpoints as needed by moving checkpoint directories to a separate disk or location.

Two locations in the product installation hold information for configuration repository checkpoints:

Profile cell_name/repository/checkpoints subdirectories hold checkpoint metadata

Checkpoint metadata is located under the relative path cell_name/repository/checkpoints of the profile configuration directory. The default path for the configuration root is profile_root/config so the typical location is profile_root/config/cells/cell_name/repository/checkpoints.

Profile /checkpoints subdirectories hold checkpoint contents

The contents of checkpoints are located, by default, under the profile_root/checkpoints directory.

These locations contain subdirectories, one for each checkpoint. Subdirectories for full checkpoints have the user-specified checkpoint name. Delta checkpoint subdirectories are named Delta-sequence_number, where the sequence numbers increase with time of creation. Older delta checkpoints have smaller sequence numbers and newer delta checkpoints have larger sequence numbers.

We must archive both the checkpoint metadata and content directories to store a checkpoint for later restoration. Similarly, you must delete both the checkpoint metadata and content directories to delete a checkpoint.

We can delete checkpoints using the Delete option on the console Repository checkpoints page. To access the page, click System administration > Extended repository service > Repository checkpoints.

We can also use the wsadmin deleteCheckpoint command to delete checkpoints. See the topic about the RepositoryCheckpointCommands command group (AdminTask).

What to do next

When recovering a delta checkpoint from an archive location, start with the most recently archived delta checkpoint. Move or unzip the checkpoint directories back to their original locations. To use delta checkpoints for recovering changes or for tracking changes, we need an unbroken chain of delta checkpoints. Do not lose any archived checkpoints and only recover them in the reverse order in which they were archived.

Related tasks

  • Restore checkpoints
  • Configure checkpoints

  • Repository checkpoint collection
  • RepositoryCheckpointCommands (AdminTask)