Vyatta Network OS Documentation

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

add system image: <iso-filename> | <iso-URL> [ username <username> password <password>]

Adds a binary system image to the currently running system.

<iso-filename>
Name of the image file to be added.
<iso-url>
URL location of the image file to be added.
username <username>
Specifies the username that is required to log in to the remote system at the indicated URL location.
password <password>
Specifies the password that is required to log in to the remote system at the indicated URL location. If the username is specified, then a password must also be specified.

Operational mode

Use this command to add a binary image to the currently running system. A system image can be added to a system that was installed by using a disk-based installation or an image-based installation. After an image is added, it is set as the new default boot image and is run the next time the system is booted.

The command validates the MD5 checksums of the files that are contained in the ISO image to ensure that the image has not been corrupted. In addition, the command does not allow more than one copy of an image to exist on the same system.

The iso-filename and iso-URL arguments provide the source for the ISO image file.

Table 1. Specifying the file syntax for different file locations
Location Specification

An absolute path

For iso-filename, use standard UNIX file specification.

A relative path

For iso-filename, you can also specify the path name relative to the current directory.

FTP server

Use the following syntax for the iso-URL argument:

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

where user is the username on the host, passwd is the password that is associated with the username, host is the host name or IP address of the FTP server, and image-file is the ISO image file, including the path. Alternatively, the username and password can be specified as username and password arguments of add system image .

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

SCP server

Use the following syntax for the iso-URL argument:

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

where user is the username on the host, passwd is the password that is associated with the username, host is the host name or IP address of the SCP server, and image-file is the ISO image file, including the path. Alternatively, the username and password can be specified as username and password arguments to add system image .

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

HTTP server

Use the following syntax for the iso-URL argument:

http://host/image-file

where host is the host name or IP address of the HTTP server and image-file is the ISO image file, including the path relative to the HTTP root directory.

TFTP server

Use the following syntax for the iso-URL argument:

tftp://host/image-file

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