Command Default

None

Command Modes

Administration EXEC

Command History

Release

Modification

Release 3.7.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 appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

Task ID

Task ID

Operation

sysmgr

read

Examples

The following example illustrates how to use the clear canbus command:

clear plugin slot counts

To clear the running counts of the backplane connector slot plugins, use the clear plugin slot counts command in administration EXEC mode.

clear plugin slot countslocationnode-id

Syntax Description

locationnode-id

Clears plugin slot counts on the designated node.
The
node-id
argument is expressed in the
rack/slot/module
notation.

Command Default

None

Command Modes

Administration EXEC

Command History

Release

Modification

Release 3.9.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 appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

The clear plugin slot counts command can be used only if the revised backplane ID card (BPID-02) is installed. If the BPID-02 card is not installed, the following error message is displayed:

environment altitude

To specify the chassis altitude, so the system can adjust the fan speed to compensate for lower cooling capability at higher altitudes, use the environment altitude command in administration configuration mode. To remove the altitude setting, use the no form of this command.

environment altitudealtituderackrack-no

no environment altitudealtituderackrack-no

Syntax Description

altitude

Chassis location altitude in meters. Values can range from 0 to 4000.

rackrack-no

Specifies the rack number of the chassis.

Command Default

1800 meters

Command Modes

Administration configuration

Command History

Release

Modification

Release 4.2.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 appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

Task ID

Task ID

Operation

root-system

read, write

Examples

This example specifies that the chassis is located at sea level:

RP/0/RSP0/CPU0:router(admin-config)#environment altitude 0 rack 0

fpd
auto-upgrade

To enable the
automatic upgrade of FPD images during a software upgrade, use the
fpd
auto-upgrade command in
Admin 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

Admin Configuration
mode

Command History

Release

Modification

Release 4.0.1

This command
was introduced.

Usage Guidelines

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:

hw-module
high-bandwidth

To upgrade the RSP3
Lite card from 80Gig per line card capacity to 220Gig per Line card capacity
(for Enhanced ethernet linecards), use the
hw-module high-bandwidth
command in the appropriate mode. To restore the
default capacity, use the
no form of the
command.

hw-module high-bandwidth

no
hw-module high-bandwidth

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

Admin config

Command History

Release

Modification

Release 5.3.0

This command
was introduced.

Usage Guidelines

This command can be used only
after applying the appropriate license to RSPLite3. Traditional or smart
licensing can be used.

Task ID

Task ID

Operation

sysmgr

execute

Examples

This example shows
how to use the
hw-module high-bandwidth
command:

RP/0/RSP0/CPU0:router (config) # hw-module high-bandwidth

hw-module location reload

To reset the power-cycle or reload the hardware for a specific node, or for all nodes installed in the router, use the hw-modulelocationreload command in EXEC or administration EXEC mode.

hw-modulelocationnode-idreload
{ path | warm }

Syntax Description

node-id

Node whose hardware attributes you want to configure. 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.

path

TFTP or disk path to the image you want to download onto the specific node or nodes.

warm

Specifies a warm reload of the node.

Command Default

No default behavior or values

Command Modes

EXEC

Administration EXEC

Command History

Release

Modification

Release 3.7.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 appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

To reset a specific node, use the hw-module location reload command in EXEC mode.

To reset a specific node or all nodes, use the hw-module location reload command in administration EXEC mode.

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.

Task ID

Task ID

Operations

root-lr

execute (in EXEC mode)

sysmgr

execute (in EXEC mode and administration EXEC mode)

Examples

This example shows how to reset the hardware on a specific node from EXEC mode:

RP/0/RSP0/CPU0:router # hw-module location 0/1/CPU0 reload

This example shows how to reset the hardware on a specific node from administration EXEC mode:

hw-module power
location

To power on a specified line card, use the
hw-modulepowerlocation command in administration configuration
mode.

hw-modulepowerlocationnode-id

Syntax Description

locationnode-id

Identifies
the node to power on. 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.7.2

This command
was introduced.

Release 4.0.0

The
override option was removed.

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
hw-modulepowerlocation command is available for line cards only;
it is not available for
route switch processor
(RSP) cards.

Use the
hw-modulepowerdisablelocation command to power off a line card.

Use the
showplatform command to view a summary of the nodes in
the router, including status information.

By default, cards
that do not have a power consumption value programmed on the manufacturing
EEPROM cannot be powered up or booted. To correct an issue with such cards,
that possibly is because of an incorrectly programmed EEPROM, you can use the
hw-module
power command with the
override
option.

hw-module power disable

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

This command was introduced.

Release 4.0.0

The override keyword was removed.

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

Syntax Description

Feature profile that supports PBB, but does not support IPv6, reverse-path forwarding
(RPF) and netflow.

Command Default

The default feature profile is
default.

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 appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

If you do not configure the feature profile, the default profile is active. The default feature profile does not support provider backbone bridge (PBB).
If you need support for PBB, configure the L2 feature profile.

If you do not reload the line cards after configuring the feature profile, the configured profile is not active and this warning message is displayed. You
must reload the affected line card so that the configured profile
matches the active profile.

LC/0/1/CPU0:Nov 5 02:50:42.732 : prm_server[236]: Configured
'hw-module profile feature l2' does not match active 'hw-module
profile feature default'. You must reload this line card in order
to activate the configured profile on this card or you must change
the configured profile.

If you have configured features that are not supported in your active feature profile, this warning is displayed. You should either change
the feature profile configuration, or remove the non-supported
features.

Scale
profile applicable for deployments that require a very large number of Layer 3
routes (up to 1.3 million) and minimal Layer 2
functionality.

Command Default

default is the default scale profile

Command Modes

Administration configuration

Command History

Release

Modification

Release 3.9.1

This command
was introduced.

Release 4.0.1

The
l3xl keyword was introduced.

This command
was moved to administration configuration mode.

Release 5.1.1

The
default scale profile for ASR 9000 Ethernet Line Cards was changed from
l2 to
l3.

Release 5.1.2

lsr and
sat keywords were introduced.

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
hw-module
profile scale command to configure the router to perform more efficiently
depending on the use of the router.

Specify the
scale profile to be
default in situations where the router is used as a Layer 2
transport device that requires the router to support high Layer 2 scale
numbers.

Specify the
scale profile to be
l3xl in situations where the router is used primarily as a
Layer 3 box to provide Layer 3 VPN services. In this case, the router needs to
support a high number of Layer 3 routes.

Note

When you upgrade
to a release that supports the
hw-module
profile scale command in administration configuration mode, the
non-administration configured settings are retained and used. Once you
configure the scale profile in the administration plane, it has higher priority
than the non-administration plane, and it replaces the non-administration scale
profile configuration.

hw-module
port-control license

To request (and apply) license for
(A9K-4T16GE-TR and A9K-4T16GE-SE) combo card , use the
hw-module port-control license command in
the appropriate mode. To remove the applied license, use the
no form of the command.

hw-module port-control license
locationnode-id

no hw-module port-control license
locationnode-id

Syntax Description

locationnode-id

Interface details.

Command Default

None

Command Modes

Global configuration

Command History

Release

Modification

Release 5.3.0

This command was
introduced.

Usage Guidelines

The
hw-module port-control license command is
used to apply the requested license on the combo card. The granted license is
permanent , unless the user wants to remove license on this card and use it on
some other card. LC reload is mandatory for the license to take effect. When
the LC comes up after the reload, the licenses are installed and can be
verified using the
show license entitlement command.

If the user wants to use the combo license on some other line-card
instead of the current one, then the license has to be removed. The
no hw-module port-control license command
removes the applied license.

Task ID

Task ID

Operation

sysmgr

execute

Examples

This example shows how to use the
hw-module port-control license command:

hw-module
port-control non-combo-mode

To use all the four
Tengig ports, instead of the Gigabit ethernet ports, use the
hw-module port-control
non-combo-mode command in the appropriate mode. To remove the
non-combo configuration, use the
no form of the
command.

hw-module port-control non-combo-mode location linecard-slot

no
hw-module port-control non-combo-mode location linecard-slot

Syntax Description

location linecard-slot

The
interface and slot details.

Command Default

None

Command Modes

Global configuration

Command History

Release

Modification

Release 5.3.0

This command
was introduced.

Usage Guidelines

On the
(A9K-4T16GE-TR and A9K-4T16GE-SE ) combo card, the customer can either use
16Gigabit Ethernet + 2Tengig or 4Tengig ports. This option is when the customer
does not have the Wildchild combo license. If the License is installed, all the
ports will be enabled. In case, the license is not available and the customer
wants to use all the 4 Tengig ports instead of the Gigabit ethernet ports, then
, this command needs to be used. This is the non-combo mode.

Note

LC reload is
mandatory for the mode to take effect.

If the
hw-module port-control non-combo-mode
command is not configured, the line card will operate in the default mode. In
the default mode, the two Tengig ports which are enabled are - 0/*/0/16 and
0/*/0/17.

Task ID

Task ID

Operation

sysmgr

execute

Examples

This example shows
how to use the
hw-module port-control
non-combo-mode command:

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.7.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 appropriate task
IDs. If the 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.

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.9.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 appropriate task
IDs. If the 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:

RP/0/RSP0/CPU0:router# hw-module subslot 0/2/1 reload

led mode

To change the message, mode or status of a router card LED display, use the led mode command in administration configuration mode. To revert to the default message, mode or status, use the no form of this command.

Syntax Description

Specifies the node for which to configure the LED information. The
node-id
argument is expressed in the
rack/slot/module
notation.

Command Default

Mode: default; status: unlocked; message: according to the state of the software

Command Modes

Administration configuration

Command History

Release

Modification

Release 3.8.0

This command was introduced.

Usage Guidelines

You must be in a user group associated with a task group that
includes the proper task IDs. The command reference guides include the task IDs
required for each command. If you suspect user group assignment is preventing
you from using a command, contact your AAA administrator for assistance.

Use the show led command to display the LED settings for a card or all cards.

Task ID

Task ID

Operation

system

read, write

Examples

This example shows how to change the message displayed on the card LED and the subsequent display in the show led command output:

Displays LED information for the router, or for a specific LED location.

power budget enforcement disable

To disable the power budget calculation and allow line cards to boot in an over-budget condition, use the power budget enforcement disable command in administration configuration mode. To enable the power budget calculation once again, use the no form of this command.

power budget enforcement disable

no power budget enforcement disable

Syntax Description

This command has no keywords or arguments.

Command Default

Power budget is enforced.

Command Modes

Administration configuration

Command History

Release

Modification

Release 4.0.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 appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

The power manager automatically reads the required power supply values from the EEPROM on all cards and calculates the required power budget. The system can power up line cards only if there is sufficient power. Use the power budget enforcement disable command to disable the power budget calculation and to allow the system to boot cards in an over-budget condition.

Use the show environment command with the power option to display the current power current and draw.

If the system is running with a power budget deficiency and the power budget enforcement disable command is not configured, a reset of a
line card powers down the line card.
Beginning with Cisco IOS XR Release 4.3.1, if you configure the power budget enforcement disable command, behavior is normal even if the system has a power budget deficiency.

Task ID

Task ID

Operation

root-system

read, write

Examples

The following example shows how to disable the power management calcuations:

Related Commands

power budget reservation

To release the standby route switch processor (RSP) power budget reservation, use the power budget reservation command in administration configuration mode. To re-reserve the standby RSP power budget reservation, use the no form of this command.

power budget reservationstandby-rsp disable

no power budget reservationstandby-rsp disable

Syntax Description

standby-rsp disable

Disables the power budget reservation for the standby RSP.

Command Default

Power is reserved for the standby RSP.

Command Modes

Administration configuration

Command History

Release

Modification

Release 4.0.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 appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

Use the power budget reservation command to disable the power budget reservation for the standby RSP if you only have one RSP installed in the router and you need additional power for other cards. Use the show environment command with the power-supply keyword to view the available power budget on the system.

Task ID

Task ID

Operation

root-system

read, write

Examples

The following example shows how to disable the power budget for the standby RSP:

Related Commands

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 3.7.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 appropriate task
IDs. If the 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:

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/RSP0/CPU0:router# show redundancy
This node (0/RP0/CPU0) is in ACTIVE role
Partner node (0/RP1/CPU0) is in UNKNOWN role
RP/0/RSP0/CPU0:router# redundancy switchover
Standby card not running; failover disallowed.

Command Default

None

Command Modes

Administration EXEC

Command History

Release

Modification

Release 3.7.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 appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

Use the show canbus command with the server-stats keyword to determine if the revised backplane ID board (BPID-02) is installed in the router.

Task ID

Task ID

Operation

sysmgr

read

Examples

The following example illustrates sample output from the show canbus command with the server-stats keyword:

show dsc

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

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 3.7.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 appropriate task
IDs. If the 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 ASR 9000 Series
Aggregation Services Router Getting Started Guide.

Syntax Description

(Optional)
Displays the environmental statistics at the time of the last shutdown.

leds

(Optional)
Displays monitor parameters for LEDs on all cards in the node.

power

(Optional) Displays power supply voltage and current
information.

table

(Optional)
Displays environmental parameter ranges.

temperatures

(Optional) Displays system temperature information.

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 3.7.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 appropriate task
IDs. If the 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:

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.7.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 appropriate task
IDs. If the 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:

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 field-programmable device (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.7.2

This command
was introduced.

Release 3.9.0

Support
was added for the 2-port channelized OC-12/DS0 SPA.

Release 4.3.2

Support
for Back-plane identification (BPID) nodes.

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.

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:

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 SPAs and SIPs are supported with your current Cisco IOS XR software release, which FPD image you need for each card, and what the minimum hardware requirements are for the various modules.

Manually upgrades the current field-programmable device (FPD) image package on a module.

show hw-module
profile

To display the
active profiles on the router, use the
show hw-module
profile command in EXEC mode.

show hw-module profile
{ all | feature | scale }
[ locationnode-id ]

Syntax Description

all

Displays
information regarding all active profiles.

feature

Displays
information regarding active feature profiles.

scale

Displays
information regarding active scale profiles.

locationnode-id

Displays the
active profile for a particular node.

Command Modes

EXEC

Command History

Release

Modification

Release 3.9.1

This command
was introduced.

Release 4.0.1

The
feature keyword
was added.

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 hw-module
profile command displays only active profiles. If a profile has
been configured and the line card has not be reloaded since the configuration,
the profile is not active. Use the
show running-config hw-module
profile command to view configured profiles.

Task ID

Task ID

Operation

root-lr

read

Examples

This example shows
sample output from the
show hw-module
profiles command with the
feature
keyword:

(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.9.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 appropriate task
IDs. If the 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:

(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

Release 5.0.0

Command History

Release

Modification

Release 3.9.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 appropriate task
IDs. If the 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:

(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.9.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 appropriate task
IDs. If the 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:

(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.9.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 appropriate task
IDs. If the 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:

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.9.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 appropriate task
IDs. If the 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:

(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.9.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 appropriate task
IDs. If the 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:

(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.9.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 appropriate task
IDs. If the 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:

Syntax Description

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

This
command was introduced.

Release 3.9.0

Support
was added for the 2-port channelized OC-12/DS0 SPA.

Usage Guidelines

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.

Examples

The following
example shows partial sample output from the
show
inventory command with the
raw keyword:

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.

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 3.7.2

This
command was introduced.

Usage Guidelines

Enter the
show platform
command to see the location of all nodes installed in the router.

Examples

The following
example sample output from the
showled command with the
all keyword:

show
operational

Syntax Description

mda-class

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

This command
was introduced.

Release 3.9.0

Support was
added for the 2-Port Channelized OC-12/DS0 SPA.

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.

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.

show
platform

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

Administration EXEC

EXEC

Command History

Release

Modification

Release 3.7.2

This
command was introduced.

Release 3.9.0

Support
was added for the 2-Port Channelized OC-12/DS0 SPA.

Usage Guidelines

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.

For
ASR-9001-S, EP1 will be displayed as,
Not allowed
online, until the required license is bought.

show plugin slot counts

To display cumulative and running counts of card inserts per slot, use the show plugin slot counts command in administration EXEC mode.

show plugin slot countslocation
{ all | node-id }

Syntax Description

location {allnode-id}

Displays plugin slot counts on the designated node or all nodes.
The
node-id
argument is expressed in the
rack/slot/module
notation.

Command Default

None

Command Modes

Administration EXEC

Command History

Release

Modification

Release 3.9.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 appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

Use the show plugin slot counts command to display the number of insertions that have been made to the router backplane for a specific line card or RSP. This command can be used only if the BPID-02 card is installed. If the BPID-02 card is not installed, the following error message is displayed:

Related Commands

show
redundancy

To display the status of route processor
redundancy, use the
showredundancy command in

EXEC

mode.

showredundancy
[ location
{ node-id | all } | statistics | summary ]

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.

statistics

(Optional)
Displays redundancy statistics information.

summary

(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 3.7.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 appropriate task
IDs. If the 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 switch processors
(RSPs). The
showredundancy command also displays the boot and
switchover history for the
RSPs. To view the nonstop routing (NSR) status of the standby
RSPs 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:

Causes the primary (active) route processor (RP) to fail over to the redundant standby RP.

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 3.7.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 appropriate task
IDs. If the 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.

Syntax Description

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

None

Command Modes

Admin EXEC mode

Command History

Release

Modification

Release 3.7.2

This
command was introduced.

Usage Guidelines

Note

The use of the
force option when doing a fpd upgrade is not recommended except under explicit
direction from Cisco engineering or TAC.

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.

Examples

The following example shows
how to upgrade the default FPGA on a SPA:

RP/0/RSP0/CPU0:router# adminRP/0/RSP0/CPU0:router(admin)# upgrade hw-module fpd fpga 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/asr9k-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 SPAs and SIPs are supported with your current Cisco IOS XR software release, which FPD image you need for each card, and what the minimum hardware requirements are for the various modules.