copy

This command downloads and uploads files from and to the device, respectively.

Syntax

# copy <File Type> {from|to} {<URL>|console|usb:///<Filename>}

Command

Description

File Type

aux-package

Defines the file type as an auxiliary package file, allowing you to download or upload a batch of auxiliary files, using a TAR (Tape ARchive) file (.tar).

The TAR file can contain any number and type of Auxiliary files, for example, a Dial Plan file and a CPT file.

call-progress-tones from

Defines the file type as a Call Progress Tones (CPT) file.

Note: The file can only be uploaded to the device (see the command 'from' below).

cas-table from

Defines the file type as a Channel Associated Signaling (CAS) table file.

Note: The file can only be uploaded to the device (see the command 'from' below).

cli-script {from|to}

Defines the file type as a CLI script file.

configuration-pkg {from|to}

Defines the file type as a Configuration Package file (.7z), which includes all files.

Note:

■ For uploading a Configuration File that is password-protected, use the encrypted option to specify the password: copy configuration-pkg from <URL> encrypted <Password>
■ For downloading the Configuration File, if you want to password-protect it and include the TLS certificates, use the encrypted and certificates options, respectively: copy configuration-pkg from <URL> encrypted <Password> certificates

debug-file to

Defines the file type as a debug file and copies the file from the device to a destination. The debug file contains the following information:

■ Exception information, indicating the specific point in the code where the crash occurred and a list of up to 50 of the most recent SNMP alarms that were raised by the device before it crashed.
■ Latest log messages that were recorded prior to the crash.
■ Core dump. The core dump is included only if core dump generation is enabled, no IP address has been configured, and the device has sufficient memory on its flash memory.

May include additional application-proprietary debug information. The debug file is saved as a zipped file with the following file name: "debug_<device name>_ver_<firmware version>_mac_<MAC address>_<date>_<time>". For example, debug_acMediant_ver_700-8-4_mac_00908F099096_1-03-2015_3-29-29.

dial-plan from

Defines the file type as a Dial Plan file.

Note: The file can only be uploaded to the device (see the command 'from' below).

firmware from

Defines the file type as a firmware file (.cmp).

Note: After the .cmp file is loaded to the device, it's automatically saved to the device's flash memory with a device reset.

incremental-ini-file from

Defines the file type as an ini file, whereby parameters that are not included in the ini file remain at their current settings.

Note: The file can only be uploaded to the device (see the command 'from' below).

ini-file {from|to}

Defines the file type as an ini file, whereby parameters that are not included in the ini file are restored to default values.

Note: The file can be uploaded to or downloaded from the device.

mt-firmware

Defines the file type as a firmware file (.cmp) for Media Transcoders (MT) in the Media Transcoding Cluster feature.

prerecorded-tones from

Defines the file type as a Prerecorded Tones (PRT) file.

Note: The file can only be uploaded to the device (see the command 'from' below).

system-log

Defines the file type as a system log file.

Note: The file can only be downloaded from the device (see the command 'to' below).

system-log-no-sip

Defines the file type as a system log file without SIP messages.

Note: The file can only be downloaded from the device (see the command 'to' below).

system-log-persistent

Defines the file type as a persistent system log file.

Note: The file can only be downloaded from the device (see the command 'to' below).

sbc-wizard from

Defines the file type as a SBC Wizard Configuration Template file, which is used by the Configuration Wizard.

Note: The file can only be uploaded to the device (see the command 'from' below).

startup-script from

Defines the file type as a Startup CLI script file.

storage-history

Defines the file type as a locally stored Call Detail Record (CDR) file. Define the name of the service. To view services, run the command show storage-history services. Currently supported service: cdr-storage-history

tls-cert from

Defines the file type as a TLS certificate file.

Note: The file can only be uploaded to the device (see the command 'from' below).

tls-private-key from

Defines the file type as a TLS private key file.

Note: The file can only be uploaded to the device (see the command 'from' below).

tls-root-cert from

Defines the file type as a TLS trusted root certificate file.

Note: The file can only be uploaded to the device (see the command 'from' below).

user-info from

Defines the file type as a User Info file.

Note: The file can only be uploaded to the device (see the command 'from' below).

voice-prompts

Defines the file type as a Voice Prompts (VP) file.

Note: The file can only be uploaded to the device (see the command 'from' below).

web-favicon from

Defines the file type as an icon file associated with the device's URL saved as a favorite bookmark on your browser's toolbar when using the device's Web interface.

Note: The file can only be uploaded to the device (see the command 'from' below).

web-logo from

Defines the file type as an image file, which is displayed as the logo in the device's Web interface.

Note: The file can only be uploaded to the device (see the command 'from' below).

Download/Upload

from

Uploads a file to the device.

to

Downloads a file from the device to a specified destination.

File Location

URL

Defines the URL from which / to which to upload / download the file.

The file transfer protocol can be one of the following:

■ HTTP
■ HTTPS
■ SCP
■ TFTP

The source network interface (IP address alias/IP VRF alias) can also be specified using the source command:

Note: The URL for HTTP/S and SCP can include the authentication username and password, using the following syntax (e.g., HTTPS):

https://<Username>:<Password>@<IP>/<Path>

For example:

copy firmware from https://sue:1234@10.4.10.0/firmware.cmp

console

Displays the current .ini configuration file on the CLI console.

Note: The command is applicable only to the .ini configuration file (copy ini-file to).

usb:///<file name>

Uploads the file from a USB stick, connected to the device, to the device, or downloads the file from the device to a USB stick connected to the device.

Note: The command is applicable only to devices that provide a USB port interface.

Command Mode

Privileged User

Related Commands

■ erase
■ dir
■ write

Note

■ When you load a file to the device, you must run the write command to save the file to flash memory, otherwise, the file is deleted when the device resets or powers off.
■ For more information on the different file types, refer to the User's Manual.
■ During firmware file (.cmp) load, a message is displayed showing load progress information. The message is also displayed in the console of all other users that are currently connected to the device through CLI. The message forcibly stops the users from performing further actions, preventing them from interrupting the load process. Below shows an example of such a message: 
# copy firmware from http://10.3.1.2:1400/tftp/SIP_F7.20A.140.226.cmp
 % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current Dload  Upload   Total   Spent    Left  Speed
100 40.7M  100 40.7M    0     0  1288k      0  0:00:32  0:00:32 --:--:-- 1979k
Firmware file http://10.3.1.2:1400/tftp/SIP_F7.20A.140.226.cmp was loaded.  (user: Admin, IP local)
The system will reboot when done
DO NOT unplug/reset the device
.............................................................
Firmware process done. Restarting now...
Restarting......

The displayed information includes:

● %: Percentage of total bytes downloaded and uploaded; downloaded is displayed only when downloading a file (i.e., copy from command)
● Total: Total bytes downloaded and uploaded.
● %: Percentage of downloaded bytes (copy from command only).
● Received: Currently downloaded bytes (copy from command only).
● %: Percentage of uploaded bytes (copy to command only).
● Xferd: Currently uploaded bytes (copy to command only).
● Average Dload: Average download speed in bytes/sec (copy from command only).
● Speed Upload: Average upload speed in bytes/sec (copy to command).
● Time Spent: Elapsed time.
● Time Left: Time remaining for the file upload/download to complete.
● Current Speed: Current upload/download speed in bytes/sec.

Example

■ Copying firmware file from an HTTP server: 
# copy firmware from http://192.169.11.11:80/SIP_F7.20A.260.002.cmp
■ Displaying (copying) the ini configuration file to the CLI console: 
# copy ini-file to console
■ Auxilliary file batch: 
# copy myauxfiles.tar from http://www.exmaple.com/auxiliary
■ Copying CLI-based configuration from TFTP server: 
# copy cli-script from tftp://192.168.0.3/script1.txt
■ Upgrading the device’s firmware from a source URL file: 
# copy firmware from http://www.exmaple.com/firmware.cmp
■ Copying the dial plan file: 
copy dial-plan from http://10.4.2.2/MyHistoryFiles/