merge
Merges a saved configuration with the active (running) configuration.
- 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.
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#