Cisco IOS XR Troubleshooting Guide, Release 3.5
Troubleshooting Upgrading and Downgrading Software
Downloads: This chapterpdf (PDF - 386.0KB) The complete bookPDF (PDF - 2.2MB) | Feedback

Troubleshooting Upgrading and Downgrading Software

Table Of Contents

Troubleshooting Upgrading and Downgrading Software

Validating and Troubleshooting ROM Monitor Software Installation

Validating and Troubleshooting Boothelper Software Installation on Cisco XR 12000 Routers

Verifying and Troubleshooting the ROM Monitor Version on Systems Running Cisco IOS XR software

Examples

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

Troubleshooting Upgrading and Downgrading ROM Monitor and Boothelper Software on Cisco XR 12000 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

Validating and Troubleshooting Boothelper Software Installation on Cisco XR 12000 Routers

Verifying and Troubleshooting the ROM Monitor Version on Systems Running Cisco IOS XR software

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

Troubleshooting Upgrading and Downgrading ROM Monitor and Boothelper Software on Cisco XR 12000 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 on Systems Running Cisco IOS XR software" section

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

"Troubleshooting Upgrading and Downgrading ROM Monitor and Boothelper Software on Cisco XR 12000 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 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.

Validating and Troubleshooting Boothelper Software Installation on Cisco XR 12000 Routers

Boothelper software is additional software that extends the capabilities of ROMMON on a Cisco XR 12000 Series Router. With Boothelper, ROMMON can load images from compact flash and TFTP servers. Without Boothelper, ROMMON can only load images from a local storage device (disk0, disk1, and bootflash).

See Upgrading from Cisco IOS to Cisco IOS XR Software on the Cisco 12000 Series Router for information on the diskboot process, copying a new Cisco IOS boothelper image to bootflash, and performing a diskboot.


Note Before being able to tftpboot an image on the performance route processor (PRP), you need to configure the IOS XR Boothelper with a unique IP address. It is also recommended that a unique MAC address is assigned. The unique MAC address allows the parallel boot of multiple RPs without creating network addressing conflicts. This configuration must be done for each RP in the system. To assign unique MAC addresses, it is suggested to look at the burned-in address (BIA) address, and change the last hex digit to the slot number. This change ensures that each slot in the system has a unique MAC address. Note that this MAC address is only used temporarily during the tftp operation, and will change once Cisco IOS XR software takes over.


Verifying and Troubleshooting the ROM Monitor Version on Systems Running Cisco IOS XR software

The ROM Monitor (ROMMON) software is known by many names—boot software, boot image, or boot helper. On Cisco XR 12000 Series Routers, the Boothelper software is different from the ROMMON software. For more information on ROMMON and Boothelper software, see Cisco IOS XR ROM Monitor Guide.

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 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.

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 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 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 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 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, Obtaining Support, and Security Guidelines" section in the Preface.

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 ROM|NODE|PLIM 
 
   
PLIM 0/1/CPU0 : JACKET CARD
  ROMMON: Version 1.38(20060207:032757)  [CRS-1 ROMMON]
NODE 0/1/0 : 4xOC3 POS SPA
NODE 0/1/4 : 4xOC48 POS/RPR HHSPA
NODE 0/1/5 : 8xGE SPA
PLIM 0/3/CPU0 : JACKET CARD
  ROMMON: Version 1.38(20060207:032757)  [CRS-1 ROMMON]
NODE 0/3/4 : 8xGE SPA
PLIM 0/6/CPU0 : JACKET CARD
  ROMMON: Version 1.38(20060207:032757)  [CRS-1 ROMMON]
NODE 0/6/0 : 4xOC3 POS SPA
NODE 0/6/4 : 8xOC3/OC12 POS SPA
NODE 0/6/5 : 8xGE SPA
NODE 0/RP0/CPU0 : RP
  ROMMON: Version 1.38(20060207:032757)  [CRS-1 ROMMON]
NODE 0/RP1/CPU0 : RP
  ROMMON: Version 1.38(20060207:032757)  [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

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

Troubleshooting Upgrading and Downgrading ROM Monitor and Boothelper Software on Cisco XR 12000 Routers

See Cisco IOS XR ROM Monitor Guide for detailed information and procedures on upgrading and downgrading ROM Monitor software on the Cisco XR 12000 Series Router.

Troubleshooting Upgrading and Downgrading Cisco IOS XR Software Packages

See Cisco IOS XR Getting Started Guide for detailed information and procedures on upgrading and downgrading Cisco IOS XR software.