To commit the target
configuration to the active (running) configuration, use the
commit command
in
any configuration
Global Configuration mode
Admin Configuration mode.
commit [best-effort] [comment line] [confirmed [seconds | minutes minutes]] [force] [label line] [replace] [save-running filename file_path]
Syntax Description
best-effort
|
(Optional)
Merges the target configuration with the running configuration and commits only
valid changes (best effort). Some configuration changes might fail due to
semantic errors.
|
comment
line
|
(Optional)
Assigns a comment to a commit. This text comment is displayed in the commit
entry displayed in the output for the
show
configuration
commit
list
command with the optional
detail
keyword.
|
confirmed
[seconds |
minutes
minutes]
|
(Optional)
Commits the configuration on a trial basis for the time specified in seconds or
minutes.
Note
|
The
confirmed
option is not available in administration
configuration mode.
|
|
force
|
(Optional)
Forces a commit operation in low-memory conditions.
|
label
line
|
(Optional)
Assigns a meaningful label. This label is displayed (instead of the
autogenerated commit ID) in the output for the
show
configuration
commit
list
.
|
replace
|
(Optional)
Replaces the entire running configuration with the contents of the target
configuration.
|
save-running
filename
file_path
|
(Optional)
Saves the running configuration to a specified file.
|
Command Default
The default
behavior is
pseudo-atomic, meaning that all changes must succeed for
the entire commit operation to succeed. If any errors are found, none of the
configuration changes take effect.
Command Modes
Any configuration mode
Global Configuration mode
Admin Configuration mode
Command History
Release
|
Modification
|
Release 3.7.2
|
This
command was introduced.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user
group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Changes made
during a configuration session are inactive until the
commit
command is entered. By default, the commit operation is
pseudo-atomic, meaning that all changes must succeed for
the entire commit operation to succeed. If any errors are found, none of the
configuration changes takes effect.
To replace the
default numeric ID for the commit, use the optional
label
keyword. This label is displayed (instead of the autogenerated
commit ID) in the output for the
show
configuration
commit
list
command.
Enter an optional
comment with the
comment
keyword to provide additional information about the commit
action. This comment is displayed in the output for the
show
configuration
commit
list
command with the
detail
keyword.
Use the optional
confirmed
minutes
keyword and argument to commit a configuration on a trial
basis for a minimum of 30 seconds and a maximum of 300 seconds (5 minutes).
During the trial configuration period, enter the
commit
command to confirm the configuration. If the
commit
command is not entered, then the system reverts to the previous configuration
when the trial time period expires. The confirmed option is not available in
administration configuration mode.
You can use the
commit
command in conjunction with the
load command.
Load a new configuration with the
load command,
and use the
commit
command with the
replace
keyword to have the loaded configuration become the active (running)
configuration.
Use the optional
save-running filename
file_path keywords and argument to save the
running configuration to a specified file. To configure automatic saving of the
configuration file on every commit, use the
configuration commit
auto-save command. If automatic saving of the configuration file
is already enabled, specifying
save-running filename
file_path
with the
commit
command has no additional effect.
In pseudo-atomic commit, if an error occurs on one or more of the configurations in a commit, other configurations which are
already part of the running configuration in the same commit are reverted.
Caution
|
Saving the
running configuration to a file is CPU intensive.
|
Note
|
If you use the
commit
command without previously loading a target configuration, a blank
configuration is committed.
|
Note
|
If you use the
commit
command with the
replace
keyword, it does not affect the mode of an 8-port E1/T1 SPA. If the mode is E1
before using the
commit
replace command, it remains E1. However, since the default mode
is T1, the router does not recognize that the mode is E1. To change the mode to
T1, you must first use the
hw-module subslot cardtype
e1 command to add the E1 mode into the configuration so that it
correlates with the system. Then manually reload the router and it boots in T1
mode.
For more
information regarding the
hw-module subslot
cardtype command, refer to
Interface and Hardware Component Command Reference for Cisco ASR 9000 Series Routers.
|
Task ID
Task ID
|
Operations
|
Task ID
for the feature or configuration mode impacted by the command
|
Operation
for the feature or configuration mode impacted by the command
|
Examples
The following
example shows how to commit the target configuration to the active running
configuration. In this example, the
commit
command saves changes to the router hostname.
RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# hostname router1
RP/0/RSP0/CPU0:router(config)# commit
RP/0/RSP0/CPU0:Feb 21 04:42:57.017 : config[65689]: %MGBL-LIBTARCFG-6-COMMIT :
Configuration committed by user 'user_a'.
Use 'show configuration commit changes 1000000033' to view the changes.
Examples
The following
example shows how to use the
commit
command with the optional
comment
line
keyword and argument to assign a text description to the
commit operation. The comment is then displayed in the output of the
show
configuration
commit
list command with the
detail
keyword.
RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# hostname router2
RP/0/RSP0/CPU0:router(config)# commit comment new name for router
RP/0/RP0/CPU0:Feb 21 04:42:57.017 : config[65689]: %MGBL-LIBTARCFG-6-COMMIT :
Configuration committed by user 'user_a'. Use 'show configuration commit
changes 1000000226' to view the changes.
RP/0/RSP0/CPU0:router2(config)# end
RP/0/RSP0/CPU0:router2# show configuration commit list detail
1) CommitId: 1000000226 Label: NONE
UserId: user_a Line: con0_RP1_CPU0
Client: CLI Time: 12:59:26 UTC Wed Feb 04 2004
Comment: new name for router
2) CommitId: 1000000225 Label: NONE
UserId: user_a Line: con0_RP1_CPU0
Client: CLI Time: 12:58:32 UTC Wed Feb 04 2004
Comment: NONE
Examples
The following
example shows how to use the
commit
command with the optional
label
line keyword and argument to change the commit ID
to a text label for easier identification. The label is then displayed in the
output of the
show
configuration
commit
list command.
RP/0/RSP0/CPU0:router2# configure
RP/0/RSP0/CPU0:router2(config)# hostname router3
RP/0/RSP0/CPU0:router2(config)# commit label new_name
RP/0/RP0/CPU0:Feb 21 04:42:57.017 : config[65689]: %MGBL-LIBTARCFG-6-COMMIT :
Configuration committed by user 'user_a'.
Use 'show configuration commit changes 1000000227' to view the changes.
RP/0/RSP0/CPU0:router3(config)# end
RP/0/RSP0/CPU0:router3# show configuration commit list
SNo. Label/ID User Line Client Time Stamp
~~~~ ~~~~~~~~ ~~~~ ~~~~ ~~~~~~ ~~~~~~~~~~
1 new_name user_a con0_RSPs1_C CLI 13:00:53 UTC Wed Feb 04 2004
2 1000000226 user_a con0_RSPs1_C CLI 12:59:26 UTC Wed Feb 04 2004
3 1000000225 user_a con0_RSPs1_C CLI 12:58:32 UTC Wed Feb 04 2004
Examples
The following
example shows how to use the
commit
command with the optional
confirmed
keyword and number
argument . The
configuration changes are committed only for the specified number of seconds.
You can then either confirm the commit operation or discard the changes.
RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# hostname router3
RP/0/RSP0/CPU0:router(config)# commit confirmed 30
RP/0/RSP0/CPU0:router3(config)# end