Committing a Junos OS Configuration
To save Junos OS configuration changes to the configuration database and to activate the configuration on the router, use the commit configuration mode command. You can issue the commit command from any hierarchy level:
When you enter the commit command, the configuration is first checked for syntax errors (commit check). Then, if the syntax is correct, the configuration is activated and becomes the current, operational router configuration.
You can issue the commit command from any hierarchy level.
A configuration commit can fail for any of the following reasons:
- The configuration includes incorrect syntax, which causes the commit check to fail.
- The candidate configuration that you are trying to commit is larger than 700 MB.
- The configuration is locked by a user who entered the configure exclusive command.
If the configuration contains syntax errors, a message indicates the location of the error, and the configuration is not activated. The error message has the following format:
For example:
You must correct the error before recommitting the configuration. To return quickly to the hierarchy level where the error is located, copy the path from the first line of the error and paste it at the configuration mode prompt at the [edit] hierarchy level.
The uncommitted, candidate configuration file is /var/rundb/juniper.db
. It is limited to 700 MB.
If the commit fails with a message configuration database size limit exceeded, view the file size from configuration mode by
entering the command run file list /var/rundb detail. You
can simplify the configuration and reduce the file size by creating
configuration groups with wildcards or defining less specific match
policies in your firewall filters.
![]() | Note: CLI commit-time warnings displayed for configuration changes at the [edit interfaces] hierarchy level are removed and are logged as system log messages. This is also applicable to VRRP configuration at the following hierarchy levels:
|
When you commit a configuration, you commit the entire configuration in its current form. If more than one user is modifying the configuration, committing it saves and activates the changes of all the users.
- If you are using Junos OS in a Common Criteria
environment, system log messages are created whenever a secret attribute is changed (for example, password changes or changes to
the RADIUS shared secret). These changes are logged during the following
configuration load operations: load mergeload replaceload overrideload update
For more information, see the Secure Configuration Guide for Common Criteria and Junos-FIPS.
- We do not recommend performing a commit operation on the backup Routing Engine when graceful Routing Engine switchover is enabled on the router.
Note: If you configure the same IP address for a management interface or internal interface such as fxp0 and an external physical interface such as ge-0/0/1, when graceful Routing Engine switchover (GRES) is enabled, the CLI displays an appropriate commit error message that identical addresses have been found on the private and public interfaces. In such cases, you must assign unique IP addresses for the two interfaces that have duplicate addresses.
The management Ethernet interface used for the TX Matrix Plus router, T1600 routers in a routing matrix, and PTX Series Packet Transport Switches, is em0. Junos OS automatically creates the router’s management Ethernet interface, em0.