Cisco IOS XR ROM Monitor Configuration Guide for the Cisco XR 12000 Series Router, Release 4.2.x
Managing Configuration Files in ROM Monitor
Downloads: This chapterpdf (PDF - 1.24MB) The complete bookPDF (PDF - 2.8MB) | Feedback

Managing Configuration Files in ROM Monitor

Managing Configuration Files in ROM Monitor

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

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 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:


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.


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.


Note


When 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.   
    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 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 boot image –o config-file-path


    Example:
    rommon 3> boot tftp://223.255.254.254/images/c12k-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.


    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.

    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.   
      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.


      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.


      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.


      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.

      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.   
        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/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.

        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.


        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.

        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.   
          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.   
            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 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 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