Vyatta Network OS Documentation

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

copy file <from-file> to <to-file>

Copies a file or directory.

copy file from-file to to-file
from-file
The source file or directory.
to-file
The destination file or directory.

Operational mode

Use this command to copy a file or directory to a destination.

This command is optimized for configuration files and directories in that command completion refers to the /config directory of all known system images. For example, running://config/ indicates the /config directory of the currently running system, and test-image1://config/ indicates the /config directory of an image called test-image1. If needed, however, any other location within the file system can be specified.

A file or directory can be copied on the local machine. Only a file can be copied to and from the remote machine by using FTP, SCP, or TFTP.

CAUTION: Use this command with caution because its effects are not reversible. In addition, when downloading files, Ciena recommends that you use SCP, TFTP, FTP, or HTTP.

The following table shows how to specify different types of file locations.

Table 1. Specifying file locations
Location Specification
FTP server ftp://user:passwd@host/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 file is the file, including the path. If you do not specify user and passwd, the system prompts you for them.
SCP server scp://user:passwd@host/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 file is the file, including the path. If you do not specify user and passwd, the system prompts you for them.
TFTP server tftp://host/file where host is the host name or IP address of the TFTP server, and file is the file, including the path relative to the TFTP root directory. The running (active) configuration running://path/file where path is the path to the file, and file is the file.
A binary image image-name://path/file where image-name is the name of a binary image, path is the path to the file, and file is the file.

The following example shows how to copy the contents of the /config/x509/ directory on the currently running system to the /config/x509/ directory of the TEST-IMAGE-1 image.

vyatta@vyatta:~$ copy file running://config/auth/x509/ to TEST-vyatta@vyatta:~$/auth/x509/
sending incremental file list
created directory /live/image/boot/TEST-IMAGE-1/live-rw/config/x509
./
ca.crt
        1265 100%    0.00kB/s    0:00:00 (xfer#1, to-check=5/7)
crl.pem
         568 100%  554.69kB/s    0:00:00 (xfer#2, to-check=4/7)
key
        5626 100%    5.37MB/s    0:00:00 (xfer#3, to-check=3/7)
straylight-r1.crt
        3632 100%    3.46MB/s    0:00:00 (xfer#4, to-check=2/7)
straylight-r1.key
         891 100%  870.12kB/s    0:00:00 (xfer#5, to-check=1/7)
test.key
         401 100%  391.60kB/s    0:00:00 (xfer#6, to-check=0/7)
 
sent 12808 bytes  received 129 bytes  25874.00 bytes/sec
total size is 12383  speedup is 0.96
vyatta@vyatta:~$