Cisco IOS XR Troubleshooting Guide for the Cisco CRS-1 Router - Troubleshooting Upgrading and Downgrading Software [Cisco IOS XR Software (End-of-Sale)]

Table Of Contents

Troubleshooting Upgrading and Downgrading Software

Validating and Troubleshooting ROM Monitor Software Installation

Verifying and Troubleshooting the ROM Monitor Version

Troubleshooting Upgrading and Downgrading ROM Monitor Software on Cisco CRS-1 Routers

Troubleshooting Upgrading and Downgrading Cisco IOS XR Software Packages

Troubleshooting Upgrading and Downgrading Software

This chapter describes techniques that you can use to troubleshoot the upgrading and downgrading of router software. It includes the following sections:

•Validating and Troubleshooting ROM Monitor Software Installation

•Verifying and Troubleshooting the ROM Monitor Version

•Troubleshooting Upgrading and Downgrading ROM Monitor Software on Cisco CRS-1 Routers

•Troubleshooting Upgrading and Downgrading Cisco IOS XR Software Packages

Validating and Troubleshooting ROM Monitor Software Installation

The ROM Monitor (ROMMON) is a bootstrap program that initializes the hardware and boots the Cisco IOS XR software when you power on or reload a router. The ROMMON software is stored on the bootflash and the ROMMON variables are stored on NVRAM.

See the following sections for information on troubleshooting ROM Monitor versions and upgrading and downgrading ROM Monitor:

•"Verifying and Troubleshooting the ROM Monitor Version" section

•"Troubleshooting Upgrading and Downgrading ROM Monitor Software on Cisco CRS-1 Routers" section

Note A copy of the ROMMON software exists on each card. If a card fails to boot the Cisco IOS XR software, the ROMMON software takes control and places the card in ROMMON mode. Because a card in ROMMON mode is not running the Cisco IOS XR software, that card will be unavailable for normal router operations.

Use the following troubleshooting tips when installing ROMMON software:

•If any node cannot be upgraded successfully or if you see error messages similar to the following message, try reformatting the bootflash and then repeat the upgrade procedure. See Cisco IOS XR ROM Monitor Guide for the Cisco CRS-1 Router for information on the bootflash upgrade procedure.

LC/0/3/CPU0:rommon_burner[65635]: %ROMMON_BURNER-3-FILE_OP_ERR : Opening ROMMON flash

partition failed: No such file or directory in function main at line 952

•If you are upgrading only ROMMONB and the version does not change to the expected version after the upgrade, the upgrade might have failed. When the router cannot load ROMMONB, it loads ROMMONA.

•If both ROMMANB and ROMMONA are damaged due to an unexpected node reset or a power interruption during the upgrade, the affected route processors must be returned to Cisco for repair.

Verifying and Troubleshooting the ROM Monitor Version

The ROM Monitor (ROMMON) software is known by many names such as boot software and boot image.

Although it is distributed with routers that use the Cisco IOS XR software, ROMMON is a separate program from the Cisco IOS XR software. During normal startup, the ROMMON initializes the cards, and then control passes to the Cisco IOS XR software. After the Cisco IOS XR software takes over, ROMMON is no longer in use.

A copy of the ROMMON software exists on each card. If a card fails to boot theCisco IOS XR software, the ROMMON software takes control and places the card in ROMMON mode. Because a card in ROMMON mode is not running the Cisco IOS XR software, that card will be unavailable for normal router operations.

When the Designated Secure Domain Router System Controller (DSDRSC) in an SDR is placed in ROMMON mode, the router operations are transferred to the standby DSDRSC (if available). If both the primary and standby DSDRSCs are in ROMMON mode, then the router operations cease since the Cisco IOS XR software is no longer running.

Caution Ensure you have the correct ROMMON firmware on your system. See the Cisco IOS XR ROM Monitor Guide for the Cisco CRS-1 Router for the ROMMON firmware requirements and information on upgrading and downgrading ROMMON firmware and information on overriding a ROMMON boot block.

To verify and troubleshoot the ROMMON version on systems running Cisco IOS XR software, perform the following procedure.

SUMMARY STEPS

1. show version

2. show diag | inc ROM|NODE|PLIM

3. more nvram:/classic-rommon-var

4. Place the designated shelf controller (DSC) in ROMMON mode:

a. admin

b. config register 0x0

c. exit

d. reload

5. set --

6. environment variable(s)

sync

7. Exit ROMMON mode:

a. confreg 0x102

b. reset

8. Contact Cisco Technical Support if the problem is not resolved.

DETAILED STEPS

Command or Action

Purpose

Step 1

show version
Example:

RP/0/RP0/CPU0:router# show version

Displays information about the router, including image names, uptime, and other system information.

Verify that the expected ROMMON version is installed. If the version is not as expected, see Cisco IOS XR ROM Monitor Guide for the Cisco CRS-1 Router for information on upgrading or downgrading the ROM Monitor version.

Step 2

show diag | inc ROM|NODE|PLIM
Example:

RP/0/RP0/CPU0:router# show diag | inc ROM|NODE|PLIM

Displays details about the hardware and software on each node in a router.

Verify that the ROMMON version on each node is as expected. If the version is not as expected on a node, see Cisco IOS XR ROM Monitor Guide for the Cisco CRS-1 Router for information on upgrading or downgrading the ROM Monitor version.

Step 3

more nvram:/classic-rommon-var
Example:

RP/0/RP0/CPU0:router# more nvram:/classic-rommon-var

Displays the configured environment variables.

Ensure that the environment variable setting are as expected. If the environment variables are not as expected, proceed to Step 4.

Step 4 .

admin
config-register 0x0
exit
reload
Example:

RP/0/RP0/CPU0:router# admin
RP/0/RP0/CPU0:router(admin)# config-register 0x0
RP/0/RP0/CPU0:router(admin)# exit
RP/0/RP0/CPU0:router# reload

Places the DSC in ROMMON.

Step 5

set
Example:

rommon B1 > set

Displays the configured environment variables.

Step 6

environment variable(s)
sync
Example:

rommon B2> IP_ADDRESS=1.1.1.1
rommon B3> IP_SUBNET_MASK=255.255.254.0
rommon B4> DEFAULT_GATEWAY=1.1.0.1
rommon B5> sync

Allows you to specify the environment variable settings.

Environment variable settings are entered in capital letters, followed by a definition. To save the current environment variable settings, enter the sync command. See Cisco IOS XR ROM Monitor Guide for the Cisco CRS-1 Router for more information on changing the environment variable settings.

Step 7

confreg 0x102
reset
Example:

rommon B6 > confreg 0x102
rommon B7 > reset

Exits ROMMON mode, resetting and initializing the router.

Step 8

Contact Cisco Technical Support.

If the problem is not resolved, contact Cisco Technical Support. For Cisco Technical Support contact information, see the "Obtaining Documentation and Submitting a Service Request" section in the Preface.

Read the information in the "Troubleshooting Upgrading and Downgrading ROM Monitor Software on Cisco CRS-1 Routers" section before you begin any upgrade procedures.

Examples

The following example shows that the ROMMON version is 1.38:
RP/0/RP0/CPU0:router# show version 
Cisco IOS XR Software, Version 3.3.0 
Copyright (c) 2006 by cisco Systems, Inc.
ROM: System Bootstrap, Version 1.38(20060207:032757) [CRS-1 ROMMON],  
router uptime is 11 hours, 47 minutes
System image file is "disk0:hfr-os-mbi-3.3.0/mbihfr-rp.vm"
cisco router (7457) processor with 4194304K bytes of memory.
7457 processor at 1197Mhz, Revision 1.2
The following example shows that the ROMMON version running on all nodes is:
RP/0/RP0/CPU0:router# show diag | inc ROMMON
ROMMON: Version 1.500(20090929:184527) [CRS-1 ROMMON]
ROMMON: Version 1.500(20090929:184527) [CRS-1 ROMMON]
ROMMON: Version 1.500(20090929:184527) [CRS-1 ROMMON]
ROMMON: Version 1.500(20090929:184527) [CRS-1 ROMMON]
ROMMON: Version 1.500(20090929:184527) [CRS-1 ROMMON]
ROMMON: Version 1.500(20090929:184527) [CRS-1 ROMMON]
The following example shows the current environment variable settings:
RP/0/RP0/CPU0:router# more nvram:/classic-rommon-var 
  PS1 = rommon ! > , IOX_ADMIN_CONFIG_FILE = , IP_ADDRESS = 192.39.52.71, IP_SUB
NET_MASK = 255.255.255.0, DEFAULT_GATEWAY = 192.39.52.1, ? = 0, TURBOBOOT = , EA
SYBAKE = 0x0, ReloadReason = 66, BSI = 0, BOOT = disk0:hfr-os-mbi-3.3.0.1I/mbihf
r-rp.vm,1;, confreg = 0x102^@
The following example shows how to place the DSC in ROMMON mode:
RP/0/RP0/CPU0:router# admin
RP/0/RP0/CPU0:router(admin)# config-register 0x0
Successfully set config-register to 0x0 on node 0/RP0/CPU0
Successfully set config-register to 0x0 on node 0/RP1/CPU0
RP/0/RP0/CPU0:router(admin)# exit
RP/0/RP0/CPU0:router# reload 
Proceed with reload? [confirm]
System Bootstrap, Version 12.0(20040624:164256) [assafb-misc1 1.14dev(0.91)] DEV
ELOPMENT SOFTWARE
Copyright (c) 1994-2004 by cisco Systems, Inc.
DRAM DIMM Slot 1: 512M found, Slot 2: Empty
MPC7450 platform with 524288 Kbytes of main memory
rommon B1 >
The following example show how to display the current environment variable settings:
rommon B1 > set
PS1=rommon ! >
TFTP_VERBOSE=2
IP_ADDRESS=1.1.1.1
IP_SUBNET_MASK=255.255.0.0
TFTP_SERVER=
DEFAULT_GATEWAY=12.25.0.1
TFTP_FILE=
CONFIG_FILE=
BOOT=disk0:hfr-os-mbi-1.0.0/mbihfr-rp.vm,1;
The following example shows how to set and save the environment variables:
rommon B2> IP_ADDRESS=10.1.1.1
rommon B3> IP_SUBNET_MASK=255.255.254.0
rommon B4> DEFAULT_GATEWAY=10.1.0.1 
rommon B5> sync 
The following example shows how to exit ROMMON mode, reset and initialize the router:
rommon B6> confreg 0x102 
rommon B7> reset 
Troubleshooting Upgrading and Downgrading ROM Monitor Software on Cisco CRS-1 Routers

If you need to upgrade or downgrade the ROM Monitor (ROMMON) firmware, first upgrade the software including the FPD PIE, and then upgrade the firmware.

Note FPD = Field programmable device. PIE = Package installation envelope.

If you need to upgrade or downgrade the ROMMON firmware on your system, be aware of the following requirement: During the upgrade/downgrade process, you must be sure that each upgrade step completes successfully before continuing to the next step. (The system will provide a message when each step completes successfully.) If a step does not complete successfully and you continue to the next step, the firmware load will fail. In that case, you should attempt to install the firmware again. If the second attempt fails, you might need to return the card to the factory for repairs.

Caution Pay close attention to the completion of each ROMMON upgrade/downgrade step. If you continue after any step is unsuccessful, the upgrade/downgrade will fail and the card might need to be returned to the factory to complete the firmware load.

See Cisco IOS XR ROM Monitor Guide for the Cisco CRS-1 Router for detailed information and procedures on upgrading and downgrading ROM Monitor software on the Cisco CRS-1.

Troubleshooting Upgrading and Downgrading Cisco IOS XR Software Packages

See Cisco IOS XR Getting Started Guide for the Cisco CRS-1 Router for detailed information and procedures on upgrading and downgrading Cisco IOS XR software.