Archive Config

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/workspace


2/43


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/


3/43


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


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=pdf


4/43


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.


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


5/43


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.


6/43


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.


7/43


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


8/43


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


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.




Archive # Name

0

1 :Deleted

2 :Deleted

3 :Deleted

4 :Deleted

5 disk0:myconfig-5

6 disk0:myconfig-6

7 disk0:myconfig-7


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)


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



Size of file :1054

Time taken for positive rollback pass = 0 msec (0 sec)



Total number of passes:1

Rollback Done


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


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






!Pass 1

!List of Commands:

no snmp-server community public ro

snmp-server community mystring ro

end


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


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


t l th t i fi ti ith th


13/43df di b PRO i

Are you a developer? Try out the HTML to PDF API






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:




14/43df di b PRO iAre you a developer? Try out the HTML to PDF API


Archive # Name

0

1 disk0:myconfig-1


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/techsupport


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


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:




Archive # Name

0

1 disk0:myconfig-1


18/43


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


Command Modes

Privileged EXEC

Command History







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:








19/43



Rollback Done


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.


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).


20/43


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



12.2(25)S The nolock keyword w as added.



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


21/43


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







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






!Pass 1

!List of Commands:

no snmp-server community public ro

snmp-server community mystring ro

end


Rollback Done

Reverting to the Startup Configuration File

f C OS f f f f


22/43


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


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).








Rollback Done


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


23/43


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:




Archive # Name

0

1 disk0:myconfig-1


24/43


maximum Sets the maximum number of archive f iles of the r unning configuration to be saved in the CiscoIOS conf iguration archive.


showarchive




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.


no debug archive config timestamp

Syntax Description


Command Modes

Privileged EXEC

Command History







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)



25/43



Size of file :1054

Starting Pass 1



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)


Starting Pass 2



Size of file :1054

Time taken for positive rollback pass = 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.


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.


no debug archive versioning

Syntax Description


Command Modes

Privileged EXEC


26/43


Privileged EXEC

Command History







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.


27/43


y , g g g

Command Modes

Archive configuration

Command History







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


configureconfirm

Confirms replacement of the current r unning conf iguration w ith a saved Cisco IOS configurationfile.


28/43


confirm file.

configurereplace

Replaces the cur rent running configuration with a saved Cisco IOS configuration file.


show

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


Command History







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


29/43


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.



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


30/43


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


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


31/43


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


The next archive file will be named tftp://10.48.71.226/router-cfg-1

Archive # Name

0

1

2

3

4

5


32/43


6

7

8

9

10

11

12

13

14

Related Commands

Command Description

archive Enters archive configuration mode.

archiveconfig


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.


show

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


Command Modes

Privileged EXEC

Command History


12 3(7)T This c ommand w as introduc ed


33/43







Examples

The following is sample output f rom the show archive command:




Archive # Name

0

1 disk0:myconfig-1


34/43



Archive # Name

0

1 :Deleted

2 :Deleted

3 :Deleted

4 :Deleted

5 disk0:myconfig-5

6 disk0:myconfig-6

7 disk0:myconfig-7


35/43





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


Command Modes

Privileged EXEC

Command History


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(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


Enter configuration commands, one per line. End with CNTL/Z.

Router(config)# configuration mode exclusive ?


36/43


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 !


37/43


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


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).


38/43


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(config)# configuration mode exclusive auto

Router(config)# end


Router(config)#


39/43


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


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.


40/43


Comm and Default

By default, no time increment is set.

Command Modes


Command History







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


41/43


archiveconfig


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.


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