C i s c o C o n f i d e n t i a l - B e t a R e v i e w R 3 . 7. 1
File System Commands on Cisco IOS XR Software
copy
SMR-226
Cisco ASR 14000 Series Router System Management Command Reference
OL-17231-01
Using FTP
FTP servers require a username and password for each client request. Cisco IOS XR software sends the
first valid username in the following list:
1.
The username and password specified in the
copy
command, if a username is specified.
The syntax is as follows:
copy ftp://
username
:
password
@
hostname or ipaddress
/
directory-path
/
pie-name
target-device
[
location
node-id
|
location
all
]
Example:
RP/0/RP0/CPU0:router#
copy ftp://john:[email protected]/images/asr14k-mcast-p.pie
disk1:
2.
An “anonymous” username and password. The anonymous password is “root@ip address,” where
“ip address” is the IP address of the local networking device.
3.
A password “[email protected]
”
formed by the networking device. The variable
“username
”
is the username associated with the current session, “iosname
”
is the configured
hostname, and “domain
”
is the domain of the networking device.
The username and password must be associated with an account on the FTP server. If you are writing to
the network server, the FTP server must be properly configured to accept the FTP write request from the
user on the networking device.
If the network server has a directory structure, the configuration file or image is written to or copied from
the directory associated with the username on the network server. For example, if the system image
resides in the home directory of a user on the network server, specify the name of that user as the remote
username.
Refer to the documentation for your FTP server for more details.
Using rcp
The rcp protocol requires a username upon each request. When you copy a configuration file or image
between the networking device and an rcp server, the Cisco IOS XR software sends the first valid
username in the following list:
1.
The remote username specified in the
copy
command, if one is specified.
2.
The username set by the
rcp client username
command, if the command is configured.
3.
The networking device hostname.
For the rcp copy request to process successfully, an account must be defined on the network server for
the remote username. If the network administrator of the destination server did not establish an account
for the remote username, this command does not run successfully. If the network server has a directory
structure, the configuration file or image is written to or copied from the directory associated with the
remote username on the network server. For example, if the system image resides in the home directory
of a user on the network server, specify the name of that user as the remote username.
If you are writing to the network server, the rcp server must be properly configured to accept the rcp
write request from the user on the networking device. For UNIX systems, add an entry to the .rhosts file
for the remote user on the rcp server. Suppose the networking device contains the following
configuration lines:
hostname Rtr1
ip rcp remote-username User0
