Archive Config

download Archive Config

of 43

  • date post

    06-Apr-2018
  • Category

    Documents

  • view

    216
  • download

    0

Embed Size (px)

Transcript of 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
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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/techsupport
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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=pdf
  • 8/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