CLI Usage
42
Basic System Configuration Guide
3HE 11010 AAAC TQZZA Edition: 01
3.8 CLI Configuration Rollback
The CLI configuration rollback feature allows operators to save rollback checkpoint
and rescue files that can be used to quickly return the node configuration to a
previous state with minimal impacts to services and without restarting the node.
CLI configuration rollback gives operators better control and visibility over router
configurations and reduces operational risk while increasing flexibility and providing
powerful recovery options.
The location and generic filename of the rollback checkpoint and rescue files must
be configured with the rollback-location and rescue-location commands before a
rollback file can be saved. Files can be saved locally on the compact flash or on a
remote device. The file URL must contain a path or directory and a generic filename
with no extension. File suffixes are automatically appended when the file is saved.
3.8.1 Rollback Checkpoint and Rescue Files
Rollback checkpoint files and rescue files are created with the rollback save
command. A rollback checkpoint file can be saved at any time or configured to be
automatically saved on a recurring schedule using the 7705 SAR CRON feature. For
more information refer to CRON.
Rollback checkpoint and rescue files contain all current operationally active
configurations, including configuration changes from CLI commands in the config
context and SNMP sets. Rollback checkpoint files are intended to be saved
whenever there have been a moderate number of changes to the configuration, in
order to create a series of intermediate checkpoints that operators can return to. The
rollback rescue file is intended to be a permanent stable configuration that can be
reverted to if needed.
Rollback checkpoint and rescue files do not contain any BOF configuration
information or any configuration or state changes performed under the debug branch
of the CLI. Similarly, performing a CLI configuration rollback never impacts the BOF
configuration or any command from the debug CLI branch.
When a rollback save command is executed, a rollback checkpoint or rescue file is
saved in the configured location. The latest rollback checkpoint file is saved with the
suffix *.rb. The suffixes of all previously saved rollback checkpoint files are
automatically incremented by one (*.rb becomes *.rb.1, *.rb.1 becomes *.rb.2, and
so on). The rescue file is saved with the suffix *.rc.