Cisco IOS XR ROM Monitor Configuration Guide for the Cisco CRS Router
Router Recovery with ROM Monitor
Downloads: This chapterpdf (PDF - 525.0KB) The complete bookPDF (PDF - 1.82MB) | Feedback

Router Recovery with ROM Monitor

Table Of Contents

Router Recovery with ROM Monitor

Overview

About ROMMON Installation Files

Locating Installable Files

tar Filenames and Version Numbers

vm Filenames and Version Numbers

About the TURBOBOOT Variable

About the Boot Device (Destination Disk)

Reinstalling Cisco IOS XR Software on Cisco CRS Routers

Cisco CRS Router Installation Overview

Installation from a TFTP Server

Installation from a Local Storage Device

Reinstalling to a Cisco CRS Router from a TFTP Server Image

Restrictions for TFTP Services

Prerequisites

Examples

Reinstalling to a Cisco CRS Router from an Image on a Local Storage Device

Prerequisites

Examples

What to Do Next

Additional References

Related Documents

Technical Assistance


Router Recovery with ROM Monitor


This chapter describes the router recovery methods in ROM Monitor mode (ROMMON) of the router.

This chapter contains the following sections:

Overview

About ROMMON Installation Files

About the TURBOBOOT Variable

About the Boot Device (Destination Disk)

Reinstalling Cisco IOS XR Software on Cisco CRS Routers

Additional References

Overview

The standard way to install new software on the Designated Shelf Controller (DSC) is by using the install command in administration EXEC mode. However, if the DSC is unable to boot the Cisco IOS XR software or you want to completely replace the existing software, you can reinstall the software while the DSC is in ROM Monitor mode. When you install the Cisco IOS XR software from ROM Monitor mode, you must use a special software installation file with a vm file extension. These files are called vm files. You cannot install software in package installation envelope (PIE) files from ROM Monitor mode.


Note Installation using a vm file in ROM Monitor mode should be performed only from the DSC of the system.



Caution Reinstalling the Cisco IOS XR software from ROM Monitor mode replaces the currently installed router software and causes substantial router downtime. We recommend installing or upgrading software packages from administration EXEC mode using PIE files, as described in the "Upgrading and Managing Cisco IOS XR Software" module of Cisco IOS XR System Management Configuration Guide for the Cisco CRS Router.

About ROMMON Installation Files

This section includes the following topics:

Locating Installable Files

tar Filenames and Version Numbers

vm Filenames and Version Numbers

Locating Installable Files

To obtain Cisco IOS XR software and version information, use the Cisco Software Delivery System (SDS), available at the following URL:

http://tools.cisco.com/support/downloads/go/Tree.x?mdfid=279017029&mdfLevel=null&treeName=Routers&modelName=Cisco%20IOS%20XR%20Software&treeMdfId=268437899

To locate Cisco IOS XR software images:

Select Cisco IOS XR software, or any entry under Cisco Carrier Routing System.

Select Cisco IOS XR software to see the image tar files, or choose any of the other categories to see the other files.

Table 2-1 lists the software packages that you can install from ROMMON.

Table 2-1 Downloadable Software for Installation from ROM Monitor

Software Package Name
Description

Cisco IOS XR IP/MPLS Core Software

This package contains two copies of the Cisco IOS XR Unicast Routing Core Bundle. One copy is in the PIE1 file format and can be installed while Cisco IOS XR is running, as described in the "Upgrading and Managing Cisco IOS XR Software" module of Cisco IOS XR System Management Configuration Guide for the Cisco CRS Router. The other copy is in a vm file that can be installed from ROM Monitor. This package also includes Cisco IOS XR MPLS, Manageability, and Multicast packages (in PIE files).

Cisco IOS XR IP/MPLS Core Software 3DES

This package contains everything in the Cisco IOS XR IP/MPLS Core Software package in addition to Cisco IOS XR Security package (in a PIE file).

1 PIE stands for Package Installation Envelope


Table 2-1 lists packages that are distributed in files with tar filename extensions (tar files are assembled with the UNIX tar utility). When you download a tar file, you must unpack the tar file with a software program before you can install any of the files in the package.

The files that you can install from ROM Monitor have a vm filename extension. These files contain the software included in the Cisco IOS XR Unicast Routing Core Bundle. The other files in the packages are PIE files.


Note The tar files contain both PIE files and vm files. If the router is operating properly, you can install the software using the appropriate PIE file with little or no interruption to router traffic, as described in the "Upgrading and Managing Cisco IOS XR Software" module of Cisco IOS XR System Management Configuration Guide for the Cisco CRS Router. If the router cannot boot the Cisco IOS XR software, install the core software using the vm file first, then install any additional packages using the PIE files after the router enters EXEC mode.


tar Filenames and Version Numbers

The format for a tar filename is:

platform-bundle_name-major.minor.maintenance.tar

Table 2-2 describes the tar filename components.

Table 2-2 tar Filename Components 

Component
Description

platform

Identifies the platform for which the software package is designed.

For packages designed for the Cisco CRS router, the platform designation is "CRS."

 

bundle_name

Identifies a specific bundle.

IOS XR bundle name indicates a file that includes all packages in the Cisco IOS XR Unicast Routing Core Bundle and the Management, MPLS, and Multicast packages. These packages are described in the Upgrading and Managing Cisco IOS XR Software module of Cisco IOS XR System Management Configuration Guide for the Cisco CRS Router.

IOS XR-k9 bundle name indicates a file that includes all packages in the iosxr bundle file plus the security package.

major

Identifies the major release of this package.

Major releases occur when there is a major architectural change to the product (for example, a major new capability is introduced).

All packages operating on the router must be at the same major release level.

Major release is the least frequent release and may require a router reboot.

minor

Identifies the minor release of this package.

Minor releases contain one or more of the following:

New features

Bug fixes

Minor release versions do not have to be identical for all software packages operating on the router, but the operating packages must be certified by Cisco as compatible with each other.

Minor releases may require a router reboot.

maintenance

Identifies the maintenance release of this package.

Maintenance releases contain a collection of bug fixes for a package.

Maintenance release versions do not have to be identical for all software packages operating on the router, but the major and minor versions of the maintenance release must match the those of the package being updated.

Maintenance releases usually do not require a router reboot.


vm Filenames and Version Numbers

The format for a composite vm filename for Cisco CRS routers is:

comp-platform-package_name.vm-major.minor.maintenance

The "comp" prefix indicates that the file is a composite of multiple packages. Table 2-3 describes the other filename components.

Table 2-3 vm Filename Components 

Component
Description

platform

Identifies the platform for which the software package is designed.

For packages designed for Cisco CRSs, the platform designation is "hfr."

 

package_name

Identifies a specific package.

Mini package names indicate a composite package that includes all packages in the Cisco IOS XR Unicast Routing Core Bundle, which is described in the "Upgrading and Managing Cisco IOS XR Software" module of Cisco IOS XR System Management Configuration Guide for the Cisco CRS Router.

major

Identifies the major release of this package.

A major release occurs when there is a major architectural change to the product (for example, a major new capability is introduced).

All packages operating on the router must be at the same major release level.

A major release is the least frequent release and may require a router reboot.

minor

Identifies the minor release of this package.

A minor release contains one or more of the following:

New features

Bug fixes

The minor release version does not have to be identical for all software packages operating on the router, but the operating packages must be certified by Cisco as compatible with each other.

A minor release may require a router reboot.

maintenance

Identifies the maintenance release of this package.

A maintenance release contains a collection of bug fixes for a package.

The maintenance release version does not have to be identical for all software packages operating on the router, but the major and minor versions of the maintenance release must match the those of the package being updated.

A maintenance release usually does not require a router reboot.


The following example shows a composite of multiple mini packages:

comp-hfr-mini.vm-3.9.0

About the TURBOBOOT Variable

The TURBOBOOT environmental variable automates the software installation process in the ROM Monitor mode and determines the installation settings, such as the boot device (destination disk) for software installation. The following is the syntax for the TURBOBOOT environmental variable:

TURBOBOOT=on,{boot-device},[format | clean],[nodisablebreak]

In the preceding example, the TURBOBOOT variable is set to on, the boot device (destination disk) is the flash disk in disk0:, the installation process formats the disk, and the installation process can be terminated prematurely.

TURBOBOOT=on,disk0,format,nodisablebreak

There are four main arguments and keywords for the TURBOBOOT variable:

on—Installs and activates the Cisco IOS XR software packages when the RP is booted with the vm image.

boot-device—Selects the destination disk for software installation. For more information, see the "About the Boot Device (Destination Disk)" section.


Note The default boot device disk is disk0:.


[format | clean]: When the clean option is selected, the Cisco IOS XR software is completely replaced, but all other files on the disk are preserved, including configuration files for each secure domain router (SDR). When the format option is selected, the Cisco IOS XR software is completely replaced, and only the administration configuration is preserved. All other files on the disk, including all configuration files for the SDRs and all user files, are deleted. The administration configuration contains the configuration that determines SDR name and inventory. The SDR configurations include router configurations such as Border Gateway Protocol (BGP) and interface configurations.

[nodisablebreak]: When the nodisablebreak flag is added, the installation process using the TURBOBOOT variable can be prematurely terminated by sending a break from the terminal. The default is to ignore breaks from the terminal.


Note Each argument is separated by a comma.


For more information, see the "Environment Variable Settings" section on page 1-11.

About the Boot Device (Destination Disk)

The boot device determines the location where the Cisco IOS XR software is installed on all RPs. The system uses the boot-device to install the software to the other RP card in the system. Any additional software or software upgrades are automatically saved to the same boot device.

When you install Cisco IOS XR software using the Turboboot method in ROM Monitor mode, you must specify a boot-device for the router. The boot device is the local disk on the RP card where the Cisco IOS XR software is installed.

On the Cisco CRS, the supported boot devices are disk0: and disk1:. If a boot-device is not specified, disk0: is used by default. If disk0: is not installed, then disk1: is used. All packages are installed on the flash disk and the MBI resides within the bootflash memory to support split-boot. For more information on Split-Boot feature, see the "Split-Boot Support" section on page 5-60.

MBI is always installed on the bootflash: device.

For more information on TURBOBOOT variable usage and syntax, see the "About the TURBOBOOT Variable" section.

The boot-device determines the slot where all software is installed on all RPs and distributed route processors (DRPs) that act as the designated secure domain router shelf controllers (DSDRSCs). In other words, when you turboboot the Cisco IOS XR software to the DSC, all the other RPs in the system must include a disk in that same slot. The system uses these disks to distribute the software to each RP in the system. Any additional software or software upgrades are automatically saved to the same boot device.

After the Cisco IOS XR software is installed to the boot device using the TURBOBOOT method, all additional software and software upgrades are automatically installed and synchronized to that same boot device and cannot be changed. For example:

If the Cisco IOS XR software is installed in the RP card using the TURBOBOOT variable, with disk0 (TURBOBOOT=on,disk0), all packages are installed to disk0: and the boot device is disk0:.

If the Cisco IOS XR software is installed in the RP card using the TURBOBOOT variable, with disk1 (TURBOBOOT=on,disk1), all packages are installed to disk1: and the boot device is "disk1:".

After you boot the Cisco IOS XR software, you are not allowed to add packages to anywhere other than the boot-device. For example, you cannot boot the DSC to disk1: and decide to add your packages to disk0: or vice versa.


Note We recommend using disk0: as the boot device. Disk0: is preinstalled in most RPs, which ensures that the correct disk is used to store the software packages on the entire system.


Reinstalling Cisco IOS XR Software on Cisco CRS Routers


Caution Reinstalling Cisco IOS XR software from ROM Monitor mode replaces the currently installed router software and causes substantial router downtime. We recommend that you install or upgrade software packages from the Administration EXEC mode using package installation envelope (PIE) files, as described in the "Upgrading and Managing Cisco IOS XR Software" module of Cisco IOS XR System Management Configuration Guide for the Cisco CRS Router.

This section includes the following topics:

Cisco CRS Router Installation Overview

Reinstalling to a Cisco CRS Router from a TFTP Server Image

Reinstalling to a Cisco CRS Router from an Image on a Local Storage Device

What to Do Next

Cisco CRS Router Installation Overview

When you reinstall the software from ROM Monitor mode, you can perform either of the following procedures:

Load the Cisco IOS XR software from a vm file on a TFTP server to the DSC.

Transfer the vm file to a local storage device and then load the Cisco IOS XR software from that storage device to the DSC.

The following sections provide an overview of these procedures:

Installation from a TFTP Server

Installation from a Local Storage Device

Installation from a TFTP Server

When you install Cisco IOS XR software from a TFTP server to the DSC, you must perform the following tasks:

1. Back up the router configuration while still in EXEC mode.

2. Verify the sanity of the configuration file system on each SDR using the cfs check command.

3. Place all RPs and DRPs in ROM Monitor mode.

4. From ROM Monitor mode, clear the ROM Monitor environmental variables on all RPs, including the DSC.

5. On the DSC, configure the IP parameters for the Management Ethernet interface. These variables are set in ROM Monitor, and are required to access the TFTP server.

6. On the DSC, configure the TURBOBOOT environment variable to either clean or format the boot disk during the installation. The recommended boot device is disk0:.

7. On the DSC, boot the Cisco IOS XR software from a vm file on the TFTP server.

8. Reset all other RPs to boot the Cisco IOS XR software.


Note After you boot the Cisco IOS XR software, the TURBOBOOT process either cleans or formats the boot device, based on the TURBOBOOT environment variable setting.



Caution If the TURBOBOOT variable is set to format the boot device, all SDR configurations are deleted and only the admin configuration is preserved. For more information, see About the TURBOBOOT Variable and About the Boot Device (Destination Disk).

Installation from a Local Storage Device

When you install Cisco IOS XR software from a local storage device, you must perform the following tasks:

1. Back up the router configuration while still in EXEC mode.

2. Verify the sanity of the configuration file system on each SDR using the command cfs check.

3. Copy the required vm file to the DSC flash disk that will hold the installable file. We recommend using disk1. You can also replace the flash disk with a flash disk that already has the correct image.

4. Place all RPs and DRPs in ROM Monitor mode.

5. From ROM Monitor mode, clear the ROM Monitor environmental variables on all RPs, including the DSC.

6. On the DSC, configure the TURBOBOOT environment variable to either clean or format the boot disk during the installation. The recommended boot device is disk0:.

7. Turboboot the DSC with the vm image located on the local storage device.

8. Reset all other RPs to boot the Cisco IOS XR software.


Caution If the TURBOBOOT variable is set to format the boot device, all existing SDR configurations are deleted. Only the admin configuration is preserved. For more information, see About the TURBOBOOT Variable and About the Boot Device (Destination Disk).

For the procedure to install Cisco IOS XR software from a local storage device, see the "Reinstalling to a Cisco CRS Router from an Image on a Local Storage Device" section.

Reinstalling to a Cisco CRS Router from a TFTP Server Image

Cisco IOS XR software can be reinstalled directly from a vm file located on a TFTP server. Complete the instructions in this section exactly as described.

Restrictions for TFTP Services

TFTP services by some vendors (such as Sun Solaris) may not support files larger than 32 MB. Because most Cisco IOS XR vm images are larger than 32 MB, you may need to use one of the following options:

Use a third-party or freeware TFTP server that supports file sizes larger than 32 MB.

Download a patch from Sun Microsystems to correct this limitation (http://www.sun.com).

Install the Cisco IOS XR software from a vm image located on the local flash disk. See the "Reinstalling to a Cisco CRS Router from an Image on a Local Storage Device" section.

Prerequisites

Before reinstalling Cisco IOS XR software from a TFTP server image, verify that the following prerequisites have been met:

ROM Monitor firmware on the Cisco CRS router is compatible with the Cisco IOS XR software image that you are installing. For more information, see Upgrading or Downgrading ROM Monitor Using the FPD PIE, page 5-61.

The following information is available:

IP address of the Management Ethernet interface on the DSC

Subnet mask of the Management Ethernet interface on the DSC

IP address of the default gateway that serves your router

IP address of the TFTP server from which the software will be downloaded

The filename and directory of the vm installation file that will be installed on the router

Boot device for your system. For more information, see the About the Boot Device (Destination Disk).

SUMMARY STEPS

1. Back up the router configuration while still in EXEC mode.

2. Verify the sanity of the configuration file system:

a. cfs check

b. Repeat on each SDR in the system.

3. Place all RPs in ROM Monitor mode:

a. admin

b. config-register 0x0 location all

c. reload location all

4. Clear the ROM Monitor environmental variables on all RPs, including the DSC:

a. unset BOOT

b. unset TFTP_FILE

c. sync

d. Repeat for each RP in the system (LCC and fabric chassis).

5. On the DSC, set the environment variables that configure the Management Ethernet interface for use in ROM Monitor mode:

a. IP_ADDRESS=ip_address

b. IP_SUBNET_MASK=mask

c. DEFAULT_GATEWAY=ip_address

6. On the DSC, set the TFTP environment variables:

a. TFTP_VERBOSE=print_setting

b. TFTP_RETRY_COUNT=retry_count

c. TFTP_TIMEOUT=timeout

d. TFTP_CHECKSUM=1

e. TFTP_BLKSIZE=transfer_size

7. Set the Turboboot variables on the DSC:

a. TURBOBOOT=on, disk0, options

b. sync

8. On the DSC, boot the vm image located on the TFTP server:
boot tftp://server/directory/filename

9. Reset all other RSPsRPs to boot the Cisco IOS XR software:

a. confreg 0x2

b. reset

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

Back up the router configuration while still in EXEC mode.

(Optional) To preserve the current router configuration, copy it to another disk while still in EXEC mode.

For more information, see the "Upgrading and Managing Cisco IOS XR Software" module of Cisco IOS XR System Management Configuration Guide for the Cisco CRS Router.

Step 2 

Verify the sanity of the configuration file system. Repeat on each SDR in the system.

cfs check

Example:

RP/0/RP0/CPU0:router# cfs check

(Optional) Verifies the sanity of the router configuration, and resolves any internal inconsistencies.

Repeat the cfs check command on each SDR in the system.

Note This step is necessary only if you wish to preserve the router configurations (if TURBOBOOT is set to clean). If TURBOBOOT is set to format, then the disk is erased and the existing configurations are deleted. The default option is clean.

Step 3 

Place all RPs in ROM Monitor mode:

admin

config-register 0x0 location all

reload location all

Example:

RP/0/RP0/CPU0:router# admin

RP/0/RP0/CPU0:router(admin)# config-register 0x0 location all

RP/0/RP0/CPU0:router(admin)# reload location all

For more information, see Resetting the Configuration Register and Reloading a DSC to ROM Monitor Mode, page 1-3.

Step 4 

Clear the ROM Monitor environmental variables on all RPs, including the DSC.

unset BOOT

unset TFTP_FILE

sync

Example:

rommon B1> unset BOOT

rommon B2> unset TFTP_FILE

rommon B3> sync

Ensures that all the RPs in the system are prepared for TURBOBOOT. Repeat for each RP in the system (LCC and fabric chassis).

Enter the settings exactly as shown. You must attach a terminal to each card for this procedure.

All variable names are case sensitive.

Clears the BOOT variable.

Clears the TFTP_FILE variable.

Saves the changes.

Note If the unset command displays an error message, it is most likely because the variable you are trying to change is not set. If this is the case, ignore the message and continue.

Step 5 

On the DSC, set the environment variables that configure the Management Ethernet interface for use in ROM Monitor mode:

IP_ADDRESS=ip_address

IP_SUBNET_MASK=mask

DEFAULT_GATEWAY=ip_address

Example:

rommon B4> IP_ADDRESS=1.1.1.1
rommon B5> IP_SUBNET_MASK=255.255.254.0
rommon B6> DEFAULT_GATEWAY=1.1.0.1

Enter these settings exactly as shown. All variable names are case sensitive.

Sets the IP address for the Management Ethernet interface on the DSC.

Sets the subnet mask for the Management Ethernet interface on the DSC.

Identifies the default gateway that serves the DSC.

Step 6 

On the DSC, set the TFTP environment variables:

TFTP_VERBOSE=print_setting

TFTP_RETRY_COUNT=retry_count

TFTP_TIMEOUT=timeout

TFTP_CHECKSUM=1

TFTP_BLKSIZE=transfer_size

Example:

rommon B4> TFTP_VERBOSE=0
rommon B5> TFTP_RETRY_COUNT=4
rommon B6> TFTP_TIMEOUT=6000
rommon B7> TFTP_CHECKSUM=1
rommon B8> TFTP_BLKSIZE=1468

(Optional) Enter these settings exactly as shown. All variable names are case sensitive.

TFTP_VERBOSE sets the printer setting: 0=quiet, 1=progress (default), 2=verbose

TFTP_RETRY_COUNT sets the retry count for ARP and TFTP (default=7)

TFTP_TIMEOUT sets the overall timeout of the operation in seconds (default=7200)

TFTP_CHECKSUM specifies whether or not to perform a checksum test on the image: 1=no, 2=yes

TFTP_BLKSIZE sets the transfer size per package in bytes (default=1468)

Step 7 

On the DSC, set the TURBOBOOT variables:

TURBOBOOT=on, boot-device, options

sync

Example:

rommon B9> TURBOBOOT=on,disk0,format

rommon B10> sync

Sets the TURBOBOOT parameters and saves the configuration. Separate each parameter with a comma (,).

To enable the Turboboot process, specify on.

Specify a boot device where all software will be installed on the DSC and all DSDRSCs. We recommend disk0.

To replace the existing software without formatting the boot device, replace options with clean.

To replace the existing software and format the boot device, replace options with format.

The default option is clean.

Any existing configuration is preserved.

Step 8 

On the DSC, boot the vm image located on the tftp server:

boot tftp://server/directory/filename

Example:

rommon B11> boot tftp://223.255.254.254/softdir/comp-hfr-mini.vm

Retrieves the file from the TFTP server and installs it on the boot disk.

Run this command on the DSC and specify the vm installation file from the TFTP server.

This process removes any existing software packages, resets the configuration register to 0x2, and boots the DSC.

Allow the system to fully boot. The Turboboot process takes some time. Do not enter any commands until you are prompted to enter a username or until the CLI prompt appears.

The "Press RETURN to get started" message appears twice. The first occurrence appears when the software is loaded into memory. The second occurrence happens after the software has been installed on the disk.

The DSC is fully booted when the following message appears:

SYSTEM CONFIGURATION COMPLETED

Step 9 

Reset all other RPs to boot the Cisco IOS XR software:

confreg 0x2

reset

Example:

rommon B4> confreg 0x2

rommon B5> reset

Sets the configuration register to automatically start the boot process instead of staying in ROM Monitor mode.

Resets the RP and starts the boot process.

The RPs synchronize the new Cisco IOS XR software from the DSC.

Examples

Verify the sanity of the configuration file system on each SDR in the system:

RP/0/RP0/CPU0:router# cfs check

Place all RPs in ROM Monitor mode:

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

Clear the ROM Monitor environmental variables on all RPs, including the DSC:

rommon B1> unset BOOT
rommon B2> unset TFTP_FILE
rommon B3> sync

Set the IP environment variables to configure the ROM Monitor Management Ethernet interface on the DSC:

rommon B4> IP_ADDRESS=10.1.1.1
rommon B5> IP_SUBNET_MASK=255.255.254.0
rommon B6> DEFAULT_GATEWAY=10.1.0.1

Enable installation process using the TURBOBOOT variable on the DSC. The following example shows how to boot the router using the specified vm file on the specified TFTP server:

rommon B7> TURBOBOOT=on,disk0,format
rommon B8> sync
rommon B9> boot tftp://10.10.10.10/software/comp-hfr-mini.vm-3.9.0

Reset all other RPs to boot the Cisco IOS XR software:

rommon B8> confreg 0x2
rommon B9> reset

Reinstalling to a Cisco CRS Router from an Image on a Local Storage Device

This section describes the tasks required to install Cisco IOS XR software on the boot device using a vm image stored on a local storage device. The local storage device can be either of the removable flash disks in disk0 or disk1. We recommend using disk1 as the storage device for the vm image, and disk0 as the boot device (destination disk).

Complete the procedures exactly as described in this section.


Note Before booting begins on the DSC, a delay of 10 minutes or more may occur while the vm image is read to memory from the removable local storage device.


Prerequisites

The ROM Monitor firmware on the Cisco CRS router is compatible with the Cisco IOS XR software image that you are installing. For more information, see Upgrading or Downgrading ROM Monitor Using the FPD PIE, page 5-61.

A valid vm image, as described in the "Locating Installable Files" section, must be located on a flash disk installed the RP. Cisco recommends using disk1.

If this file is not present on a local disk or a different version is required, use one of the following options:

While the router is still in EXEC mode, copy the necessary vm image from a TFTP, an FTP, or an rcp server to disk0 or disk1. This process is described in the "Upgrading and Managing Cisco IOS XR Software" module of Cisco IOS XR System Management Configuration Guide for the Cisco CRS Router. For more information, see specifically the section "Obtaining and Placing Cisco IOS XR Software".

Consult your system administrator for a flash disk containing the bootable vm file.

Consult your Cisco representative for a flash disk containing the bootable vm file. For more information, see Related Documents.


Note The removable flash disk used to store the installation file should be used to store archives only of vm and PIE files. This disk cannot be used as a destination for installed software or configurations. Only the boot device can be used to store active software and configurations. See the "Upgrading and Managing Cisco IOS XR Software" module of Cisco IOS XR System Management Configuration Guide for the Cisco CRS Router.


SUMMARY STEPS

1. Back up the router configuration while still in EXEC mode.

2. Verify the sanity of the configuration file system:

a. cfs check

b. Repeat on each SDR in the system.

3. Copy the required vm file to the DSC flash disk that will hold the installable file. We recommend using disk1. You can also replace the flash disk with a flash disk that already has the correct image.

4. Place all RPs in ROM Monitor mode:

a. admin

b. config-register 0x0 location all

c. reload location all

5. Clear the ROM Monitor environmental variables on all RPs, including the DSC:

a. unset BOOT

b. unset TFTP_FILE

c. sync

d. Repeat for each RP in the system (line card chassis and fabric chassis).

6. Set the TURBOBOOT variables on the DSC:

a. TURBOBOOT=on, disk0, options

b. sync

7. On the DSC, boot the vm image located on the local storage device:
boot device:/filename

8. Reset all other RPs to boot the Cisco IOS XR software:

c. confreg 0x2

d. reset

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

Back up the router configuration while still in EXEC mode.

(Optional) To preserve the current router configuration, copy it to another disk while still in EXEC mode.

For more information, see the "Upgrading and Managing Cisco IOS XR Software" module of Cisco IOS XR System Management Configuration Guide for the Cisco CRS Router.

Step 2 

Verify the sanity of the configuration file system. Repeat on each SDR in the system.

cfs check

Example:

RP/0/RP0/CPU0:router# cfs check

(Optional) Verifies the sanity of the router configuration, and resolves any internal inconsistencies.

Repeat the cfs check command on each SDR in the system.

Note This step is necessary only to preserve the router configurations (if TURBOBOOT is set to clean). If TURBOBOOT is set to format, then the disk is erased and the existing configurations are deleted. The default option is clean.

Step 3 

Copy the required vm file to the DSC flash disk, or replace the flash disk with a flash disk that has the correct image.

Places the software on the router in preparation for installation.

We recommend using flash disk1: to hold the installable file.

For more information, see Prerequisites for this procedure.

Step 4 

Place all RPs in ROM Monitor mode:

admin

config-register 0x0 location all

reload location all

Example:

RP/0/RP0/CPU0:router# admin

RP/0/RP0/CPU0:router(admin)# config-register 0x0 location all

RP/0/RP0/CPU0:router(admin)# reload location all

For more information, see Resetting the Configuration Register and Reloading a DSC to ROM Monitor Mode, page 1-3.

Step 5 

Clear the ROM Monitor environmental variables on all RPs, including the DSC.

unset BOOT

unset TFTP_FILE

sync

Example:

rommon B1> unset BOOT

rommon B2> unset TFTP_FILE

rommon B3> sync

Ensures that all RPs in the system are prepared for Turboboot. Repeat for each RP in the system (line card chassis and fabric chassis).

Enter the settings exactly as shown. You must attach a terminal to each card for this procedure.

All variable names are case sensitive.

a. Clears the BOOT variable.

b. Clears the TFTP_FILE variable.

c. Saves the changes.

Note If the unset command displays an error message, it is most likely because the variable you are trying to change is not set. If this is the case, ignore the message and continue.

Step 6 

On the DSC, set the TURBOBOOT variables:

TURBOBOOT=on, boot-device, options

sync

Example:

rommon B7> TURBOBOOT=on,disk0,format

rommon B8> sync

Sets the TURBOBOOT parameters and saves the configuration. Separate each parameter with a comma (,).

To enable the Turboboot process, specify on.

Specify a boot device where all software will be installed on the DSC and all DSDRSCs. We recommend disk0.

To replace the existing software without formatting the boot device, replace options with clean.

To replace the existing software and format the boot device, replace options with format.

The default option is clean.

Any existing configuration is preserved.

Step 7 

On the DSC, boot the vm image located the local storage device:

boot devixe:/filename

Example:

rommon B7> boot disk1:/comp-hfr-mini.vm-3.8.0

Boots the file located on the local storage device and installs it to the boot disk.

This process removes any existing software packages, resets the configuration register to 0x2, and boots the system.

Allow the RP to fully boot. The "Press RETURN to get started" message appears twice. The first occurrence appears when the software is loaded into memory. The second occurrence happens after the software has been installed on the disk.

The system is fully booted when the following message appears:

SYSTEM CONFIGURATION COMPLETED

Note A delay of 10 minutes or more occurs while the software is read from the flash disk.

Step 8 

Reset all other RPs to boot the Cisco IOS XR software:

confreg 0x2

reset

Example:

rommon B4> confreg 0x2

rommon B5> reset

Sets the configuration register to automatically start the boot process instead of staying in ROM Monitor mode.

Resets the RP and starts the boot process.

The RPs synchronize the new Cisco IOS XR software from the DSC.

Examples

Verify the sanity of the configuration file system on each SDR in the system:

RP/0/RP0/CPU0:router# cfs check

Place all RPs in ROM Monitor mode:

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

Clear the ROM Monitor environmental variables on all RPs, including the DSC:

rommon B1> unset BOOT
rommon B2> unset TFTP_FILE
rommon B4> sync

Turboboot the DSC:

rommon B5> TURBOBOOT=on,disk0,format
rommon B6> sync
rommon B7> boot disk1:/comp-hfr-mini.vm-3.8.0 

Note A delay of 10 minutes or more occurs while the software is read from the flash disk.


Reset all other RPs to boot the Cisco IOS XR software:

rommon B8> confreg 0x2
rommon B9> reset

What to Do Next

After the system is up and in EXEC mode, you can execute the full range of CLI commands from the DSC.


Note If there was no previous router configuration, you must enter a root-system username and password when the boot process is complete.


After reinstalling the software, you might want to verify interfaces, install additional packages or perform other configuration tasks:

For instructions on how to verify that the interfaces are up and properly configured, see "Verifying the System Interfaces" in the "Troubleshooting the Cisco IOS XR Software" module of Cisco IOS XR Getting Started Guide for the Cisco CRS Router.

Install additional software from the PIE files, as necessary. For more information, see the "Upgrading and Managing Cisco IOS XR Software" module of Cisco IOS XR System Management Configuration Guide for the Cisco CRS Router.

See Related Documents for a list of the additional documentation required to fully configure the router.


Additional References

The following sections provide references related to the ROM Monitor.

Related Documents

Related Topic
Document Title

Contact a Cisco representative

"Obtaining Additional Publications and Information" in What's New in Cisco Product Documentation located at:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

Removable flash disk used to store archives of vm and PIE files

Save current router configuration

Verify that interfaces are up and properly configured

Install or upgrade software packages from PIE files

Upgrading and Managing Cisco IOS XR Software module of Cisco IOS XR System Management Configuration Guide for the Cisco CRS Router

Redundancy slot pairs

Managing the Router Hardware module of Cisco IOS XR System Management Configuration Guide for the Cisco CRS Router

Upgrade a Cisco XR 12000 Series Router that is running Cisco IOS software.

Migrating from Cisco IOS to Cisco IOS XR Software on the
Cisco XR 12000 Series Router


Technical Assistance

Description
Link

The Cisco Support website provides extensive online resources, including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies.

To receive security and technical information about your products, you can subscribe to various services, such as the Product Alert Tool (accessed from Field Notices), the Cisco Technical Services Newsletter, and Really Simple Syndication (RSS) Feeds.

Access to most tools on the Cisco Support website requires a Cisco.com user ID and password.

http://www.cisco.com/support