System Image, Microcode Image, and Configuration File Load Commands

Syntax Description

Default

If no extended BOOTP commands are entered, the router software generates a gateway and subnet mask appropriate for the local network.

Command Mode

Global configuration

Usage Guidelines

Use the EXEC command show async-bootp to list the configured parameters. Use the no
async-bootp command to clear the list.

Examples

The following example illustrates how to specify different boot files: one for a PC, and one for a Macintosh. With this configuration, a BOOTP request from the host on 128.128.1.1 results in a reply listing the boot filename as pcboot. A BOOTP request from the host named mac results in a reply listing the boot filename as macboot.

async-bootp bootfile :128.128.1.1 "pcboot"
async-bootp bootfile :mac "macboot"

The following example specifies a subnet mask of 255.255.0.0:

async-bootp subnet-mask 255.255.0.0
 

The following example specifies a negative time offset of the local subnetwork of -3600 seconds:

async-bootp time-offset -3600

The following example specifies the IP address of a time server:

async-bootp time-server 128.128.1.1

Related Command

Syntax Description

Default

If you enter the boot command and press Return, the router boots from ROM by default.

If you enter the boot flash command without a filename, the first valid file in Flash memory is loaded.

For other defaults, see the Syntax Description section.

Command Mode

Usage Guidelines

Use this command only when your router cannot find the configuration information needed in nonvolatile random-access memory (NVRAM). To get to the ROM monitor prompt (>), enter the reload EXEC command, and then press the Break key during the first 60 seconds of startup, or change the boot bits in the configuration register to zero (for manual booting) and then issue the reload command.

Refer to the Cisco 7000 Hardware Installation and Maintenance publication for the correct jumper settings for the Cisco 7000 series.

Examples

In the following example, the router is manually booted from ROM:

> boot

F3:
(ROM Monitor copyrights)
 

> boot routertest 131.108.15.112

F3:
(ROM Monitor copyrights)
 

The following example shows the boot flash command without the filename argument.The first valid file in Flash memory is loaded.

> boot flash

F3: 1858656+45204+166896 at 0x1000
 
Booting gs7-k from flash memory RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR [OK - 1903912/13765276 bytes]
F3: 1858676+45204+166896 at 0x1000
 
(ROM Monitor copyrights)
 

In the following example, the boot flash command is used with the filename gs7-k. That is the file that will be loaded.

> boot flash gs7-k

F3: 1858656+45204+166896 at 0x1000
 
Booting gs7-k from flash memory RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRR [OK - 1903912/13765276 bytes]
F3: 1858676+45204+166896 at 0x1000
 
(ROM Monitor copyrights)

In the following example, the boot flash flash command boots the relocatable image file igs-bpx-l from partition 2 in Flash memory:

> boot flash flash:2:igs-bpx-l

F3: 3562264+98228+303632 at 0x30000B4

 
(ROM Monitor copyrights)
 

Related Command

Syntax Description

Default

There is no default Flash device or filename.

Command Mode

Global configuration

Usage Guidelines

Use this command only with the Cisco 7500 series. The boot bootldr command sets the BOOTLDR environment variable in the current running configuration. You must specify both the device and the filename.

The no form of the command sets the BOOTLDR environment variable to a null string. On the Cisco 7500 series, a null string causes the first image file in bootflash to be used as the rxboot image that ROM uses for booting.

Example

The following example specifies that the Flash memory card inserted in slot 0 of the RSP card contains the rxboot image:

boot bootldr slot0:boot-image

Related Commands

Use this command when you have attempted to load a system image but have run out of memory even after compressing the system image. Secondary bootstrap allows you to load a larger system image through a smaller secondary image.

Example

In the following example, the system image file sysimage-2 will be loaded by using a secondary bootstrap image:

boot bootstrap sysimage-2

Syntax Description

Default

Buffer size of the NVRAM

Command Mode

Global configuration

Usage Guidelines

Normally, the router uses a buffer the size of the system NVRAM to hold configuration commands read from the network. You can increase this size if you have a very complex configuration.

Example

The following example sets the buffer size to 64000:

configure terminal 
boot buffersize 64000

Syntax Description

Default

NVRAM (nvram:)

Command Mode

Global configuration

Usage Guidelines

Use this command only with the Cisco 7500 series. You set the CONFIG_FILE environment variable in the current running memory when you use the boot config command. This variable specifies the configuration file used for initialization (startup).

If you specify nvram: as the device, and it contains only a distilled version of the configuration, the router displays an error message and does not update the CONFIG_FILE environment variable. (A distilled configuration is one that does not contain access lists.) If you specify a configuration file in the filename argument that does not exist or is not valid, the router displays an error message and does not update the CONFIG_FILE environment variable.

The router uses the NVRAM configuration during initialization when the CONFIG_FILE environment variable does not exist or when it is null (such as at first-time startup). If the router detects a problem with NVRAM or the configuration it contains, the router enters setup mode. Refer to the Router Products Getting Started Guide for more information on the setup command facility.

When you use the no form of this command, the router returns to using the NVRAM configuration as the startup configuration.

Examples

The following example instructs a Cisco 7500 series router to use the configuration file router-config located on the Flash memory card inserted in the second PCMCIA slot of the RSP card during initialization. The second line copies the specification to the startup configuration, ensuring that this specification will take effect upon the next reload:

Router (config)# boot config slot1:router-config

^Z
Router# copy running-config startup-config

Related Commands

Syntax Description

Default

The default filename is network-config. The default transfer protocol type is TFTP, if neither tftp nor rcp is specified.

Command Mode

Global configuration

Usage Guidelines

The rcp software requires that a client send the remote username on each rcp request to the network server. When the boot network rcp command is executed, the router software sends the router host name as the both the remote and local usernames. The rcp implementation searches for the configuration files to be used relative to the account directory of the remote username on the network server, if the server has a directory structure, for example, as do UNIX systems.

If you copy the system image to a personal computer used as a file server, the remote host computer must support the remote shell (rsh) protocol.

Examples

The following example changes the network configuration filename to bridge_9.1 and uses the default broadcast address:

boot network bridge_9.1
service config 
 

The following example changes the network configuration filename to bridge_9.1, specifies that rcp is to be used as the transport mechanism, and gives 131.108.1.111 as the IP address of the server on which the network configuration file resides:

boot network rcp bridge_9.1 131.108.1.111
service config 

Related Commands

You can force the router to stop booting by pressing the Break key during the first 60 seconds of startup. The router will enter ROM Monitor mode, where you can change the configuration register or boot the router manually.

For routers with the RSP card (Cisco 7500 series), valid devices are bootflash, slot0, slot1, and tftp. On the Cisco 7500 series, the following forms of the boot system command specify a list of bootable images in the BOOT environment variable:

• boot system flash bootflash:[filename]
  no boot system flash bootflash:[filename]
  
  
• boot system flash slot0:[filename]
  no boot system flash slot0:[filename]
  
  
• boot system flash slot1:[filename]
  no boot system flash slot1:[filename]
  
  
• boot system tftp filename [ip-address]
  no boot system tftp filename [ip-address]
  
  

If an entry in the BOOT environment variable list does not specify a device, the router assumes the device is tftp. When tftp is the device, the router first loads the rxboot image to boot the system image file from a network server. If an entry in the BOOT environment variable list specifies an invalid device, the router skips that entry. To view the contents of the BOOT environment variable, use the show boot command.

To remove a single entry from the bootable image list, use the no form of a specific command. For example, to remove the entry that specifies a bootable image on a Flash memory card inserted in the second slot of the RSP card, use the no boot system flash slot1:[filename] command. All other entries in the list remain.

To eliminate all entries in the bootable image list, use the no boot system command. Issuing this command sets the BOOT environment variable to a null string, wiping out all entries. At this point, you can redefine the list of bootable images using the previous boot system commands. Remember to save your changes to your startup configuration by issuing the write memory or copy running-config startup-config command.

Examples

The following example illustrates a list specifying two possible internetwork locations for a system image, with the ROM software being used as a backup:

boot system cs3-rx.90-1 192.31.7.24

boot system cs3-rx.83-2 192.31.7.19

boot system rom
 

The following example boots the system boot relocatable image file igs-bpx-l from partition 2 of the Flash device:

boot system flash flash:2:igs-bpx-l
 

The following example instructs the router to boot from an image located on the Flash memory card inserted in slot 0 of the Cisco 7500 series RSP card:

boot system flash slot0:new-config

Related Commands

Syntax Description

Default

For the Cisco 7500 series, slot0 is the initial default device and the default device when you omit the device: argument.

Command Mode

EXEC

Usage Guidelines

Use this command only with the Cisco 7500 series. For all EXEC commands that have an optional device: argument, the system uses the device specified by the cd command when you omit the optional device: argument. For example, the dir command contains an optional device: argument and displays a list of files on a Flash memory device. When you omit this device: argument, the system shows a list of the files on the Flash device specified by the cd command.

Example

The following example sets the default device to the Flash memory card inserted in slot 0 of the RSP card:

cd slot0:

Related Commands

• If you set the configuration register value to 0x100, you must boot the operating system manually with the boot command.
  
  
• If you set the configuration register value to 0x101, the router boots using the default ROM software.
  
  
• If you set the configuration register to any value from 0x102 to 0x10F, the router uses the boot field value to form a default boot filename for netbooting.
  
  

For more information about the configuration register bit settings and default filenames, see the appropriate router hardware installation guide.

Example

In the following example, the configuration register is set to boot the system image from Flash memory:

config-register 0x010F

Related Commands

Syntax Description

Default

If you omit the source or destination device, the router uses the default device specified by the cd command. If you omit the destination filename, the router uses the source filename.

Command Mode

EXEC

Usage Guidelines

Use this copy command with the Cisco 7500 series.

When the destination is specified by the CONFIG_FILE or BOOTLDR environment variable, the router prompts you for confirmation before proceeding with the copy. When the destination is the only valid image in the BOOT environment variable, the router also prompts you for confirmation before proceeding with the copy.

The CONFIG_FILE environment variable specifies the configuration used during router initialization. The BOOTLDR environment variable specifies the Flash device and filename containing the rxboot image that ROM uses for booting. The BOOT environment variable specifies a list of bootable images on various devices. To view the contents of environment variables, use the show boot command. To modify the CONFIG_FILE environment variable, use the boot config command. To modify the BOOTLDR environment variable use the boot bootldr command. To modify the BOOT environment variable, use the boot system command. To save your modifications, use the write memory command.

If you do not specify a source or destination device, the router uses the default device specified by the cd command.

Examples

The following example copies the router-config1 file from the internal Flash memory of a Cisco 7500 series router to the router-backupconfig file on the Flash memory card inserted in the first slot of the RSP card:

copy bootflash:router-config1 slot0:router-backupconfig
 

In the following example, the router copies the router-image file from the Flash memory card inserted in slot 0 of the RSP card on a Cisco 7500 series to the startup configuration:

copy slot0:router-image startup-config
 

The following example copies the NVRAM configuration file to the router-backupconfig file on the Flash memory card inserted in slot 0 of the RSP card:

copy nvram: slot0:router-backupconfig
 

Related Commands

Syntax Description

Command Mode

EXEC

Usage Guidelines

Use the copy bootflash rcp command to copy a bootstrap image from Flash memory to a network server using rcp. The rcp protocol requires that a client send the remote username of an rcp request to the server. When you issue the copy bootflash rcp command, by default the router software sends the username associated with the current TTY, if that name is valid. For example, if the user is connected to the router through Telnet and the user was authenticated through the username command, then the router software sends that username as the remote username.

Router(config)# ip rcmd remote-username netadmin1

Router# copy bootflash rcp


System flash directory, partition 2:
File  Length   Name/status
  1   984      junk
[1048 bytes used, 8387560 available, 8388608 total]
Address or name of remote host [223.255.254.254]?
Source file name? junk
Destination file name [junk]? junk
Verifying checksum for 'junk' (file # 1)...  OK
Copy 'junk' from Flash to server
  as 'junk'? [yes/no]y
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
Upload to server done
Flash copy took 0:00:00 [hh:mm:ss]
 

The exclamation points (!) indicate that the copy process is taking place. Each exclamation point (!) indicates that ten packets have been transferred successfully.

Router# copy bootflash tftp


System flash directory, partition 2:
File  Length   Name/status
  1   984      junk
[1048 bytes used, 8387560 available, 8388608 total]
Address or name of remote host [223.255.254.254]?
Source file name? junk
Destination file name [junk]? junk
Verifying checksum for 'junk' (file # 1)...  OK
Copy 'junk' from Flash to server
  as 'junk'? [yes/no]y
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
Upload to server done
Flash copy took 0:00:00 [hh:mm:ss]

Related Commands

Syntax Description

Default

On the Cisco 7500 series, if you omit the destination device, the router uses the default device specified by the cd command. If you omit the destination filename, the router uses the source filename.

Command Mode

EXEC

Usage Guidelines

On all platforms except the Cisco 7500 series, the copy flash command copies from internal Flash memory.

On the Cisco 7500 series, the copy flash command copies from one of the three Flash memory devices on the Cisco 7500 series. The system prompts you to enter a specific device and filename. You can enter one of the following as the source device on the Cisco 7500 series:

• bootflash:. This device is the internal Flash memory in the router.
  
  
• slot0:. This device is the first PCMCIA slot on the RSP card.
  
  
• slot1:. This device is the second PCMCIA slot on the RSP card.
  
  

You must follow the source device with a colon (:) and a filename.

Use the copy flash rcp command to copy a system image from Flash memory to a network server using rcp. You can use the copy of the system image as a backup copy. You can also use it to verify that the copy in Flash memory is the same as the original file.

The rcp software requires that a client send the remote username on each rcp request to the server. When you issue the copy flash rcp command, by default the router software sends the remote username associated with the current TTY, if that name is valid. For example, if the user is connected to the router through Telnet and was authenticated through the username command, then the router software sends that username as the remote username.

If the TTY username is invalid, the router software uses the router host name as the both the remote and local usernames.

To specify a different remote username to be sent to the server, use the ip rcmd remote-username command. You can also specify the path of an existing directory along with the remote username.

Caution an account on the destination server. If you do not use the ip rcmd remote-username command to specify the name of a remote user associated with an account on the server, then the remote username associated with the current TTY process must be associated with an account on the server. If there is no username for the current TTY process, then the router host name must be associated with an account on the server. If the network administrator of the destination server did not establish accounts for the remote username used, this command will not execute successfully when a default remote username is used.

The rcp server must be properly configured to accept the rcp write request from the user on the router. For UNIX systems, you must add an entry to the .rhosts file for the remote user on the rcp server. For example, if the router contains the following configuration lines:

hostname Rtr1
ip rcmd remote-username User0
 

and the router's IP address translates to Router1.company.com, then the .rhosts file for User0 on the rcp server should contain the following line:

Router1.company.com Rtr1
 

Refer to the documentation for your rcp server for more details.

If you copy the system image to a personal computer used as a file server, the computer must support the rsh protocol.

Use the copy flash tftp command to copy a system image from Flash memory to a TFTP server. As with the copy flash rcp command, you can use the copy of the system image as a backup or to verify that the copy in Flash is the same as the original file.

On the Cisco 7500 series, when the destination is also specified by the CONFIG_FILE environment variable, the router prompts you for confirmation before proceeding with the copy. The CONFIG_FILE environment variable specifies the configuration used during router initialization. To view the contents of the CONFIG_FILE environment variable, use the show boot command. To modify the CONFIG_FILE environment variable, use the boot config command. To save your modifications to the CONFIG_FILE environment variable, use the write memory or copy running-config startup-config command.

Examples

Router# configure terminal

Router# ip rcmd remote-username netadmin1

^Z

Router# copy flash rcp

 
System flash directory, partition 2:
File  Length   Name/status
  1   984      junk
[1048 bytes used, 8387560 available, 8388608 total]
Address or name of remote host [223.255.254.254]?
Source file name? junk
Destination file name [junk]? junk
Verifying checksum for 'junk' (file # 1)...  OK
Copy 'junk' from Flash to server
  as 'junk'? [yes/no]y
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
Upload to server done
Flash copy took 0:00:00 [hh:mm:ss]
 

The exclamation points (!) indicate that the copy process is taking place. Each exclamation point (!) indicates that ten packets have been transferred successfully.

Router# copy flash rcp

IP address of remote host [255.255.255.255]? 101.2.13.110

Name of file to copy? gsxx

writing gsxx !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!copy complete
 

Router# copy flash rcp

System flash partition information:
Partition   Size     Used    Free    Bank-Size   State       Copy-Mode
    1       4096K    2048K   2048K   2048K       Read Only   RXBOOT-FLH
    2       4096K    2048K   2048K   2048K       Read/Write  Direct
 
[ Type ?<number> for partition directory; ? for full directory; q to abort]
Which partition? [default = 1]
 

The system will prompt if there are two or more partitions. If the partition entered is not valid, the process terminates. You have the option to enter a partition number, a question mark (?) for a directory display of all partitions, or a question mark and a number (?number) for a directory display of a particular partition. The default is the first partition.

System flash directory, partition 2:
File  Length   Name/status
  1   3459720  master/igs-bfpx.100-4.3
[3459784 bytes used, 734520 available, 4194304 total]
Address or name of remote host [ABC.CISCO.COM]?
Source file name? 
 

The file will be copied from the partition given by the user earlier:

Destination file name [default = source name]?
Verifying checksum for 'master/igs-bfpx.100-4.3' (file # 1)...  OK
Copy 'master/igs-bfpx.100-4.3' from Flash to server
as 'master/igs-bfpx.100-4.3'? [yes/no] yes

 

Router# copy flash tftp

IP address of remote host [255.255.255.255]? 101.2.13.110

Name of file to copy? gsxx

writing gsxx !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!copy complete
 

Router# copy flash tftp

System flash partition information:
Partition   Size     Used    Free    Bank-Size   State       Copy-Mode
    1       4096K    2048K   2048K   2048K       Read Only   RXBOOT-FLH
    2       4096K    2048K   2048K   2048K       Read/Write  Direct
 
[Type ?<number> for partition directory; ? for full directory; q to abort]
Which partition? [default = 1]
 

The system will prompt if there are two or more partitions. If the partition entered is not valid, the process terminates. You have the option to enter a partition number, a question mark (?) for a directory display of all partitions, or a question mark and a number (?number) for a directory display of a particular partition. The default is the first partition.

System flash directory, partition 2:
File  Length   Name/status
  1   3459720  master/igs-bfpx.100-4.3
[3459784 bytes used, 734520 available, 4194304 total]
Address or name of remote host [ABC.CISCO.COM]?
Source file name? 
 

The file will be copied from the partition given by the user earlier:

Destination file name [default = source name]?
Verifying checksum for 'master/igs-bfpx.100-4.3' (file # 1)...  OK
Copy 'master/igs-bfpx.100-4.3' from Flash to server
as 'master/igs-bfpx.100-4.3'? [yes/no] yes

 

The following example shows how to use the copy flash command on the Cisco 7500 series:

copy flash slot0:new-config
 

Related Commands

To copy a file from a MOP server to the router, use one of the following the copy mop EXEC commands:

Syntax Description

Default

None

Command Mode

EXEC

Usage Guidelines

The Cisco 7500 series does not support the copy mop command.

Use the copy mop bootflash command to copy a bootstrap image from a MOP server to the internal Flash memory on a Cisco 4500 series router. The router prompts for the name of the image file. It provides an option to erase the existing boot image in Flash before writing the new image into Flash. If no free space is available, or if files have never been written to Flash memory, you must erase Flash memory before copying the MOP image.

You do not need to specify the address of a MOP server. The router automatically solicits a MOP boot server for the specified file by sending a multicast file-request message.

The copying process takes several minutes; the actual time differs from network to network.

Caution If the checksum values do not match, do not reboot the router. Instead, reissue the copy mop bootflash command and compare the checksums again. If the checksum is repeatedly wrong, copy the original boot software image back into Flash memory before you reboot the router from Flash memory.

Use the copy mop flash command to copy a system image from a MOP server to internal Flash memory. MOP must be enabled on the relevant interfaces before you can use this command.

The router prompts for the MOP filename. It provides an option to erase existing Flash memory before writing onto it. The entire copying process takes several minutes and will differ from network to network.

Caution If the checksum value is not correct according to the value in the README file, do not reboot the router. Issue the copy mop flash command and compare the checksums again. If the checksum is repeatedly wrong, copy the original system software image back into Flash memory before you reboot the router from Flash memory. If you have a corrupted image in Flash memory and try to boot from Flash memory, the router will start the system image contained in ROM (assuming booting from a network server is not configured). If ROM does not contain a fully functional system image, the router might not function and will have to be reconfigured through a direct console port connection.

Examples

Router# copy mop flash


System flash directory:
File  Length   Name/status
  1   984      junk [deleted]
  2   984      junk
[2096 bytes used, 8386512 available, 8388608 total]
Source file name? junk

Destination file name [junk]?
 
Erase flash device before writing? [confirm]
Flash contains files. Are you sure you want to erase? [confirm]
 
Copy 'junk' from server
  as 'junk' into Flash WITH erase? [yes/no]yes

Erasing device... eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee ...erased
Loading junk from 1234.5678.9abc via Ethernet0: !
[OK - 984/8388608 bytes]
 
Verifying checksum...  OK (0x14B3)
Flash copy took 0:00:01 [hh:mm:ss]
 

Router# copy mop flash

System flash partition information:
Partition   Size     Used    Free    Bank-Size   State       Copy-Mode
    1       4096K    2048K   2048K   2048K       Read Only   RXBOOT-FLH
    2       4096K    2048K   2048K   2048K       Read/Write  Direct
 
[Type ?<no> for partition directory; ? for full directory; q to abort]
Which partition? [default = 2]
 

If the partition is read-only and has dual Flash bank support in boot ROMs, the session continues as follows:

                               ****  NOTICE  ****
Flash load helper v1.0
This process will accept the copy options and then terminate
the current system image to use the ROM based image for the copy.
Routing functionality will not be available during that time.
If you are logged in via telnet, this connection will terminate.
Users with console access can see the results of the copy operation.
                               ---- ******** ----
Proceed? [confirm]
System flash directory, partition 1:
File  Length   Name/status
  1   3459720  master/igs-bfpx.100-4.3
[3459784 bytes used, 734520 available, 4194304 total]
Source file name? master/igs-bfpx-100.4.3

Destination file name [default = source name]?
 

The file will be copied into the partition given by the user earlier:

Loading master/igs-bfpx.100-4.3 from 131.108.1.111: !
Erase flash device before writing? [confirm]
Flash contains files. Are you sure? [confirm]
Copy 'master/igs-bfpx.100-4.3' from MOP server
as 'master/igs-bfpx.100-4.3' into Flash WITH erase? [yes/no] yes

 

If the partition is read-write, the session continues as follows:

System flash directory, partition 2:
File  Length   Name/status
  1   3459720  master/igs-bfpx.100-4.3
[3459784 bytes used, 734520 available, 4194304 total]
Source file name? master/igs-bfpx.100-4.3

Destination file name [default = source name]? 
 

The file will be copied into the partition given by the user earlier:

Loading master/igs-bfpx.100-4.3 from 131.108.1.111: !
Erase flash device before writing? [confirm]
Flash contains files. Are you sure? [confirm]
Copy 'master/igs-bfpx.100-4.3' from MOP server
as 'master/igs-bfpx.100-4.3' into Flash WITH erase? [yes/no] yes

 

The following example shows how to use the copy mop bootflash command to copy the bootstrap image junk:

Router# copy mop bootflash


System flash directory:
File  Length   Name/status
  1   984      junk [deleted]
  2   984      junk
[2096 bytes used, 8386512 available, 8388608 total]
Source file name? junk

Destination file name [junk]?
 
Erase flash device before writing? [confirm]
Flash contains files. Are you sure you want to erase? [confirm]
 
Copy 'junk' from server
  as 'junk' into Flash WITH erase? [yes/no]yes

Erasing device... eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee ...erased
Loading junk from 1234.5678.9abc via Ethernet0: !
[OK - 984/8388608 bytes]
 
Verifying checksum...  OK (0x14B3)
Flash copy took 0:00:01 [hh:mm:ss]
 

Related Commands

Syntax Description

Default

On the Cisco 7500 series, if you omit the destination device, the router uses the default device specified by the cd command. If you omit the destination filename, the router uses the source filename.

Command Mode

EXEC

Usage Guidelines

The rcp protocol requires that a client send the remote username of an rcp request to the server. When you issue one of the copy rcp commands, by default the router software sends the username associated with the current TTY, if that name is valid. For example, if the user is connected to the router through Telnet and the user was authenticated through the username command, then the router software sends that username as the remote username.

If the TTY username is invalid, the router software uses the router host name as the both the remote and local usernames. To specify a different remote username to be sent to the rcp server, use the ip rcmd remote-username command. You can also specify the path of an existing directory along with the remote username.

Caution The remote username must be associated with an account on the destination server. If you do not use the ip rcmd remote-username command to specify the name of a remote user associated with an account on the server, then the remote username associated with the current TTY process must be associated with an account on the server. If there is no username for the current TTY process, then the router host name must be associated with an account on the server. If the network administrator of the destination server did not establish accounts for the remote username used, this command will not execute successfully when a default remote username is used.

If you copy a bootstrap image, system image, or configuration file from a personal computer used as a file server, the remote host computer must support rsh protocol.

Use the copy rcp bootflash command to copy a bootstrap image from a network server to Flash memory on a Cisco 4500 router using rcp. The router prompts for the name or address of the server and the name of the file to be copied. It provides an option to erase existing Flash memory before writing onto it, and allows you to confirm the erasure. The entire copying process takes several minutes and differs from network to network.

Before loading the router from Flash memory, verify that the checksum of the bootstrap image in Flash memory matches the checksum listed in the README file that was distributed with the system software image.

Caution If the checksum value does not match the value in the README file, do not reboot the router. Reissue the copy rcp bootflash command and compare the checksums again. If the checksum is repeatedly wrong, copy the original bootstrap image back into Flash memory before you reboot the router from Flash memory. If you have a corrupted image in Flash memory and try to boot from Flash, the router will start the system image contained in ROM (assuming booting from a network server is not configured).

Use the copy rcp flash to copy a system image from a network server to the router's internal Flash memory using rcp. The router prompts for the address of the rcp server and rcp filename. When you issue this command, the system provides an option to erase existing Flash memory before writing onto it. The entire copying process takes several minutes and differs from network to network.

Use the copy rcp startup-config command to copy a configuration file from a network server to the router's startup configuration environment using rcp.

On all platforms except the Cisco 7500 series, the copy rcp startup-config command copies a configuration file from the network server to NVRAM. On the Cisco 7500 series, the command copies a configuration file from the network server to the location specified by the CONFIG_FILE environment variable. The CONFIG_FILE environment variable specifies the configuration used during router initialization.

On the Cisco 7500 series, the copy rcp command generally copies a file from a network server to another destination using rcp. If you do not specify a source or destination device, the router uses the default device specified by the cd command.

On the Cisco 7500 series, when the destination is also specified by the CONFIG_FILE environment variable, the router prompts you for confirmation before proceeding with the copy. To view the contents of the CONFIG_FILE environment variable, use the show boot command. To modify the CONFIG_FILE environment variable, use the boot config command. To save your modifications, use the write memory or copy running-config startup-config command.

Examples

Router# configure terminal

Router(config)# ip rcmd remote-username netadmin1

^Z

Router# copy rcp bootflash 


Boot flash directory:
File  Length   Name/status
  1   2622607  c4500-xboot
[2622672 bytes used, 1571632 available, 4194304 total]
 
Address or name of remote host [255.255.255.255]? 223.255.254.254

Source file name? c4500-xboot.101

Destination file name [c4500-xboot.101]? 
Accessing file 'c4500-xboot.101' on 223.255.254.254... 
Loading c4500-xboot.101 from 223.255.254.254 (via Ethernet0): -[OK]
 
Erase flash device before writing? [confirm]
Flash contains files. Are you sure you want to erase? [confirm]
 
Copy 'c4500-xboot.101' from TFTP server into
     bootflash as 'c4500-xboot.101' WITH erase? [yes/no] yes

Erasing device... eeeeeeeeeeeeeeee ...erased
Loading c4500-xboot.101 from 223.255.254.254 (via Ethernet0): !!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
[OK - 2622607/4194304 bytes]
 
Verifying checksum...  OK (0xE408)
Flash copy took 0:00:10 [hh:mm:ss]

The exclamation points (!) indicate that the copy process is taking place. Each exclamation point (!) indicates that ten packets have been transferred successfully.

Router1# configure terminal

 
Router1(config)# rcmd remote-username netadmin1

^Z

Router# copy rcp flash 


System flash directory, partition 2:
File  Length   Name/status
  1   984      junk [deleted]
  2   984      junk
[2096 bytes used, 8386512 available, 8388608 total]
Address or name of remote host [255.255.255.255]? 131.108.101.101
Source file name? junk

Destination file name [junk]?
Accessing file 'junk' on 131.108.101.101...
Loading dirt/ssangiah/junk .from 131.108.101.101 (via Ethernet0): ! [OK]
 
Erase flash device before writing? [confirm]
Flash contains files. Are you sure you want to erase? [confirm]
 
Copy 'junk' from server
  as 'junk' into Flash WITH erase? [yes/no]yes

Erasing device... eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee ...erased
Loading junk from 223.255.254.254 (via Ethernet0): !
[OK - 984/8388608 bytes]
 
Verifying checksum...  OK (0x14B3)
Flash copy took 0:00:01 [hh:mm:ss]
 

Router# copy rcp flash

 
System flash partition information:
Partition   Size     Used    Free    Bank-Size   State       Copy-Mode
    1       4096K    2048K   2048K   2048K       Read Only   RXBOOT-FLH
    2       4096K    2048K   2048K   2048K       Read/Write  Direct
 
[Type ?<no> for partition directory; ? for full directory; q to abort]
Which partition? [default = 2]
 

If the partition is read-only and has dual Flash bank support in boot ROM, the session continues as follows:

                               ****  NOTICE  ****
Flash load helper v1.0
This process will accept the copy options and then terminate
the current system image to use the ROM based image for the copy.
Routing functionality will not be available during that time.
If you are logged in via telnet, this connection will terminate.
Users with console access can see the results of the copy operation.
                               ---- ******** ----
Proceed? [confirm]
System flash directory, partition 1:
File  Length   Name/status
  1   3459720  master/igs-bfpx.100-4.3
[3459784 bytes used, 734520 available, 4194304 total]
Address or name of remote host [255.255.255.255]? 131.108.1.1

Source file name? master/igs-bfpx-100.4.3

Destination file name [default = source name]?
 

The file will be copied into the partition given by the user earlier:

Loading master/igs-bfpx.100-4.3 from 131.108.1.111: !
Erase flash device before writing? [confirm]
Flash contains files. Are you sure? [confirm]
Copy 'master/igs-bfpx.100-4.3' from TFTP server
as 'master/igs-bfpx.100-4.3' into Flash WITH erase? [yes/no] yes

 

If the partition is read-write, the session continues as follows:

System flash directory, partition 2:
File  Length   Name/status
  1   3459720  master/igs-bfpx.100-4.3
[3459784 bytes used, 734520 available, 4194304 total]
Address or name of remote host [255.255.255.255]? 131.108.1.1

Source file name? master/igs-bfpx.100-4.3
Destination file name [default = source name]?
 

The file will be copied into the partition given by the user earlier:

Accessing file 'master/igs-bfpx.100-4.3' on ABC.CISCO.COM...
Loading master/igs-bfpx.100-4.3 from 131.108.1.111: !
Erase flash device before writing? [confirm]
Flash contains files. Are you sure? [confirm]
Copy 'master/igs-bfpx.100-4.3' from TFTP server
as 'master/igs-bfpx.100-4.3' into Flash WITH erase? [yes/no] yes

 

Router# configure terminal

Router(config)# ip rcmd remote-username netadmin1

^Z

Router# copy rcp running-config 


Host or network configuration file [host]?
Address of remote host [255.255.255.255]? 131.108.101.101

Name of configuration file [Router-confg]? host1-confg

Configure using host1-confg from 131.108.101.101? [confirm]
Connected to 131.108.101.101
Loading 1112 byte file host1-confg:![OK]
Router#
%SYS-5-CONFIG: Configured from host1-config by rcp from 131.108.101.101
 

Router# configure terminal

Router(config)# ip rcmd remote-username netadmin1

^Z

Router# copy rcp startup-config 


Address of remote host [255.255.255.255]? 131.108.101.101

Name of configuration file[rtr2-confg]? host2-confg

Configure using rtr2-confg from 131.108.101.101?[confirm]
Connected to 131.108.101.101
Loading 1112 byte file rtr2-confg:![OK]
[OK]
Router#
%SYS-5-CONFIG_NV:Non-volatile store configured from rtr2-config by 

rcp from 131.108.101.101
 

The following example uses the copy rcp file_id command to copy the router-image file from a network server using rcp to the Flash memory card inserted in slot 0 of the RSP card:

copy rcp slot0:router-image

Related Commands

Syntax Description

Default

On the Cisco 7500 series, if you omit the destination device, the router uses the default device specified by the cd command. If you omit the destination filename, the router uses the source filename.

Command Mode

EXEC

Usa