|
|
This chapter provides detailed descriptions of some of the ROM monitor commands used to load and copy system images, microcode images, and configuration files. System images contain the system software. Microcode images contain microcode to be downloaded to various hardware devices. Configuration files contain commands entered to customize the function of the Cisco IOS software.
Other commands are described elsewhere in this publication:
Switch CLI:
ATM module CLI:
Use the alias command to set and display aliases.
alias [name=value]| name | Name you give to the alias. |
| value | Value of the alias. |
This command has no default settings.
ROM monitor command.
Normal.
If value contains white space or other special (shell) characters, it must be quoted. 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 will print a list of all aliased names with their values.
This example shows how to use the alias 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 [-xv] [device][imagename]| -x | (Optional) Load the image but do not execute. |
| -v | (Optional) 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, boot will boot the first image in Flash. An image may be specified by typing its name. The device can be specified by typing the device ID.
If no device is given with an imagename the image will be net booted.
If a device name is not recognized by the monitor it will assume netbooting and pass the device ID on to the boot helper image.
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 will change the Virtual Configuration Register to match the number specified.
Without the argument, confreg will dump the contents of the VCR in plain English and allow the user 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 or the change is not saved and a reset will remove 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 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.
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 this 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 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 this 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.
Do not place white space around the equal sign. If there is white space in varvalue, it must be quoted. We recommend that variable names are spelled with all uppercase letters to make them conspicuous.
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, meminfo -l will display 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 (4MB 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, meminfo -l will display 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 | Number of the command. |
| string | Command string. |
If no argument is specified, the last command is repeated.
ROM monitor command.
Normal.
The optional command number (from the history list) or match string specifies which command to repeat.
In the case of the match string, the most recent command to begin with the specified string will be re-executed.
If the string contains white space it must be quoted.
This command is usually aliased to the letter "r."
This example shows how to use the repeat command:
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, or to set a monitor variable.
setThis command has no default.
ROM monitor command.
Normal.
This example shows how to use the set command:
rommon 2 > set PS1=rommon ! > BOOT= ?=0
Use the sync command to write the working in-core copy of environment variables and aliases out to NVRAM so they are read on the next reset.
syncThis command has no defaults.
ROM monitor command.
Normal.
This example shows how to use the sync command:
rommon> sync
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:
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 this syntax to assign a variable name to a value. 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.
This example shows how to assign a variable name to a value:
rommon> s=set rommon> s PS1=rommon ! > BOOT= ?=0
|
|