rollback apply checkpoint

Reverts the system's running configuration to the configuration in a specified or most recent checkpoint file.

Syntax

rollback apply checkpoint [ cp-name [ best-effort | stop-at-first-failure ] [ verbose ] ]

Command Default

The best-effort mode is applied if it is not specified.

Parameters

cp-name
Specifies the name of a checkpoint.
best-effort
Implements a rollback and skips any errors.
stop-at-first-failure
Implements a rollback and stops at the first failure.
verbose
Displays the execution log.

Modes

Privileged EXEC mode

Usage Guidelines

A configuration checkpoint must exist before this command is issued.

Rollback is not permitted when any of the following is in progress:
  • Configuration replay
  • File replay
  • Another rollback operation
  • Checkpoint creation

Configuration parameters that have changed are first removed and the previous values are then reapplied. If cp-name is not specified, the configuration rolls back to the most recent created checkpoint. This is not the same as an undo/redo scenario. Once the rollback process is complete, the system runs with the exact configurations in the checkpoint file.

Once the rollback is successfully completed, the execution of the show rollback diff checkpoint command, comparing the checkpoint and the running configuration file, should not report any differences.

The user can view any errors/warnings encountered during the rollback operation. The user is responsible for cleaning up the already applied changes before the error has occurred, by viewing the configuration differences between checkpoint and the running configuration.

Use of the Control+C key combination is not recommended during the rollback operation. Although Control+C is not blocked, it could leave the device with an indeterminate configuration. When the user issues the rollback command, a warning is issued that tells the user not to abort an ongoing rollback session.

The following table lists additional error conditions and messages.
Table 1. Error conditions and messages
Condition Message
All the north bound configurations are blocked when rollback operation is in progress.
%ERROR: Rollback configuration is in progress.
Please try after sometime.
Configuration replay is in progress.
%ERROR: The node is not ready to handle all
commands
File replay is in progress.
%ERROR: Configuration rollback not allowed when
file replay is in progress, try again later
Another rollback operation is in progress.
%ERROR: There is another configuration rollback
session in progress, try again later

Examples

This example reverts the configuration to a checkpoint named "user_checkpoint1".

device# rollback apply checkpoint user_checkpoint1
This operation will modify the running configuration of the system. Do you want to continue? [Y/N]y
% Warning: Configuration Rollback is in-progress.
Please do not abort an ongoing session as it can leave the system with an inconsistent configuration.
......
Rollback completed successfully.