Cisco IOS XR ROM Monitor Guide, Release 3.4 - Managing Configuration Files in ROM Monitor [Cisco IOS XR Software]

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

	Cisco IOS XR ROM Monitor Guide, Release 3.4
	Managing Configuration Files in ROM Monitor
Cisco IOS XR ROM Monitor Guide, Release 3.4 Preface ROM Monitor Overview and Basic Procedures Router Recovery with ROM Monitor Managing Configuration Files in ROM Monitor Password Recovery in ROM Monitor Mode Upgrading and Downgrading ROM Monitor Firmware on Cisco CRS-1 Routers Upgrading and Downgrading Boothelper and ROM Monitor on Cisco XR 12000 Series Routers Index	Download this chapter Managing Configuration Files in ROM Monitor Download the complete book Book-level PDF: Cisco IOS XR ROM Monitor Guide (PDF - 1 MB) 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
	© 1992-2009 Cisco Systems, Inc. All rights reserved. Terms & Conditions \| Privacy Statement \| Cookie Policy \| Trademarks of Cisco Systems, Inc.