Remote Management Commands
This chapter is a reference for commands that copy these types of files:
• Start-up configuration and running configuration
• System files such as boot files, core dumps, and debug logs
Users can use these commands to copy files locally or to copy between the local device and a remote system.
The commands in this chapter use the techniques in
Table 4-1 to remotely transfer files:
Table 4-1: File transfer techniques
Trivial File Transfer Protocol (TFTP) | No authentication or encryption; dangerous to use over the Internet, but might be acceptable in a trusted environment Address format: tftp:[//server[:port]][/path] |
File Transfer Protocol (FTP) | Authenticates, but does not encrypt Address format: ftp:[//server][/path] |
Secure copy (SCP) | Authenticates and encrypts using Secure Shell (SSH1) Address format: scp:[//server][/path] |
SSH File Transfer Protocol (SFTP) | Authenticates and encrypts using Secure Shell (SSH2); this is the most secure technique Address format: sftp:[//server][/path] |
Hyper text Transfer Protocol (HTTP) | Address format: http:[//server][/path] For download of running and startup configurations |
This chapter contains these commands.
copy running-config
Use this command to copy the running configuration to an FTP server, an SCP server, an SFTP server, a TFTP server or an HTTP server.
Command Syntax
copy running-config (tftp TFTP-URL|ftp FTP-URL|scp SCP-URL|sftp SFTP-URL|http HTTP-URL) (vrf (NAME|management)|)
Parameters
TFTP-URL
Destination: tftp:[//server[:port]][/path]
FTP-URL
Destination: ftp:[//server][/path]
SCP-URL
Destination: scp:[//server][/path]
SFTP-URL
Destination: sftp:[//server][/path]
HTTP-URL
Destination: http:[//server][/path]
NAME
Virtual Routing and Forwarding name
management
Management Virtual Routing and Forwarding
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#copy running-config sftp sftp://sftp.mysite.com/running_conf vrf management
copy running-config (interactive)
Use this command to copy the running configuration to an FTP server, an SCP server, an SFTP server, a TFTP server or an HTTP server.
Command Syntax
copy running-config (ftp|tftp|scp|sftp|http) (vrf (NAME|management)|)
Parameters
ftp
Destination: FTP server
tftp
Destination: TFTP server
scp
Destination: SCP server
sftp
Destination: SFTP server
http
Destination: HTTP server
NAME
Virtual Routing and Forwarding name
management
Management Virtual Routing and Forwarding
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#copy running-config sftp vrf management
copy startup-config
Use this command to copy the running configuration to an FTP server, an SCP server, an SFTP server, a TFTP server or an HTTP server.
Command Syntax
copy startup-config (tftp TFTP-URL|ftp FTP-URL|scp SCP-URL|sftp SFTP-URL|http HTTP_URL) (vrf (NAME|management)|)
Parameters
TFTP-URL
Destination: tftp:[//server[:port]][/path]
FTP-URL
Destination: ftp:[//server][/path]
SCP-URL
Destination: scp:[//server][/path]
SFTP-URL
Destination: sftp:[//server][/path]
HTTP-URL
Destination: http:[//server][/path]
NAME
Virtual Routing and Forwarding name
management
Management Virtual Routing and Forwarding
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#copy startup-config sftp sftp://sftp.mysite.com/start-up_conf vrf management
copy startup-config (interactive)
Use this command to copy the running configuration to an FTP server, an SCP server, an SFTP server, a TFTP server or an HTTP server.
Command Syntax
copy startup-config (ftp|tftp|scp|sftp|http) (vrf (NAME|management)|)
Parameters
ftp
Destination: FTP server
tftp
Destination: TFTP server
scp
Destination: SCP server
sftp
Destination: SFTP server
http
Destination: HTTP server
NAME
Virtual Routing and Forwarding name
management
Management Virtual Routing and Forwarding
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#copy startup-config sftp vrf management
copy system file
Use this command to copy a system file to an FTP server, an SCP server, an SFTP server, or a TFTP server.
Note: The names of the options for the source in the first parameter refer to symbolic locations. The specific locations for Linux are noted below. The locations on a specific device can vary depending on the platform.
Command Syntax
copy (core|debug|log|techsupport|filepath) FILE (tftp TFTP-URL|ftp FTP-URL|scp SCP-URL|sftp SFTP-URL)(vrf (NAME|management)|)
Parameters
core
Core file storage; on Linux this refers to /var/log/crash/cores/
debug
Debug file storage; on Linux this refers to /log/
log
Log file storage; on Linux this refers to /var/log/
techsupport
Copy techsupport log files to remote machine
filepath
Copy device file to remote machine
FILE
Source file name
TFTP-URL
Destination: tftp:[//server[:port]][/path]
FTP-URL
Destination: ftp:[//server][/path]
SCP-URL
Destination: scp:[//server][/path]
SFTP-URL
Destination: sftp:[//server][/path]
NAME
Virtual Routing and Forwarding name
management
Management Virtual Routing and Forwarding
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#copy core myFile sftp sftp://sftp.mysite.com/dst_filename vrf management
#copy techsupport tech_support_23_Feb_2001_18_27_00.tar.gz scp scp://10.12.16.17/home/satya/tech_support_23_Feb_2001_18_27_00.tar.gz vrf management
Enter Username:root
Enter Password:
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 72368 0 0 0 72368 0 147k -::- -::- -::- 147k
100 72368 0 0 0 72368 0 147k -::- -::- -::- 147k
Copy Success
copy system file (interactive)
Use this command to copy a system file to an FTP server, an SCP server, an SFTP server, or a TFTP server.
Note: The names of the options for the source in the first parameter refer to symbolic locations. The specific locations for Linux are noted below. The locations on a specific device can vary depending on the platform.
Command Syntax
copy (core|debug|log|techsupport|filepath) FILE (tftp TFTP-URL|ftp FTP-URL|scp SCP-URL|sftp SFTP-URL)(vrf (NAME|management)|)
Parameters
core
Core file storage; on Linux this refers to /var/log/crash/cores/
debug
Debug file storage; on Linux this refers to /log/
log
Log file storage; on Linux this refers to /var/log/
techsupport
Copy techsupport log files to remote machine
filepath
Copy device file to remote machine
FILE
Source file name
TFTP-URL
Destination: tftp:[//server[:port]][/path]
FTP-URL
Destination: ftp:[//server][/path]
SCP-URL
Destination: scp:[//server][/path]
SFTP-URL
Destination: sftp:[//server][/path]
ftp
Destination: FTP server
tftp
Destination: TFTP server
scp
Destination: SCP server
sftp
Destination: SFTP server
NAME
Virtual Routing and Forwarding name
management
Management Virtual Routing and Forwarding
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#copy log myFile sftp sftp://sftp.mysite.com/dst_filename vrf management
copy ftp startup-config
Use this command to copy the start up configuration from an FTP server to the local device.
Command Syntax
copy ftp FTP-URL startup-config (vrf (NAME|management)|)
Parameters
FTP-URL
Configuration source: ftp:[//server][/path]
NAME
Virtual Routing and Forwarding name
management
Management Virtual Routing and Forwarding
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#copy ftp ftp://ftp.mysite.com/scr filename startup-config vrf management
copy scp filepath
Use this command to copy the remote system file using SCP to the local device.
Note: OcNOS has a dedicated partition called /cfg for storing system level configurations, OcNOS configurations and license data. This is persistent across reboots and upgrades and consists of directories /cfg/ and /usr/local/etc. Copying user/general files under /cfg partition is discouraged because the size of this partition is very small and impacts normal system operations like bootup/upgrades and important system files copy when it doesn't have enough space. Users are recommended to use /home to copy the general files. Please note that the contents placed in /home directory are deleted upon software upgrade.
Command Syntax
copy scp SCP-URL (filepath FILEPATH) (vrf (NAME|management)|)
Parameters
SCP-URL
Configuration source: scp:[//server][/path]
FILEPATH
Enter the local filesystem path with filename
NAME
Virtual Routing and Forwarding name
management
Management Virtual Routing and Forwarding
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 3.0.
Examples
#copy scp scp://10.12.65.89/root/cmlsh filepath /root/cmlsh vrf management
copy scp startup-config
Use this command to copy the start up configuration from a SCP server to the local device.
Command Syntax
copy scp SCP-URL startup-config (vrf (NAME|management)|)
Parameters
SCP-URL
Configuration source: scp:[//server][/path]
NAME
Virtual Routing and Forwarding name
management
Management Virtual Routing and Forwarding
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#copy scp scp://scp.mysite.com/scr filename startup-config vrf management
copy sftp startup-config
Use this command to copy the start up configuration from a SFTP server to the local device.
Command Syntax
copy sftp SFTP-URL startup-config (vrf (NAME|management)|)
Parameters
SFTP-URL
Configuration source: sftp:[//server][/path]
NAME
Virtual Routing and Forwarding name
management
Management Virtual Routing and Forwarding
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#copy sftp sftp://sftp.mysite.com/scr filename startup-config vrf management
copy tftp startup-config
Use this command to copy the start up configuration from a TFTP server to the local device.
Command Syntax
copy tftp TFTP-URL startup-config (vrf (NAME|management)|)
Parameters
TFTP-URL
Configuration source: tftp:[//server][/path]
NAME
Virtual Routing and Forwarding name
management
Management Virtual Routing and Forwarding
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#copy tftp tftp://tftp.mysite.com/scr filename startup-config vrf management
copy http startup-config
Use this command to copy the start up configuration from an HTTP server to the local device.
Command Syntax
copy http HTTP-URL startup-config (vrf (NAME|management)|)
Parameters
HTTP-URL
Configuration source: http:[//server][/path]
NAME
Virtual Routing and Forwarding name
management
Management Virtual Routing and Forwarding
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#copy http http://http.mysite.com/scr filename startup-config vrf management
copy ftp startup-config (interactive)
Use this command to copy the start up confguration from an FTP server to the local device.
Command Syntax
copy ftp startup-config (vrf (NAME|management)|)
Parameters
NAME
Virtual Routing and Forwarding name
management
Management Virtual Routing and Forwarding
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#copy ftp startup-config vrf management
copy scp startup-config (interactive)
Use this command to copy the start up confguration from a SCP server to the local device.
Command Syntax
copy scp startup-config (vrf (NAME|management)|)
Parameters
NAME
Virtual Routing and Forwarding name
management
Management Virtual Routing and Forwarding
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#copy scp startup-config vrf management
copy sftp startup-config (interactive)
Use this command to copy the start up confguration from an SFTP server to the local device.
Command Syntax
copy sftp startup-config (vrf (NAME|management)|)
Parameters
NAME
Virtual Routing and Forwarding name
management
Management Virtual Routing and Forwarding
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#copy sftp startup-config vrf management
copy tftp startup-config (interactive)
Use this command to copy the start-up confguration from a TFTP server to the local device.
Command Syntax
copy tftp startup-config (vrf (NAME|management)|)
Parameters
NAME
Virtual Routing and Forwarding name
management
Management Virtual Routing and Forwarding
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#copy tftp startup-config vrf management
copy http startup-config (interactive)
Use this command to copy the start-up confguration from an HTTP server to the local device.
Command Syntax
copy http startup-config (vrf (NAME|management)|)
Parameters
NAME
Virtual Routing and Forwarding name
management
Management Virtual Routing and Forwarding
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#copy http startup-config vrf management
copy file startup-config
Use this command to copy and store a local file into the startup configuration.
Command Syntax
copy file FILE startup-config
Parameters
FILE
File name
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#copy file myFile startup-config
load-config
Use this command to copy a configuration file from either the remote or local file system and apply it to the running-config.
Command Syntax
load-config ((scp SCP-URL) | (filepath FILEPATH))
Parameters
SCP-URL
Configuration source in the format scp:[//server][/path]
FILEPATH
Enter the local file system path with the filename.
Command Mode
Privileged Exec mode
Applicability
This command was introduced in OcNOS version 6.4.1.
Example
For instance, when retrieving a configuration from a remote source, the command might be used as follows:
Remote:
Remote#cat /home/config.txt
interface eth2
ip address 3.3.3.5/24
Device:
OcNOS#load-config scp scp://10.12.43.155/home/config.txt
Enter Username:root
Enter Password:
Enter configuration commands, one per line. End with CNTL/Z.
Please wait. System is restoring previous saved configs..
This may take sometime. Please don't abort....
50% [||||||||||||||||||||||||| ]
Please wait. Starting commit operation..
This may take sometime. Please don't abort....
100% [||||||||||||||||||||||||||||||||||||||||||||||||||]