System Image and Microcode Commands

This chapter describes the function and syntax of the commands used to load and copy system images and microcode images. For more information about these commands, refer to the corresponding chapter of the Cisco IOS Configuration Fundamentals Command Reference .

Flash Memory File System Types

Cisco platforms generally use one of three different Flash memory file system types. Some commands in this chapter are supported on only one or two file system types.

Use Table 9 to determine which Flash memory file system type your platform uses.

Table 9 Flash Memory File System Types

Type	Platforms
Class A	Cisco 7000 family, Cisco 12000 series routers, LightStream1010 (LS1010) switches
Class B	Cisco 1003, Cisco 1004, Cisco 1005, Cisco 2500 series, Cisco 3600 series, and Cisco 4000 series routers, and Cisco AS5200 access servers
Class C	Cisco MC3810 multiservice concentrators, disk0 of Cisco SC3640 system controllers

Replaced Commands

Some commands found in this chapter in previous releases of this book have been replaced. Older commands generally continue to provide the same functionality in the current release, but are no longer documented. Support for the older version of these commands may already be removed on your system, or may be removed in a future Cisco IOS software release.

Table 10 Replaced Commands

Old Command	New Command
copy erase flash	erase flash: (Class B Flash file systems only) format (Class A and C Flash file systems only)
copy verify	verify
copy verify bootflash	verify bootflash:
copy verify flash	verify flash:
copy xmodem	xmodem
copy ymodem	xmodem -y
show flh-log	more flh: logfile
verify bootflash	verify bootflash:
verify flash	verify flash:

For a description of the copy and verify commands, see the "Cisco IOS File System Commands" chapter.

copy erase flash

The copy erase flash command has been replaced by the erase flash:command. See the description of the erase command in the "Cisco IOS File System Commands" chapter for more information.

copy verify

The copy verify command has been replaced by the verify command. See the description of the verify command in the "Cisco IOS File System Commands" chapter for more information.

copy verify bootflash

The copy verify bootflash command has been replaced by the verify bootflash: command. See the description of the verify command in the "Cisco IOS File System Commands" chapter for more information.

copy verify flash

The copy verify flash command has been replaced by the verify flash: command. See the description of the verify command in the "Cisco IOS File System Commands" chapter for more information.

copy xmodem:

To copy a Cisco IOS image from a local or remote computer (such as a PC, Macintosh, or UNIX workstation) to Flash memory on a Cisco 3600 series router using the Xmodem protocol, use the copy xmodem: EXEC command.

copy ymodem:

To copy a Cisco IOS image from a local or remote computer (such as a PC, Macintosh, or UNIX workstation) to Flash memory on a Cisco 3600 series router using the Ymodem protocol, use the copy ymodem: EXEC command.

erase flash:

The erase flash: and erase flash commands are identical. See the description of the erase command in the "Cisco IOS File System Commands" chapter for more information.

microcode (7000/7500)

To specify the location of the microcode that you want to download from Flash memory into the writable control store (WCS) on Cisco 7000 series (including RSP based routers) or Cisco 7500 series routers, use the microcode global configuration command. To load the microcode bundled with the system image, use the no form of this command.

interface-type

One of the following interface processor names: aip, cip, eip, feip, fip, fsip, hip, mip, sip, sp, ssp, trip, vip, or vip2.

flash-filesystem:

Flash file system, followed by a colon. Valid file systems are bootflash, slot0, and slot1.

Slave devices such as slaveslot0 are invalid. The slave's file system is not available during microcode reloads.

filename

Name of the microcode file.

slot

(Optional) Number of the slot. Range is from 0 to 15.

rom

If ROM is specified, the router loads from the onboard ROM microcode.

system

If the system keyword is specified, the router loads the microcode from the microcode bundled into the system image you are running for that interface type.

microcode (7200)

To configure a default override for the microcode that is downloaded to the hardware on a Cisco 7200 series router, use the microcode global configuration command. To revert to the default microcode for the current running version of the Cisco IOS software, use the no form of this command.

ecpa

ESCON Channel Port Adapter (CPA) interface.

pcpa

Parallel CPA interface.

location

Location of microcode, including the device and filename.

microcode (12000)

To load a Cisco IOS software image on a line card from Flash memory or the GRP card on a Cisco 12000 series Gigabit Switch Router (GSR), use the microcode global configuration command. To load the microcode bundled with the GRP system image, use the no form of this command.

oc12-atm | oc12-pos | oc3-pos4

Interface name.

flash

Loads the image from the Flash file system.

file-id

Specifies the device and filename of the image file to download from Flash memory. A colon (:) must separate the device and filename (for example, slot0:gsr-p-mz). Valid devices include:

bootflash:—Internal Flash memory.

slot0:—First PCMCIA slot.

slot1:—Second PCMCIA slot.

slot

(Optional) Slot number of the line card that you want to copy the software image to. Slot numbers range from 0 to 11 for the Cisco 12012 router and 0 to 7 for the Cisco 12008 router. If you do not specify a slot number, the Cisco IOS software image is downloaded on all line cards.

system

Loads the image from the software image on the GRP card.

microcode reload (7000/7500)

To reload the processor card on the Cisco 7000 series with RSP7000 or Cisco 7500 series routers, use the microcode reload global configuration command.

microcode reload (7200)

To reload the Cisco IOS microcode image on an ESCON CPA card in the Cisco 7200 series router, use the microcode reload command in privileged EXEC configuration mode.

all

Resets and reloads all hardware types that support downloadable microcode.

ecpa

Resets and reloads only those slots that contain hardware type ecpa.

pcpa

Resets and reloads only those slots that contain hardware type pcpa.

slot slot#

(Optional) Resets and reloads only the slot specified, and only if it contains the hardware specified.

microcode reload (12000)

To reload the Cisco IOS image from a line card on Cisco 12000 series routers, use the microcode reload global configuration command.

slot-number

(Optional) Slot number of the line card that you want to reload the Cisco IOS software image on. Slot numbers range from 0 to 11 for the Cisco 12012 and from 0 to 7 for the Cisco 12008 router. If you do not specify a slot number, the Cisco IOS software image is reloaded on all line cards.

more flh:logfile

To view the system console output generated during the Flash load helper operation, use the more flh:logfile privileged EXEC command.

show flh-log

The show flh-log command has been replaced by the more flh:logfile command. See the description of the more flh:logfile command in this chapter for more information.

show microcode

To display microcode image information available on line cards, use the show microcode EXEC command.

xmodem

To copy a Cisco IOS image to a router using the ROM monitor and the Xmodem or Ymodem protocol, use the xmodem ROM monitor command.

-c

(Optional) CRC-16 checksumming, which is more sophisticated and thorough than standard checksumming.

-y

(Optional) Uses the Ymodem protocol for higher throughput.

-e

(Optional) Erases the first partition in Flash memory before starting the download. This option is only valid for the Cisco 1600 series.

-f

(Optional) Erases all of Flash memory before starting the download. This option is only valid for the Cisco 1600 series.

-r

(Optional) Downloads the file to DRAM. The default is Flash memory.

-x

(Optional) Do not execute Cisco IOS image on completion of the download.

-s data-rate

(Optional) Sets the console port's data rate during file transfer. Values are 1200, 2400, 4800, 9600, 19200, 38400, and 115200 bps. The default rate is specified in the configuration register. This option is only valid for the Cisco 1600 series.

filename

(Optional) Filename to copy. This argument is ignored when the -r keyword is specified, because only one file can be copied to DRAM. On the Cisco 1600 series routers, files are loaded to the ROM for execution.

interface-type	One of the following interface processor names: aip, cip, eip, feip, fip, fsip, hip, mip, sip, sp, ssp, trip, vip, or vip2.
flash-filesystem:	Flash file system, followed by a colon. Valid file systems are bootflash, slot0, and slot1. Slave devices such as slaveslot0 are invalid. The slave's file system is not available during microcode reloads.
filename	Name of the microcode file.
slot	(Optional) Number of the slot. Range is from 0 to 15.
rom	If ROM is specified, the router loads from the onboard ROM microcode.
system	If the system keyword is specified, the router loads the microcode from the microcode bundled into the system image you are running for that interface type.

ecpa	ESCON Channel Port Adapter (CPA) interface.
pcpa	Parallel CPA interface.
location	Location of microcode, including the device and filename.

oc12-atm \| oc12-pos \| oc3-pos4	Interface name.
flash	Loads the image from the Flash file system.
file-id	Specifies the device and filename of the image file to download from Flash memory. A colon (:) must separate the device and filename (for example, slot0:gsr-p-mz). Valid devices include: bootflash:—Internal Flash memory. slot0:—First PCMCIA slot. slot1:—Second PCMCIA slot.
slot	(Optional) Slot number of the line card that you want to copy the software image to. Slot numbers range from 0 to 11 for the Cisco 12012 router and 0 to 7 for the Cisco 12008 router. If you do not specify a slot number, the Cisco IOS software image is downloaded on all line cards.
system	Loads the image from the software image on the GRP card.

all	Resets and reloads all hardware types that support downloadable microcode.
ecpa	Resets and reloads only those slots that contain hardware type ecpa.
pcpa	Resets and reloads only those slots that contain hardware type pcpa.
slot slot#	(Optional) Resets and reloads only the slot specified, and only if it contains the hardware specified.

-c	(Optional) CRC-16 checksumming, which is more sophisticated and thorough than standard checksumming.
-y	(Optional) Uses the Ymodem protocol for higher throughput.
-e	(Optional) Erases the first partition in Flash memory before starting the download. This option is only valid for the Cisco 1600 series.
-f	(Optional) Erases all of Flash memory before starting the download. This option is only valid for the Cisco 1600 series.
-r	(Optional) Downloads the file to DRAM. The default is Flash memory.
-x	(Optional) Do not execute Cisco IOS image on completion of the download.
-s data-rate	(Optional) Sets the console port's data rate during file transfer. Values are 1200, 2400, 4800, 9600, 19200, 38400, and 115200 bps. The default rate is specified in the configuration register. This option is only valid for the Cisco 1600 series.
filename	(Optional) Filename to copy. This argument is ignored when the -r keyword is specified, because only one file can be copied to DRAM. On the Cisco 1600 series routers, files are loaded to the ROM for execution.

Table of Contents