|
|
This chapter describes the ROM monitor commands that you can use to load and copy system images, microcode images, and configuration files. System images contain the system software. Microcode images contain microcode that you can download to various hardware devices. Configuration files contain commands that you can enter to customize your Catalyst 5000 series software.
Refer to the section, "ROM Monitor Mode" in the Switch Command-Line Interface chapter for information on how to access the ROM monitor mode.
Use the alias command to set and display aliases.
alias [name=value]| name= | (Optional) Name you give to the alias. |
| value | (Optional) Value of the alias. |
This command has no default settings.
ROM monitor command.
Normal.
If value contains white space or other special (shell) characters, you must use quotation marks. If value has a space as its last character, the next command line word is also checked for an alias (normally only the first word on a command line is checked).
Without an argument, this command prints a list of all aliased names with their values.
An equal sign (=) is required between the name and value of the alias.
The following example shows how to display a list of available alias commands, and then use the alias command to create an alias for the set command:
rommon 1 > alias r=repeat h=history ?=help b=boot ls=dir i=reset k=stack rommon 2 > alias s=set rommon 3 > alias r=repeat h=history ?=help b=boot ls=dir i=reset k=stack s=set rommon 4 > s PS1=rommon ! > BOOT=bootflash:RTSYNC_llue_11,1;slot0:f1,1; =========================================================================
Use the boot command to boot up an external process.
boot [-x | -v] [device:][imagename]| -x | (Optional) Argument used to load the image but not execute. |
| -v | (Optional) Argument used to toggle verbose mode. |
| device: | (Optional) ID of the device. |
| imagename | (Optional) Name of the image. |
This command has no defaults.
ROM monitor command.
Normal.
With no arguments, the boot command boots the first image in Flash. You can specify an image by typing its name, and specify a device by typing the device ID.
If no device is given with an imagename, the image is net booted.
If a device name is not recognized by the monitor, it assumes netbooting and passes the device ID on to the boot helper image.
A colon (:) is required after the device name.
This example shows how to use the boot command:
rommon> boot -x bootflash:cat5000-sup3.3-1-180.bin
CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
Uncompressing file: #################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################
rommon 11 > boot -v bootflash:cat5000-sup3.3-1-180.bin
rommon 1 > boot -v bootflash:164
boot: bootstring is: "bootflash:164"
loading section to address 0x80008000 from file position 0x16c, size is 0xa090
loading section to address 0x800120a8 from file position 0xa214, size is 0x2678
loading section to address 0x80014720 from file position 0xc88c, size is 0x40
open(): Open Error = -9
loadprog: error - on file open
boot: cannot load "bootflash:164"
rommon 2 > dir bootflash:
File size Checksum File name
1973032 bytes (0x1e1b28) 0xdadf5e24 llue
rommon 3 > b -v bootflash:llue
boot: bootstring is: "bootflash:llue"
loading section to address 0x80008000 from file position 0x16c, size is 0xa090
loading section to address 0x800120a8 from file position 0xa214, size is 0x2678
loading section to address 0x80014720 from file position 0xc88c, size is 0x40
CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCloading section to address 0x80010000 from file position 0x16c, size is 0x970
loading section to address 0x80010988 from file position 0xaf4, size is 0x158
loading section to address 0x80010ae0 from file position 0xc4c, size is 0x10
Uncompressing file: #################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################
loading section to address 0x80020000 from file position 0x10000, size is 0x315420
loading section to address 0x80335438 from file position 0x325438, size is 0x8e778
loading section to address 0x803c3bb0 from file position 0x3b3bb0, size is 0x32bf0
loading section to address 0x803f67a0 from file position 0x3e67a0, size is 0x10
System Power On Diagnostics
NVRAM Size .. .................512KB
ID Prom Test ..................Passed
DPRAM Size ....................16KB
DPRAM Data 0x55 Test ..........Passed
DPRAM Data 0xaa Test ..........Passed
DPRAM Address Test ............Passed
Clearing DPRAM ................Done
System DRAM Memory Size .......16MB
DRAM Data 0x55 Test ...........Passed
DRAM Data 0xaa Test ...........Passed
DRAM Address Test ............Passed
Clearing DRAM .................Done
EARL++ ........................Present
EARL RAM Test .................Passed
EARL Serial Prom Test .........Passed
Level2 Cache ..................Present
Level2 Cache test..............Passed
Boot image: bootflash:llue
Cisco Systems Console
12/8/1997,23:11:59:SYS-5:Module 1 is online
Enter password:
Console>
Use the confreg command to configure the configuration register utility.
confreg [num]| num | (Optional) Valid values are 0 = ROM monitor, 1 = the boot helper image, 2-15 = boot system. |
This command has no defaults.
ROM monitor command.
Normal.
Executed with the argument num, confreg changes the VCR to match the number specified.
Without the argument, confreg dumps the contents of the VCR in plain English and allows you to alter the contents.
You are prompted to change or keep the information held in each bit of the VCR. In either case, the new VCR value is written into NVRAM and does not take effect until you reset or power cycle the platform.
You must issue a sync command. Otherwise, the change is not saved and a reset removes your change.
This example shows how to use the confreg command:
rommon 7 > confreg
Configuration Summary
enabled are:
console baud: 9600
boot: the ROM Monitor
do you wish to change the configuration? y/n [n]: y
enable "diagnostic mode"? y/n [n]: y
enable "use net in IP bcast address"? y/n [n]:
enable "load rom after netboot fails"? y/n [n]:
enable "use all zero broadcast"? y/n [n]:
enable "break/abort has effect"? y/n [n]:
enable "ignore system config info"? y/n [n]:
change console baud rate? y/n [n]: y
enter rate: 0 = 9600, 1 = 4800, 2 = 1200, 3 = 2400
4 = 19200, 5 = 38400, 6 = 57600, 7 = 115200 [0]: 0
change the boot characteristics? y/n [n]: y
enter to boot:
0 = ROM Monitor
1 = the boot helper image
2-15 = boot system
[0]: 0
Configuration Summary
enabled are:
diagnostic mode
console baud: 9600
boot: the ROM Monitor
do you wish to change the configuration? y/n [n]:
You must reset or power cycle for new config to take effect
Use the dev command to list the device IDs available on a platform.
devThis command has no arguments or keywords.
This command has no defaults.
ROM monitor command.
Normal.
This example shows how to use the dev command:
rommon 10 > dev
Devices in device table:
id name
flash: flash
slot0: PCMCIA slot 0
slot1: PCMCIA slot 1
eprom: eprom
Use the dir command to list the files of the named device.
dir device:| device: | ID of the device. |
This command has no defaults.
ROM monitor command.
Normal.
A colon is required after the device name.
This example shows how to use the dir command:
rommon 11 > dir flash:
File size Checksum File name
65 bytes (0x41) 0xb49d clev/oddfile65
2229799 bytes (0x220627) 0x469e clev/sierra-k.Z
Use the history command to display the command history (the last 16 commands executed in the monitor environment). This command is aliased to "h" by the monitor for convenience.
historyThis command has no arguments or keywords.
This command has no defaults.
ROM monitor command.
Normal.
This example shows how to use the history command:
rommon 13 > history 1 help 2 break -s 0x20090 3 break -s 10090 4 break -s 0xa0001000 5 cont 6 help 7 dev 8 dir 9 dir bootflash: 10 dis 11 dis 0xa0001000 12 dis 0xbe000000 13 history =============================================================================
Use the meminfo command to display information about the main memory, packet memory, and NVRAM. With the -l option, the supported DRAM configurations are displayed.
meminfo [-l]| -l | (Optional) Long listing--displays DRAM configurations. |
This command has no defaults.
ROM monitor command.
Normal.
The minus sign (-) is required with the -l option.
This example shows how to use the meminfo command:
rommon 9 > meminfo Main memory size: 16 MB in 32 bit mode. Available main memory starts at 0xa000e000, size 16328KB IO (packet) memory size: 25 percent of main memory. NVRAM size: 32KB
On a Cisco 3640 router, meminfo -l displays the following tables. The size of the SIMM indicated is its total size. The "-DUAL" attached to the size indicates that the SIMM is a dual-bank SIMM. For example, "8M" indicates that the SIMM is a single bank with a total size of 8 MB. "8M-DUAL" indicates that the SIMM is dual bank with a total size of 8 MB (4 MB on each bank).
rommon 10 > meminfo -l Supported 64 bit configurations: SIMM 0 SIMM 1 SIMM 2 SIMM 3 -------------------------------------- 4M 4M 4M 4M 8M 8M 8M-DUAL 8M-DUAL 8M 8M 4M 4M 8M-DUAL 8M-DUAL 4M 4M 8M 8M 8M 8M 8M 8M 8M-DUAL 8M-DUAL 8M-DUAL 8M-DUAL 8M 8M 8M-DUAL 8M-DUAL 8M-DUAL 8M-DUAL 16M 16M 16M 16M 4M 4M 16M 16M 8M 8M 16M 16M 8M-DUAL 8M-DUAL 16M 16M 16M 16M 32M-DUAL 32M-DUAL 32M-DUAL 32M-DUAL 4M 4M 32M-DUAL 32M-DUAL 8M 8M 32M-DUAL 32M-DUAL 8M-DUAL 8M-DUAL 32M-DUAL 32M-DUAL 16M 16M 32M-DUAL 32M-DUAL 32M-DUAL 32M-DUAL Supported 32 bit configurations: SIMM 0 SIMM 1 SIMM 2 SIMM 3 -------------------------------------- 4M 4M 4M 4M 8M 4M 16M 4M 4M 4M 4M 4M 8M 8M 8M 4M 8M 16M 8M 8M 4M 8M 8M 8M 8M 8M 16M 8M 8M 4M 8M 8M 8M 8M 4M 16M 16M 4M 16M 8M 16M 16M 4M 16M 16M 8M 16M 16M 16M 16M 16M 4M 8M 16M 16M 4M 16M 16M 16M 8M 4M 16M 16M 8M 16M 16M 16M 16M 4M 16M 16M 16M 8M
On a Cisco 3620 router, meminfo -l displays the following table:
rommon 10 > meminfo -l Supported memory configurations: SIMM 0 SIMM 1 SIMM 2 SIMM 3 -------------------------------------- 4M 4M 4M 4M 8M 4M 16M 4M 4M 4M 4M 4M 8M 4M 4M 4M 4M 8M 8M 4M 8M 8M 8M 16M 8M 8M 4M 8M 8M 8M 8M 8M 16M 8M 8M 4M 4M 8M 8M 4M 8M 8M 8M 8M 4M 8M 8M 8M 8M 16M 16M 4M 16M 8M 16M 16M 16M 16M 4M 16M 16M 8M 16M 16M 16M 16M 16M 4M 4M 16M 16M 4M 8M 16M 16M 4M 16M 16M 16M 8M 4M 16M 16M 8M 8M 16M 16M 8M 16M 16M 16M 16M 4M 16M 16M 16M 8M 16M 16M 16M 16M
Use the repeat command to repeat a command.
repeat [number | string]| number | (Optional) Number of the command. |
| string | (Optional) Command string. |
If no argument is specified, the last command is repeated.
ROM monitor command.
Normal.
The optional command number (from the history buffer list) or match string specifies which command to repeat.
In the match string, the most recent command to begin with the specified string is executed again.
If the string contains white space, you must use quotation marks.
This command is usually aliased to the letter "r."
These examples show how to use the repeat command. You use the history command to display the list of previously entered commands:
rommon 22 > history
8 dir
9 dir bootflash:
10 dis
11 dis 0xa0001000
12 dis 0xbe000000
13 history
14 meminfo
15 meminfo -l
16 meminfo
17 meminfo -l
18 meninfo
19 meminfo
20 meminfo -l
21 meminfo -l
22 history
rommon 23 > repeat dir
dir bootflash:
File size Checksum File name
1973032 bytes (0x1e1b28) 0xdadf5e24 llue
rommon 24 > repeat
dir bootflash:
File size Checksum File name
1973032 bytes (0x1e1b28) 0xdadf5e24 llue
rommon 25 > repeat 15
meminfo -l
Main memory size: 16 MB.
Packet memory size: 0 MB
Main memory size: 0x1000000
Available main memory starts at 0xa000e000, size 0xff2000
NVRAM size: 0x20000
Parity Map for the DRAM Banks
Socket 0 in Bank 0 Has No Parity
Socket 1 in Bank 0 Has No Parity
Socket 0 in Bank 1 Has No Parity
Socket 1 in Bank 1 Has No Parity
==========================================================================
Use the reset command to soft reset the switch.
reset {mod_num | system}| mod_num | Number of the module to be reset. |
| system | Keyword to reset the entire switch. |
The default Flash device is slot0.
ROM monitor command.
Normal.
This example shows how to use the reset command:
rommon 26 > reset System Bootstrap, Version 3.1(1.69) Copyright (c) 1994-1997 by cisco Systems, Inc. Supervisor III processor with 16384 Kbytes of main memory rommon 1 > ===========================================================================
Use the set command to display all of the monitor variable names with their values.
setThis command has no arguments or keywords.
This command has no default.
ROM monitor command.
Normal.
This example shows how to use the set command to display all of the monitor variable names with their values:
rommon 2 > set PS1=rommon ! > BOOT= ?=0
Use the sync command to write the working in-core copy of environment variables and the aliases out to NVRAM so they are read on the next reset.
syncThis command has no arguments or keywords.
This command has no defaults.
ROM monitor command.
Normal.
This example shows how to use the sync command:
rommon 10 > sync rommon 11 >
Use the unalias command to remove the alias name and associated value from the alias list.
unalias name| name | Name of the alias. |
ROM monitor command.
Normal.
This example shows how to use the unalias command to remove the s alias and then check to ensure it was removed:
rommon 5 > alias r=repeat h=history ?=help b=boot ls=dir i=reset k=stack s=set rommon 6 > unalias s rommon 7 > alias r=repeat h=history ?=help b=boot ls=dir i=reset k=stack rmmon 8 > s monitor: command "s" not found ===========================================================================
Use the unset=varname command to remove a variable name from the variable list.
unset=varnameThis command has no arguments or keywords.
This command has no defaults.
ROM monitor command.
Normal.
This example shows how to use the set command to display the variable list, remove a variable name from the variable list, and then display the variable list to verify:
rommon 2 > set PS1=rommon ! > BOOT= ?=0 rommon 3 > unset=0 rommon 4 > set PS1=rommon ! > BOOT=
Use the varname= command to set the ROM monitor variable VARNAME to varvalue. Note that the syntax varname= sets the variable to a NULL string.
varname=value| varname= | Name of the variable. |
| value | Any ROM monitor command. |
This command has no defaults.
ROM monitor command.
Normal.
Do not put a space before or after the equal (=) sign. If there are spaces, you must place the value in quotes. Spell out variable names in all caps to make them conspicuous.
This example shows how to assign a variable name to a value:
rommon> s=set rommon> s PS1=rommon ! > BOOT= ?=0
|
|