8/3/2019 Archive Config
1/43
pdfcrowd comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
Cisco IOS Software Releases 12.3 T
Configuration Replace and Configuration Rollback
Downloads
Configuration Replace and
Configuration Rollback
Feedback: Help us help you
Please rate this document.
Excellent
Good
Average
Fair
Poor
This document solved myproblem.
Yes
No
Just Browsing
Suggestions to im prove thisdocument.
(512 charac ter limit)
Table Of Contents
Configuration Replace and Configuration RollbackContentsPrerequisites for Configuration Replace and Configuration RollbackRestrictions for Configuration Replace and Configuration RollbackInformation About Configuration Replace and Configuration Rollback
Configuration ArchiveConfiguration ReplaceConfiguration RollbackBenefits of Configuration Replace and Configuration Rollback
How to Use Configuration Replace and Configuration RollbackConfiguring the Configuration ArchivePerforming a Configuration Replace or Configuration Rollback OperationMonitoring and Troubleshooting the Configuration Replace and Configuration RollbackRollback Feature
Configuration Examples for Configuration Replace and Configuration RollbackConfiguring the Configuration Archive: ExampleReplacing the Current Running Configuration w ith a Saved Cisco IOS Configuration File: ExampleReverting to the Star tup Configuration File: ExamplePerforming a Configuration Replace Operation with the conf igure confirm Command: ExamplePerforming a Configuration Rollback Operation: Example
Additional ReferencesRelated DocumentsStandardsMIBsRFCsTechnical Assistance
Command Referencearchive configconfigure confirm
configure replacedebug archive config timestampdebug archive vers ioningmaximumpath (archive configuration)show archiveshow configuration locktime-periodFeature Information for Configuration Replace and Configuration Rollback
Configuration Replace and Configuration Rollback
First Published: March 3, 2004
HOMESUPPORT
PRODUCT SUPPORT
END-OF-SALE AND END-OF-LIFEPRODUCTS
CISCO IOS SOFTWARE RELEASES12.3 T
CONFIGURE
FEATURE GUIDES
Configuration Replace andConfiguration Rollback
Csco.com Worldwde Home
Products & Services Support How to Buy Training & Events Partners Search
Worldwide [change] Log In Acc ount Register My Cisco
http://www.cisco.com/en/US/products/hw/tsd_products_support_end-of-sale_and_end-of-life_products_list.htmlhttp://www.cisco.com/en/US/support/index.htmlhttp://www.cisco.com/en/US/hmpgs/index.htmlhttp://www.cisco.com/en/US/hmpgs/index.htmlhttp://www.cisco.com/en/US/hmpgs/index.htmlhttp://www.cisco.com/en/US/products/index.htmlhttp://www.cisco.com/en/US/hmpgs/index.htmlhttp://www.cisco.com/en/US/docs/ios/12_3t/12_3t7/feature/guide/gtrollbk.pdfhttp://www.cisco.com/web/ordering/root/index.htmlhttp://www.cisco.com/en/US/learning/index.htmlhttp://www.cisco.com/web/ordering/root/index.htmlhttp://www.cisco.com/en/US/learning/index.htmlhttp://www.cisco.com/web/ordering/root/index.htmlhttp://www.cisco.com/en/US/learning/index.htmlhttp://www.cisco.com/web/ordering/root/index.htmlhttp://www.cisco.com/en/US/learning/index.htmlhttp://www.cisco.com/en/US/docs/ios/12_3t/12_3t7/feature/guide/gtrollbk.htmlhttp://www.cisco.com/en/US/products/sw/iosswrel/ps5207/products_feature_guides_list.htmlhttp://www.cisco.com/en/US/products/sw/iosswrel/ps5207/tsd_products_support_configure.htmlhttp://www.cisco.com/en/US/products/sw/iosswrel/ps5207/tsd_products_support_eol_series_home.htmlhttp://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdfhttp://www.cisco.com/en/US/docs/ios/12_3t/12_3t7/feature/guide/gtrollbk.pdfhttp://www.cisco.com/en/US/hmpgs/index.htmlhttp://www.cisco.com/en/US/support/index.htmlhttp://www.cisco.com/cisco/web/psa/configure.html?mode=prodhttp://www.cisco.com/en/US/products/hw/tsd_products_support_end-of-sale_and_end-of-life_products_list.htmlhttp://www.cisco.com/en/US/products/sw/iosswrel/ps5207/tsd_products_support_eol_series_home.htmlhttp://www.cisco.com/en/US/products/sw/iosswrel/ps5207/tsd_products_support_configure.htmlhttp://www.cisco.com/en/US/products/sw/iosswrel/ps5207/products_feature_guides_list.htmlhttp://www.cisco.com/en/US/docs/ios/12_3t/12_3t7/feature/guide/gtrollbk.htmlhttp://www.cisco.com/en/US/hmpgs/index.htmlhttp://www.cisco.com/en/US/products/index.htmlhttp://www.cisco.com/cisco/web/support/index.htmlhttp://www.cisco.com/web/ordering/root/index.htmlhttp://www.cisco.com/en/US/learning/index.htmlhttp://www.cisco.com/en/US/partners/index.htmlhttp://cisco.com/en/US/swassets/sw274/sitewide_country_language_selector.htmlhttp://www.cisco.com/cgi-bin/loginhttp://www.cisco.com/web/siteassets/account/index.htmlhttp://tools.cisco.com/RPF/register/register.dohttp://www.cisco.com/cisco/psn/web/workspace8/3/2019 Archive Config
2/43
pdfcrowd comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
sugges tion, please enter yourfull name and e-mail address.This information is optionaland allows us to contact you ifnecessary.
Name:
E-mail:
Submit
Last Updated: Decemb er 4, 2006; Last Modife d: August 2007
The Configuration Replace and Configuration Rollback f eature provides the capability to replace the current running conf iguration w ith anysaved Cisco IOS configuration file. This f unctionality can be us ed to revert to a previous configuration state, eff ectively rolling back anyconfiguration changes that were made since that configuration file was saved.
Finding Feature Information in This Module
Your Cisco IOS softw are release may not support all of the f eatures documented in this module. To reach links to specif ic featuredocumentation in this module and to see a list of the releases in w hich each feature is supported, use the "Feature Information for ConfigurationReplace and Configuration Rollback" section.
Finding Support Infor mation for Platforms and Cisco IOS Software Im ages
Use Cisco Feature Navigator to f ind information about platform support and sof tw are image support. Cisco Feature Navigator enables you todetermine which Cisco IOS and Catalyst OS softw are images support a specific softw are release, feature set, or platform. To access Cisco
Feature Navigator, go to http://ww w .cisco.com/go/cfn. An account on Cisco.com is not required.
Contents
Prerequisites for Configuration Replace and Configuration Rollback
Restrictions for Configuration Replace and Configuration Rollback
Information About Configuration Replace and Configuration Rollback
How to Use Configur ation Replace and Configuration Rollback
Configuration Examples for Configuration Replace and Configuration Rollback
Additional References
Command Reference
Feature Information for Configuration Replace and Configuration Rollback
Prerequisites for Configuration Replace and Configuration Rollback
The format of the configuration files used as input by the Configuration Replace and Configuration Rollback feature must comply withstandard Cisco IOS softw are configuration file indentation rules as follows:
Start all commands on a new line w ith no indentation, unless the command is within a configuration submode.
Indent commands w ithin a first-level configuration submode one space.
Indent commands within a second-level configuration submode two spaces.
Indent commands within subsequent submodes accordingly.
These indentation rules descr ibe how Cisco IOS softw are creates c onfiguration files for such Cisco IOS commands as show r unning-config orcopy running-config destination-url. Any configuration file generated on a Cisco IOS device complies w ith these rules.
Free memory larger than the combined size of the two conf iguration files (the current running configuration and the saved replacement
configuration) is r equired.
Restrictions for Configuration Replace and Configuration Rollback
If the router does not have free memory larger than the combined size of the two configuration files (the current running configuration andthe saved replacement configuration), the configuration replace operation is not performed.
Certain Cisco IOS configuration commands such as those pertaining to physical components of a netw orking device (for example, physicalinterfaces) cannot be added or r emoved f rom the running configuration. To illustrate, a c onfiguration replace operation cannot remove theinterface e thernet 0 command line from the current running configuration if that interf ace is physically present on the device. Similarly,the interface ether net 1 command line cannot be added to the running configuration if no such interface is physically present on thedevice. A configuration replace operation that attempts to perform these types of c hanges results in error messages indicating that thesespecific command lines failed.
In very rare cases, certain Cisco IOS configuration commands cannot be removed from the Cisco IOS running configuration withoutreloading the router. A c onfiguration replace operation that attempts to remove this ty pe of command results in err or messages indicating
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdfhttp://tools.cisco.com/ITDIT/CFN/8/3/2019 Archive Config
3/43
pdfcrowd comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
that these s pecific command lines failed.
Information About Configuration Replace and Configuration Rollback
To use the Configuration Replace and Configuration Rollback feature, you should understand the f ollow ing concepts:
Configuration Archive
Configuration Replace
Configuration Rollback
Benefits of Configuration Replace and Configuration Rollback
Configuration Archive
The Cisco IOS configuration archive is intended to provide a mechanism to store, organize, and manage an archive of Cisco IOS configurationfiles to enhance the conf iguration rollback capability provided by the configure replace command. Before this feature w as introduced, youcould save copies of the running configuration using the copy running-configdestination-urlcommand, storing the replacement file eitherlocally or remotely. How ever , this method lacked any automated file management. On the other hand, the Configurat ion Replace andConfiguration Rollback feature prov ides the capability to automatically save copies of the running configuration to the Cisco IOS configurationarchive. These archived files serve as checkpoint configuration references and can be used by the configure replace command to revert toprevious configuration states.
The archive config command allows you to save Cisco IOS conf igurations in the configuration archive using a standard location and filenameprefix that is automatically appended w ith an incremental version number (and optional timestamp) as each consecutive f ile is saved. Thisfunctionality provides a means for consistent identification of saved Cisco IOS configuration files. You can specify how many vers ions of therunning configuration are kept in the archive. Af ter the maximum number of files are saved in the archive, the oldest file is automatically deletedw hen the next, most recent file is saved. The show archive command displays information for all configuration files sav ed in the Cisco IOSconfiguration archive.
The Cisco IOS configuration archive, in w hich the configuration files are stored and available for use w ith the configure replace command,
can be located on the following file systems:
If your platform has disk0disk0:, disk1:, ftp:, pram:, rcp:, slavedisk0:, slavedisk1:, or tftp:
If your platform does not have disk0ftp:, http:, pram:, rcp:, or tftp:
Configuration Replace
The configure replace command provides the c apability to r eplace the current running configuration w ith any saved Cisco IOS configurationfile. This functionality can be used to r evert to a previous configuration state, effec tively rolling back any configuration changes that w ere madesince the previous configuration state was saved.
When using the configure replace command, you must specif y a s aved Cisco IOS configuration as the r eplacement configuration file for thecurrent r unning conf iguration. The replacement file must be a complete conf iguration generated by a Cisco IOS device (for example, aconfiguration generated by the copy running-configdestination-urlcommand), or, if generated externally, the replacement file must complyw ith the format of f iles generated by Cisco IOS devices. When the configure replace command is entered, the curr ent running conf igurationis compared with the specif ied replacement conf iguration and a set of dif fs is generated. The algorithm used to compare the tw o files is the
same as that employed by the show archive config differences command. The resulting diffs are then applied by the Cisco IOS parser toachieve the replacement configuration state. Only the diff s are applied, avoiding potential service disruption from reapplying configurationcommands that already ex ist in the c urrent running configuration. This algorithm effectively handles conf iguration changes to order-dependentcommands (such as acc ess lists) through a multiple pass process. Under normal circumstances, no more than three passes are needed tocomplete a conf iguration replace operation, and a limit of five passes is perf ormed to prec lude any looping behavior.
The Cisco IOS copysource-urlrunning-config command is often used to copy a stored Cisco IOS configuration file to the runningconfiguration. When using the copysource-urlrunning-config command as an alternative to the configure replace target-urlcommand, thefollow ing major differences should be noted:
The copysource-urlrunning-config command is a merge operation and preserves all the commands from both the source file and thecurrent r unning configuration. This command does not r emove commands f rom the current r unning configuration that are not present in thesource file. In contrast, the configure replace target-urlcommand removes commands f rom the current running configuration that arenot present in the replacement file and adds commands to the current running configuration that need to be added.
The copysource-urlrunning-config command applies every c ommand in the source file, w hether or not the command is already present
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
4/43
pdfcrowd comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
in the current running configuration. This algorithm is ineff icient and, in some cases , can r esult in service outages. In contrast , theconfigure replace target-urlcommand only applies the commands that need to be appliedno existing commands in the current runningconfiguration are reapplied.
A partial configuration file may be used as the source file for the copysource-urlrunning-config command, w hereas a complete CiscoIOS configuration file must be used as the replacement file for the configure replace target-urlcommand.
Note In Cisco IOS Release 12.2(25)S and 12.3(14)T, a locking feature f or the c onfiguration replace operation w as introduced. When the configurereplace command is used, the running configuration file is locked by default f or the duration of the conf iguration replace operation. Thislocking mechanism prevents other user s f rom changing the running conf iguration w hile the replacement operation is taking place, w hichmight otherw ise cause the r eplacement operation to terminate unsuccessf ully. You can disable the locking of the running configuration byusing the nolock keyword w hen issuing the configure replace command.
The running conf iguration lock is automatically c leared at the end of the conf iguration replace operation. You can display any locks that may becurrently applied to the running conf iguration using the show configuration lock command.
Configuration Rollback
The concept of rollback comes f rom the transactional processing model common to database operations. In a database tr ansaction, you mightmake a set of changes to a given database table. You then must choose w hether to commit the changes (apply the changes permanently) or toroll back the changes (discard the changes and revert to the previous state of the table). In this context, rollback means that a journal filecontaining a log of the changes is discarded, and no changes are applied. The result of the rollback operation is to revert to the prev ious state,before any changes w ere applied.
The configure replace command allow s you to revert to a previous configuration state, effectively rolling back changes that w ere made sincethe previous configuration state w as saved. Instead of basing the rollback operation on a specific s et of c hanges that w ere applied, the CiscoIOS configuration rollback capability uses the c oncept of reverting to a specific configuration state based on a saved Cisco IOS configurationfile. This concept is similar to the database idea of saving a checkpoint (a saved version of the database) to preserve a specif ic state.
If the c onfiguration rollback capability is desired, you must save the Cisco IOS running configuration before making any conf iguration changes.Then, af ter entering configuration changes, you can us e that saved c onfiguration file to roll back the changes (using the configure replacetarget-urlcommand). Furthermore, since you can spec ify any saved Cisco IOS configuration file as the r eplacement configuration, you are notlimited to a fixed number of rollbacks, as is the case in some rollback models based on a journal file.
Benefits of Configuration Replace and Configuration Rollback
Allow s you to revert to a previous configuration state, effectively rolling back configuration changes.
Allow s you to replace the current running configuration file with the startup configuration file without having to reload the router ormanually undo CLI changes to the running configuration file, therefore reducing sys tem downtime.
Allow s you to revert to any saved Cisco IOS configuration state.
Simplifies configuration changes by allow ing you to apply a complete configuration file to the router, where only the commands that need tobe added or removed are aff ected.
When us ing the configure replace command as an alternative to the copysource-urlrunning-config command, increases ef ficiencyand prevents risk of service outages by not reapplying existing commands in the current r unning conf iguration.
How to Use Configuration Replace and Configuration Rollback
This section contains the following procedures:
Configuring the Configuration Ar chive (optional)
Performing a Configuration Replace or Configuration Rollback Operation (required)
Monitoring and Troubleshooting the Configuration Replace and Configuration RollbackRollback Feature (optional)
Configuring the Configuration Archive
No prerequisite conf iguration is needed to us e the configure replace command. Using the configure replace command in conjunction w ith
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
5/43
pdfcrowd comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
the Cisco IOS configuration archive and the archive config command is optional but off ers s ignificant benefit for configuration rollbackscenarios. Before using the archive config command, the conf iguration archive must be configured. Perform this task to conf igure thecharacteristics of the configuration archive.
SUMMARY STEPS
1. enable
2. configure term inal
3. archive
4. pathurl
5. maximum number
6. time-periodminutes
7. end
DETAILED STEPS
Command orAction Purpose
Step 1 enable
Example:
Router> enable
Enables privileged EXEC mode.
Enter your passw ord if prompted.
Step 2 configureterminal
Example:
Router#
configure
terminal
Enters global configuration mode.
Step 3 archive
Example:
Router(config)#
archive
Enters archive configuration mode.
Step 4 pathurl
Example:
Router(config-
archive)# path
disk0:myconfig
Specifies the location and filename prefix for the files in the Cisco IOSconfiguration archive.
The urlargument is a URL (accessible by the Cisco IOS file system)used for saving archive f iles of the running configuration file in the
Cisco IOS configuration archive. You c an set up an arc hive on anyfile system that your platform supports (see the "ConfigurationArchive" section).
Step 5 maximumnumber
Example:
Router(config-
archive)#
maximum 14
(Optional) Sets the maximum number of archive files of the runningconfiguration to be saved in the Cisco IOS configuration archive.
The numberargument is the maximum number of archive files of therunning configuration to be saved in the Cisco IOS configurationarchive. Valid values are f rom 1 to 14. The default is 10.
Note Before using this command, you must configure the path commandto specify the location and filename prefix f or the files in theCisco IOS conf iguration archive.
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
6/43
pdfcrowd comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
Step 6 time-periodminutes
Example:
Router(config-
archive)# time-
period 10
(Optional) Sets the time increment for automatically saving an archive fileof the current running configuration in the Cisco IOS configurationarchive.
The minutes argument specifies how often, in minutes, toautomatically save an archive file of the current runningconfiguration in the Cisco IOS configuration archive.
Note Before using this command, you must configure the path commandto specify the location and filename prefix f or the files in theCisco IOS conf iguration archive.
Step 7 end
Example:
Router(config-
archive)# end
Exits to priv ileged EXEC mode.
Performing a Configuration Replace or Configuration Rollback Operation
Perform this task to replace the current running configuration file w ith a saved Cisco IOS configuration file.
SUMMARY STEPS
1. Configure the Cisco IOS configuration archive.
2. enable
3. archive config
4. configure term inal
5. Enter changes to the current running configuration.
6. exit
7. configure replacetarget-url[list] [force ] [timeseconds] [nolock]
8. configure confirm
9. exit
DETAILED STEPS
Command orAction Purpose
Step 1 Configure the
Cisco IOSconfigurationarchive.
See the "Configuring the Configuration Archive" sec tion.
Step 2 enable
Example:
Router> enable
Enables privileged EXEC mode.
Enter your passw ord if prompted.
Step 3 archive config
Example:
Router# archive
config
(Optional) Saves the c urrent running configuration file to theconfiguration archive.
Note The path command must be configured before using thiscommand.
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
7/43
pdfcrowd comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
Step 4 configureterminal
Example:
Router#
configure
terminal
Enters global configuration mode.
Step 5 Enter changes tothe currentrunningconfiguration.
Step 6 exit
Example:
Router(config)#
exit
Exits to priv ileged EXEC mode.
Step 7 configurereplacetarget-
url [list]
[force] [time
seconds]
[nolock]
Example:
Router#
configure
replace
disk0:myconfig-
1 list time 30
Replaces the c urrent running configuration file w ith a saved Cisco IOSconfiguration file.
The target-urlargument is a URL (accessible by the Cisco IOS filesys tem) of the saved Cisco IOS configuration file that is to replacethe current running configuration, such as the configuration filecreated in Step 3 using the archive config command.
The list keyw ord displays a list of the command lines applied by theCisco IOS softw are parser during each pass of the configurationreplace operation. The total number of passes performed is alsodisplayed.
The force keyw ord replaces the current running configuration filew ith the specified saved Cisco IOS configuration file w ithoutprompting you f or c onfirmation.
The timeseconds keyw ord and argument specif y the time (inseconds) w ithin w hich you must enter the configure confirmcommand to confirm replacement of the current runningconfiguration file. If the configure confirm command is notentered w ithin the specified time limit, the c onfiguration replaceoperation is automatically reversed ( in other words, the currentrunning configuration file is restored to the configuration state thatexisted prior to entering the configure replace command).
The nolock keyw ord disables the locking of the runningconfiguration file that prevents other users from changing therunning configuration during a conf iguration replace operation.
Step 8 configureconfirm
Example:
Router#
configure
confirm
(Optional) Confirms replacement of the current running configuration filew ith a saved Cisco IOS configuration file.
Note Use this command only if the timeseconds keyword andargument of the configure replace command are specified.
Step 9 exit
Example:
Router# exit
Exits to user EXEC mode.
Monitoring and Troubleshooting the Configuration Replace and Configuration RollbackRollback Feature
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
8/43
pdfcrowd comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
Perform this task to monitor and troubleshoot the Configuration Replace and Configuration Rollback feature.
SUMMARY STEPS
1. enable
1. show archive
2. debug archive versioning
3. debug archive config times tamp
4. exit
DETAILED STEPS
Step 1 enable
Use this command to enable privileged EXEC mode. Enter your passw ord if pr ompted. For example:
Router> enable
Router#
Step 2 show archive
Use this command to display information about the files saved in the Cisco IOS configuration archive. For example:
Router# show archive
There are currently 1 archive configurations saved.
The next archive file will be named disk0:myconfig-2
Archive # Name
0
1 disk0:myconfig-1
8/3/2019 Archive Config
9/43
df d mi b PRO i Are you a developer? Try out the HTML to PDF API
13
14
The following is sample output f rom the show archive command after s everal archive f iles of the r unning configuration have been saved. Inthis example, the maximum number of archive f iles to be saved is set to three.
Router# show archive
There are currently 3 archive configurations saved.
The next archive file will be named disk0:myconfig-8
Archive # Name
0
1 :Deleted
2 :Deleted
3 :Deleted
4 :Deleted
5 disk0:myconfig-5
6 disk0:myconfig-6
7 disk0:myconfig-7
8/3/2019 Archive Config
10/43
df di b PRO i Are you a developer? Try out the HTML to PDF API
Jan 9 06:46:29.547: backup worked
Step 4 debug archive config times tamp
Use this command to enable debugging of the process ing time for each integral step of a conf iguration replace operation and the size of theconfiguration files being handled. For example:
Router# debug archive config timestamp
Router# configure replace disk0:myconfig force
Timing Debug Statistics for IOS Config Replace operation:
Time to read file slot0:sample_2.cfg = 0 msec (0 sec)
Number of lines read:55
Size of file :1054
Starting Pass 1
Time to read file system:running-config = 0 msec (0 sec)
Number of lines read:93
Size of file :2539Time taken for positive rollback pass = 320 msec (0 sec)
Time taken for negative rollback pass = 0 msec (0 sec)
Time taken for negative incremental diffs pass = 59 msec (0 sec)
Time taken by PI to apply changes = 0 msec (0 sec)
Time taken for Pass 1 = 380 msec (0 sec)
Starting Pass 2
Time to read file system:running-config = 0 msec (0 sec)
Number of lines read:55
Size of file :1054
Time taken for positive rollback pass = 0 msec (0 sec)
Time taken for negative rollback pass = 0 msec (0 sec)
Time taken for Pass 2 = 0 msec (0 sec)
Total number of passes:1
Rollback Done
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
11/43
df di b PRO i A d l ? T t th HTML t PDF API
Step 5 exit
Use this command to exit to user EXEC mode. For example:
Router# exit
Router>
Configuration Examples for Configuration Repla ce and Configuration Rollback
This s ection provides the follow ing configuration examples:
Configuring the Configuration Archive: Example
Replacing the Current Running Configurat ion w ith a Saved Cisco IOS Configur ation File: Example
Reverting to the Star tup Configuration File: Example
Performing a Configuration Replace Operation w ith the conf igure conf irm Command: Example
Performing a Configuration Rollback Operation: Example
Configuring the Configuration Archive: Example
The following example shows how to perform the initial configuration of t he Cisco IOS configuration archive. In this example, disk0:myconf ig isspecified as the location and filename prefix for the files in the configuration archive and a value of 10 is set as the maximum number of archivefiles to be saved.
configure terminal
!
archive
path disk0:myconfig
maximum 10
end
Replacing the Current Running Configuration with a Saved Cisco IOS Configuration File: Example
The following example show s how to replace the current running configuration with a saved Cisco IOS configuration file nameddisk0:myconf ig. The configure replace command interactively prompts you to c onfirm the operation.
Router# configure replace disk0:myconfig
This will apply all necessary additions and deletions
to replace the current running configuration with the
contents of the specified configuration file, which is
assumed to be a complete configuration, not a partial
configuration. Enter Y if you are sure you want to proceed. ? [no]: Y
Total number of passes: 1
Rollback Done
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
12/43df di b PRO i A d l ? T t th HTML t PDF API
In the follow ing example, the list keyw ord is specified in order to display the command lines that w ere applied during the configuration replaceoperation:
Router# configure replace disk0:myconfig list
This will apply all necessary additions and deletions
to replace the current running configuration with the
contents of the specified configuration file, which is
assumed to be a complete configuration, not a partial
configuration. Enter Y if you are sure you want to proceed. ? [no]: Y
!Pass 1
!List of Commands:
no snmp-server community public ro
snmp-server community mystring ro
end
Total number of passes: 1
Rollback Done
Reverting to the Startup Configuration File: Example
The following example show s how to revert to the Cisco IOS startup configuration file using the configure replace command. This examplealso show s the use of the optional force keyw ord to override the interactive user prompt.
Router# configure replace nvram:startup-config force
Total number of passes: 1
Rollback Done
Performing a Configuration Replace Operation with the configure confirm Command: Example
The follow ing example shows the use of the configure replace command w ith the timeseconds keyw ord and argument. You must enter theconfigure confirm command w ithin the specified time limit to confirm replacement of the current running configuration file. If the configureconfirm command is not entered w ithin the specified time limit, the c onfiguration replace operation is automatically reversed (in other w ords,the current running configuration file is res tored back to the conf iguration state that existed prior to entering the configure replace command).
Router# configure replace nvram:startup-config time 120
This will apply all necessary additions and deletions
t l th t i fi ti ith th
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
13/43df di b PRO i
Are you a developer? Try out the HTML to PDF API
to replace the current running configuration with the
contents of the specified configuration file, which is
assumed to be a complete configuration, not a partial
configuration. Enter Y if you are sure you want to proceed. ? [no]: Y
Total number of passes: 1
Rollback Done
Router# configure confirm
Performing a Configuration Rollback Operation: Example
The following example show s how to make changes to the current running configuration and then roll back the changes. As part of theconfiguration rollback operation, you must save the c urrent running configuration before making changes to the f ile. In this example, the archiveconfig command is used to save the current running configuration. The generated output of the configure replace command indicates thatonly one pass w as performed to complete the rollback operation.
Note Before using the archive config command, you must configure the path command to specif y the location and filename prefix for the files inthe Cisco IOS configuration archive.
You firs t save the current running configuration in the configuration archive as f ollows:
archive config
You then enter configuration changes as show n in the following example:
configure terminal
!
user netops2 password rain
user netops3 password snow
exit
Af ter having made changes to the running configuration file, assume you now w ant to roll back these changes and revert to the configurationthat existed before the changes w ere made. The show archive command is used to verify the version of the configuration to be used as areplacement file. The configure replace command is then used to revert to the r eplacement configuration file as s how n in the follow ingexample:
Router# show archive
There are currently 1 archive configurations saved.
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
14/43df di b PRO iAre you a developer? Try out the HTML to PDF API
The next archive file will be named disk0:myconfig-2
Archive # Name
0
1 disk0:myconfig-1
8/3/2019 Archive Config
15/43df di b PRO iAre you a developer? Try out the HTML to PDF API
No new or modified standards are supported by this f eature, and support for existing standards has notbeen modified by this feature.
MIBs
MIBs MIBs Link
No new or modified MIBs are supported by thisfeature, and support for existing MIBs has not beenmodified by this f eature.
To locate and dow nload MIBs for selected platforms,Cisco IOS releases, and f eature sets, use Cisco MIBLocator found at the follow ing URL:
http://ww w .cisco.com/go/mibs
RFCs
RFCs Title
No new or modified RFCs are s upported by this f eature, and support for existing RFCs has not beenmodified by this f eature.
Technical Assistance
Description Link
The Cisco Technical Support & Documentation webs ite contains thousandsof pages of s earchable technical content, including links to products,technologies, s olutions, technical tips, and tools. Registered Cisco.comusers c an log in from this page to access even more content.
http://ww w .cisco.com/techsupport
Command Reference
This section documents new and modified commands only.
archive config
configure confirm
configure replace
debug archive config timestamp
debug archive versioning
maximum
path (archive configuration)
show archive
show configuration lock
time-period
archive config
f f C OS f
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdfhttp://www.cisco.com/go/mibshttp://www.cisco.com/techsupport8/3/2019 Archive Config
16/43
Are you a developer? Try out the HTML to PDF API
To save a copy of the current running conf iguration to the Cisco IOS configuration archive, use the archive config command in privilegedEXEC mode.
archive config
Syntax Description
This c ommand has no arguments or keyw ords.
Command Modes
Privileged EXEC
Command History
Release Modification
12.3(7)T This c ommand w as introduc ed.
12.2(25)S This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(27)SBC This command w as integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA This command w as integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2 This command w as implemented on the Cisco 10000 series.
Usage Guidelines
Note Before using this command, you must configure the path command in order to specif y the location and filename prefix for the files in the CiscoIOS configuration archive.
The Cisco IOS configuration archive is intended to provide a mechanism to store, organize, and manage an archive of Cisco IOS configurationfiles to enhance the conf iguration rollback capability provided by the configure replace command. Before this feature w as introduced, youcould save copies of the running configuration using the copy running-configdestination-urlcommand, storing the target file either locally orremotely. However , this method lacked any automated file management. On the other hand, the Configurat ion Replace and ConfigurationRollback feature prov ides the capability to automatically save copies of the running configuration to the Cisco IOS configuration archive. Thesearchived files serve as checkpoint configuration references and can be used by the configure replace command to revert to previousconfiguration states.
The archive config command allows you to save Cisco IOS conf igurations in the configuration archive using a standard location and filenameprefix that is automatically appended w ith an incremental version number (and optional time stamp) as each consecutive f ile is saved. This
functionality provides a means for consistent identification of saved Cisco IOS configuration files. You can specify how many vers ions of therunning configuration are kept in the archive. Af ter the maximum number of files has been saved in the archive, the oldest file is automaticallydeleted when the next, most recent f ile is saved. The show archive command displays information for all configuration files sav ed in the CiscoIOS configuration archive.
Examples
The following example show s how to save the curr ent running configuration to the Cisco IOS configuration archive using the archive configcommand. Before using the archive config command, you must configure the path command to specify the location and filename prefix f or thefiles in the Cisco IOS configuration archive. In this example, the location and filename prefix are specif ied as disk0:myconf ig as follows:
configure terminal
!
archive
path disk0:myconfig
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
17/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
p y g
end
You then save the curr ent running configuration in the configuration archive, as follow s:
archive config
The show archive command displays information on the f iles saved in the conf iguration archive as show n in the follow ing sample output:
Router# show archive
There are currently 1 archive configurations saved.
The next archive file will be named disk0:myconfig-2
Archive # Name
0
1 disk0:myconfig-1
8/3/2019 Archive Config
18/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
showarchive
sp ays o a o abou e es sa ed e Csco OS co gu a o a c e
time-period Sets the time increment for automatically saving an archive file of the current runningconfiguration in the Cisco IOS configuration archive.
configure confirm
To confirm replacement of the current running configuration w ith a saved Cisco IOS configuration file, use the configure confirm command inprivileged EXEC mode.
configure confirm
Syntax Description
This c ommand has no arguments or keyw ords.
Command Modes
Privileged EXEC
Command History
Release Modification
12.3(7)T This c ommand w as introduc ed.
12.2(25)S This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(27)SBC This command w as integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA This command w as integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2 This command w as implemented on the Cisco 10000 series.
Usage Guidelines
The configure confirm command is used only if the timeseconds keyw ord and argument of the configure replace command arespecified. If the configure confirm command is not entered w ithin the specif ied time limit, the conf iguration replace operation is automaticallyreversed (in other w ords, the curr ent running configuration file is restored to the conf iguration state that existed prior to entering the configurereplace command).
Examples
The follow ing example shows the use of the configure replace command w ith the timeseconds keyw ord and argument. You must enter theconfigure confirm command w ithin the specified time limit to confirm replacement of the current running configuration file:
Router# configure replace nvram:startup-config time 120
This will apply all necessary additions and deletions
to replace the current running configuration with the
contents of the specified configuration file, which is
assumed to be a complete configuration, not a partial
configuration. Enter Y if you are sure you want to proceed. ? [no]: Y
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
19/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
Total number of passes: 1
Rollback Done
Router# configure confirm
Related Commands
Command Description
archiveconfig
Saves a copy of the current running configuration to the Cisco IOS configuration archive.
configurereplace
Replaces the curr ent running configuration with a s aved Cisco IOS configuration file.
maximum Sets the maximum number of archive f iles of the running configuration to be saved in the CiscoIOS conf iguration archive.
path Specifies the location and filename prefix for the files in the Cisco IOS configuration archive.
show
archive
Displays information about the f iles saved in the Cisco IOS configuration archive.
time-period Sets the time increment for automatically saving an archive file of the current runningconfiguration in the Cisco IOS configuration archive.
configure replace
To replace the current running configuration w ith a saved Cisco IOS configuration file, use the configure replace command in privileged EXECmode.
configure replace target-url[list] [force ] [timeseconds] [nolock]
Syntax Description
target-
url
URL (accessible by the Cisco IOS file sys tem) of the saved Cisco IOS configuration file that is toreplace the curr ent running configuration.
list (Optional) Displays a list of the command lines applied by the Cisco IOS softw are parser during eachpass of the configuration replace operation. The total number of passes performed is also displayed.
force (Optional) Replaces the c urrent running configuration file w ith the specified saved Cisco IOSconfiguration file w ithout prompting you for confirmation.
timeseconds
(Optional) Time (in seconds) w ithin which you must enter the configure confirm command toconfirm replacement of the current running configuration file. If the configure confirm command isnot entered w ithin the specified time limit, the c onfiguration replace operation is automatically r eversed(in other w ords, the curr ent running configuration file is restored to the conf iguration state that existed
prior to entering the configure replace command).
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
20/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
nolock (Optional) Disables the locking of the r unning configuration file that prevents other users fr omchanging the running configuration during a c onfiguration replace operation.
Command Modes
Privileged EXEC
Command History
Release Modification
12.3(7)T This c ommand w as introduc ed.
12.2(25)S The nolock keyword w as added.
12.2(27)SBC This command w as integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA This command w as integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB This command w as implemented on the Cisco 10000 series.
Usage Guidelines
When configuring more than one keyw ord option, use the follow ing rules:
The list keyw ord must be entered before the force and time keywords.
The force keyw ord must be entered before the time keyword.
If the curr ent running configuration is replaced w ith a saved Cisco IOS configuration file that contains commands unaccepted by the Cisco IOSsoftw are parser, an error message is displayed listing the commands that w ere unaccepted. The total number of pass es performed in theconfiguration replace operation is also displayed.
Note In Cisco IOS Release 12.2(25)S, a locking feature f or the c onfiguration replace operation w as introduced. When the configure replacecommand is enabled, the Cisco IOS running conf iguration f ile is locked by default for the duration of the conf iguration replace operation.This locking mechanism prevents other users from changing the running configuration w hile the replace operation is taking place, w hichmight otherw ise cause the r eplace operation to terminate unsucces sfully. You can disable the locking of the running configuration usingthe configure replace nolock command.
The running conf iguration lock is automatically c leared at the end of the conf iguration replace operation. It is not expected that you s hould needto clear the lock manually during the replace operation, but as a protection against any unfor eseen circumstances, you can manually clear thelock using the clear configuration lock command. You can also display any locks that may be c urrently applied to the running configurationusing the show configuration lock command.
Examples
This s ection contains the follow ing examples:
Replacing the Current Running Configur ation w ith a Saved Cisco IOS Configur ation File
Reverting to the Startup Configuration File
Performing a Configur ation Replace Operation with the conf igure conf irm Command
Performing a Configuration Rollback Operation
Replacing the Curren t Running Configuration w ith a Saved Cisco IOS Configuration File
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
21/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
The following example show s how to replace the current running configuration with a saved Cisco IOS configuration file nameddisk0:myconf ig. Note that the configure replace command interactively prompts you to confirm the operation.
Router# configure replace disk0:myconfig
This will apply all necessary additions and deletions
to replace the current running configuration with the
contents of the specified configuration file, which is
assumed to be a complete configuration, not a partial
configuration. Enter Y if you are sure you want to proceed. ? [no]: Y
Total number of passes: 1
Rollback Done
In the follow ing example, the list keyw ord is specified to display the command lines that w ere applied during the configuration replaceoperation:
Router# configure replace disk0:myconfig list
This will apply all necessary additions and deletions
to replace the current running configuration with the
contents of the specified configuration file, which is
assumed to be a complete configuration, not a partial
configuration. Enter Y if you are sure you want to proceed. ? [no]: Y
!Pass 1
!List of Commands:
no snmp-server community public ro
snmp-server community mystring ro
end
Total number of passes: 1
Rollback Done
Reverting to the Startup Configuration File
f C OS f f f f
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
22/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
The following example show s how to revert to the Cisco IOS startup configuration file. This example also show s the use of the optional forcekeyw ord to override the interactive user prompt.
Router# configure replace nvram:startup-config force
Total number of passes: 1
Rollback Done
Performing a Configuration Replace Operation with the configure confirm Command
The follow ing example shows the use of the configure replace command w ith the timeseconds keyw ord and argument. You must enter the
configure confirm command w ithin the specified time limit to confirm replacement of the current running configuration file. If the configureconfirm command is not entered w ithin the specified time limit, the c onfiguration replace operation is automatically reversed (in other w ords,the current running configuration file is res tored to the conf iguration state that exis ted prior to entering the configure replace command).
Router# configure replace nvram:startup-config time 120
This will apply all necessary additions and deletions
to replace the current running configuration with the
contents of the specified configuration file, which is
assumed to be a complete configuration, not a partial
configuration. Enter Y if you are sure you want to proceed. ? [no]: Y
Total number of passes: 1
Rollback Done
Router# configure confirm
Perform ing a Configuration Rollback Operation
The following example show s how to make changes to the current running configuration and then roll back the changes. As part of theconfiguration rollback operation, you must save the c urrent running configuration before making changes to the f ile. In this example, the archiveconfig command is used to save the current running configuration. Note that the generated output of the configure replace commandindicates that only one pass w as perf ormed to complete the rollback operation.
Note The path command must be configured bef ore using the archive config command.
You firs t save the current running configuration in the configuration archive as f ollows:
Router# archive config
You then enter configuration changes as show n in the following example:
Router# configure terminal
Router(config)# user netops2 password rain
( fi ) d
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
23/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
Router(config)# user netops3 password snow
Router(config)# exit
Af ter making changes to the running configuration file, you might want to roll back these changes and revert to the configuration that existedbefore the changes w ere made. The show archive command is used to verify the version of the configuration to be used as a target file. Theconfigure replace command is then used to revert to the target c onfiguration file as show n in the follow ing example:
Router# show archive
There are currently 1 archive configurations saved.
The next archive file will be named disk0:myconfig-2
Archive # Name
0
1 disk0:myconfig-1
8/3/2019 Archive Config
24/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
maximum Sets the maximum number of archive f iles of the r unning configuration to be saved in the CiscoIOS conf iguration archive.
path Specifies the location and filename prefix for the files in the Cisco IOS configuration archive.
showarchive
Displays information about the f iles saved in the Cisco IOS configuration archive.
time-period Sets the time increment for automatically saving an archive file of the current runningconfiguration in the Cisco IOS configuration archive.
debug archive config timestamp
To enable debugging of t he processing time for each integral step of a configuration replace operation and the size of the configuration filesbeing handled, use the debug archive config timestamp command in privileged EXEC mode. To disable debugging output, use the no formof this command.
debug archive config timestamp
no debug archive config timestamp
Syntax Description
This c ommand has no arguments or keyw ords.
Command Modes
Privileged EXEC
Command History
Release Modification
12.3(7)T This c ommand w as introduc ed.
12.2(25)S This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(27)SBC This command w as integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA This command w as integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2 This command w as implemented on the Cisco 10000 series.
Examples
The following is sample output f rom the debug archive config timestamp command:
Router# debug archive config timestamp
Router# configure replace disk0:myconfig force
Timing Debug Statistics for IOS Config Replace operation:
Time to read file slot0:sample_2.cfg = 0 msec (0 sec)
Number of lines read:55
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
25/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
Number of lines read:55
Size of file :1054
Starting Pass 1
Time to read file system:running-config = 0 msec (0 sec)
Number of lines read:93
Size of file :2539
Time taken for positive rollback pass = 320 msec (0 sec)Time taken for negative rollback pass = 0 msec (0 sec)
Time taken for negative incremental diffs pass = 59 msec (0 sec)
Time taken by PI to apply changes = 0 msec (0 sec)
Time taken for Pass 1 = 380 msec (0 sec)
Starting Pass 2
Time to read file system:running-config = 0 msec (0 sec)
Number of lines read:55
Size of file :1054
Time taken for positive rollback pass = 0 msec (0 sec)
Time taken for negative rollback pass = 0 msec (0 sec)
Time taken for Pass 2 = 0 msec (0 sec)
Total number of passes:1
Rollback Done
Related Commands
Command Description
debug archive versioning Enables debugging of the Cisco IOS configuration archive activities.
debug archive versioning
To enable debugging of the Cisco IOS configuration archive activities, use the debug archive versioning command in privileged EXEC mode.To disable debugging output, use the no form of this command.
debug archive versioning
no debug archive versioning
Syntax Description
This c ommand has no arguments or keyw ords.
Command Modes
Privileged EXEC
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
26/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
Privileged EXEC
Command History
Release Modification
12.3(7)T This c ommand w as introduc ed.
12.2(25)S This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(27)SBC This command w as integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA This command w as integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2 This command w as implemented on the Cisco 10000 series.
Examples
The following is sample output f rom the debug archive versioning command:
Router# debug archive versioning
Jan 9 06:46:28.419:backup_running_config
Jan 9 06:46:28.419:Current = 7
Jan 9 06:46:28.443:Writing backup file disk0:myconfig-7
Jan 9 06:46:29.547: backup worked
Related Commands
Command Description
debug archiveconfig timestamp
Enables debugging of the processing time for each integral step of a conf iguration replaceoperation and the size of the conf iguration f iles being handled.
maximum
To set the maximum number of archive f iles of the r unning configuration to be sav ed in the Cisco IOS configuration archive, use the maximumcommand in archive configuration mode. To reset this command to its default, use the no form of this command.
maximum number
no maximum number
Syntax Description
number Maximum number of archive files of the running configuration to be saved in the Cisco IOSconfiguration archive. You can archive from 1 to 14 configuration files. The default is 10.
Comm and Default
By default, a maximum of 10 archive f iles of the r unning configuration are saved in the Cisco IOS configuration archive.
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
27/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
y , g g g
Command Modes
Archive configuration
Command History
Release Modification
12.3(7)T This c ommand w as introduc ed.
12.2(25)S This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(27)SBC This command w as integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA This command w as integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2 This command w as implemented on the Cisco 10000 series.
Usage Guidelines
Note Before using this command, you must configure the path command to specify the location and filename prefix for the files in the Cisco IOSconfiguration archive.
Af ter the maximum number of files are saved in the Cisco IOS configuration archive, the oldest f ile is automatically deleted when the next, mostrecent file is saved.
Note This c ommand should only be used w hen a local w ritable file system is specified in the urlargument of the path command. Network f ilesys tems may not support deletion of previously saved f iles.
Examples
In the following example, a value of 5 is set as the maximum number of archive f iles of the r unning conf iguration to be saved in the Cisco IOSconfiguration archive:
configure terminal
!
archive
path disk0:myconfig
maximum 5
end
Related Commands
Command Description
archiveconfig
Saves a copy of the current running configuration to the Cisco IOS configuration archive.
configureconfirm
Confirms replacement of the current r unning conf iguration w ith a saved Cisco IOS configurationfile.
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
28/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
confirm file.
configurereplace
Replaces the cur rent running configuration with a saved Cisco IOS configuration file.
path Specifies the location and filename prefix for the files in the Cisco IOS configuration archive.
show
archive
Displays information about the f iles saved in the Cisco IOS configuration archive.
time-period Sets the time increment for automatically saving an archive file of the current runningconfiguration in the Cisco IOS configuration archive.
path (archive configuration)
To specify the location and filename prefix f or the f iles in the Cisco IOS configuration archive, use the path command in archive configurationmode. To disable this func tion, use the no form of this command.
pathurl
no pathurl
Syntax Description
url URL (accessible by the Cisco IOS file system) used for saving archive files of the running configuration filein the Cisco IOS configuration archive.
Comm and Default
If this command is not conf igured, no location or f ilename prefix is specified for files in the Cisco IOS configuration archive.
Command Modes
Archive configuration
Command History
Release Modification
12.3(7)T This c ommand w as introduc ed.
12.2(25)S This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(27)SBC This command w as integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA This command w as integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2 This command w as implemented on the Cisco 10000 series.
Usage Guidelines
When this command is entered, an archive f ile of the running configuration is saved w hen the archive config, write-memory, orcopy
running-config startup-config command is entered.
URLs are c ommonly used to s pecify files or location on the World Wide Web. On Cisco routers, URLs can be used to specify the location of afil di t t t fil Th th d URL t if th l ti d fil f i f th Ci IOS
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
29/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
file or directory on a router or a remote file server. The path command uses a URL to specify the location and filename pref ix f or the Cisco IOSconfiguration archive.
The locations or f ile systems that you can specif y in the urlargument are as follows:
If your platform has disk0disk0:, disk1:, ftp:, pram:, rcp:, slavedisk0:, slavedisk1:, or tftp:
If your platform does not have disk0ftp:, http:, pram:, rcp:, or tftp:
The colon is required in the location format.
The filename of the first archive f ile is the filename specif ied in the urlargument followed by -1. The filename of the second archive f ile is thefilename specified in the urlargument followed by -2 and so on.
Because some file systems are incapable of storing the date and time that a file w as w ritten, the filename of the archive file can contain the
date, time, and router hostname. To include the router hostname in the archive file filename, enter the characters $h (for example, disk0:$h). Toinclude the date and time in the arc hive file f ilename, enter the c haracters $t.
When a configuration archive operation is attempted on a local file sys tem, the file system is tested to determine if it is w ritable and if it hassufficient space to save an archive file. If the file system is read-only or if there is not enough space to save an archive file, an error messageis displayed.
If you specify the tf tp: file server as the location w ith the path command, you need to create the configuration file on the TFTP file server andchange the file's privileges before the archive config command w orks properly.
Examples
The following example of the path command shows how to specify the hostname, date, and time as the filename prefix f or w hich to savearchive f iles of the r unning configuration. In this example, the time-period command is also c onfigured to automatically save an archive file ofthe running configuration every 20 minutes.
configure terminal
!
archive
path disk0:$h$t
time-period 20
end
The following is sample output f rom the show archive command illustrating the f ormat of the resulting conf iguration archive f ilenames.
Router# show archive
There are currently 3 archive configurations saved.
The next archive file will be named routerJan-16-01:12:23.019-4
Archive # Name
0
1 disk0:routerJan-16-00:12:23.019-1
2 disk0:routerJan-16-00:32:23.019-2
3 disk0:routerJan-16-00:52:23.019-3
8/3/2019 Archive Config
30/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
6
7
8
9
10
11
12
13
14
Cisco IOS Configuration Archive on th e TFTP File Serve r
The follow ing example shows how to use the path command to specify the TFTP file server, address 10.48.71.226, as the archiveconfiguration location and router-cf g as the c onfiguration filename. First you need to c reate the configuration file on the TFTP server andchange the file's privileges, then you can save configuration file to the configuration archive.
The following example show s the commands to use to c reate the f ile and change the file's pr ivileges on the TFTP server ( UNIX commands):
> touchrouter-cfg-1
> chmod777 router-cfg-1
The following example show how to create the configuration archive, save the running configuration to the archive, and display the f iles in thearchive:
configure terminal
!
archive
path tftp://10.48.71.226/router-cfg
exit
exit
!
archive config
Router# show archive
The next archive file will be named tftp://10.48.71.226/router-cfg-2
Archive # Name
0
1 tftp://10.48.71.226/router-cfg-1
8/3/2019 Archive Config
31/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
4
5
6
7
8
9
10
11
12
13
14
Router#
The following is sample output f rom the show archive command if y ou did not cr eate the conf iguration f ile on the TFTP server bef oreattempting to archive the current r unning conf iguration f ile:
configure terminal
!
archive
path tftp://10.48.71.226/router-cfg
exit
exit
archive config
Router# show archive
The next archive file will be named tftp://10.48.71.226/router-cfg-1
Archive # Name
0
1
2
3
4
5
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
32/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
6
7
8
9
10
11
12
13
14
Related Commands
Command Description
archive Enters archive configuration mode.
archiveconfig
Saves a copy of the current running configuration to the Cisco IOS configuration archive.
configureconfirm
Confirms replacement of the current r unning conf iguration w ith a saved Cisco IOS configurationfile.
configure
replace
Replaces the cur rent running configuration with a saved Cisco IOS configuration file.
maximum Sets the maximum number of archive f iles of the r unning configuration to be saved in the CiscoIOS conf iguration archive.
show
archive
Displays information about the f iles saved in the Cisco IOS configuration archive.
time-period Sets the time increment for automatically saving an archive file of the current runningconfiguration in the Cisco IOS configuration archive.
show archive
To display information about the f iles saved in the Cisco IOS configuration archive, use the show archive command in privileged EXEC mode.
show archive
Syntax Description
This c ommand has no arguments or keyw ords.
Command Modes
Privileged EXEC
Command History
Release Modification
12 3(7)T This c ommand w as introduc ed
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
33/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
12.3(7)T This c ommand w as introduc ed.
12.2(25)S This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(27)SBC This command w as integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA This command w as integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2 This command w as implemented on the Cisco 10000 series.
Examples
The following is sample output f rom the show archive command:
Router# show archive
There are currently 1 archive configurations saved.
The next archive file will be named disk0:myconfig-2
Archive # Name
0
1 disk0:myconfig-1
8/3/2019 Archive Config
34/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
The next archive file will be named disk0:myconfig-8
Archive # Name
0
1 :Deleted
2 :Deleted
3 :Deleted
4 :Deleted
5 disk0:myconfig-5
6 disk0:myconfig-6
7 disk0:myconfig-7
8/3/2019 Archive Config
35/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
maximum Sets the maximum number of archive f iles of the r unning configuration to be saved in the CiscoIOS conf iguration archive.
path Specifies the location and filename prefix for the files in the Cisco IOS configuration archive.
time-period Sets the time increment for automatically saving an archive file of the current runningconfiguration in the Cisco IOS configuration archive.
show configuration lockTo display information about the lock status of the running configuration file during a conf iguration replace operation, use the showconfiguration lock command in privileged EXEC mode.
show configuration lock
Syntax Description
This c ommand has no arguments or keyw ords.
Command Modes
Privileged EXEC
Command History
Release Modification
12.2(25)S This command was introduced.
12.3(14)T This command w as integrated into Cisco IOS Release 12.3(14)T.
The output of this command w as updated to display the conf iguration locking class.
12.0(31)S The command output was enhanced.
12.2(27)SBC This command w as integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA This command w as integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2 This command was implemented on the Cisco 10000 series.
Examples
The following is sample output f rom the show configuration lock command w hen the running configuration file is locked by another user.
Cisco IOS Release 12.2(25)S, Release 12.2(27)SBC, Release 12.3(14)T, and Later Releases
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# configuration mode exclusive ?
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
36/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
auto Lock configuration mode automatically
manual Lock configuration mode on-demand
Router(config)# configuration mode exclusive auto
Router(config)# end
Router# show running-config | include configuration
configuration mode exclusive auto
Router#
Router# configure terminal !
8/3/2019 Archive Config
37/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
State : FREE
Class : unknown
Count : 0
Pending Requests : 0
User debug info :
Router#
Cisco IOS Release 12.0(31)S, 12.2(33)SRA, and Later Releases
Router# show configuration lock
Parser Configure Lock
------------------------------------------------------
Owner PID : 3
User : unknown
TTY : 0
Type : EXCLUSIVE
State : LOCKED
Class : EXPOSED
Count : 1
Pending Requests : 0
User debug info : configure terminal
Session idle state : TRUE
No of exec cmds getting executed : 0
No of exec cmds blocked : 0
Config wait for show completion : FALSE
Remote ip address : Unknown
Lock active time (in Sec) : 6
Lock Expiration timer (in Sec) : 593
Router(config)#
Table 2 describes the significant fields show n in the displays.
Table 2 show configuration lock Field Descriptions
Field Description
Owner PID Process identifier (PID) of the process that ow ns the lock.
User Ow ner's username.
TTY Ow ner's terminal number.
Type Lock type (EXCLUSIVE/COUNTER/NO LOCK).
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
38/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
Type Lock type (EXCLUSIVE/COUNTER/NO LOCK).
State State of the lock (FREE/LOCKED).
Class Classification of users of the lock (EXPOSED/ROLLBACK). Processes other than ROLLBACKbelong to the EXPOSED class.
Count In the case of a counter lock, total number of processes holding the lock.
PendingRequests
Total number of processes blocked by the lock.
User debuginfo
Any string given by the process (used for debugging only).
Session idlestate
Indicates w hether the user in an acc ess s ession locking session is idle. Displays TRUE orFALSE.
No of execcmds gettingexecuted
Total number of EXEC commands (show and clear) being executed s imultaneously f romdifferent sessions.
No of execcmds blocked
Total number of EXEC commands (show and clear) w aiting for the configurationcommand(running from the access sess ion locking sess ion) to complete its execution.
Config w aitfor showcompletion
Indicates w hether a configuration command executed in an access session locking session isw aiting for the completion of the show command being executed s imultaneously f rom a diff erentsession. Displays TRUE or FALSE.
Remote ipaddress
IP address of the terminal from w hich the user telneted to the router.
Lock activetime (in Sec)
Amount of time, in seconds, that elapsed since the lock w as acquired.
LockExpirationtimer (in Sec)
The amount of time, in seconds, that expires bef ore the lock is automatically released.
The following example show s how to configure the conf iguration file for single user auto configuration mode (using the configuration modeexclusive auto command). Use the configure terminal command to enter global configuration mode and lock the configuration modeexclusively. Once the Cisco IOS configuration mode is locked exclusively, you can verif y the lock using the show configuration lockcommand.
Router#
Router# configure terminal
Router(config)# configuration mode exclusive auto
Router(config)# end
Router# configure terminal
Router(config)#
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
39/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
Router(config)#
Router(config)# show configuration lock
Parser Configure Lock
Owner PID : 10
User : User1
TTY : 3
Type : EXCLUSIVE
State : LOCKED
Class : Exposed
Count : 0
Pending Requests : 0
User debug info : 0
Related Commands
Command Description
configuration modeexclusive
Enables s ingle-user (exclusive) acc ess functionality for the Cisco IOS CLI.
configure replace Replaces the curr ent running configuration with a saved Cisco IOSconfiguration file.
debug configuration lock Enables debugging of the Cisco IOS configuration lock.
time-period
To set the time increment f or automatically sav ing an archive f ile of the current r unning configuration in the Cisco IOS conf iguration archive, usethe time-period command in archive configuration mode. To disable this function, use the no form of this command.
time-periodminutes
no time-periodminutes
Syntax Description
minutes Specifies how often, in minutes, to automatically save an archive f ile of the current runningconfiguration in the Cisco IOS conf iguration archive.
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
40/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
Comm and Default
By default, no time increment is set.
Command Modes
Archive configuration
Command History
Release Modification
12.3(7)T This c ommand w as introduc ed.
12.2(25)S This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(27)SBC This command w as integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA This command w as integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2 This command w as implemented on the Cisco 10000 series.
Usage Guidelines
Note Before using this command, you must configure the path command to specify the location and filename prefix for the files in the Cisco IOSconfiguration archive.
If this command is conf igured, an archive file of the current running conf iguration is automatically saved af ter the given time specified by theminutes argument. Archive f iles continue to be automatically saved at this given time increment until this f unction is disabled. Use themaximum command to set the maximum number of archive f iles of the running configuration to be saved.
Note This c ommand saves the current r unning conf iguration to the conf iguration archive w hether or not the running configuration has been modifiedsince the last archive file w as saved.
Examples
In the following example, a value of 20 minutes is set as the time increment for w hich to automatically save an arc hive file of the current runningconfiguration in the Cisco IOS conf iguration archive:
configure terminal
!
archive
path disk0:myconfig
time-period 20
end
Related Commands
Command Description
http://pdfcrowd.com/http://pdfcrowd.com/redirect/?url=http%3a%2f%2fwww.cisco.com%2fen%2fUS%2fdocs%2fios%2f12_3t%2f12_3t7%2ffeature%2fguide%2fgtrollbk.html%23wp1100253&id=ma-120103212238-bf6c4874http://pdfcrowd.com/customize/http://pdfcrowd.com/html-to-pdf-api/?ref=pdf8/3/2019 Archive Config
41/43
pdfcrowd.comopen in browser PRO version Are you a developer? Try out the HTML to PDF API
archiveconfig
Saves a copy of the current running configuration to the Cisco IOS configuration archive.
configureconfirm
Confirms replacement of the current running configuration w ith a saved Cisco IOSconfiguration file.
configurereplace
Replaces the cur rent running configuration w ith a saved Cisco IOS configuration file.
maximumSets the maximum number of archive f iles of the r unning configuration to be saved in the CiscoIOS configuration archive.
path Specifies the location and filename prefix for the files in the Cisco IOS configuration archive.
show archive Displays information about the f iles saved in the Cisco IOS configuration archive.
Feature Information for Configuration Replace and Configuration Rollback
Table 3 lists the release history for this feature.
Not all commands may be available in your Cisco IOS sof tw are release. For releas e information about a specif ic command, see the commandreference documentation.
Cisco IOS softw are images are specif ic to a Cisco IOS softw are release, a feature set, and a platform. Use Cisco Feature Navigator to find
information about platform support and Cisco IOS softw are image support. A ccess Cisco Feature Navigator at http://ww w .cisco.com/go/cfn.An acc ount on Cisco.com is not required.
Note Table 3 lists only the Cisco IOS softw are release that introduced support f or a given feature in a given Cisco IOS softw are release. Unlessnoted otherw ise, subsequent releases of that Cisco IOS softw are release also support that feature.
Table 3 Feature Infor mation for Configuration Replace and Configur ation Rollback
FeatureName Releases Feature Information
ConfigurationReplace andConfigurationRollback (F-4239)
12.3(7)T,12.2(25)S,12.3(14)T,12.2(27)SBC,12.2(31)SB2,12.2(33)SRA,12.2(33)SXH
The Configuration Replace and Configuration Rollback feature provides thecapability to replace the current running configuration w ith any saved Cisco IOSconfiguration file. This functionality can be used to revert to a previousconfiguration s