Cisco ONS 15454, Cisco ONS 15600, and Cisco ONS 15310-MA SONET TL1 Command Guide, Release 9.0
Chapter 8: COPY commands
Downloads: This chapterpdf (PDF - 349.0KB) The complete bookPDF (PDF - 10.22MB) | Feedback

COPY Commands

Table Of Contents

COPY Commands

8.1  COPY-IOSCFG

8.2  COPY-RFILE

Prerequisite


COPY Commands


This chapter provides copy (COPY) commands for the Cisco ONS 15454, Cisco ONS 15310-CL,
Cisco ONS 15310-MA, and Cisco ONS 15600.

8.1  COPY-IOSCFG

(Cisco ONS 15454, ONS 15310-CL, ONS 15310-MA) The Copy Cisco IOS Configuration File (COPY-IOSCFG) command supports the following types of operations on the Cisco IOS configuration file of ML-Series Ethernet cards:

1. Uploading the startup Cisco IOS configuration file from the network to the node.

FTP is the only protocol allowed for uploading. When doing this operation, the source access identifier (SRC) field must be an FTP URL string specifying the user name and password for FTP authentication, and specifying the host and the directory to locate the startup configuration file from the network. The DEST field must be a string of "STARTUP."

2. Downloading the startup Cisco IOS configuration file from the node to the network.

FTP is the only protocol allowed for downloading. When doing this operation, the SRC field must be a string of "STARTUP." The DEST field must be an FTP URL string specifying the user name and password for FTP authentication, and specifying the host and the directory to store the startup configuration file on the network.

Usage Guidelines

This FTP timeout is 30 seconds and is not configurable.

The Cisco IOS configuration file is unique for each ML-Series card, and is specified by the SLOT number in the AID field of the command.

The format of the FTP URL string used in the SRC or DEST field of the command is as follows:

In a nonfirewall environment, the format of the URL should be:

"FTP://[FTPUSER[:FTPPASSWORD]]@FTPHOST/CONFIG_FILE_PATH"

where:

FTPUSER is the user ID to connect to the computer with the package file.

<FTPPASSWORD> is the password used to connect to the computer with the package file.

<FTPHOST> is the IP address of the computer with the package file. DNS lookup of hostnames is not supported.

<CONFIG_FILE_PATH> is the long path name to the package file.

Note that USERID and PASSWORD are optional if the user does not need to log into the host computer. All the other portions of the URL are required, including the initial "FTP:\\" string.

In a firewall environment, the hostname should be replaced with a list of IP addresses each separated by the ampersand (@) character. The first IP address should be the machine where the package file is stored. Subsequent IP addresses should be for firewall machines moving outwards towards the edge of the network, until the final IP address listed was the machine that outside users first access the network. For example, if your topology is

"FTPHOST <-> GNE3 <->GNE2 <-> GNE1 <-> ENE"

your FTP URL will be:

"FTP://FTPUSER:FTPPASSWORD@FTPHOST@GNE3@GNE2@GNE1/CONFIG_FILE_PATH"

Category

File Transfer

Security

Provisioning

Input Format

COPY-IOSCFG:[<TID>]:<AID>:<CTAG>::SRC=<SRC>,DEST=<DEST>,[FTTD=<FTTD>];

Input Example

COPY-IOSCFG::SLOT-1:CTAG::SRC="LONG_FTP_PATH",DEST="STARTUP",
FTTD="FTTD_URL";

Input Parameters

<AID>

Access identifier. Specifies the slot number of the card where the Cisco IOS configuration file belongs. The AID is from the "EQPT" section.

<SRC>

Source AID. Specifies where the Cisco IOS configuration file is copied from. SRC is a string.

<DEST>

Specifies where the Cisco IOS configuration file is copied to. DEST is a string.

<FTTD>

FTTD is a string.


8.2  COPY-RFILE

(Cisco ONS 15454, 15327, 15600, 15310) The Copy File (COPY-RFILE) command downloads a new software package from the location specified by the FTP URL. It is also used to back up and restore the system database.

Prerequisite

To run the COPY-RFILE command, do the following:

Run the FTP server on the remote machine.

Register the FTP server on the GNE using the ENT-FTPSERVER command.

Here is an example that explains the execution of COPY-RFILE command:

> ENT-FTPSERVER:::A:::IPADDR=72.163.210.211,ENABLE=Y,IPMASK=255.255.255.
> 0,TIMER=0;
Infy600-162 2009-01-23 07:18:27
M  A COMPLD
;
> 
> RTRV-FTPSERVER:::A;
Infy600-162 2009-01-23 07:18:43
M  A COMPLD
   "IPADDR=10.77.29.252,IPMASK=255.255.255.0,ENABLE=Y,TIMER=0"
   "IPADDR=72.163.210.211,IPMASK=255.255.255.0,ENABLE=Y,TIMER=0"
   "IPADDR=64.103.135.83,IPMASK=255.255.255.0,ENABLE=Y,TIMER=0"
   "IPADDR=10.65.72.136,IPMASK=255.255.255.0,ENABLE=N,TIMER=0"
;
> 

Usage Guidelines

To upload package files or restore databases from a host, the host must be running an FTP server application. If the host is not running an FTP server application, the command fails, indicating that the NE was unable to connect to the remote IP address (host). A host can either be a PC or a workstation running an FTP server application.

User ID is the user's ID used to connect to the computer hosting the package file or system database.

Password is the password used to connect to the computer hosting the package file or system database.

Hostname is the hostname or IP address of the computer hosting the package file or system database.

PACKAGE_PATH is the long path name to the package file, starting from the home directory of the logged-in user.

All the other portions of the URL are required, including the initial "FTP://" string. For example:

COPY-RFILE:TID:RFILE-PKG:703::TYPE=SWDL,SRC="FTP://USERID:PASSWORD@HOSTIP:21/DIR1/DIR2/DIR3/PACKAGE.PKG";


NoteThe SWDL type is used for software package uploads. The RFBU type is used for system database backups, and the RFR type is used for system database restores. The SRC input is required when the type is SWDL or RFR. The DEST input is needed when the type is RFBU. The SRC and DEST inputs cannot both be used in the same command.

The extended FTP URL syntax is required by the COPY-RFILE syntax.

If using an FTP URL, port number (21) is optional. Leaving this field blank defaults to 21. However, if using an FTTD URL, then port number (21) is mandatory and no default is defined.

The default values for all optional parameters are NE default values. These values might not be the current value for a parameter. In order to obtain the current value, issue the RTRV-XX command.

If using an FTTD URL, the firewall on the GNE must be disabled.



Note FTP timeout is 30 seconds and is not configurable.


Category

File Transfer

Security

Superuser

Input Format

COPY-RFILE:[<TID>]:<SRC>:<CTAG>::TYPE=<XFERTYPE>,[SRC=<SRC1>],
[DEST=<DEST>],[OVWRT=<OVWRT>],[FTTD=<FTTD>];

Input Example

COPY-RFILE:HERNDON:RFILE-PKG:703::TYPE=SWDL,SRC="LONG_FTP_PATH",
DEST="LONG_FTP_PATH",OVWRT=YES,FTTD="FTTD_URL";

Input Parameters

<SRC>

Source AID. The type of file being transferred. Defaults to RFILE-PKG. From the AID "RFILE" section.

<XFERTYPE>

The file transfer protocol. The parameter type is TX_TYPE, which specifies the type and direction of the file transferred.

RFBU

Remote File Backup. Applicable for Maintenance User (and higher).

RFR

Remote File Restore. Applicable for Superuser.

SWDL

Software Download. Applicable for Maintenance User (and higher).

<SRC1>

Specifies the source of the file to be transferred. Only the FTP URL is supported. In a nonfirewall environment, the format of the URL should be:

"FTP://FTP_USER[:FTP_PASSWORD]]@FTP_HOST_IP[:21]/PACKAGE_PATH[;TYPE=I]"

where:

<FTP_USER> is the user ID to connect to the computer hosting the package file.

<FTP_PASSWORD> is the password used to connect to the computer hosting the package file.

<FTP_HOST_IP> is the IP address of the computer hosting the package file. DNS lookup of host names is not supported.

<PACKAGE_PATH> is the long path name to the package file starting from the home directory of the logged-in user.

Note User ID and password are optional if the user does not need to log into the host computer. All the other portions of the URL are required, including the initial "FTP://" string.

Note In Software Release 5.0 and later, PACKAGE_PATH is relative to your home directory, instead of being an absolute path from the root directory of the network element (NE). If you want to specify an absolute path, start the path with the string "%2F".

In a firewall environment, the hostname should be replaced with a list of IP addresses each separated by a @ character. The first IP address should be for the machine where the package file is stored. Subsequent IP addresses should then be for firewall machines moving outwards towards the edge of the network, until the final IP address listed is the machine that outside users first access the network.

For example, if the topology is

"FTP_HOST_IP <-> GNE3 <->GNE2 <-> GNE1 <-> ENE"

the FTP URL is:

FTP://FTP_USER:FTP_PASSWORD@FTP_HOST_IP@GNE3@GNE2@
GNE1/PACKAGE_PATH

The FTP_HOST_IP must be one of the IP addresses that is configured on the node as a secure FTP Host.

Note In the secure mode setting, if the IP address of the front LAN port is different from the IP address of the back LAN port, then GNE3 is the IP address of the front LAN port.

SRC1 is a string.

<DEST>

Specifies the destination of the file to be transferred. The comments for the SRC parameter (above) also apply to the DEST parameter. DEST is a string.

<OVWRT>

If OVWRT is YES, the files should be overwritten. If OVWRT is NO, the file transfer will fail if the file already exists at the destination. Using the NO value will result in an error message. The NO value is not supported for database restore or software download.

The parameter type is YES_NO, which indicates whether the user password is about to expire, the user is logged into the N or the user is locked out of the NE.

NO

No

YES

Yes

<FTTD>

FTTD is a string