Cisco IOS XR ROM Monitor Configuration Guide for the Cisco CRS Router
Managing Configuration Files in ROM Monitor
Downloads: This chapterpdf (PDF - 206.0KB) The complete bookPDF (PDF - 0.95MB) | Feedback

Table of Contents

Managing Configuration Files in ROM Monitor

Information about Configuration Files

Specifying an Alternative Administration Configuration

Specifying a Temporary Alternative Administrative Configuration with the -o Boot Option

Specifying a Permanent Alternative Administrative Configuration File with the IOX_ADMIN_CONFIG_FILE= Variable

Specifying an Alternative SDR Configuration

Specifying a Temporary SDR Configuration File with the -a Boot Option

Specifying a Permanent SDR Configuration File with the IOX_CONFIG_FILE= Variable

Specifying an Alternate Storage Location for Configuration Files

Additional References

Related Documents

Technical Assistance

Managing Configuration Files in ROM Monitor

This chapter provides information about managing configuration files in the router.

This chapter contains the following sections:

Information about Configuration Files

Cisco IOS XR software creates two types of configuration files—the administration configuration file and the default secure domain router (SDR) configuration files. These configuration files are stored in the following locations:

  • There is only one administration configuration file, which is stored on the designated shelf controller (DSC) and contains system-wide configurations for items such as SDR name and node inventory.
  • In addition, each SDR has its own SDR configuration to specify the parameters for routing, interfaces, SDR usernames, and other SDR-specific configurations. By default, the configuration file for each SDR is stored on the designated secure domain router shelf controller (DSDRSC) for the SDR.

For more information on SDRs, DSDRSCs and admin plane configuration, see the “ Configuring Secure Domain Routers on Cisco IOS XR Software” module of Cisco IOS XR System Management Configuration Guide for the Cisco CRS Router .

The following sections describe ways to manage the use of configuration files from ROM Monitor:


Caution The default configuration should be sufficient for most situations. The options described in the following sections are for rare cases in which an alternative configuration is required. Use of these options can result in system errors or downtime. Consult Cisco technical support before using these options.

Specifying an Alternative Administration Configuration

The administration configuration stores system-wide configurations such as the SDR name and node inventory for the entire system. This is separate from the default-SDR configuration that stores routing and interface configurations.

To specify an alternative administration configuration file from ROM Monitor mode, use the methods described in the following sections:


Caution The default committed administration configuration should be sufficient for most situations. The option described in this section is for rare cases when an alternative admin configuration is required. Use of this method can result in system errors or downtime.

Specifying a Temporary Alternative Administrative Configuration with the
-o Boot Option

This mode of administrative configuration with the -o boot option is temporary in nature. After this boot option is set, this mode allows the router to boot from this alternative configuration, and the configuration specified in this configuration file becomes part of the running and persistent configuration.


NoteWhen the router boots with the external configuration specified by the -o option, the system loses the default configuration. The default configuration is completely replaced with this alternative configuration.


To specify a temporary administration configuration file with the -o boot option, use the following procedure. With this method, the specified configuration file is used for a single router boot. If the DSC is reset again, the permanent configuration file is used.

SUMMARY STEPS

1. Place the DSC and the standby DSC in ROM Monitor mode.

2. confreg 0x0

3. confreg 0x102

4. set

5. boot image –o config-file-path

6. confreg 0x102

7. reset

DETAILED STEPS

Command or Action
Purpose

Step 1

Place the DSC and the standby DSC in ROM Monitor mode.

For more information, see Entering ROM Monitor Mode.

Step 2

confreg 0x0

Example:

rommon 1> confreg 0x0

Sets the configuration register of the standby DSC to 0x0 so that the standby DSC does not take control.

Note The configuration register is not an environment variable like TURBOBOOT. Do not enter an equal sign when entering the confreg command. For more information about ROMMON commands and environmental variables, see Chapter 1, “ROM Monitor Overview and Basic Procedures”.

Step 3

confreg 0x102

Example:

rommon 1 > confreg 0x102

Sets the active RP configuration register to 0x102.

Step 4

set

Example:

rommon 2 > set

Displays the current environment variable settings.

Note The filename is set in the BOOT variable.

Step 5

b oot image –o config-file-path

 

Example:

rommon 3> boot tftp://223.255.254.254/images/comp-hfr-mini.vm -o /disk1:/cfgarchives/admingold.conf

Boots the router. Replace image with the filename listed in the boot variable, and replace
config-file-path with the path and filename for the configuration file.

Note The pathname should be a valid UNIX pathname (a slash [/] must be included after the device: “disk1:/”).

Step 6

confreg 0x102

Example:

rommon 1> confreg 0x102

Sets the configuration register of the standby DSC to 0x102.

Step 7

reset

Example:

rommon 2 > reset

Resets the standby DSC so that the new setting takes effect and the standby DSC becomes operational.

Specifying a Permanent Alternative Administrative Configuration File with the IOX_ADMIN_CONFIG_FILE= Variable

This mode of alternative administrative configuration with the IOX_ADMIN_CONFIG_FILE= variable is permanent in nature. After this variable is set, this mode allows the router to always boot from this alternative configuration, and the system does not revert to the default commited configuration on the next system reload.


NoteWhen the router boots with the external configuration specified by the
IOX_ADMIN_CONFIG_FILE= variable, the system loses the default configuration. The default configuration is completely replaced with this alternative configuration.


To permanently change the location of the default administration configuration file, specify the filename and directory path in the IOX_ADMIN_CONFIG_FILE= environment variable while in ROM Monitor mode. Specifying the environment variable forces the use of the specified file for all boots while this variable is set.

SUMMARY STEPS

1. Place the DSC and the standby DSC in ROM Monitor mode.

2. confreg 0x0

3. confreg 0x102

4. set

5. IOX_ADMIN_CONFIG_FILE= drive:path/file

6. sync

7. boot

8. confreg 0x102

9. reset

DETAILED STEPS

Command or Action
Purpose

Step 1

Place the DSC and the standby DSC in ROM Monitor mode.

For more information, see Entering ROM Monitor Mode.

Step 2

confreg 0x0

Example:

rommon 1> confreg 0x0

Sets the configuration register of the standby DSC to 0x0 so that the standby DSC does not take control.

Note The configuration register is not an environment variable like TURBOBOOT. Do not enter an equal sign when entering the confreg command.

Step 3

confreg 0x102

Example:

rommon 1 > confreg 0x102

Sets the DSC configuration register to 0x102.

Step 4

set

Example:

rommon 2 > set

Displays the current environment variable settings.

Note The filename is set in the IOX_ADMIN_CONFIG_FILE variable.

Step 5

IOX_ADMIN_CONFIG_FILE= drive:path/file

Example:

rommon B1> IOX_ADMIN_CONFIG_FILE=/disk2:/cfgarchives/
admingold.conf

Sets the IOX_ADMIN_CONFIG_FILE variable to specify the absolute path of a different administration configuration file.

Note The IOX_ADMIN_CONFIG_FILE variable is overridden by the boot command when it is entered with the -o option.

Step 6

sync

Example:

rommon B1> sync

Saves the changes.

Step 7

boot

Example:

rommon B1> boot

Boots the router.

Step 8

confreg 0x102

Example:

rommon 1> confreg 0x102

Sets the configuration register of the standby DSC to 0x102.

Step 9

reset

Example:

rommon 2 > reset

Resets the standby DSC so that the new setting takes effect and the standby DSC becomes operational.

Specifying an Alternative SDR Configuration

You can specify an alternative configuration for an SDR from ROM Monitor mode, using the methods described in the following sections. These procedures are run from the DSDRSC for the SDR. The DSC is also the DSDRSC of the owner SDR. For all other non-owner SDRs, the DSDRSC is the RP or DRP assigned as the DSDRSC.


NoteFor more information on SDRs and DSDRSCs, see the “Configuring Secure Domain Routers on Cisco IOS XR Software” module ofCisco IOS XR System Management Configuration Guide for the Cisco CRS Router.


This section includes the following procedures:


Caution The default committed SDR configuration should be sufficient for most situations. The option described in this section is for rare cases when an alternative SDR configuration is required. Use of this method can result in system errors or downtime.

Specifying a Temporary SDR Configuration File with the -a Boot Option

This mode of SDR configuration with the -a boot option is temporary in nature. Once this boot option is set, this mode allows the router to boot from this alternative configuration and the configuration specified in this configuration file becomes part of the running and persistent configuration.


NoteWhen the router boots with the external configuration specified by the -a option, the system loses the default configuration. The default configuration is completely replaced with this alternative configuration.


To specify a temporary SDR configuration file with the -a boot option, use the following procedure. With this method, the specified configuration file is used for a single router boot. If the DSC is reset again, the permanent configuration file is used.

SUMMARY STEPS

1. Place the DSDRSC and the standby DSDRSC in ROM Monitor mode.

2. confreg 0x0

3. confreg 0x102

4. set

5. boot image –a config-file-path

6. confreg 0x102

7. reset

DETAILED STEPS

Command or Action
Purpose

Step 1

Place the DSDRSC and the standby DSDRSC in ROM Monitor mode.

For more information, see Entering ROM Monitor Mode.

Step 2

confreg 0x0

Example:

rommon 1> confreg 0x0

Sets the configuration register of the standby DSDRSC to 0x0 so that the standby DSDRSC does not take control.

Note The configuration register is not an environment variable like TURBOBOOT. Do not enter an equal sign when entering the confreg command.

Step 3

confreg 0x102

Example:

rommon 1 > confreg 0x102

Sets the DSDRSC configuration register to 0x102.

Step 4

set

Example:

rommon 2 > set

Displays the current environment variable settings.

Note The filename is set in the BOOT variable.

Step 5

boot image –a config-file-path

 

Example:

rommon 3> boot tftp://223.255.254.254/images/comp-hfr-mini.vm -a /disk1:/cfgarchives/SDRgold.conf

Enter the boot command. Replace image with the filename listed in the boot variable, and replace config-file-path with the path and filename for the configuration file.

Note The pathname should be a valid UNIX pathname (a slash [/] must be included after the device: “disk1:/”).

Step 6

confreg 0x102

Example:

rommon 1> confreg 0x102

Sets the configuration register of the standby DSDRSC to 0x102.

Step 7

reset

Example:

rommon 2 > reset

Resets the standby DSDRSC so that the new setting takes effect and the standby DSDRSC becomes operational.

Specifying a Permanent SDR Configuration File with the
IOX_CONFIG_FILE= Variable

This mode of alternative SDR configuration with the IOX_CONFIG_FILE= variable is permanent in nature. Once this variable is set, this mode allows the router to always boot from this alternative configuration. The system does not revert to the default commited configuration on the next system reload.


NoteWhen the router boots with the external configuration specified by the
IOX_CONFIG_FILE= variable, the system loses the default configuration. The default configuration is completely replaced with this alternative configuration.


To permanently change the location of the default configuration file for an SDR, specify the filename and directory path in the IOX_CONFIG_FILE= environment variable while in ROM Monitor mode. Specifying the environment variable forces the use of the specified file for all boots while this variable is set.

 

SUMMARY STEPS

1. Place the DSDRSC and the standby DSDRSC in ROM Monitor mode.

2. confreg 0x0

3. confreg 0x102

4. set

5. IOX_CONFIG_FILE= drive:path/file

6. sync

7. boot

8. confreg 0x102

9. reset

DETAILED STEPS

Command or Action
Purpose

Step 1

Place the DSDRSC and the standby DSDRSC in ROM Monitor mode.

For more information, see Entering ROM Monitor Mode.

Step 2

confreg 0x0

Example:

rommon 1> confreg 0x0

Sets the configuration register of the standby DSDRSC to 0x0 so that the standby DSDRSC does not take control.

Note The configuration register is not an environment variable like TURBOBOOT. Do not enter an equal sign when entering the confreg command.

Step 3

confreg 0x102

Example:

rommon 1 > confreg 0x102

Sets the DSDRSC configuration register to 0x102.

Step 4

set

Example:

rommon 2 > set

Displays the current environment variable settings.

Note The filename is set in the IOX_CONFIG_FILE variable.

Step 5

IOX_CONFIG_FILE = drive:path/file

Example:

rommon B1> IOX_CONFIG_FILE=/disk2:/cfgarchives/
admingold.conf

Sets the IOX_CONFIG_FILE variable to specify the absolute path of a different SDR configuration file.

Note The IOX_CONFIG_FILE= variable is overridden by the boot command when it is entered with the -a option.

Step 6

sync

Example:

rommon B1> sync

Saves the changes.

Step 7

boot

Example:

rommon B1> boot

Boots the router.

Step 8

confreg 0x102

Example:

rommon 1> confreg 0x102

Sets the configuration register of the standby DSDRSC to 0x102.

Step 9

reset

Example:

rommon 2 > reset

Resets the standby DSDRSC so that the new setting takes effect and the standby DSDRSC becomes operational.

Specifying an Alternate Storage Location for Configuration Files

To change the default location where the configuration files for an SDR are saved (committed), specify the location and directory path in the IOX_CONFIG_MEDIUM= environment variable while in ROM Monitor mode. Specifying the environment variable forces the use of the specified location while this variable is set.

 

SUMMARY STEPS

1. Place the DSDRSC and the standby DSDRSC in ROM Monitor mode.

2. confreg 0x0

3. confreg 0x102

4. set

5. IOX_CONFIG_MEDIUM =/location:/path/

6. sync

7. boot

8. confreg 0x102

9. reset

DETAILED STEPS

Command or Action
Purpose

Step 1

Place the DSDRSC and the standby DSDRSC in ROM Monitor mode.

For more information, see Entering ROM Monitor Mode.

Step 2

confreg 0x0

Example:

rommon 1> confreg 0x0

Sets the configuration register of the standby DSDRSC to 0x0 so that the standby DSDRSC does not take control.

Note The configuration register is not an environment variable like TURBOBOOT. Do not enter an equal sign when entering the confreg command.

Step 3

confreg 0x102

Example:

rommon 1 > confreg 0x102

Sets the DSDRSC configuration register to 0x102.

Step 4

set

Example:

rommon 2 > set

Displays the current environment variable settings.

Note The filename is set in the IOX_CONFIG_MEDIUM variable.

Step 5

IOX_CONFIG_MEDIUM= /location:/path/

Example:

rommon B1> IOX_CONFIG_MEDIUM=/disk1:/cfgarchives/admingold.conf

Sets the IOX_CONFIG_MEDIUM variable to specify a different location.

  • For the Cisco CRS router, replace location with disk0 or disk1. Replace the path argument with the path to the directory in which you want to store the configuration files.
  • For the Cisco XR 12000 Series Router, replace location with disk0, disk1, or compactflash. Replace path with the path to the directory in which you want to store the configuration files.

Note By default, the directory /disk0:/usr is available for storing alternative configurations and other user files. We recommend that you do not use a directory path starting with /disk0:/config because that path is used to store system files.

Step 6

sync

Example:

rommon B1> sync

Saves the changes.

Step 7

boot

Example:

rommon B1> boot

Boots the router.

Step 8

confreg 0x102

Example:

rommon 1> confreg 0x102

Sets the configuration register of the standby DSDRSC to 0x102.

Step 9

reset

Example:

rommon 2 > reset

Resets the standby DSDRSC so that the new setting takes effect and the standby DSDRSC becomes operational.

Additional References

The following sections provide references related to the ROM Monitor.

Related Documents

 

Related Topic
Document Title

SDRs, DSDRSCs, and admin plane configuration

Configuring Secure Domain Routers on Cisco IOS XR Software module of Cisco IOS XR System Management Configuration Guide for the Cisco CRS 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