14. Tasks/Commands for Dealing with Configuration Checkpoints

14.1. checkpoint

The checkpoint task creates a configuration checkpoint with the given name. It is equivalent to using the “Administration/Configuration/Configuration Checkpoint” screen of WebGUI. If the checkpoint with the provided name already exists, it is automatically deleted (this is different from WebGUI’s behavior). Note that DataPower can accommodate only a limited number of checkpoints in a domain.

If the checkpoint’s name contains dots, they will be replaced with underscores. This makes it easier to accommodate version numbers in the checkpoint name.

14.1.1. Attributes/Options

Name	Description	Required
name	Name of the checkpoint.	Yes
appendTimestamp	If true, append timestamp to the checkpoint name. Use with caution as this could quickly create a large number of checkpoints. The timestamp has the format “yyyyMMdd_HHmmss”. Defaults to false.	No

14.1.2. Examples

dpbuddy checkpoint -name release-1.0.1  -save

<dp:checkpoint name="release-1.0.1" save="true"/>

14.2. rollback

This tasks reverts the domain configuration to the specified checkpoint or to the latest checkpoint. Note that the content of the local file system will also be restored using the files that resided on the local:/ at the time of the checkpoint.

14.2.1. Attributes/Options

Name	Description	Required
name	Name of the checkpoint to which to rollback. Defaults to the latest checkpoint in the domain. If the domain does not have any checkpoints, an exception will be raised.	No

14.2.2. Examples

dpbuddy rollback -save

<dp:rollback save="true"/>

14.3. delCheckpoint

This task deletes configuration checkpoints. Since DataPower can accommodate only a limited number of checkpoints, it may be necessary to delete old checkpoints from time to time.

The default number of checkpoints for a domain is 3. You can increase this limit from the domain configuration screen in WebGUI.

14.3.1. Attributes/Options

Name	Description	Required
name	Name of the checkpoint to remove.	Yes, unless namePattern was provided.
namePattern	Regular expression pattern defining checkpoints to remove. Use .* to delete all checkpoints.	Yes, unless name was provided.
matchRequired	If set to true, fail if no checkpoints matched the pattern specified in namePattern. Defaults to true.	No

14.3.2. Examples

dpbuddy delCheckpoint -namePattern ".*1_0_1" -matchRequired false

<dp:delCheckpoint namePattern=".*1_0_1"/>