copy

Copies files from one location to another.

copy <source> <dest>
 
copy /<data-type> rsync:[//<user>:<password>@<host>:<port>/<dir>]
 
copy rsync:[//<user>:<password>@<host>:<port>/<dir>] /<data-type> 
 

• source--can be one of the following:
• URL of source file
• running-config
• startup-config
• Name of a file in the CNA repository
• dest--can be one of the following:
• URL of destination file
• running-config
• startup-config
• Name of a file in the CNA repository
• data-type--type of data being replicated (must be trends)
• user--user name for logging on to remote rsync host
• password--password required for remote rsync host
• host--IP address or hostname of remote rsync host
• port--access port on remote rsync host
• dir--rsync root directory on remote rsync host

System operations mode, privileged-level access.

Files are specified as URLs, in one of the following forms:

ftp://[<username>:<password>@]<host>[:<port>]/<directory>/<file>
 
http://[<username>:<password>@]<host>[:<port>]/<directory>/<file>
 

 

For ftp or http authentication, you can specify user name and password as part of the URL, as in the following examples:

ftp://user-1:password@my-ftp-host/directory-name/my-file-name
 
http://user-1:password@my-http-host/directory-name/my-file-name
 

 

Alternatively, you can specify them on the command line prior to executing the copy command. Use the ip ftp username and ip ftp password or ip http username and ip http password commands.

If username and password values are not specified, CNA will still attempt to copy the files from the network server.

If authentication is required and none is specified, the copy command will fail.

If the destination is specified as running-config, the commands in the source file will be merged with the currently running configuration.

If the destination is specified as startup-config, the current startup configuration will be copied to a backup location before the new one is written. The backup copy of the startup configuration can be obtained by executing the recover startup-config command.

You cannot copy an empty file; if the file has no contents, the command will fail.

When you copy a file containing multiple commands to the running configuration, the CLI will generate a status report indicating the number of commands contained in the file, the number of commands that were successfully applied, and the number and name of any commands that could not be applied because of some configuration conflict.

The copy command can be used to force a one-time update of a remote repository of user data.

You can also use the copy command to restore the local user data repository from the remote site.

See the commands rsync enable, rsync target and rsync username for more information.