home

Supported platforms

Vyatta documentation

Learn how to install, configure, and operate the Vyatta Network Operating System (Vyatta NOS) and Orchestrator, which help drive our virtual networking and physical platforms portfolio.

merge

Merges a saved configuration with the active (running) configuration.

merge file-name
file-name
The name of a configuration file, including the full path to its location.

Configuration mode

Use this command to load from a file a configuration that was previously saved and merge it with the active (running) configuration. The merger adds new configuration entries and applies any modifications to existing active entries to produce a new working configuration. This configuration must be committed before it becomes the active configuration.

Configuration can be loaded from a hard disk (including a Flash disk or USB device), a TFTP server, an FTP server, an SCP server, or an HTTP server. Note that you cannot load an empty configuration file; the configuration file must contain at least one configuration node.

The default configuration directory is /config.

The following table shows how to specify the syntax for files from different file locations.

Table 1. Specifying locations for the configuration file
Location Specification

An absolute path

Use standard UNIX file specification.

A relative path

Specify the path name relative to the default configuration directory.

FTP server

Use the following syntax for file-name:

ftp://user:passwd@host /config-file

where user is the username on the host, passwd is the password associated with the username, host is the host name or IP address of the FTP server, and config-file is the configuration file, including the path.

If you do not specify user and passwd, you are prompted for them.

SCP server

Use the following syntax for file-name:

scp://user:passwd@host /config-file

where user is the username on the host, passwd is the password associated with the username, host is the host name or IP address of the SCP server, and config-file is the configuration file, including the path.

If you do not specify user and passwd, you are prompted for them.

HTTP server

Use the following syntax for file-name:

http://host /config-file

where host is the host name or IP address of the HTTP server, and config-file is the configuration file, including the path.

TFTP server

Use the following syntax for file-name:

tftp://host /config-file

where host is the host name or IP address of the TFTP server, and config-file is the configuration file, including the path relative to the TFTP root directory.

The following example shows how to load the testconfig configuration file from the default configuration directory and merge it with the active configuration.

The new working configuration must be committed before it becomes active. After the merger, you must save the new file if you want to be able to load it again. If you want the system to load the merged configuration when it boots, you must save the file to /config/config.boot.

vyatta@vyatta# merge testconfig
Loading config file /config/testconfig...

Merge complete.  Use 'commit' to make changes active.
[edit]
vyatta@vyatta#