To define the configuration register boot value, use the config-register command in the appropriate mode.

Command Default

By default, the configuration register value is 0x102 after a Turboboot.

Command Modes

Administration EXEC

EXEC mode

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

The configuration register setting is a 16-bit, user-configurable value that determines how the route processor (RP) functions during initialization. The configuration register can cause the RP to boot normally from the default configuration, or to enter ROMMON mode during a reload. Configuration register settings can also be used to perform tasks such as password recovery.

The config-register command is entered in administration EXEC mode, on the designated shelf controller (DSC) of the system. The DSC is the primary RP of the owner secure domain router (owner SDR).

When you have two RPs (Primary RP0 and Standby RP1) and the config-registers of the two are different, you must manually set the config-register in RP1 equal to RP0 in order for RP1 to synchronize with the configurations on RP0.

Use the show variables boot command in the EXEC mode to see status of the config-register in both the RPs.

Use the config-registerxlocationx command in the Admin mode to change the config-register in either of the RPs.

When setting the configuration register value for the config-register command, note the following conditions:

• If both the primary and standby DSC are up and running when the configuration register value is set, the configuration register value applies to both the primary and standby DSC.

• By contrast, if only the primary DSC is up and running when the configuration register value is set and the standby DSC is introduced into the router at a later time, the router does not attempt to synchronize the configuration register value for the standby RP to that of the active RP; in this situation, the configuration register setting applied to the standby DSC is determined by the configuration register value set in ROMMON mode.

• To set the configuration register value for all RPs in a multishelf system, enter the config-register value location all command. Enter the config-register command with the value argument to set the configuration register setting for the DSC (DSDRSC of the owner SDR).

To configure disk mirroring on a node, use the mirror command in global configuration mode. To disable disk mirroring, use the no form of this command.

Command Default

None

Command Modes

Global configuration

Command History

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

The mirror command replicates all critical data contained in the primary partition of the primary boot device, onto a second storage device on the same RP. Therefore, if the primary boot device fails, applications continue to be serviced transparently by the secondary device, without having to switch control to a standby RP.

Before the mirror command can be used, the secondary storage device must be partitioned using the format command. If the primary boot device is not partitioned, once mirroring is enabled and all data on the primary boot device is replicated to the secondary device, the primary boot device is partitioned automatically. This guarantees that only critical data on the primary boot device is mirrored to the secondary device. Noncritical data, such as logging data, should not be mirrored and should, therefore, be saved to the secondary partition on the storage device.

To temporarily suspend disk mirroring without changing the configuration, use the mirror pause command in EXEC mode.

Task ID

To temporarily pause disk mirroring on a node, use the mirror pause command in EXEC or administration EXEC mode.

Command Default

If no node is specified, disk mirroring is paused on the active RP.

Command Modes

EXEC

Administration EXEC

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

The mirror pause command temporarily pauses the mirroring of the primary boot device. This command is primarily useful during an installation operation to prevent significant performance degradation on single CPU boards. The mirror pause command does not change the configured state of mirroring, but rather causes the mirroring to be suspended until the mirror resume command is used.

The mirror pause command has no affect if the mirror configuration command is not enabled.

To resume disk mirroring on a node after it has been temporarily stopped, use the mirror resume command in EXEC or administration EXEC mode.

Command Modes

EXEC

Administration EXEC

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

The mirror resume command resumes the mirroring of the primary boot device after it has been temporarily paused with the mirror pause command.

The mirror resume command has no affect if the mirror configuration command is not enabled and the mirror pause command has not been used.

To verify disk synchronization for disk mirroring on a node, use the mirror verify command in EXEC or administration EXEC mode.

Command Default

If no node is specified, the verification is done on the active RP.

Command Modes

EXEC

Administration EXEC

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

The mirror verify command verifies the synchronization consistency between the primary and secondary media devices being used in mirroring. The command verifies that the full contents are identical between the mirrored devices and reports any inconsistencies found.

To reload the designated secure domain router shelf controller (DSDRSC), use the reload command in EXEC mode.

Syntax Description

This command has no keywords or arguments.

Command Default

No default behavior or values

Command Modes

EXEC

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the reload command to cause the DSDRSC to reload the Cisco IOS XR software according to the configuration register setting (for example, 0x0 to enter ROMMON mode and 0x2 to reload the RP to EXEC mode). If a standby DSDRSC is in the ready redundancy state, the reload command also causes the router to fail over to the standby DSDRSC . Use the show redundancy command in EXEC mode to display the status of the standby RP.

When the reload command is used and a switchover occurs, the running (active) software configuration is automatically maintained during switchover.

Caution

If a standby RP is not installed or is not in the ready state, then the router experiences a loss of service while the active RP is reloading Cisco IOS XR software. To view the status of the standby RP, issue the show redundancy command in EXEC mode.

If you use the reload command and there is no available standby node, you are prompted to continue with the reload:

RP/0/RP0/CPU0:router# reload

Standby card not present or not Ready for failover. Proceed?[confirm]y         
  

To reload a node or all nodes on a single chassis or multishelf system, use the reload command in the appropriate mode.

Command Default

None

Command Modes

Administration EXEC

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Note

Before reloading nodes on the router, we recommend using the cfs check command to check the sanity of the configuration file system and attempt to recover from internal inconsistencies. Enter the cfs check command on each secure domain router (SDR) that has nodes impacted by the reload. If you enter the reload location all command, run the cfs check command on every SDR in the system before reloading the router.

To reload all the nodes in all chassis in a multishelf system, use the reload command with the location all keywords.

To reload all the nodes in a specific chassis, use the reload command with the rack rack-number keyword and argument. This command cannot be used to reload the DSC line card chassis (rack 0).

To reload a specific node on the router, specify the reload command with the location node-id keyword and argument. The node-id is expressed in the rack/slot/module notation.

Command Default

All traces from all trace files from all RP nodes are displayed in time order, starting with the oldest traces.

Command Modes

Administration EXEC

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

The show epm trace boot command provides a simple way of tracking and time-stamping critical events to clearly understand their temporal relationship to one another and the amount of time spent performing critical operations. The command displays a merged output from a set of trace files.

To display disk mirroring information, use the show mirror command in EXEC or administration EXEC mode.

Command Default

No default behavior or values

Command Modes

EXEC

Administration EXEC

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Command Default

None

Command Modes

EXEC

Administration EXEC

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

The history keyword for the show reboot command displays all reboot causes stored for previous node resets.

Crash information ( crashinfo ), syslog, and kernel dumper ltrace ( trace ) can be displayed for the first or last reboot if it is an ungraceful reboot.

To display the system backup details and history, use the show system backup command in EXEC or administration EXEC mode.

Command Default

Enter the show system backup command without keywords or arguments to display the date, time, and status of the last backup for the current designated secure domain router shelf controller (DSDRSC). This command also displays the configured primary and secondary boot devices.

Command Modes

EXEC

Administration EXEC

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the show system backup command to display details of the current system backup on a local storage device. The command displays information about the backup performed for the active RP to which you are logged in, including the date, time, and status of the last backup.

• Use the target-device argument to display backup information for a specified device on a RP node.

• Use the details keyword to list information about the software packages and configuration files stored on the backup device.

• Use the diff keyword to display the differences between the software and configurations on the backup device and the software and configurations on the currently active boot disk.

• Use the location node-id keyword and argument to display information for a backup on a specific node. Use the location all keywords to display information for backups on all nodes in the system.

Various Command Modes

• To display information for the current secure domain router (SDR), enter the show system backup command in the EXEC mode of that SDR.

• When the command is entered in administration EXEC mode, the backup information for the owner SDR is displayed.

Command Default

No default behavior or values

Command Modes

Administration EXEC

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the show variables boot command to display system boot variables for the router. This command displays the configuration register setting and boot file setting for the RPs in the system. Use the location node-id keyword and argument to display the configuration register setting for a specific card.

The configuration register setting is set with the config-register command. The boot variable is set in ROM Monitor mode. For more information about ROM Monitor mode, see Cisco IOS XR ROM Monitor Guide for the Cisco CRS Router.

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

EXEC

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the show variables system command to display system environmental variables for the router.

To display the configuration register setting, use the show variables boot command in administration EXEC mode.

To back up the system software and configurations to a backup disk, use the system backup command in EXEC or administration EXEC mode.

Command Default

The operation is performed in synchronous mode.

The backup files are copied to the secondary device defined with the system boot-sequence command.

The backup files are copied to the target device on the current designated secure domain router shelf controller (DSDRSC).

Command Modes

EXEC

Administration EXEC

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Note	The system backup command does not make any changes to bootflash content.

Target Device for the Backup

Use the system boot-sequence command with the target-device argument to specify the local storage device for backup software and configuration files. The target-device argument is optional and applies only to the current backup operation.

• If a target storage device is not specified, then the files are backed up to the secondary storage device defined with the system boot-sequence command.

• If a target device is not specified with either the system backup command or the system boot-sequence command, then the backup operation is not allowed.

The target-device can be any local storage device except the current boot device, and must be large enough to store the current software set and configuration. Supported storage devices are:

• disk0:

• disk1: (if installed)

Location Node of the Target Device

By default, the backup is created on the specified target device of the active DSDRSC where the command is executed.

• To specify an alternate node for the system backup, such as the standby DSDRSC, use the system backup command with the location node-id keyword and argument.

• To perform the backup on all installed route processors (RPs), use the system backup command with the location all keywords in EXEC mode.

• To perform the backup on all RPs in all SDRs installed in the system, use the system backup command with the location all keywords in administration EXEC mode.

Note	Each RP or distributed route processor (DRP) impacted by the system backup command must contain the specified target device. For example, if the system backup command is executed for disk1: on all RPs in the system, then a flash disk must be installed in disk1: of each RP.

Various Command Modes

• Use the system backup command in administration EXEC mode to back up the administration plane configuration, including software and configurations for all SDRs in the system.

• Use the system backup command in the EXEC mode of an SDR to back up the software and configurations for a specific SDR.

Commit and Installation Operations Not Allowed During Backup

• Configuration changes are not allowed during the backup process. Any attempts to commit configuration changes are rejected until the backup operation is complete.

• The backup process cannot be performed during an installation operation. If an installation operation is performed while a backup is in process, the backup operation terminates.

Displaying the Current Backup Information

Enter the show system backup command to display information about the current backup files. If no backup exists, an error message is displayed.

To define the order of local storage devices used to boot a router, use the system boot-sequence command in EXEC or administration EXEC mode.

Command Default

The primary device is disk0:. The (optional) secondary boot device is not defined.

Command Modes

EXEC

Administration EXEC

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the system boot-sequence command to define the local storage devices used to boot a router. You can define two devices with this command.

• The value of the primary-device argument defines the default device where software packages are installed and run. This device is also the default location for router configurations.

• The value of the secondary-device argument defines the device used by the system backup command to back up system software and configurations. This field is optional.

• The secondary device can also be temporarily defined when the system backup command is executed with the target-device argument. Use the system boot-sequence command with the secondary-device argument to permanently define the secondary (backup) device.

Note	The primary and secondary device definitions remain in effect until the system boot-sequence command is entered again.

General Guidelines

• The value of the secondary-device argument must be different from the value of the primary-device argument.

• We recommend disk0: as the primary boot device in the boot sequence, and disk1: as the secondary boot device.

• The boot device specified with the system boot-sequence command must be installed in the card or the command is rejected.

Command Mode Options

• Use the system boot-sequence command in administration EXEC mode to define the boot sequence for all secure domain routers (SDRs) in the system.

• Use the system boot-sequence command in EXEC mode to define the boot sequence for a specific SDR.

Location Node

• Use the location node-id keyword and argument to define the boot sequence for a specific route processor (RP) .

• Use the location all keywords to define the boot sequence for all RPs in the SDR. Use this command in administration EXEC mode to define the boot sequence for all RPs in all SDRs.

Disabling Automatic Recovery

Use the system boot-sequence command with the disable keyword to disable the automatic recovery.

Displaying the Current Boot Sequence Settings

Enter the show system backup command to display the currently configured boot sequence devices.