The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter provides information about managing configuration files in the router.
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 the Cisco IOS XR System Management Configuration Guide for the Cisco XR 12000 Series Router.
The following sections describe ways to manage the use of configuration files from ROM Monitor:
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.
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.
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.
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.
Note | When 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.
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 | Place the DSC and the standby DSC in 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.
| ||
Step 3 | confreg 0x102 Example: rommon 1 > confreg 0x102 | |||
Step 4 | set Example: rommon 2 > set | Displays the current environment variable settings.
| ||
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.
| ||
Step 6 | sync Example: rommon B1> sync | |||
Step 7 | boot Example: rommon B1> boot | |||
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. |
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.
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 for the Cisco XR 12000 Series Router . |
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. |
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.
Note | When 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.
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 | Place the DSDRSC and the standby DSDRSC in 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.
| ||
Step 3 | confreg 0x102 Example: rommon 1 > confreg 0x102 | |||
Step 4 | set Example: rommon 2 > set | Displays the current environment variable settings.
| ||
Step 5 | boot image –a config-file-path Example: rommon 3> boot tftp://223.255.254.254/images/c12k-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.
| ||
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. |
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.
Note | When 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.
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 | Place the DSDRSC and the standby DSDRSC in 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.
| ||
Step 3 | confreg 0x102 Example: rommon 1 > confreg 0x102 | |||
Step 4 | set Example: rommon 2 > set | Displays the current environment variable settings.
| ||
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.
| ||
Step 6 | sync Example: rommon B1> sync | |||
Step 7 | boot Example: rommon B1> boot | |||
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. |
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.
1. Place the DSDRSC and the standby DSDRSC in ROM Monitor mode.
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 | Place the DSDRSC and the standby DSDRSC in 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.
| ||
Step 3 | confreg 0x102 Example: rommon 1 > confreg 0x102 | |||
Step 4 | set Example: rommon 2 > set | Displays the current environment variable settings.
| ||
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.
| ||
Step 6 | sync Example: rommon B1> sync | |||
Step 7 | boot Example: rommon B1> boot | |||
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. |
The following sections provide references related to the ROM Monitor.
Configuring Secure Domain Routers on Cisco IOS XR Software module of Cisco IOS XR System Management Configuration Guide for the Cisco XR 12000 Series Router |
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. |