Operation Manual

File Management Commands
Mobility System Software Command Reference Guide
Version 7.3
21 – 486
Syntax copy source-url destination-url
Defaults None.
Access Enabled.
History
Usage
The filename and file:filename URLs are equivalent. You can use either URL to refer to a
file in an MX nonvolatile memory. The tftp://ip-addr/filename URL refers to a file on a TFTP
server. If DNS is configured on the MX, you can specify a TFTP server hostname as an alternative
to specifying the IP address.
The tmp:filename URL specifies a file in temporary storage. You can copy a file out of temporary
storage but you cannot copy a file into temporary storage. Temporary storage is reserved for use
by MSS.
If you are copying a system image file into nonvolatile storage, the filename must be preceded by
the boot partition name, which can be boot0 or boot1. Enter the filename as boot0:/filename or
boot1:/filename. You must specify the boot partition that was not used to load the currently
running image.
The maximum supported file size for TFTP is 32 MB.
Examples The following command copies a file called floormx from nonvolatile storage to a TFTP
server:
MX# copy floormx tftp://10.1.1.1/floormx
success: sent 365 bytes in 0.401 seconds [ 910 bytes/sec]
The following command copies a file called closetmx from a TFTP server to nonvolatile storage:
MX# copy tftp://10.1.1.1/closetmx closetmx
source-url Name and location of the file to copy. The uniform resource locator (URL) can be one
of the following:
❑ [subdirname/]filename
❑ file:[subdirname/]filename
❑ ftp://ip-addr/[subdirname/]filename
❑ scp://ip-addr/[subdirname/]filename
❑ tftp://ip-addr/[subdirname/]filename
❑ tmp:filename
For the filename, specify between 1 and 128 alphanumeric characters, with no spaces.
Enter the IP address in dotted decimal notation.
The subdirname/ option specifies a subdirectory.
destination-url Name of the copy and the location to place the copy. The URL can be one of the
following:
❑ [subdirname/]filename
❑ file:[subdirname/]filename
❑ ftp://ip-addr/[subdirname/]filename
❑ scp://ip-addr/[subdirname/]filename
❑ tftp://ip-addr/[subdirname/]filename
If you are copying a system image file into nonvolatile storage, the filename must
include the boot partition name. You can specify one of the following:
❑ boot0:/filename
❑ boot1:/filename
Version 1.0 Command introduced
Version 1.1 Enhanced to allow copying files from one area in nonvolatile storage to another and
from one name to another in the same area
Version 3.0 Subdirectory support added
Version 7.1 FTP and SCP added as protocols.