Vyatta Network OS Documentation

Learn how to install, configure and operate the Vyatta NOS, which helps drive our virtual networking & physical platforms portfolio.

load

Loads from a file a configuration that was previously saved.

load 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.

The loaded configuration becomes the working configuration and must be committed before it becomes the active configuration.

CAUTION: If your login user is not a member of the login user group "secrets" and you save a configuration either through the REST API or use the save command, the encrypted passwords in the configuration file are replaced with the ******** placeholder. If you load this configuration, the replaced password fields trigger validation errors because the placeholder does not match the format for an encrypted password. Do not commit this configuration. If you ignore the error message and perform a commit with this invalid configuration, the passwords are deleted.

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. In addition, an error is reported if an invalid configuration file is loaded.

The default configuration directory is /config.

Note: When downloading files, Ciena recommends that you use SCP, TFTP, FTP, or HTTP.

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 file from the default configuration directory.

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

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