Table Of Contents
System Image and Configuration File Load Commands
async-bootp
b
boot bootstrap
boot buffersize
boot host
boot network
boot system
configure
configure overwrite
config-register
continue
copy flash
copy mop flash
copy rcp
copy running-config
copy startup-config
copy tftp
copy verify
erase
erase flash
ip rarp-server
ip rcmd domain-lookup
ip rcmd rcp-enable
ip rcmd remote-host
ip rcmd remote-username
ip rcmd rsh-enable
mop device-code
mop retransmit-timer
mop retries
o
partition flash
reload
rsh
service compress-config
service config
show async bootp
show configuration
show flash
show flh-log
show running-config
show startup-config
show version
tftp-server
verify flash
write erase
write memory
write network
write terminal
System Image and Configuration File Load Commands
This chapter provides detailed descriptions of the commands used to load and copy system images and configuration files. System images contain the system software. Configuration files contain commands entered to customize the functions of the access server.
For access server configuration information and examples, refer to the "Loading System Images and Configuration Files" chapter in the Access and Communication Servers Configuration Guide.
Note
Commands in this chapter that have been replaced by new commands continue to perform their normal functions in the current release but are not longer documented. Support for these commands will cease in a future release.
Table 3-1 Mapping Old Commands to New Commands
Old Command
|
New Command
|
configure network
|
copy rcp running-config (for an rcp server)
copy tftp running-config (for a TFTP server)
|
configure overwrite-network
|
copy rcp startup-config (for an rcp server)
copy tftp startup-config (for a TFTP server)
|
copy erase flash
|
erase flash
|
copy verify or copy verify flash
|
verify flash
|
copy verify bootflash
|
verify bootflash
|
show configuration
|
show startup-config
|
tftp-server system
|
tftp-server
|
write erase
|
erase startup-config
|
write memory
|
copy running-config startup-config
|
write network
|
copy running-config rcp (for an rcp server)
copy running-config tftp (for a TFTP server)
|
write terminal
|
show running-config
|
For access server configuration information and examples, refer to the "Loading System Images, Microcode Images, and Configuration Files" chapter in the Access and Communication Servers Configuration Guide.
async-bootp
Use the async-bootp command to enable support for extended BOOTP requests as defined in RFC 1084 when the access server is configured for SLIP. Use the no form of this command to restore the default.
async-bootp tag [:hostname] data
no async-bootp
Syntax Description
tag
|
Item being requested; expressed as filename, integer, or IP dotted-decimal address. See for possible values.
|
:hostname
|
(Optional) This entry applies only to the host specified. The argument :hostname accepts both an IP address and a logical host name.
|
data
|
List of IP addresses entered in dotted-decimal notation or as logical host names, a number, or a quoted string.
|
Table 3-2 Async-BOOTP Tag Keywords
Keyword
|
Description
|
bootfile
|
Specifies use of a server boot file from which to download the boot program. Use the optional :hostname and data arguments to specify the filename.
|
subnet-mask mask
|
Dotted-decimal address specifying the network and local subnetwork mask (as defined by RFC 950).
|
time-offset offset
|
Signed 32-bit integer specifying the time offset of the local subnetwork in seconds from Universal Coordinated Time (UTC).
|
gateway address
|
Dotted-decimal address specifying the IP addresses of gateways for this subnetwork. A preferred gateway should be listed first.
|
time-server address
|
Dotted-decimal address specifying the IP address of time servers (as defined by RFC 868).
|
ien116-server address
|
Dotted-decimal address specifying the IP address of name servers (as defined by IEN 116).
|
dns-server address
|
Dotted-decimal address specifying the IP address of the Domain Name Server (DNS) (as defined by RFC 1034).
|
log-server address
|
Dotted-decimal address specifying the IP address of an MIT-LCS UDP log server.
|
quote-server address
|
Dotted-decimal address specifying the IP address of Quote of the Day servers (as defined in RFC 865).
|
lpr-server address
|
Dotted-decimal address specifying the IP address of Berkeley UNIX Version 4 BSD servers.
|
impress-server address
|
Dotted-decimal address specifying the IP address of Impress network image servers.
|
rlp-server address
|
Dotted-decimal address specifying the IP address of Resource Location Protocol (RLP) servers (as defined in RFC 887).
|
hostname name
|
The name of the client, which might or might not be domain qualified, depending upon the site.
|
bootfile-size value
|
A two-octet value specifying the number of 512-octet (byte) blocks in the default boot file.
|
Default
If no extended BOOTP commands are entered, the access server 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 172.30.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 :172.30.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 172.30.1.4
Related Command
show async bootp
b
To boot the access server manually, use the b ROM monitor command.
b
b filename [ip-address]
b flash [filename]
b flash [device:][partition-number:][filename]
Syntax Description
filename
|
Name of the system image from which you want to netboot. The filename is case sensitive.
|
ip-address
|
(Optional) IP address of the network server on which the system image resides. If omitted, this value defaults to the IP broadcast address of 255.255.255.255.
|
flash filename
|
(Optional) Boots the access server from Flash memory with the optional filename of the image you want loaded. The filename is case sensitive. Without a filename, the first valid file in Flash memory will be loaded.
|
device:
|
(Optional) Valid value is flash. The colon (:) is required.
|
partition-number:
|
(Optional) Boots the access server from Flash memory with the optional filename of the image you want loaded from the specified Flash partition. If you do not specify a filename, the first valid file in the specified partition of Flash memory is loaded.
|
filename
|
(Optional) Boots the access server from Flash memory with the filename of the image you want loaded from the specified Flash partition, if a partition is specified. If a partition is not specified, the system boots with the filename from the first partition. The filename is case sensitive. If you do not specify a filename, the first valid file in the specified partition of Flash memory is loaded.
|
Default
If you enter the b command and press Return, the access server boots from ROM by default.
If you enter the b flash command without specifying a filename, the first valid file in Flash memory is loaded.
For other defaults, see the preceding Syntax Description section.
Command Mode
ROM monitor
Usage Guidelines
Use this command only when your access server cannot find the configuration information needed in nonvolatile memory. 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 for manual booting, change the boot bits in the configuration register to zero and then issue the reload command.
Examples
In the following example, the access server is manually booted from ROM:
In the following example, the file cstest is netbooted from IP address 172.30.15.112:
The following example shows the b flash command without the filename argument.The first valid file in Flash memory is loaded.
F3: 1858656+45204+166896 at 0x1000
Booting igs-k from flash memory RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR [OK - 1903912/13765276 bytes]
F3: 1858676+45204+166896 at 0x1000
In the following example, the b flash command is used with the filename igs-k. This is the file that will be loaded.
F3: 1858656+45204+166896 at 0x1000
Booting igs-k from flash memory RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
RRRRRRRRRRRRRR [OK - 1903912/13765276 bytes]
F3: 1858676+45204+166896 at 0x1000
In the following example, the b flash flash command boots the relocatable image file igs-bpx-l from partition 2 in Flash memory.
> b flash flash:2:igs-bpx-l
F3: 3562264+98228+303632 at 0x30000B4
boot bootstrap
To configure the filename that is used to boot a secondary bootstrap image, use the boot bootstrap global configuration command. Use the no form of the command to disable booting from a secondary bootstrap image.
boot bootstrap flash [filename]
no boot bootstrap flash [filename]
boot bootstrap mop filename [mac-address] [interface]
no boot bootstrap mop filename [mac-address] [interface]
boot bootstrap [tftp] filename [ip-address]
no boot bootstrap [tftp] filename [ip-address]
Syntax Description
flash
|
Indicates that the access server will be booted from Flash memory.
|
mop
|
Indicates that the access server will be netbooted from a system image stored on a Digital MOP server.
|
tftp
|
(Optional) Indicates that the access server will be netbooted from a system image stored on a TFTP server.
|
filename
|
(Optional with flash) Name of the system image from which you want to netboot. If you omit the filename when booting from Flash, the access server uses the first system image stored in Flash memory.
|
ip-address
|
(Optional) IP address of the TFTP server on which the system image resides. If omitted, this value defaults to the IP broadcast address of 255.255.255.255.
|
mac-address
|
(Optional) MAC address of the MOP server on which the file resides. If the MAC address argument is not included, a broadcast message is sent to all MOP boot servers. The first MOP server to indicate that it has the file will be the server from which the access server gets the boot image.
|
interface
|
(Optional) Interface out which the access server should send MOP requests to reach the MOP server. The interface options are async, dialer, Ethernet, loopback, null, serial, and tunnel. If the interface argument is not specified, a request will be sent on all interfaces that have MOP enabled, and the interface from which the first response is received will be used to load the software.
|
Default
No secondary bootstrap
Command Mode
Global configuration
Usage Guidelines
The boot bootstrap command, in conjunction with setting bit 9 on the configuration register of a access server, causes the access server to load a secondary bootstrap image over the network. The secondary bootstrap image then loads the specified system image file. The name of the secondary bootstrap file is boot-csc3 or boot-csc4, depending on the access server model. See the appropriate hardware installation guide for details on the configuration register and secondary bootstrap filename.
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
boot buffersize
To modify the buffer size used to load configuration files, use the boot buffersize global configuration command. Use the no form of the command to return to the default setting.
boot buffersize bytes
no boot buffersize
Syntax Description
bytes
|
Specifies the size of the buffer to be used. There is no minimum or maximum size that can be specified.
|
Default
Buffer size of the nonvolatile memory
Command Mode
Global configuration
Usage Guidelines
Normally, the access server uses a buffer the size of the system nonvolatile memory to hold configuration commands read from the network. You can increase this size if you have a very complex configuration. There is no minimum or maximum size that can be specified.
Example
The following example sets the buffer size to 64000:
boot host
To change the default name of the host configuration filename from which you want to load configuration commands, use the boot host global configuration command. Use the no form of the command to restore the host configuration filename to the default.
boot host mop filename [mac-address] [interface]
no boot host mop filename [mac-address] [interface]
boot host [tftp | rcp] filename [ip-address]
no boot host [tftp | rcp] filename [ip-address]
Syntax Description
mop
|
Indicates that the access server will be configured from a configuration file stored on a Digital MOP server.
|
tftp
|
(Optional) Indicates that the access server will be configured from a configuration file stored on a TFTP server.
|
rcp
|
(Optional) Indicates that the access server will be configured from a configuration file stored on an rcp server.
|
filename
|
Name of the file from which you want to load configuration commands.
|
ip-address
|
(Optional) IP address of the TFTP server on which the file resides. If omitted, this value defaults to the IP broadcast address of 255.255.255.255.
|
mac-address
|
(Optional) MAC address of the MOP server on which the file resides. If the MAC address argument is not included, a broadcast message is sent to all MOP boot servers. The first MOP server to indicate that it has the file will be the server from which the access server gets the boot image.
|
interface
|
(Optional) Interface out which the access server should send MOP requests to reach the MOP server. The interface options are async, dialer, ethernet, serial, and tunnel. If the interface argument is not specified, a request will be sent on all interfaces that have MOP enabled, and the interface from which the first response is received will be used to load the software.
|
Default
The access server uses its host name to form a host configuration filename. To form this name, the access server converts its name to all lowercase letters, removes all domain information, and appends -confg.
Command Mode
Global configuration
Usage Guidelines
Use the service config command to enable the loading of the specified configuration file at reboot time. Without this command, the access server ignores the boot host command and uses the configuration information in nonvolatile memory. If the configuration information in nonvolatile memory is invalid or missing, the service config command is enabled automatically.
The network server will attempt to load two configuration files from remote hosts. The first is the network configuration file containing commands that apply to all network servers on a network. The second is the host configuration file containing commands that apply to one network server in particular.
Example
The following example sets the host filename to wilma-confg at address 172.30.7.19:
boot host /usr/local/tftpdir/wilma-confg 172.30.7.19
Related Commands
boot network
service config
boot network
To change the default name of the network configuration file from which you want to load configuration commands, use the boot network global configuration command. Use the no form of this command to restore the network configuration filename to the default.
boot network mop filename [mac-address] [interface]
no boot network mop filename [mac-address] [interface]
boot network [tftp | rcp] filename [ip-address]
no boot network [tftp | rcp] filename [ip-address]
Syntax Description
mop
|
Configures the access server to download the configuration file from a network server using the Digital MOP protocol.
|
filename
|
Name of the file from which you want to load configuration commands. The default filename is network-config.
|
mac-address
|
(Optional) If MOP is specified, the MAC address of the network server on which the file resides. If the MAC address argument is not included, a broadcast message is sent to all MOP boot servers. The first server to indicate that it has the file will be the server from which the access server gets the boot image.
|
interface
|
(Optional) If MOP is specified, the interface out which the access server should send MOP requests to reach the server. The interface options are async, dialer, ethernet, serial, and tunnel. If the interface argument is not specified, a request will be sent on all interfaces that have MOP enabled, and the interface from which the first response is received will be used to load the software.
|
rcp
|
(Optional) Configures the access server to download the configuration file from a network server using rcp. If omitted, defaults to tftp.
|
tftp
|
(Optional) Configures the access server to download the configuration file from a network server using tftp. If omitted and rcp is not specified, defaults to tftp.
|
ip-address
|
(Optional) If rcp or tftp is specified, the IP address of the network server on which the compressed image file resides. If omitted, this value defaults to the IP broadcast address of 255.255.255.255.
|
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
When booting from a network server, access servers ignore routing information and static IP routes information. As a result, intermediate access servers are responsible for handling rcp or tftp requests correctly. Before booting from a network server, verify that a server is available by using the ping command.
Use the service config command to enable the loading of the specified configuration file at reboot time. Without this command, the access server ignores the boot network command and uses the configuration information in nonvolatile memory. If the configuration information in nonvolatile memory is invalid or missing, the service config command is enabled automatically.
The network server attempts to load two configuration files from remote hosts. The first is the network configuration file containing commands that apply to all network servers on a network. Use the boot network command to identify the network configuration file.
The rcp protocol 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 access server software sends the host name as the both the remote and local usernames. The rcp protocol implementation searches for the configuration files to be used relative to the account directory of the remote username on the network server.
If you copy the system image to a PC used as a file server, the remote host computer must support the remote shell (rsh) protocol.
Caution 
For rcp, if you do not explicitly specify a remote username by issuing the ip rcmd remote-username command and the access server host name is used, an account for the access server host name must be defined on the destination server. If the network administrator of the destination server did not establish an account for the access server host name, this command will not execute successfully.
If you copy the system image to a personal computer used as a file server, the remote host computer must support the remote shell protocol.
Examples
The following example changes the network configuration filename to bridge_9.1 and uses the default broadcast address:
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 172.30.1.111 as the IP address of the server on which the network configuration file resides.
boot network RCP bridge_9.1 172.30.1.111
Related Commands
boot host
ip rcmd remote-username
service config
boot system
To change the filename of the system image that is loaded onto the access server when it reboots, use the boot system global configuration command. Use the no boot system command to remove the name.
boot system flash [device:][partition-number:][filename]
no boot system flash [filename]
boot system mop filename [mac-address] [interface]
no boot system mop filename [mac-address] [interface]
boot system rom
no boot system rom
boot system [tftp | rcp] filename [ip-address]
no boot system [tftp | rcp] filename [ip-address]
boot system flash [device:][partition-number:][filename]
no boot system
Syntax Description
flash
|
Indicates that the access server will be booted from Flash memory.
|
mop
|
Indicates that the access server will be netbooted from a system image stored on a Digital MOP server.
|
rom
|
Indicates that the access server will be booted from ROM.
|
rcp
|
(Optional) Indicates that the access server will be netbooted from a system image acquired from a network server using rcp. If omitted, the system defaults to tftp.
|
tftp
|
(Optional) Indicates that the access server will be booted from a system image stored on a network server using tftp. If omitted and rcp is not specified, the system defaults to tftp.
|
filename
|
(Optional with flash) Name of the system image file from which you want to netboot. It is case sensitive.
|
ip-address
|
(Optional) IP address of the network server on which the image file resides. If omitted, this value defaults to the IP broadcast address of 255.255.255.255.
|
mac-address
|
(Optional) If MOP is used, the MAC address of the server on which the file resides. If the MAC address argument is not included, a broadcast message is sent to all MOP boot servers. The first server to indicate that it has the file will be the server from which the access server gets the boot image.
|
interface
|
(Optional) Interface out which the access server should send MOP requests to reach the MOP server. The interface options are async, dialer, ethernet, serial, and tunnel. If the interface argument is not specified, a request will be sent on all interfaces that have MOP enabled, and the interface from which the first response is received will be used to load the software.
|
device:
|
(Optional) Valid value is flash.
|
partition-number:
|
(Optional) Boots the access server from Flash memory with the optional filename of the image you want loaded from the specified Flash partition. If you do not specify a filename, the first valid file in the specified partition of Flash memory is loaded.
|
filename
|
(Optional) Boots the access server from Flash memory with the filename of the image you want loaded from the specified Flash partition. The filename is case sensitive. If you do not specify a filename, the first valid file in the specified partition of Flash memory will be loaded.
|
Default
If you do not specify a system image file with the boot system command, the access server uses the configuration register settings to determine the default system image filename for netbooting. The access server forms the default boot filename by starting with the word cisco and then appending the octal equivalent of the boot field number in the configuration register, followed by a hyphen, and the processor-type name (cisconn-cpu). See the appropriate hardware installation guide for details on the configuration register and default filename. See also the command config-register. See also the Syntax Description section preceding this section.
If neither tftp or rcp is specified, the default transfer protocol type is tftp.
Command Mode
Global configuration
Usage Guidelines
In order for this command to work, the config-register command must be set properly.
Enter several boot system commands to provide a fail-safe method for booting your access server. Use the boot system rom command to specify use of the ROM system image as a backup to other boot commands in the configuration. The boot system commands are stored and executed on the order in which they are entered. If you enter multiple boot commands of the same type—for example, if you enter two commands that instruct the access server to boot from different network servers—then the access server tries them in the order they are entered.
Each time you write a new software image to Flash memory, you must delete the existing filename in the configuration file with the no boot system flash filename command. Then add a new line in the configuration file with the boot system flash filename command.
Note
The no boot system global configuration command disables all boot system configuration commands regardless of argument and keyword. Specifying the flash keyword or the filename argument with the no boot system command disables only the command specified by these arguments.
You can netboot from a compressed image. When a server netboots software, the image being booted and the running image must both fit into memory. Use compressed images to ensure that there is enough available memory to boot the access server. You can produce a compressed software image on any UNIX platform using the compress command. Refer to your UNIX platform's documentation for the exact usage of the compress command. (You can also uncompress data with the UNIX uncompress command.)
The rcp protocol requires that a client send the remote username on an rcp request to a server. When the boot system rcp command is executed, by default the access server software sends the host name as the both the remote and local usernames. The rcp software searches for the system image to be booted from the remote server relative to the directory of the remote username, if the server has a directory structure, for example, as do UNIX systems.
Examples
The following example shows a list specifying two possible internetwork locations for a system image, with the ROM software being used as a backup. When the system image is booted from either of the internetwork locations, TFTP is used as the transport mechanism:
boot system cs3-rx.90-1 172.30.7.24
boot system cs3-rx.83-2 172.30.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
Related Commands
config-register
copy flash
copy rcp
copy tftp
ip rcmd remote-username
configure
To enter global configuration mode, use the configure privileged EXEC command.
configure {terminal | memory | network}
Syntax Description
terminal
|
Executes configuration commands from the terminal.
|
memory
|
Executes the configuration commands stored in nonvolatile memory.
|
network
|
The copy [rcp| tftp] running-config command replaces the configure network command. Use the appropriate keyword (tftp or rcp) for your application. Refer to the copy rcp or copy tftp command for more information.
|
Default
None
Command Mode
Privileged EXEC
Usage Guidelines
If you do not specify terminal or memory the access server prompts you for the source of configuration commands. After you enter the configure command, the system prompt changes from Router-name# to Router-name(config)#, indicating that you are in global configuration mode. To leave global configuration mode and return to the privileged EXEC prompt, press Ctrl-Z. If you specify memory, the access server executes the commands located in NVRAM.
Example
In the following example, the access server is configured from the terminal:
Configuring from terminal, memory, or network [terminal]?
Enter configuration commands, one per line. End with CNTL/Z.
Related Commands
configure overwrite
copy running-config
show configuration
show running-config
configure overwrite
The copy rcp startup-config or copy tftp startup-config command replaces the configure overwrite command. If you use rcp, see the copy rcp command for more information. If you use TFTP, see the copy tftp command for more information.
config-register
To change the access server configuration register settings, use the config-register global configuration command.
config-register value
Syntax Description
value
|
Hexadecimal or decimal value that represents the 16-bit configuration register value you want to use the next time the access server is restarted. The value range is from 0x0 to 0xFFFF (0 to 65535 in decimal).
|
Default
For the access server models without Flash memory, the default is 0x101, which causes the access server to boot from ROM and the Break key to be ignored. For access server models with Flash memory, the default is 0x10F, which causes the access server to boot from Flash memory and the Break key to be ignored.
Command Mode
Global configuration
Usage Guidelines
The lowest four bits of the configuration register (bits 3, 2, 1, and 0) form the boot field. The boot field determines if the access server boots manually, from ROM, or from Flash or the network. Bit 8 controls the console Break key; when set to 1, it causes the Break key to be ignored. The remaining bits control other features of the access server and are typically set to 0.
To change the boot field value and leave all other bits set to their default values, follow these guidelines:
•
If you set the configuration register value to 0x100, you must boot the operating system manually with the b command.
•
If you set the configuration register value to 0x101, the access server boots using the default ROM software.
•
If you set the configuration register to any value from 0x102 to 0x10F, the access server 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 access server hardware installation guide.
Example
In the following example, the configuration register is set to boot the system image from Flash memory:
Related Commands
boot system
o
show version
continue
To return to the EXEC mode from ROM monitor mode, use the continue ROM monitor command.
continue
Syntax Description
This command has no arguments or keywords.
Command Mode
ROM monitor
Usage Guidelines
Use this command when you are in ROM monitor mode, and you want to return to EXEC mode to use the system image instead of reloading. The angle bracket (>) indicates that you are in ROM monitor mode. You are in ROM monitor mode when you manually load a system image or perform diagnostic tests. Otherwise, you will most likely never be in this mode.
Caution 
While in ROM monitor mode, the Cisco IOS system software is suspended until you issue either a reset or the continue command.
Example
In the following example, the continue command takes you from ROM monitor to EXEC mode:
copy flash
To copy a file from Flash memory to another destination, use one of the following copy flash EXEC commands:
copy flash {rcp | tftp}
Syntax Description
rcp
|
Specifies a copy operation to a network server using rcp.
|
tftp
|
Specifies a TFTP server as the destination of the copy operation.
|
Command Mode
EXEC
Usage Guidelines
To copy a system image from Flash memory to a network server that is using rcp, use the copy flash rcp EXEC command. To copy a system image from Flash memory to a network server that is using TFTP, use the copy flash tftp command.
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 in the original file on disk.
The rcp protocol 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 access server software sends the remote username associated with the current TTY process, if that name is valid. For example, if the user is connected to the access server through Telnet and the user was authenticated through the username command, then the Cisco IOS software sends that username as the remote username.
If the TTY username is invalid, the Cisco IOS software uses the access server host name as the both the remote and local usernames.
Note
For Cisco, TTYs are commonly used in communications servers. The concept of TTYs originated with UNIX. For UNIX systems, each physical device is represented in the file system. Terminals are called TTY devices (which stands for teletype, the original UNIX terminal).
To specify that a different remote username be sent to the server, use the ip rcmd remote-username command. rcp copies the system image to the remote server relative to the directory of the remote username, if that server has a directory structure (for example, UNIX systems).
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 access server 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 that is used, and if a default remote username is used, this command will not execute successfully.
If you copy the system image to a PC used as a file server, the PC must support the remote shell (rsh) protocol.
Examples
The following example illustrates how to use this command with the tftp keyword:
IP address of remote host [255.255.255.255]? 172.30.13.110
Name of file to copy? igs-k
writing gsxx !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!copy complete
The following example illustrates how to use this command when copying from a particular partition of Flash memory:
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 can enter a partition number, ? for directory display of all partitions, or ?number for directory display of a particular partition. The default is the first partition.
System flash directory, partition 2:
1 3459720 master/igs-bfpx.100-4.3
[3459784 bytes used, 734520 available, 4194304 total]
Address or name of remote host [ABC.CISCO.COM]?
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 copy a system image from Flash memory to a network server using rcp:
Router# configure terminal
Router#config ip rcmd remote-username netadmin1
System flash directory, partition 2:
[1048 bytes used, 8387560 available, 8388608 total]
Address or name of remote host [223.255.254.254]?
Destination file name [junk]? junk
Verifying checksum for 'junk' (file # 1)... OK
Copy 'junk' from Flash to server
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
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.
The following example illustrates how to use this command with rcp:
IP address of remote host [255.255.255.255]? 172.30.13.110
Name of file to copy? gsxx
writing gsxx !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!copy complete
The following example illustrates how to use this command when copying from a particular partition of Flash memory:
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 you 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, ? for directory display of all partitions, or ?number for directory display of a particular partition. The default is the first partition.
System flash directory, partition 2:
1 3459720 master/igs-bfpx.100-4.3
[3459784 bytes used, 734520 available, 4194304 total]
Address or name of remote host [ABC.CISCO.COM]?
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
Related Commands
boot system
copy tftp
copy rcp
ip rcmd remote-username
copy mop flash
To copy a system image using MOP into Flash memory, use the copy mop flash EXEC command.
copy mop flash
Syntax Description
This command has no arguments or keywords.
Command Mode
EXEC
Usage Guidelines
The access server 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.
Before booting from Flash memory, verify that the checksum of the image in Flash memory matches the checksum listed in the README file that was distributed with the system software image. The checksum of the image in Flash memory is displayed at the bottom of the screen when you issue the copy mop flash command.
Caution 
If the checksum value is not correct according to the value in the README file, do not reboot the access server. 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 access server from Flash memory. If you have a bad image in Flash memory and try to boot from Flash, and netbooting is not configured, the access server will start the system image contained in ROM. If ROM does not contain a fully functional system image, the access server might not function and will have to be reconfigured through a direct console port connection.
Examples
The following example shows sample output of when copying a system image into a partition of Flash memory:
[2096 bytes used, 8386512 available, 8388608 total]
Destination file name [junk]?
Erase flash device before writing? [confirm]
Flash contains files. Are you sure you want to erase? [confirm]
as 'junk' into Flash WITH erase? [yes/no]yes
Erasing device... eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee ...erased
Loading junk from 1234.5678.9abc via Ethernet0: !
Verifying checksum... OK (0x14B3)
Flash copy took 0:00:01 [hh:mm:ss]
The following example shows sample output of copying a system image into a partition of Flash memory. The system will prompt only if there are two or more read/write partitions or one read-only and one read/write partition and dual Flash bank support in boot ROMs. If the partition entered is not valid, the process terminates. You can enter a partition number, ? for directory display of all partitions, or ?number for directory display of a particular partition. The default is the first read/write partition.
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:
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.
System flash directory, partition 1:
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 172.30.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:
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 172.30.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
Related Commands
boot system
copy verify
copy rcp
To copy a system image from a network server into Flash memory using rcp, use the copy rcp EXEC commands. The copy rcp running-config command replaces the configure network command. The copy rcp startup-config command replaces the configure overwrite-network command.
copy rcp {flash | running-config | startup-config}
Syntax Description
flash
|
Specifies internal Flash memory as the destination of the copy operation.
|
running-config
|
Specifies the currently running configuration as the destination of the copy operation.
|
startup-config
|
Specifies the configuration used for initialization as the destination of the copy operation.
|
Command Mode
EXEC
Usage Guidelines
The access server prompts you for the address of the rcp server and rcp 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.
Before booting from Flash memory, verify that the checksum of the image in Flash memory matches the checksum listed in the README file that was distributed with the system software image. The checksum of the image in Flash memory is displayed at the bottom of the screen when you issue the copy rcp flash command. The README file was copied to the server automatically when you installed the system software image.
Caution 
If the checksum value is not correct according to the value in the README file, do not reboot the access server. Issue the copy rcp 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 access server from Flash memory. If you have a bad image in Flash memory and try to boot from Flash, and netbooting is not configured, the access server will start the system image contained in ROM. If ROM does not contain a fully functional system image, the access server will not function and will have to be reconfigured through a direct console port connection.
The rcp protocol requires that a client send the remote username of an rcp request to the server. When you issue the copy rcp flash command, by default the software sends the username associated with the current TTY, if that name is valid. For example, if the user is connected to the access server through Telnet and the user was authenticated through the username command, then the Cisco IOS software sends that username as the remote username.
Note
For Cisco, TTYs are commonly used in communications servers. The concept of TTYs originated with UNIX. For UNIX systems, each physical device is represented in the file system. Terminals are called TTY devices (which stands for teletype, the original UNIX terminal).
If the TTY remote username is invalid, the Cisco IOS software uses the access server host name as the both the remote and local usernames. To specify that a different remote username be sent to the network server, use the ip rcmd remote-username command. The rcp protocol copies the system image from the remote server relative to the directory of the remote username, if the server has a directory structure (for example, UNIX systems).
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 access server 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, and if a default remote username is used, this command will not execute successfully.
If you copy the system image from a PC used as a file server, the remote host computer must support the remote shell protocol.
Use the copy rcp flash to copy a system image from a network server to the access server's internal Flash memory using rcp. The access server 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 will differ from network to network.
Before booting from Flash memory, verify that the checksum of the image in internal Flash memory matches the checksum listed in the README file that was distributed with the system software image. The checksum of the image in Flash memory is displayed at the bottom of the screen when you issue the copy tftp flash command. The README file was copied to the rcp server automatically when you installed the system software image.
Caution 
If the checksum value does not match the value in the README file, do not reboot the access server. Reissue the copy rcp 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 access server from Flash memory. If you have a bad image in Flash memory and try to boot from Flash, and booting from a network server is not configured, the access server will start the system image contained in ROM. If ROM does not contain a fully functional system image, the access server will not function and will have to be reconfigured through a direct console port connection.
Use the copy rcp running-config command to copy a configuration file from a network server to the access server's running configuration environment using rcp. You can copy either a host configuration file or a network configuration file. Accept the default value of host to copy and load a host configuration file containing commands that apply to one network server. Enter network to copy and load a network configuration file containing commands that apply to all network servers on a network.
Note
When using rcp, the copy rcp running-config command replaces the configure network command.
Use the copy rcp startup-config c