The rollback configuration command rolls the system configuration back to a preceding configuration.
Parameter | Description | Value |
---|---|---|
to |
The system will be rolled back to the configurations when the configuration rollback point is generated. |
- |
commit-id commit-id |
Specifies the label of the configuration rollback point to which the system configuration is expected to roll back. |
The value is an integer that is generated automatically and ranging from 1000000001 to 1999999999, the value of periodical configuration rollback point is ranging from 2000000001 to 2999999999. |
last number-of-commits |
Specifies the number of the last configuration rollback point to which the system rolls back. |
The value is an integer ranging from 1 to 80. |
label label |
Specifies a user label for a configuration rollback point. A specified user label indicates the historical configuration state to which the system configuration is expected to roll back. |
The value is a string of 1 to 256 case-sensitive characters. It can be any visible ASCII character except for the space. However, the string can contain spaces if it is enclosed with double quotation marks (" "). The string cannot start with a digit or be a hyphen (-). |
file file-name |
Rolls back the current configuration to the configuration in the specified configuration file. After the rollback, the configuration on the device is the same as that in the specified configuration file. |
The value is a string of 5 to 64 case-sensitive characters in the format of *.zip, *.cfg, or *.dat, spaces not supported. |
Usage Scenario
When an error occurs or the configuration procedure has an unexpected impact on services, run the rollback configuration command to roll the system configuration back to a specified configuration.
Assume that a user has committed four configurations and four consecutive rollback points (A, B, C, and D) are generated. If an error is found in configurations committed at rollback point B and the system must be rolled back, configuration rollback allows the system to roll back to the configurations at rollback point A. Additionally, configuration rollback point E is generated and specially marked with a Rollback flag, indicating that this point is generated because of configuration rollback.
If a configuration rollback error is detected, system configurations can be rolled back to what they were before the configuration rollback operation was performed and the new configuration rollback point is specially marked.
Prerequisites
The display configuration commit changes command has been run to view configuration changes at the rollback point, and system configurations have been determined to roll back. back system configurations.
Follow-up Procedure
Run the display configuration rollback result command to view the configurations that fail to be rolled back and the messages displayed when configuration commands are run.
Precautions