Cisco IOS XR ROM Monitor Guide, Release 3.4
Managing Configuration Files in ROM Monitor
Downloads: This chapterpdf (PDF - 206.0KB) The complete bookPDF (PDF - 1.33MB) | Feedback

Managing Configuration Files in ROM Monitor

Table Of Contents

Managing Configuration Files in ROM Monitor

Specifying an Alternative Admin 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


Managing Configuration Files in ROM Monitor


Cisco IOS XR software creates two types of configuration files, the admin configuration file and secure domain router (SDR) configuration files.

There is only one admin configuration file, which is stored on the designated system controller (DSC) and contains system-wide configurations for items such as SDR names 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 system 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" chapter of Cisco IOS XR System Management Configuration Guide.

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.

This chapter contains the following sections:

Specifying an Alternative Admin Configuration

Specifying an Alternative SDR Configuration

Specifying an Alternate Storage Location for Configuration Files

Specifying an Alternative Admin Configuration

The admin configuration stores system-wide configurations such as the SDR names and node inventory for the entire system. This is separate from the individual SDR configurations that store routing and interface configurations.

To specify an alternative admin configuration file from ROMMON, use the methods described in the following sections:

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


Caution The default committed admin 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

To specify a temporary admin 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.


Step 1 Place the DSC and the standby DSC in ROM Monitor mode, as described in Entering ROM Monitor Mode.

Step 2 Set the configuration register of the standby DSC to 0x0 so that the standby DSC does not take control:

rommon 1> confreg 0x0

Note The configuration register is not an environment variable like TURBOBOOT. Do not enter an equal sign when entering the confreg command. See "ROM Monitor Overview and Basic Procedures" for more information on ROMMON commands and environmental variables.


Step 3 Set the active RP configuration register to 0x2102:

rommon 1 > confreg 0x2102
 
   

Step 4 Enter the set command to display the current environment variable settings:

rommon 2 > set
 
   

Note the filename set in the BOOT variable.

Step 5 Enter the boot command using the following command syntax:

boot image -o config-file-path

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

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

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


Although this command causes the router to boot from an alternative configuration, the system reverts to the default committed configuration on the next system reload.

Step 6 Set the configuration register of the standby DSC to 0x102:

rommon 1> confreg 0x102
 
   

Step 7 Reset the standby DSC so that the new setting can take effect and the standby DSC becomes operational:

rommon 2 > reset
 
   

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

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


Step 1 Place the DSC and the standby DSC in ROM Monitor mode, as described in Entering ROM Monitor Mode.

Step 2 Set the configuration register of the standby DSC to 0x0 so that the standby DSC does not take control:

rommon 1> confreg 0x0

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


Step 3 Set the DSC configuration register to 0x2102:

rommon 1 > confreg 0x2102
 
   

Step 4 Enter the set command to display the current environment variable settings:

rommon 2 > set
 
   

Step 5 Note the filename set in the IOX_ADMIN_CONFIG_FILE variable.

Step 6 To define the path to a different admin configuration file, set the IOX_ADMIN_CONFIG_FILE variable using the following syntax:

rommon B1> IOX_ADMIN_CONFIG_FILE=drive:path/file
 
   

Step 7 To save the change, enter the sync command as follows:

rommon B1> sync
 
   

Step 8 Boot the router with the following command:

rommon B1> boot
 
   

Step 9 Set the configuration register of the standby DSC to 0x102:

rommon 1> confreg 0x102
 
   

Step 10 Reset the standby DSC so that the new setting can take effect and the standby DSC becomes operational:

rommon 2 > reset
 
   


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


Specifying an Alternative SDR Configuration

You can specify an alternative configuration for an SDR from ROMMON, 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.


Note For more information on SDRs and DSDRSCs, see the "Configuring Secure Domain Routers on Cisco IOS XR Software" module of Cisco IOS XR System Management Configuration Guide.


This section includes the following instructions:

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

Specifying a Permanent SDR Configuration File with the IOX_CONFIG_FILE= Variable


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

To specify a temporary SDR configuration file with the -a boot option, use the following procedure:


Step 1 Place the DSDRSC and the standby DSDRSC in ROM Monitor mode, as described in Entering ROM Monitor Mode.

Step 2 Set the configuration register of the standby DSDRSC to 0x0 so that the standby DSDRSC does not take control:

rommon 1> confreg 0x0

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


Step 3 Set the DSDRSC configuration register to 0x2102:

rommon 1 > confreg 0x2102
 
   

Step 4 Enter the set command to display the current environment variable settings:

rommon 2 > set
 
   

Note the filename set in the BOOT variable.

Step 5 Enter the boot command using the following command syntax:

boot image -a config-file-path

Replace image with the filename listed in the BOOT variable, and replace config-file-path with the path and filename for the configuration file. Example:

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

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


Although this command causes the SDR to boot from an alternative configuration, the system reverts to the default committed configuration on the next reload.

Step 6 Set the configuration register of the standby DSDRSC to 0x102:

rommon 1> confreg 0x102
 
   

Step 7 Reset the standby DSDRSC so that the new setting can take effect and the standby DSDRSC becomes operational:

rommon 2 > reset
 
   

Specifying a Permanent SDR Configuration File with the IOX_CONFIG_FILE= Variable

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 ROMMON mode. Specifying the variable forces the use of the specified file for all boots while this variable is set.


Step 1 Place the DSDRSC and the standby for it in ROM Monitor mode, as described in Entering ROM Monitor Mode.

Step 2 Set the configuration register of the standby DSDRSC to 0x0 so that the standby DSDRSC does not take control:

rommon 1> confreg 0x0

Note The configuration register is not an environment variable like TURBOBOOT (which is described earlier in this chapter). Do not enter an equal sign when entering the confreg command.


Step 3 Set the DSDRSC configuration register to 0x2102:

rommon 1 > confreg 0x2102
 
   

Step 4 Enter the set command to display the current environment variable settings:

rommon 2 > set
 
   

Step 5 Note the filename set in the IOX_CONFIG_FILE variable.

Step 6 To define the path to a different SDR configuration file, set the IOX_CONFIG_FILE variable using the following syntax:

rommon B1> IOX_CONFIG_FILE=drive:path/file
 
   

Step 7 To save the change, enter the sync command as follows:

rommon B1> sync
 
   

Step 8 Boot the router with the following command:

rommon B1> boot
 
   

Step 9 Set the configuration register of the standby DSDRSC to 0x102:

rommon 1> confreg 0x102
 
   

Step 10 Reset the standby DSDRSC so that the new setting can take effect and the standby DSDRSC becomes operational:

rommon 2 > reset
 
   


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


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 ROMMON mode. Specifying the variable forces the use of the specified location while this variable is set.


Step 1 Place the DSDRSC and the standby DSDRSC in ROM Monitor mode, as described in Entering ROM Monitor Mode.

Step 2 Set the configuration register of the standby DSDRSC to 0x0 so that the standby DSDRSC does not take control:

rommon 1> confreg 0x0
 
   

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


Step 3 Set the DSDRSC configuration register to 0x2102:

rommon 1 > confreg 0x2102
 
   

Step 4 Enter the set command to display the current environment variable settings:

rommon 2 > set
 
   

Step 5 Note the filename set in the IOX_CONFIG_MEDIUM variable.

Step 6 To specify a different location, set the IOX_CONFIG_MEDIUM variable using the following syntax:

rommon B1> IOX_CONFIG_MEDIUM=/location:/path/
 
   

For the Cisco CRS-1, replace location with disk0 or disk1. Replace path 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 7 To save the change, enter the sync command as follows:

rommon B1> sync
 
   

Step 8 Boot the router with the following command:

rommon B1> boot
 
   

Step 9 Set the configuration register of the standby DSDRSC to 0x102:

rommon 1> confreg 0x102
 
   

Step 10 Reset the standby DSDRSC so that the new setting can take effect and the standby DSDRSC becomes operational:

rommon 2 > reset