Chapter 4 Configuring General Router Features

Managing Configuration Sessions

To commit target configuration changes to the running configuration, enter the commit command by itself or with one or more of the options described in Table 4-5.

Table 4-5 Commit Command Options

 

 

Command

Description

 

 

 

 

 

 

 

 

 

commit

 

(Default) Merges the target configuration with the running configuration

 

 

 

 

and commits changes only if all changes in the target configuration pass

 

 

 

 

the semantic verification process. If any semantic errors are found, none

 

 

 

 

of the configuration changes takes effect.

 

 

 

 

 

 

 

 

commit best-effort

 

Merges the target configuration with the running configuration and

 

 

 

 

commits only valid changes (best effort). Some configuration changes

 

 

 

 

might fail due to semantic errors.

 

 

 

 

 

 

 

 

commit comment line

 

(Optional) Assigns a comment to a commit.

 

 

 

 

This text comment is displayed in the commit entry displayed with

 

 

 

 

the show configuration commit list [detail] command.

 

 

 

 

The line argument is the text for the optional comment or label.

 

 

 

 

The comment option must appear at the end of the command line. If

 

 

 

 

multiple options are entered, all text after the comment option is

 

 

 

 

treated as a comment.

 

 

 

 

 

 

 

 

commit confirmed

 

(Optional) Commits the configuration in global configuration mode on a

 

 

seconds

 

trial basis for a minimum of 30 seconds and a maximum of 300 seconds

 

 

 

 

(5 minutes).

 

 

 

 

During the trial configuration, enter commit to confirm the

 

 

 

 

configuration. If you do not enter the commit command, the router

 

 

 

 

reverts to the previous configuration when the trial time period

 

 

 

 

expires.

 

 

 

 

The confirmed option is not available in administration

 

 

 

 

configuration mode.

 

 

 

 

 

 

 

 

commit label line

 

(Optional) Assigns a meaningful label. This label is displayed in the

 

 

 

 

output for the show configuration commit list [detail] command instead

 

 

 

 

of the numeric label.

 

 

 

 

The line argument is the text for the optional comment or label.

 

 

 

 

 

 

 

 

commit force

 

(Optional) Merges the target configuration with the running

 

 

 

 

configuration and allows a configuration commit in low-memory

 

 

 

 

conditions.

 

 

 

 

A low-memory warning occurs when a user attempts to commit a target

 

 

 

 

configuration that exceeds the default capacity of the router.

 

 

 

 

The recommended resolution to such a warning is to remove

 

 

 

 

configurations using the no commands.

 

 

 

 

 

 

 

 

 

 

 

 

 

Caution The force option can cause the router to experience severe

 

 

 

 

 

 

problems if low-memory conditions occur. The force option

 

 

 

 

 

 

should be used only to remove configurations.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

commit replace

 

(Optional) Replaces the contents of the running configuration with the

 

 

 

 

target configuration.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Cisco IOS XR Getting Started Guide

 

 

 

 

 

 

 

 

 

OL-10957-02

 

 

 

 

 

4-35

 

 

 

 

 

 

 

 

 

Page 121
Image 121
Cisco Systems Cisco IOS XR manual Commit best-effort, Commit comment line, Show configuration commit list detail command