Hardware Redundancy and Node Administration Commands on the Cisco IOS XR Software
This module describes the commands used to manage the hardware
redundancy, power, and administrative status of the nodes on a router running
Cisco IOS XR software.
To define the serial ID for a rack, use the dsc serial command in administration configuration mode. To remove a serial ID entry from the designated shelf controller (DSC) table, use the no form of this command.
dscserialserial_idrackrack_num
nodscserialserial_idrackrack_num
Syntax Description
serial_id
Serial ID for a rack. The serial ID is included as an entry in the DSC table. Range is from 0 through 16 characters.
rackrack_num
Identifies the rack whose ID you are configuring to be the serial ID.
Note
For systems that include two line card chassis and one fabric chassis, the line card chassis IDs are 0 and 1, and the fabric chassis ID is F0.
Command Default
No default behavior or values
Command Modes
Administration configuration
Command History
Release
Modification
Release 2.0
This command was introduced.
Release 3.3.0
The task ID was updated to system.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
For more information about identifying and selecting a DSC on your router, see
Cisco IOS XR Getting Started Guide for the Cisco CRS Router.
Note
The serial ID is the hardware serial number that identifies the chassis.
Use the show running-config command to display and verify the defined serial ID for a rack.
Task ID
Task ID
Operations
system
read, write
Examples
The following example shows how to define the serial ID for a rack:
RP/0/RP0/CPU0:router# adminRP/0/RP0/CPU0:router(admin)# configureRP/0/RP0/CPU0:router(admin-config)# dsc serial TBC0610991700000 rack 1
Displays the current DSC configuration for the shelf or for the system.
showrunning-config
Displays the current running (active) configuration.
env disable
To disable environment monitoring on the chassis, use the envdisable command in administration configuration mode. To reenable environment monitoring after it has been disabled, use the no form of this command.
envdisable
noenvdisable
Syntax Description
This command has no keywords or arguments.
Command Default
Environment monitoring is enabled.
Command Modes
Administration configuration
Command History
Release
Modification
Release 2.0
This command was introduced.
Release 3.2
The env disable command was moved from the root-system task ID to the system task ID.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
By default, environment monitoring related to temperature and voltage is enabled on a router running
Cisco IOS XR software. If environmental monitoring is disabled, you are not alerted if the router overheats.
Task ID
Task ID
Operations
system
read, write
Examples
The following example shows how to disable environment monitoring with the envdisable command:
To disable power supply monitoring on the chassis, use the envpower-supplydisable command in administration configuration mode. To disable power supply monitoring, use the no form of this command.
envpower-supplydisable
noenvpower-supplydisable
Syntax Description
This command has no keywords or arguments.
Command Default
Power supply monitoring is enabled.
Command Modes
Administration configuration
Command History
Release
Modification
Release 2.0
This command was introduced.
Release 3.3.0
The env power-supply command was moved from the root-system task ID to the system task ID.
The threshold {restartvoltage | shutdownvoltage} keywords and arguments were added to the env power-supply command.
Release 3.4.1
The threshold {restartvoltage | shutdownvoltage} keywords and arguments were removed, and the command was changed to env power-supply disable.
Power supply monitoring was enabled by default.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID
Task ID
Operations
system
read, write
Examples
The following example shows how to disable power supply monitoring with the envpower-supplydisable command:
To enable the automatic upgrade of FPD images during a software upgrade, use the fpd auto-upgrade command in administration configuration mode. To disable automatic FPD upgrades, use the
no
form of this command.
fpd auto-upgrade
Syntax Description
This command has no keywords or arguments.
Command Default
FPD images are not automatically upgraded.
Command Modes
Administration configuration
Command History
Release
Modification
Release 4.0.1
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
By default automatic upgrades of the FPD images are not performed during a software upgrade. Once the fpd auto-upgrade command is enabled, when you upgrade the software and an FPD upgrade is required, the FPD upgrade is done automatically before the router is rebooted. The automatic FPD upgrade works only if the FPD image is upgraded together with the mini installation PIE. For example, use the install add and install activate commands as shown here:
Adds the contents of a PIE file to a storage device.
hw-module boot override
To place the standby RP into ROM Monitor mode so that you can update the ROMMON software in a single chassis system to a compatible ROM Monitor version, use the hw-modulebootoverride command in administration configuration mode. To remove an RP from ROM Monitor mode, use the no form of this command.
hw-modulebootoverride
nohw-modulebootoverride
Command Default
No default behavior or values
Command Modes
Administration configuration
Command History
Release
Modification
Release 3.3.0
This command was introduced.
Release 3.9.0
This command was deprecated.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Note
This command is deprecated as of Cisco IOS XR Release 3.9.0.
Before you can upgrade a single-chassis system from a release of Cisco IOS XR software prior to Release 3.3.0, you need to first upgrade the ROM Monitor software to a compatible version. If you do not perform this upgrade in a single-chassis system, the standby RP fails to boot and an error message appears. To avoid boot failure, you need to use the hw-modulebootoverride command to place the standby RP into ROM Monitor mode, and update the ROMMON software as required.
For ROM Monitor requirements, refer to the Software/Firmware Compatibility Matrix at the following URL:
Displays information and status for each node in the system.
hw-module location
To configure various hardware attributes for a specific node, or for all nodes installed in the router, use the hw-modulelocation command in EXEC or administration EXEC mode.
Slot whose hardware attributes you want to configure. The node-id is expressed in the notation rack/slot/*.
Note
Enter the showplatform command to see the location of all nodes installed in the router.
maintenance-mode
Brings the node down and puts the node into maintenance mode.
reload
Resets power-cycle, reloads hardware, or both on a specific node.
path
Specific image you want to download onto the specific node or nodes. Replace path with the TFTP or disk path to the image you want to download.
Command Default
No default behavior or values
Command Modes
EXEC
Administration EXEC
Command History
Release
Modification
Release 3.3.0
This command was introduced.
Release 3.4.0
The maintenance-mode keyword was added in EXEC mode.
Release 4.1.0
The warm reload option was removed.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
To reset a specific node, or to put a node into maintenance mode, use the hw-modulelocation command in EXEC mode.
To reset a specific node or all nodes, use the hw-modulelocation command in administration EXEC mode.
Starting with Cisco IOS XR Release 4.0.1, it is recommended to use the partially qualified node ID in the hw-module location command. Specify an entire slot using the notation rack/slot/*.
Note
Before reloading nodes, we recommend using the cfscheck command to check the sanity of the configuration file system and attempt to recover from internal inconsistencies. You need to enter the cfscheck command on each secure domain router (SDR) that has nodes impacted by the reload.
Task ID
Task ID
Operations
root-lr
execute (in EXEC mode)
sysmgr
execute (in EXEC mode and administration EXEC mode)
Examples
The following example shows how to reset the hardware on a specific node from EXEC mode:
To disable the node power-on feature on a specific line card, use the hw-modulepowerdisable command in administration configuration mode. To reenable the node power-on feature on a line card, use the no form of this command.
hw-modulepowerdisablelocationnode-id
nohw-modulepowerdisablelocationnode-id
Syntax Description
locationnode-id
Identifies the node whose power-on feature you want to disable. The node-id argument is expressed in the rack/slot/module notation.
Command Default
Power is on for all nodes.
Command Modes
Administration configuration
Command History
Release
Modification
Release 3.3.0
This command was introduced.
Release 3.9.0
The option to use this command without the disable keyword was removed.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Use the showplatform command to view a summary of the nodes in the router, including status information.
The hw-modulepowerdisable command is available for line cards only; it is not available for RP cards.
Task ID
Task ID
Operations
sysmgr
read, write
root-lr
read, write
Examples
The following example shows how to disable the node power-on feature on a line card:
RP/0/RP0/CPU0:router# adminRP/0/RP0/CPU0:router(admin)# configureRP/0/RP0/CPU0:router(admin-config)# hw-module power disable location 0/0/CPU0
Displays information and status for each node in the system.
hw-module reset auto
To reset a specific node, use the hw-moduleresetauto command in administration configuration mode. To disable the reset feature on a specific node, use the no form of this command.
hw-moduleresetauto [disable] locationnode-id
nohw-moduleresetauto [disable] locationnode-id
Syntax Description
disable
Disables the node reset feature on the specified node.
locationnode-id
Identifies the node you want to reload. The node-id argument is entered in the rack/slot/module notation.
Command Default
The node reset feature is enabled for all nodes.
Command Modes
Administration configuration
Command History
Release
Modification
Release 3.3.0
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The hw-moduleresetauto command is used to reload
Cisco IOS XR software on a specific node. The node reloads with the current running configuration and active software set for that node.
Task ID
Task ID
Operations
root-system
read, write
root-lr
read, write
Examples
The following example shows how to reload a node:
RP/0/RP0/CPU0:router# adminRP/0/RP0/CPU0:router(admin)# configureRP/0/RP0/CPU0:router(admin-config)# hw-module reset auto location 0/2/CPU0
RP/0/RP0/CPU0:router# RP/0/RP0/CPU0:Apr 2 22:04:43.659 : shelfmgr[294]:
%S HELFMGR-3-USER_RESET : Node 0/2/CPU0 is reset due to user reload request
To configure the router to take a specific node into maintenance mode in the event of disaster recovery, use the hw-moduleservicemaintenance-modelocation command in global configuration mode. To reset this configuration, use the no form of the command.
hw-moduleservicemaintenance-modelocationnode-id
nohw-moduleservicemaintenance-modelocationnode-id
Syntax Description
node-id
Location of the service card that you want to move into offline mode. The node-id argument is entered in the rack/slot/module notation.
Command Default
In case of disaster recovery, the router reloads a failed line card if MDR is unsuccessful, and does not put the line card in maintenance mode.
Command Modes
Global configuration
Command History
Release
Modification
Release 3.4.1
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
In the event that a line card fails, the router attempts to restart all the processes on the line card without disrupting the traffic flow. This is called a Minimum Disruptive Restart (MDR). If the MDR does not recover the line card, the router reloads the line card. You can configure the router to place the line card into maintenance mode after an unsuccessful MDR, instead of reloading it. Use the hw-moduleservicemaintenance-modelocation command to configure the router to take a specified line card into maintenance mode after an unsuccessful MDR, instead of reloading the line card.
Maintenance mode is a mode in which only the processes that are required for collecting useful data for debugging run.
Task ID
Task ID
Operations
root-lr
read, write
Examples
The following example shows how to move the card at 0/1/CPU0 into maintenance mode:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# hw-module service maintenance-mode location 0/1/CPU0
To configure offline mode as the role for a specific node, use the hw-moduleserviceofflinelocation command in global configuration mode. To disable offline mode, use the no form of the command.
hw-moduleserviceofflinelocationnode-id
nohw-moduleserviceofflinelocationnode-id
Syntax Description
node-id
Location of the service card that you want to move into offline mode. The node-id argument is entered in the rack/slot/module notation.
Command Default
No default behavior or values
Command Modes
Global configuration
Command History
Release
Modification
Release 3.4.0
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Offline mode disables all configured service instances on a service card. If there is a service active on the service card, the service switches over to a standby location if a standby is configured.
Task ID
Task ID
Operations
root-lr
read, write
Examples
The following example shows how to move the card at 0/1/CPU0 into offline mode:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# hw-module service offline location 0/1/CPU0
hw-module subslot reload
To reload
Cisco IOS XR software on a specific subslot, use the hw-modulesubslotreload command in EXEC mode.
hw-modulesubslotsubslot-idreload
Syntax Description
subslot-id
Specifies the subslot to be restarted. The subslot-id argument is entered in the rack/slot/subslot notation.
Command Default
No default behavior or values
Command Modes
EXEC
Command History
Release
Modification
Release 3.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
This command reloads
Cisco IOS XR software on the specified shared port adapter (SPA) and restarts the SPA interfaces. The SPA reloads with the current running configuration and active software set for the SPA.
Task ID
Task ID
Operations
root-lr
read, write
Examples
The following example shows how to restart the SPA in slot 2, subslot 1:
To administratively shut down a specific shared port adapter (SPA), use the hw-modulesubslotshutdown command in global configuration mode. To return a SPA to the up state, use the no form of this command.
Specifies the subslot to be shut down. The subslot-id argument is entered in the rack/slot/subslot notation.
powered
(Optional) Retains power to the specified subslot.
unpowered
(Optional) Powers down completely the specified subslot.
Command Default
Shutdown is powered if no option is specified.
Command Modes
Global configuration
Command History
Release
Modification
Release 3.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
This command administratively shuts down the SPA in the specified subslot. Subslots that are shut down still have power but cannot load or operate
Cisco IOS XR software.
Task ID
Task ID
Operations
root-lr
read, write
Examples
The following example shows how to shut down the SPA in subslot 1 of the SPA interface processor (SIP) in slot 2:
Disables an interface (forces an interface to be administratively down).
redundancy switchover
To cause the primary (active) route processor (RP) to fail over to the redundant standby RP, use the redundancyswitchover command in EXEC or administration EXEC mode. To disable the forced switchover, use the no form of this command.
redundancyswitchover
[ locationnode-id ]
noredundancyswitchover
[ locationnode-id ]
Syntax Description
locationnode-id
(Optional) Specifies the primary RP on which to force a switchover. The node-id argument is expressed in the rack/slot/module notation.
Command Default
No default behavior or values
Command Modes
EXEC
Administration EXEC
Command History
Release
Modification
Release 2.0
This command was introduced.
Release 3.3.0
The redundancy switchover command was moved from the system task ID to the root-lr task ID.
Release 3.5.0
This command was supported in administration EXEC mode.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Use the redundancyswitchover command to trigger a switchover from the primary RP to the standby RP. When the redundancyswitchover command is issued, the running (committed) configuration is automatically saved and loaded during switchover, and the standby RP becomes the active primary RP, while the original primary RP becomes the standby RP.
Note
The redundancyswitchover command can be used only if the standby RP is in the ready state. Use the show redundancy command to view the status of the RPs.
Task ID
Task ID
Operations
root-lr
read, write
Examples
The following example shows partial output for a successful redundancy switchover operation:
RP/0/RP0/CPU0:router# show redundancy
Redundancy information for node 0/RP0/CPU0:
==========================================
Node 0/RP0/CPU0 is in ACTIVE role
Partner node (0/RP1/CPU0) is in STANDBY role
Standby node in 0/RP1/CPU0 is ready
Reload and boot info
----------------------
RP reloaded Tue Mar 28 09:02:26 2006: 5 hours, 41 minutes ago
Active node booted Tue Mar 28 09:02:56 2006: 5 hours, 41 minutes ago
Last switch-over Tue Mar 28 09:09:26 2006: 5 hours, 34 minutes ago
Standby node boot Tue Mar 28 09:10:37 2006: 5 hours, 33 minutes ago
Standby node last went not ready Tue Mar 28 09:25:49 2006: 5 hours, 18 minutes
go
Standby node last went ready Tue Mar 28 09:25:51 2006: 5 hours, 18 minutes ago
There has been 1 switch-over since reload
....
RP/0/RP0/CPU0:router# redundancy switchover
Initializing DDR SDRAM...found 2048 MB
Initializing ECC on bank 0
...
Turning off data cache, using DDR for first time
Initializing NVRAM...
Testing a portion of DDR SDRAM ...done
Reading ID EEPROMs ...
Initializing SQUID ...
Initializing PCI ...
PCI0 device[1]: Vendor ID 0x10ee
Configuring MPPs ...
Configuring PCMCIA slots ...
--More--
If the standby RP is not in the ready state, the switchover operation is not allowed. The following example shows output for a failed redundancy switchover attempt:
RP/0/RP0/CPU0:router# show redundancy
This node (0/RP0/CPU0) is in ACTIVE role
Partner node (0/RP1/CPU0) is in UNKNOWN role
RP/0/RP0/CPU0:router# redundancy switchover
Standby card not running; failover disallowed.
To display the current designated shelf controller (DSC) configuration for the shelf or for the system, enter the showdsc command in administration EXEC mode.
showdsc
[ all | mine | locationnode-id ]
Syntax Description
all
Displays DSC information from all available nodes in the system.
mine
Displays information about the current node.
locationnode-id
Displays DSC information for a specific node. The node-id is expressed in the rack/slot/module notation.
Command Default
This command has no keywords or arguments.
Command Default
No default behavior or values
Command Modes
Administration EXEC
Command History
Release
Modification
Release 2.0
This command was introduced.
Release 3.3.0
The node keyword was replaced by the location keyword.
The show dsc command was moved from the root-system task ID to the system task ID.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
For more information about identifying and selecting a DSC on your router, see
Cisco IOS XR Getting Started Guide for the Cisco CRS Router.
Task ID
Task ID
Operations
system
read
Examples
The following example shows sample output from the showdsc command with the mine keyword.
RP/0/RP0/CPU0:router# admin
RP/0/RP0/CPU0:router(admin)# show dsc mine
Sun Jan 25 04:26:33.103 PST
NODE ROLE PRIORITY TBEACON PRESENT SERIAL ID
============================================================================
0/RP0/CPU0 DSC DEFAULT 300 YES TBA09160TBA
----------------------------------------------------------------------------
Table 1
show dsc Field Descriptions
Field
Description
NODE
Location of the node in the rack/slot/module notation.
ROLE
Role this node is performing.
PRIORITY
DSC priority assigned to this node.
TBEACON
Current DSC beacon timeout value.
PRESENT
Indicates whether the node is present in the slot.
SERIAL ID
Serial ID assigned to this node.
MIGRATION
Displays the current DSC migration functionality to the standby card. Can be one of the following:
ENABLE—Migration process is enabled
UNKNOWN—Migration configuration is unknown.
The following example shows sample output from the showdsc command with the all keyword:
RP/0/RP0/CPU0:router#admin
RP/0/RP0/CPU0:router(admin)#show dsc all
NODE ROLE PRIORITY TBEACON PRESENT SERIAL ID
============================================================================
0/RP0/CPU0 DSC DEFAULT 300 YES TBA09370035
----------------------------------------------------------------------------
0/RP1/CPU0 BACKUP DEFAULT 300 YES TBA09370035
----------------------------------------------------------------------------
0/4/CPU0 NON-DSC 65 300 YES TBA09370035
----------------------------------------------------------------------------
0/4/CPU1 NON-DSC 66 300 YES TBA09370035
----------------------------------------------------------------------------
(Optional) Displays system temperature information.
trace
(Optional) Displays trace data for environment monitoring.
voltages
(Optional) Displays system voltage information.
node-id
(Optional) Node whose information you want to display. The node-id argument is expressed in the rack/slot/module notation.
Command Default
All environmental monitor parameters are displayed.
Command Modes
EXEC
Administration EXEC
Command History
Release
Modification
Release 2.0
This command was introduced.
Release 3.3.0
The optional node-id argument was supported.
The show environment command was moved from the root-system task ID to the system task ID.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The show environment command displays information about the hardware that is installed in the system, including fans, LEDs, power supply voltage, and current information and temperatures.
Task ID
Task ID
Operations
system
read
Examples
The following example shows sample output from the show environment command with the temperatures keyword:
RP/0/RP0/CPU0:router# show environment temperatures
R/S/I Modules Inlet Exhaust Hotspot
Temperature Temperature Temperature
(deg C) (deg C) (deg C)
0/2/* host 31, 27 43, 45 48
cpu 31
fabricq0 46
fabricq1 44
ingressq 34
egressq 41 43
ingresspse 35
egresspse 42
plimasic 30, 31 42
0/RP1/* host 38 44
cpu 36
ingressq 42
fabricq0 43
0/SM0/* host 29, 29 41, 33
The following example shows sample output from the show environment command with the temperatures keyword on the Cisco CRS Series Modular Services Card 140G:
RP/0/RP0/CPU0:router(admin)# show environment tempuratures location 0/0/cpu0
Thu Oct 28 10:45:05.852 UTC
R/S/I Modules Inlet Exhaust Hotspot
Temperature Temperature Temperature
(deg C) (deg C) (deg C)
0/0/*
host 33, 31 48, 45 47, 48, 52,
38, 57, 47, 35
cpu 52, 36
plimasic 34 46 44, 42
Table 1
describes the significant fields shown in the display.
Table 2
show environment temperatures Field Descriptions
Field
Description
R/S/I
Rack number, slot number, and interface for which information is displayed, in the format rack/slot/module.
Modules
Module for which temperature information is displayed.
Inlet Temperature (deg C)
Current temperature of the inlet sensor, in degrees Celsius.
Note
The inlet temperature corresponds to the room air temperature entering the router.
Exhaust Temperature (deg C)
Current temperature of the exhaust sensor, in degrees Celsius.
Note
The exhaust temperature corresponds to the air being exhausted from the router.
Hotspot Temperature (deg C)
Current temperature of the hotspot, in degrees Celsius.
The following example shows sample output from the show environment command the with the leds keyword:
RP/0/RP0/CPU0:router# show environment leds
0/2/*: Module (host) LED status says: OK
0/2/*: Module (plimasic) LED status says: OK
0/SM0/*: Module (host) LED status says: OK
Table 2describes the significant fields shown in the display.
Table 3
show environment leds Field Descriptions
Field
Description
rack_num/slot_num/*:
Rack number and slot number where the node resides.
Module (host) LED status says:
Current LED status of the specified node.
The following example shows sample output from the show environment command the with the power-supply keyword:
RP/0/RP0/CPU0:router(admin)# show env power-supply
Thu Aug 5 00:18:29.492 DST
Power Supply Voltage Current
AC-REC AC-REC (V) (A)
Zone 1: [A], [B] 54.965, 54.181 3.447, 4.073
Zone 2: [A], [B] 54.671, 54.083 8.983, 8.670
Zone 3: [A], [B] 55.063, 54.279 3.865, 4.073
Total Current: 33.111 A
Total Power : 1804.049 W
Table 3 describes the significant fields shown in the display.
Table 4
show environment power-supply Field Descriptions
Field
Description
R/S/I
Rack number, slot number, and interface for which information is displayed, in the format PEM/Power Module/* (for example 0/PM0/*).
Modules
Module for which power information is displayed.
Capacity
Power capacity of each power module in Watts.
Status
Operational status of power modules.
Power Draw
Real (measured) power drawn from each power module.
Voltage
Real (measured) power module voltage.
Current
Real (measured) power module current draw.
Power Shelves Type
AC or DC.
Total Power Capacity
Sum of the power capacity of each of the modules installed in the chassis.
Usable Power Capacity
Sum of the power capacity of each of the powered and operational power modules installed in the chassis.
Supply Failure Protected Capacity
Protected power capacity of the chassis with power module
redundancy (ASR 9010 AC 3+3, ASR 9010 DC 5+1, ASR 9006 AC 2+1, ASR 9010 DC 2+1).
Feed Failure Protected Capacity
Feed protected power capacity. This value applies to the ASR 9010 AC system only.
Worst Case Power Used
Sum of the estimated power draw of each of the load modules in the
chassis. Load modules can be fan trays, RSPs and line cards.
Worst Case Power Available
Usable power capacity minus the worst case power used.
Supply Protected Capacity Available
Supply failure protected capacity minus the worst case power used.
Feed Protected Capacity Available
Feed failure protected capacity minus the worst case power used.
show fpd package
To display which shared port adapters
(SPA) and SPA interface processors (SIPs) are supported with your current Cisco IOS XR software release, which field-programmable device (FPD) image you need for each SPA and SIP, and
what the minimum hardware requirements are for the SPA and SIP modules, use the showfpdpackage command in administration EXEC mode.
showfpdpackage
Syntax Description
This command has no keywords or arguments.
Command Default
No default behavior or values
Command Modes
Administration EXEC
Command History
Release
Modification
Release 3.4.1
The show fpd package command output was updated to display the ROMMON
images.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
If there are multiple FPD images for your card, use the showfpdpackage command to determine which FPD image
to use if you only want to upgrade a specific FPD type.
Task ID
Task ID
Operations
sysmgr
read
Examples
The following example shows sample output from the
showfpdpackage command:
This table describes the significant fields shown in the display:
Table 5 show fpd package Field Descriptions
Field
Description
Card Type
Module part number.
FPD Description
Description of all FPD images available for the SPA.
Type
Hardware type. Possible types can be:
spa—Shared port
adapter
lc—Line card
Subtype
FPD subtype. These values are used in the
upgradehw-modulefpd command to indicate a specific FPD image type to
upgrade.
SW Version
FPD software version recommended for the associated module
running the current
Cisco IOS XR software.
Min Req SW Vers
Minimum required FPD
image software version to operate the card. Version 0.0 indicates that a minimum required image was not programmed into the card.
Min Req HW Vers
Minimum required hardware version for the associated FPD
image. A minimum hardware requirement of version 0.0 indicates that all
hardware can support this FPD image version.
Note
In the
showfpdpackage command output, the
“subtype” column shows the FPDs that correspond with each SPA
image. To upgrade a specific FPD with the
upgradehw-modulefpd command, replace the
fpga-type
argument with the appropriate FPD from the
“subtype” column, as shown in the following example:
Manually upgrades the current FPD image package on a module.
show hw-module fpd
To display field-programmable device
(FPD) compatibility for all modules or a specific module, use the showhw-modulefpd command in the EXEC or administration EXE mode.
showhw-modulefpdlocation
{ node-id | all }
Syntax Description
location{node-id | all}
Specifies the location of the module. The node-id argument is expressed in the rack/slot/module notation. Use the all keyword to indicate all nodes.
Command Default
No default behavior or values
Command Modes
EXEC
Administration EXEC
Command History
Release
Modification
Release 3.4.0
The show hw-module fpd command output was updated to display the
ROMMON images.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID
Task ID
Operations
sysmgr
read
root-lr
read
Examples
The following example shows how to display FPD compatibility for all
modules in the router:
RP/0/RP0/CPU0:router# show hw-module fpd location all
===================================== ==========================================
Existing Field Programmable Devices
==========================================
HW Current SW Upg/
Location Card Type Version Type Subtype Inst Version Dng?
============ ======================== ======= ==== ======= ==== =========== ====
0/1/CPU0 CRS1-SIP-800 0.96 lc fpga 0 2.0 No
--------------------------------------------------------------------------------
0/1/0 SPA-4XOC3-POS 1.0 spa fpga 0 3.4 No
--------------------------------------------------------------------------------
0/1/5 SPA-8X1GE 2.2 spa fpga 5 1.8 No
--------------------------------------------------------------------------------
0/6/CPU0 CRS1-SIP-800 0.96 lc fpga 0 2.0 No
--------------------------------------------------------------------------------
0/6/0 SPA-4XOC3-POS 1.0 spa fpga 0 3.4 No
--------------------------------------------------------------------------------
0/6/4 SPA-8XOC3-OC12-POS 1.1 spa fpga 4 0.5 Yes
--------------------------------------------------------------------------------
0/6/5 SPA-8X1GE 2.2 spa fpga 5 1.8 No
--------------------------------------------------------------------------------
NOTES:
1. One or more FPD needs an upgrade or a downgrade. This can be accomplished
using the "admin upgrade hw-module fpd" CLI.
RP/0/RP0/CPU0:router# show hw-module fpd location 0/6/cpu0
Sun Apr 18 03:18:24.903 DST
===================================== ==========================================
Existing Field Programmable Devices
==========================================
HW Current SW Upg/
Location Card Type Version Type Subtype Inst Version Dng?
============ ======================== ======= ==== ======= ==== =========== ====
0/6/CPU0 CRS1-SIP-800 0.96 lc fpga1 0 6.00 No
lc rommonA 0 2.100 No
lc rommon 0 2.100 No
--------------------------------------------------------------------------------
If the cards in the system do not meet the
minimum requirements, the output contains a “NOTES” section that states how to
upgrade the FPD image.
Table 6 show hw-module fpd Field Descriptions
Field
Description
Location
Location of the module in the
rack/slot/module
notation.
Card Type
Module part number.
HW Version
Hardware model version for the module.
Type
Hardware type. Can be one of the following types:
spa—Shared port
adapter
lc—Line card
Subtype
FPD type. Can be one of the following types:
fabldr—Fabric
downloader
fpga1—Field-programmable gate array
fpga2—Field-programmable gate array 2
fpga3—Field-programmable gate array 3
fpga4—Field-programmable gate array 4
fpga5—Field-programmable gate array 5
rommonA—Read-only
memory monitor A
rommon—Read-only
memory monitor B
Inst
FPD instance. The FPD instance uniquely identifies an FPD and
is used by the FPD process to register an FPD.
Current SW Version
Currently running FPD image version.
Upg/Dng?
Specifies whether an FPD upgrade or downgrade is required. A
downgrade is required in rare cases when the version of the FPD image has
a higher major revision than the version of the FPD image in the current
Cisco IOS XR software package.
Displays which FPD image package is needed for the router to properly
support the modules for the running Cisco IOS XR software release. Also indicates all available FPD
images that are available for a specific module.
Manually upgrades the current FPD image package on a module.
show hw-module subslot brief
To display summary information related to a specified internal hardware device on a shared port adapter (SPA), use the showhw-modulesubslotbrief command in EXEC mode.
spi4—Displays system packet interface level 4.2 bus device information.
temperature-sensor—Displays temperature sensor information.
device-index
(Optional) Index of the specific device if there are multiple devices of the same type.
device-subindex
(Optional) Subindex of the specific device if there are multiple devices of the same device index.
Command Default
No default behavior or values
Command Modes
EXEC
Command History
Release
Modification
Release 3.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
You can also enter a partially qualified location specifier by using the wildcard (*) character. For example, 0/1/* would display information for all modules on slot 1 in rack 0.
Use the showhw-modulesubslotbrief command to obtain summary diagnostic information about a device on an interface on the SPA.
Task ID
Task ID
Operations
root-lr
read
Examples
The following example shows sample output for the showhw-modulesubslotbrief command:
Table 7 show hw-module subslot config Field Descriptions
Field
Description
SPA inserted
Indicates if a SPA is currently detected in the subslot.
SPA type
Description of SPA including the technology type, number of ports, height of SPA (HHSPA—single height, FHSPA—double height), and optics type.
SPA operational state
Current state of the SPA module.
SPA cfg admin up
Configured state of the SPA: YES—the SPA is not shut down; NO—the SPA is shut down.
show hw-module subslot config
To display information related to configuration of the specified internal hardware device on a shared port adapter (SPA), use the showhw-modulesubslotconfig command in EXEC mode.
spi4—Displays system packet interface level 4.2 bus device information.
temperature-sensor—Displays temperature sensor information.
device-index
(Optional) Index of the specific device if there are multiple devices of the same type.
device-subindex
(Optional) Subindex of the specific device if there are multiple devices of the same device index.
Command Default
No default behavior or values
Command Modes
EXEC
Command History
Release
Modification
Release 3.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
You can also enter a partially qualified location specifier by using the wildcard (*) character. For example, 0/1/* would display information for all modules on slot 1 in rack 0.
Use the showhw-modulesubslotconfig command to obtain diagnostic information about the configuration of an interface on the SPA.
Task ID
Task ID
Operations
root-lr
read
Examples
The following example shows sample output for the showhw-modulesubslotconfig command:
RP/0/RP0/CPU0:router# show hw-module subslot 0/6/cpu0 config
Thu Feb 19 00:33:02.921 PST
Subslot 0/6/0 config info:
------------------------
SPA inserted: YES
SPA cfg admin up: YES
SPA cfg power up: YES
Subslot 0/6/1 config info:
------------------------
SPA inserted: YES
SPA cfg admin up: YES
SPA cfg power up: YES
Subslot 0/6/2 config info:
------------------------
SPA inserted: NO
SPA cfg admin up: YES
SPA cfg power up: NO
Subslot 0/6/3 config info:
------------------------
SPA inserted: NO
SPA cfg admin up: YES
SPA cfg power up: NO
Subslot 0/6/4 config info:
------------------------
SPA inserted: NO
SPA cfg admin up: YES
SPA cfg power up: NO
Subslot 0/6/5 config info:
------------------------
SPA inserted: NO
SPA cfg admin up: YES
SPA cfg power up: NO
Table 8
show hw-module subslot config Field Descriptions
Field
Description
SPA inserted
Indicates if a SPA is currently detected in the subslot.
SPA cfg admin up
Configured state of the SPA: YES—the SPA is not shut down; NO—the SPA is shut down.
SPA cfg power up
Indicates whether the subslot is currently configured as powered or not.
Related Commands
Command
Description
showcontrollers
Displays the controller type and other information.
show hw-module subslot counters
To display statistics related to the processing of internal hardware devices for a shared port adapter (SPA), use the showhw-modulesubslotcounters command in EXEC mode.
spi4—Displays system packet interface level 4.2 bus device information.
temperature-sensor—Displays temperature sensor information.
device-index
(Optional) Index of the specific device if there are multiple devices of the same type.
device-subindex
(Optional) Subindex of the specific device if there are multiple devices of the same device index.
Command Default
No default behavior or values
Command Modes
EXEC
Command History
Release
Modification
Release 3.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
You can also enter a partially qualified location specifier by using the wildcard (*) character. For example, 0/1/* would display information for all modules on slot 1 in rack 0.
Use the showhw-modulesubslotcounters command to display statistics related to the processing by the specified internal hardware device.
Task ID
Task ID
Operations
root-lr
read
Examples
The following example shows sample output for the showhw-modulesubslotcounters command:
RP/0/RP0/CPU0:router# show hw-module subslot 0/1/cpu0 counters
Subslot 0/1/0 counts info:
------------------------
SPA inserted: YES
SPA type: 8xGE SPA
SPA operational state: READY
SPA insertion time: Wed Jan 14 11:33:24 2009
SPA last time ready: Wed Jan 14 11:33:37 2009
SPA uptime [HH:MM:SS]: 852:54:24
Subslot 0/1/1 counts info:
------------------------
SPA inserted: YES
SPA type: 5xGE SPA
SPA operational state: READY
SPA insertion time: Wed Jan 14 11:33:24 2009
SPA last time ready: Wed Jan 14 11:33:38 2009
SPA uptime [HH:MM:SS]: 852:54:23
--More--
Table 9
show hw-module subslot counters Field Descriptions
Field
Description
SPA inserted
Indicates if a SPA is currently detected in the subslot.
SPA type
Description of SPA including the technology type, number of ports, height of SPA (HHSPA—single height, FHSPA—double height), and optics type.
SPA operational state
Current state of the SPA module.
SPA insertion time
Time the SPA module was last physically inserted or power-cycled.
SPA last time ready
Time the SPA module last changed state to up or ready (the last time the module was loaded or reloaded).
SPA uptime
The time in service or amount of time since the module was last out of service due to a reload, power cycle, or configuration event.
The following example shows sample output for the showhw-modulesubslotcounters command with the framer keyword:
RP/0/RP0/CPU0:router# show hw-module subslot counters framer
SPA device framer index 0 subindex 0 info:
Milan Framer counters:
STREAM 0
Rx Bytes (48-bit) (#0x381fa078-0x883c): 163857232569448
Rx Good Bytes (48-bit) (#0x381fa080-0x8840): 1964924
Rx Good Packets (48-bit) (#0x381fa040-0x8820): 26234
Tx Byte Cnt Reg (48-bit) (#0x381fe070-0xa838): 9375380
Tx Good Bytes Cnt Reg (48-bit) (#0x381fe068-0xa834): 8909442
Tx Transmitted Packet Cnt Reg (48-bit) (#0x381fe040-0xa820): 114692
show hw-module subslot errors
To display error information about internal hardware devices for a shared port adapter (SPA), use the showhw-modulesubsloterrors command in EXEC mode.
spi4—Displays system packet interface level 4.2 bus device information.
temperature-sensor—Displays temperature sensor information.
device-index
(Optional) Index of the specific device if there are multiple devices of the same type.
device-subindex
(Optional) Subindex of the specific device if there are multiple devices of the same device index.
Command Default
No default behavior or values
Command Modes
EXEC
Command History
Release
Modification
Release 3.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
You can also enter a partially qualified location specifier by using the wildcard (*) character. For example, 0/1/* would display information for all modules on slot 1 in rack 0.
Use the showhw-modulesubsloterrors command to display error information related to the specified internal hardware device on a SPA.
Task ID
Task ID
Operations
root-lr
read
Examples
The following example shows partial sample output for the showhw-modulesubsloterrors command:
Table 10
show hw-module subslot errors Field Descriptions
Field
Description
Subslot */*/* errors info
SPA for which error information is being displayed. The location of the SPA is expressed in the rack/slot/module notation.
SPA inserted
Indication if a SPA is currently detected in the subslot.
SPA type
Description of SPA including the technology type, number of ports, height of SPA (HHSPA—single-height, FHSPA—double-height), and optics type.
SPA operational state
Current operational state of the SPA module.
SPA last reset reason
Reason for the most recent reset of this SPA.
SPA last failure reason
Reason for the last failure on this SPA.
Related Commands
Command
Description
showcontrollers
Displays the controller type and other information.
show hw-module subslot plim-subblock
To display SPA firmware information for a shared port adapter (SPA), use the showhw-modulesubslotplim-subblock command in EXEC mode.
showhw-modulesubslot [node-id] plim-subblock
Syntax Description
node-id
(Optional) Location for which to display the specified information. The node-id argument is entered in the rack/slot/module notation.
Command Default
No default behavior or values
Command Modes
EXEC
Command History
Release
Modification
Release 3.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Use the showhw-modulesubslotplim-subblock command to display SPA firmware information, both kernel and application information, as well as heartbeat and keepalive information. The showhw-modulesubslotplim-subblock command is mainly used for debugging purposes.
Task ID
Task ID
Operations
root-lr
read
Examples
The following example shows sample output for the showhw-modulesubslotplim-subblock command:
RP/0/0/CPU0:router# show hw-module subslot 0/5/0 plim-subblock
Subslot 0/5/0 Plim Subblock Info:
-------------------------------------
Firmware information:
SPA v4.10.1, ifs-spa_ppc_iox.elf
Application v3.44.0, spa_ct3_pat_apps_iox.tar.gz
SPA keepalive information:
Heartbeat check disabled : FALSE
Keepalive seq 372638, seen 372637, Time since last ipc keep 1s
Related Commands
Command
Description
showcontrollers
Displays the controller type and other information.
show hw-module subslot registers
To display register information about internal hardware devices for a shared port adapter (SPA), use the showhw-modulesubslotregisters command in EXEC mode.
spi4—Displays system packet interface level 4.2 bus device information.
temperature-sensor—Displays temperature sensor information.
device-index
(Optional) Index of the specific device if there are multiple devices of the same type.
device-subindex
(Optional) Subindex of the specific device if there are multiple devices of the same device index.
Command Default
No default behavior or values
Command Modes
EXEC
Command History
Release
Modification
Release 3.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Use the command to display the nodes on the router.
You can also enter a partially qualified location specifier by using the wildcard (*) character. For example, 0/1/* would display information for all modules on slot 1 in rack 0.
Use the showhw-modulesubslotregisters command to display register information for the specified internal hardware device on the SPA.
Task ID
Task ID
Operations
root-lr
read
Examples
The following example shows sample output for the showhw-modulesubslotregisters command:
Table 11
show hw-module subslot registers Field Descriptions
Field
Description
SPA hardware ID
SPA hardware identifier in hexadecimal format.
SPA SW FPGA rev.
SPA software field-programmable gate array (FPGA) revision number in hexadecimal format.
Related Commands
Command
Description
showcontrollers
Displays the controller type and other information.
show hw-module subslot status
To display status information about internal hardware devices for a shared port adapter (SPA), use the showhw-modulesubslotstatus command in EXEC mode.
showhw-modulesubslot [node-id] status
[ device
[ device-index [device-subindex] ] ]
Syntax Description
node-id
(Optional) Location for which to display the specified information. The node-id argument is entered in the rack/slot/module notation.
device
(Optional) Internal hardware device for which to display the specified information. Valid devices include:
spi4—Displays system packet interface level 4.2 bus device information.
temperature-sensor—Displays temperature sensor information.
device-index
(Optional) Index of the specific device if there are multiple devices of the same type.
device-subindex
(Optional) Subindex of the specific device if there are multiple devices of the same device index.
Command Default
No default behavior or values
Command Modes
EXEC
Command History
Release
Modification
Release 3.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
You can also enter a partially qualified location specifier by using the wildcard (*) character. For example, 0/1/* would display information for all modules on slot 1 in rack 0.
Use the showhw-modulesubslotstatus command to obtain status information about an interface on the SPA.
Task ID
Task ID
Operations
root-lr
read
Examples
The following example shows sample output for the showhw-modulesubslotstatus command with the temperature-sensor option:
RP/0/RP0/CPU0:router# show hw-module subslot 0/2/CPU0 status temperature-sensor
SPA device temperature-sensor index 0 subindex 0 info:
DS1631 (0x0803c2e4) device status:
temperature = 0x1c80 (28.5 degree C)
SPA device temperature-sensor index 0 subindex 0 info:
DS1631 (0x08063bec) device status:
temperature = 0x1e00 (30.0 degree C)
Table 12
show hw-module subslot status Field Descriptions
Field
Description
DS1631 (0x0803c2e4) device status
Device for which the temperature status is displayed.
temperature = 0x1c80 (28.5 degree C)
Current temperature of the specified device, in hexadecimal format and degrees Celsius.
Related Commands
Command
Description
showcontrollers
Displays the controller type and other information.
show inventory
To retrieve and display information about all the Cisco products that are installed in the router, use the showinventory command in EXEC or administration EXEC mode.
EXEC Modeshowinventory
[ node-id | all | location
{ node-id | all } | raw ]
Administration EXEC Modeshowinventory
[ node-id | all | chassis | fans | location
{ node-id | all } | power-supply | raw ]
Syntax Description
node-id
(Optional) Location for which to display the specified information. The node-id argument is entered in the rack/slot/module notation.
all
(Optional) Displays inventory information for all the physical entities in the chassis.
location
{node-id | all}
(Optional) Displays inventory information for a specific node, or for all nodes in the chassis.
raw
(Optional) Displays raw information about the chassis for diagnostic purposes.
chassis
(Optional) Displays inventory information for the entire chassis.
fans
(Optional) Displays inventory information for the fans.
power-supply
(Optional) Displays inventory information for the power supply.
Command Default
All inventory information for the entire chassis is displayed.
Command Modes
EXEC
Administration EXEC
Command History
Release
Modification
Release 3.3.0
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
If a Cisco entity is not assigned a product ID (PID), that entity is not retrieved or displayed.
Enter the show inventory command with the raw keyword to display every RFC 2737 entity installed in the router, including those without a PID, unique device identifier (UDI), or other physical identification.
Note
The raw keyword is primarily intended for troubleshooting problems with the show inventory command itself.
If any of the Cisco products do not have an assigned PID, the output displays incorrect PIDs, and version ID (VID) and serial number (SN) elements may be missing.
For UDI compliance products, the PID, VID, and SN are stored in EEPROM and NVRAM. Use the show inventory command to display this information.
Task ID
Task ID
Operations
sysmgr
read
Examples
The following example shows partial sample output from the show inventory command with the raw keyword:
Table 1
describes the significant fields shown in the display.
Table 13
show inventory Field Descriptions
Field
Description
NAME
Hardware for which the inventory information is displayed. If you are displaying the chassis inventory, this field shows “chassis.” If you are displaying raw inventory, or all inventory information for all nodes in the chassis, this field shows the node name in partially qualified format. For a node, the NAME is expressed in rack/slot/module notation.
DESCR
Describes the chassis or the node.
Chassis descriptions provide the name of the chassis and its Gbps. Node descriptions provide the type of node and its software version.
A description value of “CPU_PORT_0” indicates a control Ethernet port on the CPU module.
PID
Physical model name of the chassis or node.
VID
Physical hardware revision of the chassis or node.
SN
Physical serial number for the chassis or node.
show led
To display LED information for the router, or for a specific LED location, use the showled command in EXEC or administration EXEC mode.
showled
[ location
{ node-id | all } ]
Syntax Description
location {node-id
| all}
(Optional) Specifies the node for which to display LED information. The node-id argument is expressed in the rack/slot/module notation. Use the all keyword to indicate all nodes.
Command Default
If no node is specified, information about all LEDs on the router is displayed.
Command Modes
EXEC
Administration EXEC
Command History
Release
Modification
Release 2.0
This command was introduced.
Release 3.3.0
The show led command was moved from the root-system task ID to the system task ID.
The show led command was supported in administration EXEC mode.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Enter the show platform command to see the location of all nodes installed in the router.
Task ID
Task ID
Operations
system
read
Examples
The following example sample output from the showled command with the all keyword:
RP/0/RP0/CPU0:router# show led location all
LOCATION MESSAGE MODE STATUS
==================================================
0/1/* IOS XR DEFAULT UNLOCKED
0/4/* ACTVDRP DEFAULT UNLOCKED
0/6/* IOS XR DEFAULT UNLOCKED
0/RP0/* ACTV RP DEFAULT UNLOCKED
0/RP1/* STBYRDY DEFAULT UNLOCKED
Table 14
show led location Field Descriptions
Field
Description
LOCATION
Location of the node. LOCATION is expressed in the rack/slot/module notation.
MESSAGE
Current message displayed by the LED.
MODE
Current operating mode of the specified node.
STATUS
Current status of the specified node.
show operational
To display all operational data provided as XML schema, use the showoperational command in EXEC or administration EXEC mode.
Name of the management data API (MDA) class to output. To specify a class name in hierarchy, all classes must be specified from the top of the class to the specific class name that you are interested in. MDA classes are case-sensitive.
To view all available MDA classes, use the question mark (?) online help function.
descriptive
Displays more descriptive information.
Command Default
No default behavior or values
Command Modes
EXEC
Administration EXEC
Command History
Release
Modification
Release 3.6.0
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Although the showoperational command uses the schema database, the command displays the information in a string format like the other show commands. No XML related setups or knowledge is required to use the command.
Task ID
Task ID
Operations
Depends on the MDA class for which you are displaying the information
read
Examples
The following example shows sample output from the showoperational command. Not all the output is shown.
RP/0/RP0/CPU0:router# show operational BGP DefaultVRF GlobalProcessInfo descriptive
[BGP DefaultVRF GlobalProcessInfo]
InStandaloneMode: true[Standalone or Distributed mode]
RouterID: 0.0.0.0[Router ID for the local system]
ConfiguredRouterID: 0.0.0.0[Configured router ID]
LocalAS: 10[Local autonomous system #]
RestartCount: 1[No of times BGP has started]
ISRedistributeIBGPToIGPsEnabled: false[Redistribute iBGP into IGPs enabled]
IsFastExternalFalloverEnabled: true[Fast external fallover enabled]
IsBestpathMissingMEDIsWorstEnabled: false[Bestpath: Treat missing MED as worst]
.
.
.
DefaultLocalPreference: 100[Default local preference]
KeepAliveTime: 60[Default keepalive timer (seconds)]
HoldTime: 180[Default hold timer (seconds)]
GenericScanPeriod: 60[Period (in seconds) of generic scanner runs]
.
.
.
VrfIsActive: true[VRF state ]
VrfName: "default"[Name of the VRF ]
This example shows sample output from the showoperational command where only the top-level MDA class is specified. Not all of the output is shown.
To display information and status for each node in the system, use the showplatform command in EXEC or administration EXEC mode.
showplatform [node-id]
Syntax Description
node-id
(Optional) Node for which to display information. The node-id argument is entered in the rack/slot/module notation.
Command Default
Status and information are displayed for all nodes in the system.
Command Modes
EXEC
Administration EXEC
Command History
Release
Modification
Release 2.0
This command was introduced.
Release 3.3.0
The showplatform command was first supported in administration EXEC mode.
In EXEC mode, the showplatform command was moved from the root-system task ID to the system task ID.
Release 4.0.1
Support was added for the MSC-140G.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The showplatform command provides a summary of the nodes in the system, including node type and status.
Enter the showplatform command in administration EXEC mode to display output for the entire system. Enter the showplatform command in EXEC mode to display output for only those nodes that belong to the SDR on which the command is executed.
Task ID
Task ID
Operations
system
read (in EXEC mode)
root-system
read (in administration EXEC mode)
Examples
The following example shows sample output from the showplatform command:
RP/0/RP0/CPU0:router# show platform
Node Type PLIM State Config State
-----------------------------------------------------------------------------
0/1/CPU0 MSC Jacket Card IOS XR RUN PWR,NSHUT,MON
0/1/0 MSC(SPA) 4XOC3-POS OK PWR,NSHUT,MON
0/1/5 MSC(SPA) 8X1GE OK PWR,NSHUT,MON
0/6/CPU0 MSC Jacket Card IOS XR RUN PWR,NSHUT,MON
0/6/0 MSC(SPA) 4XOC3-POS OK PWR,NSHUT,MON
0/6/4 MSC(SPA) 8XOC3/OC12-POS OK PWR,NSHUT,MON
0/6/5 MSC(SPA) 8X1GE OK PWR,NSHUT,MON
0/RP0/CPU0 RP(Active) N/A IOS XR RUN PWR,NSHUT,MON
0/RP1/CPU0 RP(Standby) N/A IOS XR RUN PWR,NSHUT,MON
This example shows sample output from the showplatform command on the Cisco CRS Series Modular Services Card 140G:
RP/0/RP0/CPU0:router# show platform 0/3/*
Thu Aug 26 15:37:34.263 UTC
**********************************************************************
********** Router is running in Dual Router configuration **********
**********************************************************************
Node Type PLIM State Config State
---------------------------------------------------------------------------------------
0/3/CPU0 MSC-140G 20-10GbE IOS XR RUN PWR,NSHUT,NMON
The following is sample output for the showplatform command with the node-id argument:
RP/0/RP0/CPU0:router# show platform 0/1/0
Node Type PLIM State Config State
-----------------------------------------------------------------------------
0/1/0 MSC(SPA) 4XOC3-POS OK PWR,NSHUT,MON
This table describes the significant fields shown in the display.
Table 15
show platform Field Descriptions
Field
Description
Node
Identifier of the node in the rack/slot/module notation.
Type
Type of node.
PLIM
Type of physical layer interface module currently supported on the module.
(Optional) Specifies the node for which to display LED information. The node-id argument is expressed in the rack/slot/module notation. Use the all keyword to indicate all nodes.
(Optional) Displays a summary of all redundant node pairs in the router.
Command Default
Route processor redundancy information is displayed for all nodes in the system.
Command Modes
EXEC
Command History
Release
Modification
Release 2.0
This command was introduced.
Release 3.5.0
The statistics and trace keywords were added.
Release 3.6.0
Nonstop routing (NSR) indication was added to the command display.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Use the showredundancy command to display the redundancy status of the route processors (RPs). The showredundancy command also displays the boot and switchover history for the RPs. To view the nonstop routing (NSR) status of the standby RPs in the system, use the summary keyword.
Task ID
Task ID
Operations
system
read
basic-services
read (for statistics keyword)
Examples
The following example shows sample output from the showredundancy command:
RP/0/RP0/CPU0:router# show redundancy location 0/rp0/cpu0
Node 0/RP0/CPU0 is in ACTIVE role
Partner node (0/RP1/CPU0) is in STANDBY role
Standby node in 0/RP1/CPU0 is ready
Standby node in 0/RP1/CPU0 is NSR-ready
Reload and boot info
----------------------
RP reloaded Mon Jul 30 19:27:42 2007: 2 weeks, 1 day, 13 hours,
40 minutes ago
Active node booted Mon Jul 30 19:27:42 2007: 2 weeks, 1 day,
13 hours, 40 minutes ago
Standby node boot Mon Jul 30 19:28:13 2007: 2 weeks, 1 day,
13 hours, 39 minutes ago
Standby node last went not ready Mon Jul 30 20:27:00 2007:
2 weeks, 1 day, 12 hours, 41 minutes ago
Standby node last went ready Mon Jul 30 20:27:00 2007: 2 weeks,
1 day, 12 hours, 41 minutes ago
There have been 0 switch-overs since reload
Table 16
show redundancy Field Descriptions
Field
Description
Node */*/* is in XXX role
Current role of the primary route processor, where (*/*/*) is the route processor ID in the format rack/slot/module, and XXX is the role of the route processor (active or standby).
In the example, this field shows that the node with the ID 0/RP0/CPU0 is in active role.
Partner node (*/*/*) is in XXX role
Current role of the secondary (or partner) route processor, where (*/*/*) is the route processor ID in the rack/slot/module format, and XXX is the role of the route processor (active or standby).
In the example, this field shows that the node with the ID 0/RP1/CPU0 is in standby role.
Standby node in (*/*/*) is ready
Current state of the standby node, where (*/*/*) is the standby route processor ID.
In the example, the standby node is ready.
Standby node in (*/*/*) is NSR-ready
Current state of the standby node regarding nonstop routing (NSR), where (*/*/*) is the standby route processor ID.
In the example, the standby node is NSR-ready.
Reload and boot info
General overview of the active and standby route processors’ reload and boot history.
The following sample output shows the status of the redundant RPs in the system. The status of the standby node is indicated in parentheses next to the node identifier. The nonstop routing (NSR) status is indicated following NSR. Possible values are Ready and Not ready.
RP/0/RP0/CPU0:router# show redundancy summary
Active Node Standby Node
---------- ------------
0/4/CPU0 N/A
0/4/CPU1 N/A
0/RP0/CPU0 0/RP1/CPU0 (Ready, NSR: Ready)
Causes the primary (active) RP to switch over to the redundant standby RP, if the standby RP is available.
show screddrv
To display system controller (SC) redundancy information, use the showscreddrv command in EXEC mode.
showscreddrv
[ all | standby ]
Syntax Description
all
(Optional) Displays redundancy details for the entire router.
standby
(Optional) Displays detailed redundancy information for the standby node.
Command Default
SC redundancy information is displayed for all nodes in the system.
Command Modes
EXEC
Command History
Release
Modification
Release 2.0
This command was introduced.
Release 3.0
No modification.
Release 3.2
No modification.
Release 3.3.0
The show screddrv command was moved from the root-system task ID to the system task ID.
The arbitration keyword was removed from the show screddrv command.
Release 3.4.0
No modification.
Release 3.5.0
No modification.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Release 3.8.0
No modification.
Release 3.9.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Enter the show screddrv command without any of the optional parameters to display summarized SC redundancy and arbitration information for the router.
Task ID
Task ID
Operations
system
read
Examples
The following is sample output from the show screddrv command with the all keyword:
RP/0/RP0/CPU0:router# show screddrv all
Redundancy Driver Info for slot 32:
Slot=32
Role=active role
State=ACTIVE STATE
Prefer_slot=0
Registers: ICreg=[1], MSreg=[33], MPPReg=[c0005cc8]
Tx error count=0
Rx error count=22
Comm Statistics=5632
SHOW REDDRV ARBITRATION is not supported.
Table 17
show screddrv Field Descriptions
Field
Description
Role
Current role of the card in the specified slot; for example, it may be active, standby, and so forth.
State
Current state of the card in the specified slot.
Prefer_slot
Information about the preferred redundancy slot.
Registers
Information about the following registers:
ICreg
MSreg
MPPReg
Tx error count
Number of transmit errors that have occurred on the card in the specified slot.
Rx error count
Number of receive errors that have occurred on the card in the specified slot.
Comm Statistics
Command statistics.
SHOW REDDRV ARBITRATION
Describes whether arbitration is supported or not on this slot. If arbitration is supported, this field provides arbitration information.
show version
To display the configuration of the system hardware, the software version, the names and sources of configuration files, and the boot images, use the showversion command in EXEC mode.
showversion
Syntax Description
This command has no keywords or arguments.
Command Default
No default behavior or values
Command Modes
EXEC
Command History
Release
Modification
Release 2.0
This command was introduced.
Release 3.3.0
The show version command was moved from the sysmgr task ID to the basic-services task ID.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The showversion command displays a variety of system information, including hardware and software version, router uptime, boot settings (configuration register), and active software.
Task ID
Task ID
Operations
basic-services
read
Examples
This example shows partial output from the showversion command:
RP/0/RP0/CPU0:router# show version
Cisco IOS XR Software, Version 3.4.0
Copyright (c) 2006 by cisco Systems, Inc.
ROM: System Bootstrap, Version 1.32(20050525:193559) [CRS-1 ROMMON],
CRS-8_P1 uptime is 1 week, 22 hours, 27 minutes
System image file is "disk0:hfr-os-mbi-3.3.90/mbihfr-rp.vm"
cisco CRS-8/S (7457) processor with 4194304K bytes of memory.
7457 processor at 1197Mhz, Revision 1.2
16 Packet over SONET/SDH network interface(s)
16 SONET/SDH Port controller(s)
2 Ethernet/IEEE 802.3 interface(s)
16 GigabitEthernet/IEEE 802.3 interface(s)
2043k bytes of non-volatile configuration memory.
38079M bytes of hard disk.
1000592k bytes of ATA PCMCIA card at disk 0 (Sector size 512 bytes).
1000640k bytes of ATA PCMCIA card at disk 1 (Sector size 512 bytes).
Package active on node 0/1/SP:
hfr-diags, V 3.3.90[1I], Cisco Systems, at disk0:hfr-diags-3.3.90
Built on Mon Mar 27 12:29:00 UTC 2006
By edde-bld1 in /vws/aga/production/3.3.90.1I/hfr/workspace for c2.95.3-p8
hfr-admin, V 3.3.90[1I], Cisco Systems, at disk0:hfr-admin-3.3.90
Built on Mon Mar 27 09:22:26 UTC 2006
By edde-bld1 in /vws/aga/production/3.3.90.1I/hfr/workspace for c2.95.3-p8
hfr-base, V 3.3.90[1I], Cisco Systems, at disk0:hfr-base-3.3.90
Built on Mon Mar 27 09:13:04 UTC 2006
By edde-bld1 in /vws/aga/production/3.3.90.1I/hfr/workspace for c2.95.3-p8
hfr-os-mbi, V 3.3.90[1I], Cisco Systems, at disk0:hfr-os-mbi-3.3.90
Built on Mon Mar 27 08:34:13 UTC 2006
By edde-bld1 in /vws/aga/production/3.3.90.1I/hfr/workspace for c2.95.3-p8
--More--
Table 18
show version Field Descriptions
Field
Description
Cisco IOS XR Software, Version #
Cisco IOS XR software version number currently running on the router.
ROM
System bootstrap version number currently running on the router.
router uptime
Number of uninterrupted days, hours, minutes, and seconds the system has been up and running.
System image file is
Location and name of the system image file currently running on the router.
Packet over SONET/SDH network interface(s)
Number of Packet-over-SONET/SDH interfaces available on the current router.
SONET/SDH Port controller(s)
Number of SONET or SDH1 interfaces available on the current router.
Ethernet/IEEE 802.3 interface(s)
Number of Ethernet or IEEE 802.3 interfaces available on the current router.
GigabitEthernet/IEEE interface(s)
Number of Gigabit Ethernet or IEEE 802.3 interfaces available on the current router.
bytes of non-volatile configuration memory
Available volatile configuration memory, in bytes.
bytes of ATA PCMCIA card at disk 0
ATA PCMCIA2 available on the card in disk 0, in bytes.
Package active on node 0/1/SP
Details about the current software package that is running on the SP node in slot 1.
2 ATA PCMCIA = AT Attachment Personal Computer Memory Card Industry Association
upgrade cpuctrlbits
To upgrade the CPU controller bits on all nodes that are installed in the router or on a specific node, use the upgradecpuctrlbits command in administration EXEC mode.
Upgrades the CPU controller bits on all nodes installed in the router.
locationnode-id
Upgrades the CPU controller bits on a specific node. The node-id is expressed in the rack/slot/module notation.
Note
Enter the showplatform command to see the location of all nodes installed in the router.
bootflash
(Optional) Uses the images located on the bootflash to upgrade the CPU controller on all nodes, or on the specified node.
disk0
(Optional) Uses the images located on disk0 to upgrade the CPU controller on all nodes, or on the specified node.
disk1
(Optional) Uses the images located on disk1 to upgrade the CPU controller on all nodes, or on the specified node.
internal
(Optional) Uses the images located in the /pkg/bin.
Note
This is the default location for the ROMMON image.
Command Default
Default location for the ROMMON image: internal
Command Modes
Administration EXEC
Command History
Release
Modification
Release 3.2
This command was introduced.
Release 3.3.0
The upgradecpuctrlbits
command was moved from the sysmgr task ID to the system task ID.
Release 3.4.0
No modification.
Release 3.5.0
No modification.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Release 3.8.0
No modification.
Release 3.9.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The upgradecpuctrlbits command is only applicable to boards that use the Squid CPU controller, and not the Squirt controller. Use the internal keyword to determine which CPU controller is used in a specific card, as indicated in bold in the following example:
This example shows how to upgrade the CPU controller bits on all nodes in a router:
RP/0/RP0/CPU0:router# admin
RP/0/RP0/CPU0:router(admin)# upgrade cpucrtlbits all
Please do not power cycle, reload the router or reset any nodes until
all upgrades are completed.
Please check the syslog to make sure that all nodes are upgraded successfully.
If you need to perform multiple upgrades, please wait for current upgrade
to be completed before proceeding to another upgrade.
Failure to do so may render the cards under upgrade to be unusable.
Related Commands
Command
Description
showcontrollercpuctrlinternal
Displays information about the internal CPU controller in the cards in the router.
Displays information and status for each node in the system.
upgrade hw-module fpd
To manually upgrade the current field-programmable device (FPD) image package on a module, use the upgradehw-modulefpd command in administration EXEC mode.
upgradehw-modulefpd
{ all | fabldr | fpga-type | rommon }
[force] location
[ node-id | all ]
Syntax Description
all
Upgrades all FPD images on the selected module.
fabldr
Upgrades the fabric-downloader FPD image on the module.
fpga-type
Upgrades a specific field-programmable gate array (FPGA) image on the module. Use the showfpdpackage command to view all available FPGA images available for a specific module.
rommon
Upgrades the ROMMON image on the module.
force
(Optional) Forces the update of the indicated FPD image package on a shared port adapter (SPA) that meets the minimum version requirements. Without this option, the manual upgrade upgrades only incompatible FPD images.
location {node-id
| all}
Specifies the node for which to upgrade the FPD image. The node-id argument is expressed in the rack/slot/subslot notation. Use the all keyword to indicate all nodes.
Command Default
No default behavior or values
Command Modes
Administration EXEC
Command History
Release
Modification
Release 3.2
This command was introduced.
Release 3.3.0
Support for multiple FPGA images was added.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
During the upgrade procedure, the module must be offline (shut down but powered).
Naming notation for the node-id argument is rack/slot/subslot; a slash between values is required as part of the notation.
rack—Chassis number of the rack.
slot—Physical slot number of the SPA interface processor (SIP).
subslot—Subslot number of the SPA.
For more information about the syntax for the router, use the question mark (?) online help function.
When you start the FPD upgrade procedure or log into a router that is running the FPD upgrade procedure, the following message is displayed to the screen on TTY, console and AUX ports:
FPD upgrade in progress on some hardware, reload/configuration change on those
is not recommended as it might cause HW programming failure and result in RMA
of the hardware.
If you enter administration mode while the FPD upgrade procedure is running, the following message is displayed to the screen on TTY, console and AUX ports:
FPD upgrade in progress on some hardware, reload/configuration change on those
is not recommended as it might cause HW programming failure and result in RMA
of the hardware. Do you want to continue? [Confirm (y/n)]
If you enter global configuration mode while the FPD upgrade procedure is running, the following message is displayed to the screen on TTY, console and AUX ports:
FPD upgrade in progress on some hardware, configuration change on those is not
recommended as it might cause HW programming failure and result in RMA of the
hardware. Do you want to continue? [Confirm (y/n)]
When the FPD upgrade global timer expires, the following warning message displayed to the screen.
FPD upgrade has exceeded the maximum time window, the process will terminate now.
Please check the status of the hardware and reissue the upgrade command if required.
Task ID
Task ID
Operations
system
read, write
sysmgr
read, write
Examples
The following example shows how to upgrade the default FPGA on a SPA:
RP/0/RP0/CPU0:router# adminRP/0/RP0/CPU0:router(admin)# upgrade hw-module fpd fpga force location 0/1/4
% RELOAD REMINDER:
- The upgrade operation of the target module will not interrupt its normal
operation. However, for the changes to take effect, the target module
will need to be manually reloaded after the upgrade operation. This can
be accomplished with the use of "hw-module <target> reload" command.
- If automatic reload operation is desired after the upgrade, please use
the "reload" option at the end of the upgrade command.
- The output of "show hw-module fpd location" command will not display
correct version information after the upgrade if the target module is
not reloaded.
Continue? [confirm] y
SP/0/1/SP:Dec 22 05:41:17.920 : upgrade_daemon[125]: programming...with file
/net/node0_RP1_CPU0/hfr-lc-3.3.83/fpd/ucode/fpga_gladiator_sw0.6.xsvf
SP/0/1/SP:Dec 22 05:41:28.900 : upgrade_daemon[125]: ...programming...
SP/0/1/SP:Dec 22 05:41:28.906 : upgrade_daemon[125]: ...it will take a while...
SP/0/1/SP:Dec 22 05:41:29.004 : upgrade_daemon[125]: ...it will take a while...
SP/0/1/SP:Dec 22 05:43:03.432 : upgrade_daemon[125]: ...programming...
SP/0/1/SP:Dec 22 05:43:03.438 : upgrade_daemon[125]: ...it will take a while...
Successfully upgraded spa fpga instance 4 on location 0/1/4.
Displays which FPD image package is needed for the router to properly support the modules for the running
Cisco IOS XR software release. Also indicates all available FPD images that are available for a specific module.