Hardware Redundancy and Node Administration Commands

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.

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 counts location node-id

Syntax Description

location node-id Clears plugin slot counts on the designated node. The node-id argument is expressed in the rack/ slot 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:

0/1/CPU0 slot counts 'current' ...Response error: 'ENVMON' detected the 'warning' condition 'Hardware not available'

Task ID

Task ID Operation

sysmgr

execute

Examples

The following example illustrates how to use the clear plugin slot counts command: 


RP/0/RSP0/CPU0:router(admin)# clear plugin slot counts location 0/FT1/SP

Fri Jan 15 10:15:55.388 pst

 0/FT1/SP slot counts 'current' ... cleared
RP/0/RSP0/CPU0:router(admin)# show plugin slot counts location 0/FT1/SP

Fri Jan 15 10:16:15.503 pst

Backplane connector slot plugin counters

                        Current         Cumulative
0/FT1/SP                0               14

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 altitude altitude rack rack-no

no environment altitude altitude rack rack-no

Syntax Description

altitude

Chassis location altitude in meters. Values can range from 0 to 4000.
rack rack-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/RP0/CPU0:router(admin-config)#environment altitude 0 rack 0

fabric enable mode

To change the fabric operation mode on Cisco ASR 9922 Series routers, use the fabric enable mode command in the System Admin Config mode.

fabric enable mode [highbandwidth | a99-highbandwidth]

Syntax Description

highbandwidth

Enables high scale Virtual Queuing Instance (VQI). In this mode, the maximum number of VQI that can be defined on the router is 2048.

In the default mode, a maximum of 1024 VQI is supported and only first five switch fabric links can be used in each line card slot.

a99-highbandwidth

Enables the use of all seven switch fabric links in each line card slot. In this mode, the maximum number of VQI that can be defined on the router is 2048.

Note 

This keyword is allowed only when all the line cards in the chassis are of A99 type (for example, A99-12X100GE, A99-8X100GE, and so on).

Command Default

In Cisco IOS XR, default operating mode is not configured (None).

In Cisco IOS XR 64 bit, default operating mode is highbandwidth .

Command Modes

System Admin Config mode.

Command History

Release Modification

Release 6.1.2

a99-highbandwidth keyword support was introduced.

Release 5.3.0

This command was introduced.

Usage Guidelines

In Cisco IOS XR 64 bit, highbandwidth mode is enabled by default. Therefore, only a99-highbandwidth keyword can be used during command execution on Cisco IOS XR 64 bit routers.


Note

Ensure to remove all the line cards that are unsupported for an operating mode before executing this command; the command will otherwise be rejected.


Note

Remove all unsupported line cards in the chassis before enabling the highbandwidth operating mode. This mode is NOT available on the following line cards:

  • A9K-2X100GE

  • A9K-1X100GE

  • A9K-36X10GE

  • A9K-24X10GE

  • A9K-MOD160

  • A9K-MOD80

  • A9K-16T

  • A9K-8T

  • A9K-4T

  • A9K-2T20GE

  • A9K-40GE

  • A9K-SIP-700

Examples

This example shows the available fabric operating modes: 

RP/0/RP0/CPU0:router (admin-config) # fabric enable mode ?
A99-highbandwidth  A99 High bandwidth cards only
highbandwidth      High bandwidth cards only

fpd auto-upgrade

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

System Admin Config mode

Command History

Release Modification
Release 5.0.0

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: 


(admin)# install add comp-hfr-mini.pie hfr-fpd.pie hfr-mpls-p.pie
(admin)# install activate disk0:/comp-hfr-mini.pie disk0:/hfr-fpd.piedisk0: hfr-mpls-p.pie

Task ID

Task ID Operation
system

read, write

Examples

The following example shows how to enable automatic FPD upgrades: 


RP/0/RP0/CPU0:router(admin-config)# fpd auto-upgrade

fpd auto-reload

To enable the automatic reload of a line card after successful FPD software upgrade, use the fpd auto-reload command in System Admin Config mode. To disable automatic LC reload, use the no form of this command.

fpd auto-reload

Syntax Description

This command has no keywords or arguments.

Command Default

None.

Command Modes

System Admin Config mode

Command History

Release Modification
Release 6.5.1

This command was introduced.

Usage Guidelines

The fpd auto-reload command works only if fpd auto-upgrade command is configured. 


(admin-config)#fpd auto-reload
(admin-config)#fpd auto-upgrade
(admin-config)#commit

This command is supported on Cisco IOS XR 32-bit OS.

Task ID

Task ID Operation
system

read, write

Examples

The following example shows how to enable automatic LC reload after FPD upgrades: 


RP/0/RP0/CPU0:router(admin-config)# fpd auto-reload

fpd auto-reload (Cisco IOS XR 64-bit)

To enable or disable automatic reload of a line card after successful FPD upgrade, use the fpd auto-reload command in XR Config mode.

fpd auto-reload {enable | | disable}

Syntax Description

enable

Enables LC auto reload after FPD auto upgrade.

disable

Disables LC auto reload after FPD auto upgrade.

Command Default

None.

Command Modes

XR Config mode

Command History

Release Modification
Release 6.5.1

This command was introduced.

Usage Guidelines

This command is supported on Cisco IOS XR 64-bit OS.

Task ID

Task ID Operation
system

read, write

Examples

The following example shows how to enable automatic LC reload after successful FPD upgrades: 


RP/0/RP0/CPU0:router(config)# fpd auto-reload enable

hw-module cmp disable

To disable the Console Management Port (CMP) on a RSP880/RP2, use the hw-module cmp disable command in Admin Configuration mode. Disabling unused CMP ensures a higher level of security.

To enable a CMP, use the no form of this command.

hw-module cmp disable

no hw-module cmp disable

Syntax Description

location loc-name

RSP880/RP2 location.

Command Default

CMP on a RSP880/RP2 is enabled.

Command Modes

Admin configuration

Command History

Release Modification

Release 6.3.1

This command was introduced.

Usage Guidelines

By default, CMP on a RSP880/RP2 is enabled and you can disable the port later by executing the command. If CMP is already disabled using this command, it will automatically be re-enabled when the RSP is re-loaded (at boot-up). However, after the RSP is in a stable state/UP state, the port gets disabled again as the configuration is automatically re-applied.


Note

After CMP is disabled using this command, the CMP shell access session will be terminated.

This command can be executed only RSPs; not on Line Cards.

Examples

This example shows how to disable CMP on a RSP/RP: 

RP/0/RP0/CPU0:router (admin-config) # hw-module cmp disable location 0/RSP0/CPU0

This example shows how to enable CMP on a RSP/RP: 

RP/0/RP0/CPU0:router (admin-config) # no hw-module cmp disable location 0/RSP0/CPU0

hw-module external-usb disable

To disable USB ports on any RSP, use the hw-module external-usb disable command in Admin Configuration mode. Disabling unused USB ports ensures a higher level of security.

To enable a USB port, use the no form of this command.

On Cisco IOS XR 64 bit, use external-usb disable and no external-usb disable commands in Admin Configuration mode for the same.

hw-module external-usb disable

no hw-module external-usb disable

Syntax Description

This command has no keywords or arguments.

Command Default

USB port on a RSP is enabled.

Command Modes

Admin configuration

Command History

Release Modification

Release 6.3.1

This command was introduced.

Usage Guidelines

By default, USB port on a RSP is enabled. If USB is already inserted into a port and then the USB port is disabled using this command, the existing USB continues to be recognized until it is removed.


Note

Inserting a USB will not be detected after a USB port is disabled using this command.

This command can be executed only RSPs; not on Line Cards.

Examples

This example shows how to disable a USB port on a RSP: 

RP/0/RP0/CPU0:router (admin-config) # hw-module external-usb disable

This example shows how to enable a USB port on a RSP: 

RP/0/RP0/CPU0:router (admin-config) # no hw-module external-usb disable

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/RP0/CPU0:router (config) # hw-module high-bandwidth

hw-module location port breakout

To convert the speed of a interface port from one to another, for example, 100G port to 40G port, use the hw-module location node-id port port numberbreakout interface command in the global configuration mode.

hw-module location node-id port number breakout interface

Syntax Description

node-id

Node whose hardware attributes you want to configure. The node-id argument is expressed in the rack/ slot notation.

Note 
Enter the show platform command to see the location of all nodes installed in the router.
port port-number

Indicates the optics port number. Depending on the line card, the port numbers and its type might vary.
breakout interface

Configures the breakout interface.

Defaults

No default behavior or values

Command Modes

Global configuration mode

Command History

Release

Modification

Release 6.4.2

This command was introduced.

Release 7.1.3

This command was updated. The command is supported on two new hardware:

  • Cisco ASR 9000 12-Port 100GE line card (A99-12x100GE)

  • Cisco ASR 9000 4-Port 100GE line card (A9K-4x100GE)

Usage Guidelines

This command is supported only on these routers and line cards:

  • Cisco ASR 9901 Routers

  • Cisco ASR 9000 12-Port 100GE line card (A99-12x100GE)

  • Cisco ASR 9000 4-Port 100GE line card (A9K-4x100GE)

Task ID

Task ID

Operations

root-system

read, write

root-lr

read, write

Examples

This example shows how to convert 100G port to 40G port:

RP/0/RP0/CPU0:router(config)# hw-module location 0/0/CPU0 port 20 breakout 1xFortyGigE

hw-module location breakout

To configure the breakout option for a specified interface, use the hw-module location breakout command in the appropriate mode. To disable the breakout option, use the no form of the command.

hw-module location node-id [ preconfigure ] bay bay-number port port-number breakout interface

Syntax Description

location node-id

Interface details.

preconfigure

(Optional) Enables the user to preconfigure breakout on an empty slot.

bay bay-number

Bay number of the device (Upper, left, right, lower).

port port-number

Specifies the port on which you want to enable breakout.
breakout interface

Enables the breakout option. For information on supported port modes, see System Management Configuration Guide for Cisco ASR 9000 Series Routers.

Command Default

None

Command Modes

Global config

Command History

Release Modification

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

SR10 CPAK can operate in the 10x10GE mode.

Use the show ipv4 interfaces brief command to get the details of the breakout interfaces: 

show ipv4 interfaces brief | include Ten
TenGigE0/0/0/2/0               unassigned      Shutdown              Down
TenGigE0/0/0/2/1               unassigned      Shutdown              Down
TenGigE0/0/0/2/2               unassigned      Shutdown              Down
TenGigE0/0/0/2/3               unassigned      Shutdown              Down
TenGigE0/0/0/2/4               unassigned      Shutdown              Down
TenGigE0/0/0/2/5               unassigned      Shutdown              Down
TenGigE0/0/0/2/6               unassigned      Shutdown              Down
TenGigE0/0/0/2/7               unassigned      Shutdown              Down
TenGigE0/0/0/2/8               unassigned      Shutdown              Down
TenGigE0/0/0/2/9               unassigned      Shutdown              Down

Task ID

Task ID Operation

sysmgr

read

Examples

This example shows how to use the hw-module location breakout command: 

RP/0/RP0/CPU0:router (config) # hw-module location 0/0/CPU0 bay 0 port 2 breakout 10xTenGigE
This example shows how to use the hw-module location breakout command to enable 1 GbE port mode option on port 10: 
RP/0/RP0/CPU0:router (config) # hw-module location 0/0/CPU0 bay 0 port 10 breakout 5x1GE-5x10GE

hw-module location bay port port-mode

To configure an MPA with optics in 200G mode use the hw-module location bay port port-mode command in the global configurion mode.


Note

Staircase FEC is supported only in 100gig mode.

hw-module location location bay bay-number port port-number port-mode port-mode

Syntax Description

location location

Indicates the location of the MPA, which is the line card ID.
bay bay-number

Indicates the bay number of the line card.
port port-number

Indicates the port number of the optical-module or optic. You can configure the port number with only the value, 0.
port-mode port-mode

Configures the 200G port mode. Port mode can be:

  • 2xHundredGigE-16QAM: Configures 200G 16QAM port mode for EP

  • 2xHundredGigE-8QAM: Configures 200G 8QAM port mode for EP

A higher QAM value leads to higher data transmission rates, but also increases the risk of errors that necessitates re-sends.

Command Default

If this command is not configured, the MPA and optics work in 100G mode.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.1

This command was introduced.

Usage Guidelines

You can configure this command only at port 0 of a router.

Task ID

Task ID

Operation

root-system

read, write

root-lr

read, write

Examples

This example shows how to configure 200G for an optical module of a router.

Router(config)# hw-module location 0/2/CPU0 bay 0 port 0 port-mode 2xHundredGigE-16QAM

hw-module location slice config-mode

To convert the speed of a interface port from one to another, for example, 10GE port to 1GE port, use the hw-module location node-id slice numberconfig-mode interface command in the global configuration mode.

hw-module location node-id slice number config-mode interface

Syntax Description

node-id

Node whose hardware attributes you want to configure. The node-id argument is expressed in the rack/ slot notation.

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

Defaults

No default behavior or values

Command Modes

Global configuration mode

Command History

Release

Modification

Usage Guidelines

This command is supported on Cisco ASR 9902 router and on the following line cards:

  • A9K-4HG-FLEX-SE/TR

  • A99-4HG-FLEX-SE/TR

  • A9K-4HG-FLEX-FC

  • A99-4HG-FLEX-FC

The 5x1GE_5x10GE port mode enables 1GE support in the following ports:

  • Slice 0: Ports 1, 3, 5, 7, 13, 15, 17, 19, 21, and 23

  • Slice 1: Ports 25, 27, 29, 31, 33, 35, 41, 43, 45, and 47

Task ID

Task ID

Operations

root-system

read, write

root-lr

read, write

Examples

This example shows how to enable 5x1GE_5x10GE port mode: 

RP/0/RP0/CPU0:ios#configure
RP/0/RP0/CPU0:ios(config)#hw-module location 0/0/CPU0 slice 0 config-mode config-mode 1x100GE,1x100GE,5x1GE_5x10GE,5x1GE_5x10GE
RP/0/RP0/CPU0:ios(config)#commit

hw-module location slice power-down

To power off a specified slice, use the hw-module location slice power-down command in the XR Config mode. To power on a slice, use the no form of the command.

hw-module location node-id slice number power-down

Syntax Description

location node-id

Specifies the line card node location.

slice number

Specifies the slice number that should be power off.

Command Default

All slices are power on.

Command Modes

XR Config mode

Command History

Release Modification

Release 7.0.1

This command was introduced.

Usage Guidelines

This feature is supported on the Cisco ASR 9000 4th Generation Ethernet line cards.


Note

It is necessary to reload the line card after executing the hw-module location slice power-down command.

Task ID

Task ID Operation

sysmgr

read, write

Examples

This example shows how to power down slice 3, and 7 of the line card at node 0:

RP/0/RP0/CPU0:router (config) # hw-module location 0/0/CPU0 slice 3 power-down 
RP/0/RP0/CPU0:router (config) # hw-module location 0/0/CPU0 slice 7 power-down 
RP/0/RP0/CPU0:router (config) # commit 
RP/0/RP0/CPU0:router (config) # end 
RP/0/RP0/CPU0:router # admin 
RP/0/RP0/CPU0:router (sysadmin) # hw-module location 0/0/CPU0 reload

hw-module power saving

To configure the power saving mode for a specified slice, use the hw-module power saving command in the appropriate mode. To delete the power saving option, use the no form of the command.

hw-module power saving location location slice number

no hw-module power saving location location slice number

Syntax Description

location location

The interface details.

slice number

The slice number on which power save mode needs to be enabled. Each slice has two physical ports. Slice 1, 2 ,3 can be configured to the power saving mode. Power save option is not applicable for slice 0.

Command Default

None

Command Modes

Admin config

Command History

Release Modification

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

Once a slice is configured in the power saving mode, the interfaces will be deleted and hence all traffic passing through the interfaces will be dropped.

Task ID

Task ID Operation

sysmgr

read, write

Examples

This example shows how to use the hw-module power saving command: 

RP/0/RP0/CPU0:router (admin-config) # hw-module power saving location 0/1/cpu0 slice 3

hw-module profile feature

To enable a feature bundle on the router, use the hw-module profile feature command in administration configuration mode. To disable a feature bundle, use the no form of this command.

hw-module profile feature {default | l2}

no hw-module profile feature {default | l2}

Syntax Description

default

Feature profile that supports all features except provider backbone bridge (PBB).

l2

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. 

LC/0/1/CPU0:Nov 5 02:50:42.732 : prm_server[236]: Active 'hw-module
profile feature l2' does not support IPv6, RPF, or Netflow
features. Please remove all unsupported feature configurations.

Task ID

Task ID Operation

system

read, write

root-lr

read, write

Examples

This example shows how to set the feature profile to L2:


RP/0/RSP0/CPU0:router# admin
RP/0/RSP0/CPU0:router(admin)# configure
RP/0/RSP0/CPU0:router(admin-config)# hw-module profile 
feature l2

Wed Dec  8 08:29:54.053 PST
L2 feature profile does NOT support the following features: 
IPv6, RPF, Netflow.
In order to activate this new memory resource profile,
you must manually reboot the line cards.
RP/0/RSP0/CPU0:router(admin-config)# commit

hw-module profile scale

To specify a scale profile for the router, use the hw-module profile scale command in administration configuration mode.

hw-module profile scale {default | l3 | l3xl}

Syntax Description

bng-max

This is an unused scale profile and will be deprecated in a future Cisco IOS XR software release.

default

Scale profile applicable for deployments that require large Layer 2 MAC tables (up to 512,000 entries) and a relatively small number of Layer 3 routes (less than 512,000).

l3

Scale profile applicable for deployments that require more Layer 3 routes (up to 1 million) and smaller Layer 2 MAC tables (less than 128,000 entries).

l3xl

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.

Task ID

Task ID Operation

system

read, write

root-lr

read, write

Examples

The following example shows how to set the scale profile to Layer 3: 


RP/0/RSP0/CPU0:router# admin
RP/0/RSP0/CPU0:router(admin)# configure
RP/0/RSP0/CPU0:router(admin-config)# hw-module profile scale l3

Tue Aug 24 23:52:51.828 UTC
In order to activate this new memory resource profile, 
you must manually reboot the system.
RP/0/RSP0/CPU0:router(admin-config)# commit

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 location node-id

no hw-module port-control license location node-id

Syntax Description

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

RP/0/RP0/CPU0:router (config) # hw-module port-control license location 0/1/CPU0

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: 

RP/0/RP0/CPU0:router (config) # hw-module port-control non-combo-mode location 0/1/CPU0

power budget enforcement n-plus-1 redundancy

To configure N+1 power redundancy protection mode on Cisco ASR 9910 Routers and Cisco ASR 9010 Routers (AC), use power budget enforcement n-plus-1-redundancy command in administration configuration mode. To remove configuration, use the no form of this command.

power budget enforcement n-plus-1-redundancy

Syntax Description

This command has no keywords or arguments.

Command Default

NA

Command Modes

Administration configuration

Command History

Release Modification

Release 6.3.3

This command was introduced.

Usage Guidelines

Power on Cisco ASR 9000 Series Routers (ASR-9010-AC and ASR-9910-AC) was previously conserved based on the N+N power redundancy protection mode. The chassis had to be powered up in advance and for longer time than desired. The system will recalculate the power requirements based on the N+1 mode after this command is configured.


Note

By default, the power requirements are calculated based on the N+N power redundancy mode when the router is powered on.

Note

When the system is in N+1 power redundancy mode and a there is a switchover, the new Active RSP powers up with power calculations based on N+N power redundancy mode. After parsing this configuration, system recalculates the power requirements based on the N+1 power redundancy mode.


Note

This configuration is only supported on AC power module varients of Cisco ASR 9910 Routers and Cisco ASR 9010 Routers.

Examples

The following example shows how to enable N+1 power redundancy protection mode:

RP/0/RP0/CPU0:router#admin
RP/0/RP0/CPU0:router(admin)#config
RP/0/RP0/CPU0:router(admin-config)#power budget enforcement n-plus-1-redundancy

redundancy switchover

To cause the primary (active) route processor (RP) to fail over to the redundant standby RP, use the redundancy switchover command in

XR EXEC

mode. To disable the forced switchover, use the no form of this command.

redundancy switchover [location node-id]

no redundancy switchover [location node-id]

Syntax Description

location node-id

(Optional) Specifies the primary RP on which to force a switchover. The node-id argument is expressed in the rack/ slot notation.

Command Default

No default behavior or values

Command Modes

XR EXEC

Command History

Release

Modification

Release 5.0.0

This command was introduced.

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

Use the redundancy switchover command to trigger a switchover from the primary RP to the standby RP. When the redundancy switchover 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 redundancy switchover 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.

show apm psa status

To display the PSA status for APM, use the show apm psa status command in EXEC mode.

show apm psa status location node-id

Syntax Description

location node-id

The interface details.

Command Default

None

Command Modes

Admin EXEC

Command History

Release Modification

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

This example shows how to use the show apm psa status command: 

RP/0/RP0/CPU0:router (admin) # show apm psa status location 0/0/CPU0

0/0/CPU0

PSA Client Status
DIAG            ENVMON          INVMGR          FIA             PCIE            LDA  \
            PRM             
Registered      Registered      Registered      Registered      Registered           \
Registered      Registered      

PSA Slice Status
Slice   0: Power On     Completed     1: Power On     Completed     2: Power On      \
Completed     3: Power Saving Completed     
DIAG       Completed                     Completed                     Completed     \
                 Completed                     
ENVMON     Completed                     Completed                     Completed     \
                 Completed                     
INVMGR     Completed                     Completed                     Completed     \
                 Completed                     
FIA        Completed                     Completed                     Completed     \
                 Completed                     
PCIE       Completed                     Completed                     Completed     \
                 Completed                     
LDA        Completed                     Completed                     Completed     \
                 Completed                     
PRM        Completed                     Completed                     Completed     \
                 Completed

show apm psm status

To display the PSM status for APM, use the show apm psm status command in EXEC mode.

show apm psa status location node-id

Syntax Description

location node-id

The interface details.

Command Default

None

Command Modes

  Admin EXEC

Command History

Release Modification

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

This example shows how to use the show apm psa status command: 

RP/0/RP0/CPU0:router (admin) #  show apm psm status location 0/0/CPU0
PSM Status
----------
PSM Client Status
        ENVMON:         Registered    
        DIAG0:          Registered    
        DIAG1:          Registered    
        INVMGR:         Registered    
        0/0/CPU0 PSA:   Registered

LC Status
---------
Line Card       Slice   Config  Status          ENVMON          DIAG0                \
DIAG1           INVMGR          PSA             
0/0/CPU0        0       On      Completed       Completed       Completed            \
Completed       Completed       Completed     
                1       On      Completed       Completed       Completed            \
Completed       Completed       Completed     
                2       On      Completed       Completed       Completed            \
Completed       Completed       Completed     
                3       Saving  Completed       Completed       Completed            \
Completed       Completed       Completed

show controllers pm ixdb

To display the platform manager output for Cisco ASR 9000 Series line cards, use the show controllers pm ixdb command in EXEC mode.

show controllers pm ixdb location [location {node-id | | all}]

Syntax Description

ixdb

Displays the platform manager database utilization.
location {node-id | all}

Specifies the location of the node. The node-id argument is entered in the rack/ slot notation. The all keyword specifies all nodes.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 6.2.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 show controllers pm ixdb command displays the platform manager output equivalent to the PM shell command pkg/bin/show_ixdb -f vkg_pmlib_ixdb -s for Cisco ASR 9000 Series line cards.

Task ID

Task ID

Operations

sonet-sdh

read

dwdm

read

interface

read

drivers

read

Examples

The following example shows sample output from the show controllers pm ixdb command for the specified node location: 


RP/0/RP0/CPU0:router# show controllers pm ixdb location 0/1/CPU0
  
Sun Oct  9 12:19:41.245 UTC

ixdb header Information:(0/1/CPU0)
==================================
ixdb version                = 1
ispec version               = 1
pathname                    = vkg_pmlib_ixdb
Hash collisions possible    = Yes
invalid_key                 = 0x0
hashsize                    = 163840
db_size                     = 81920
rec_size                    = 752
db_keys_offset              = 331776
hashtable_offset            = 987136
pool0_offset                = 1642520
db_offset                   = 3281056
start_alloc_index           = 12
alloc_index_tail            = 81919
serial                      = 1

========= DB Allocation ==========
last db alloc happened = 105 seconds ago

Number of allocated db records = 12, 
Number of free db records = 81908, 

========= Hash Table Datas ========= 
Used hash table entries = 12, 
Unused hash table entries = 163828, 
Collisions = 0, 

========== Pools stats ===========
Pool0 linked list pool information
version = 0,    magic = 0xfeef1f00, 
pool id/ serial = 0/0, 
size in bytes  = 1638536, 
Total entries = 81920, 
Free entries = 81908, 
next pool size = 0

The following example shows sample output from the show controllers pm ixdb command for all node locations: 


RP/0/RP0/CPU0:router# show controllers pm ixdb location all
  Sun Oct  9 12:19:58.154 UTC

ixdb header Information:(0/1/CPU0)
==================================
ixdb version                = 1
ispec version               = 1
pathname                    = vkg_pmlib_ixdb
Hash collisions possible    = Yes
invalid_key                 = 0x0
hashsize                    = 163840
db_size                     = 81920
rec_size                    = 752
db_keys_offset              = 331776
hashtable_offset            = 987136
pool0_offset                = 1642520
db_offset                   = 3281056
start_alloc_index           = 12
alloc_index_tail            = 81919
serial                      = 1

========= DB Allocation ==========
last db alloc happened = 122 seconds ago

Number of allocated db records = 12, 
Number of free db records = 81908, 

========= Hash Table Datas ========= 
Used hash table entries = 12, 
Unused hash table entries = 163828, 
Collisions = 0, 

========== Pools stats ===========
Pool0 linked list pool information
version = 0,    magic = 0xfeef1f00, 
pool id/ serial = 0/0, 
size in bytes  = 1638536, 
Total entries = 81920, 
Free entries = 81908, 
next pool size = 0



ixdb header Information:(0/2/CPU0)
==================================
ixdb version                = 1
ispec version               = 1
pathname                    = vkg_pmlib_ixdb
Hash collisions possible    = Yes
invalid_key                 = 0x0
hashsize                    = 163840
db_size                     = 81920
rec_size                    = 752
db_keys_offset              = 331776
hashtable_offset            = 987136
pool0_offset                = 1642520
db_offset                   = 3281056
start_alloc_index           = 0
alloc_index_tail            = 81919
serial                      = 1

========= DB Allocation ==========
DB alloc never happened
Number of allocated db records = 0, 
Number of free db records = 81920, 

========= Hash Table Datas ========= 
Used hash table entries = 0, 
Unused hash table entries = 163840, 
Collisions = 0, 

========== Pools stats ===========
Pool0 linked list pool information
version = 0,    magic = 0xfeef1f00, 
pool id/ serial = 0/0, 
size in bytes  = 1638536, 
Total entries = 81920, 
Free entries = 81920, 
next pool size = 0

show environment

To display environmental monitor parameters for the system, use the show environment command in the appropriate mode.

SysAdmin EXEC Mode: show environment {all | current | fan | power | temperatures | trace | voltages}location [node-id]

Syntax Description

current

Displays all the current information.

all

(Optional) Displays information for all environmental monitor parameters.

fans

(Optional) Displays information about the fans.

location {all | node-id}

(Optional) Displays all environmental monitor parameters for the specified location only.

power-supply

(Optional) Displays power supply voltage and current information.

temperatures

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

Command Default

All environmental monitor parameters are displayed.

Command Modes

System Admin EXEC

Command History

Release

Modification

Release 5.0.0

This command was introduced.

Release 3.9.0

No modification.

Usage Guidelines

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 environemnt temperatures
Location  Sensor                      Value   Crit Major Minor Minor Major  Crit
                                    (deg C)   (Lo) (Lo)  (Lo)  (Hi)  (Hi)   (Hi)
================================================================================
0/5
          MB Inlet                       24    -10    -5     0    50    60    70
          HotSpot                        28    -10    -5     0    95   100   105
          MB Outlet                      24    -10    -5     0    95   100   105
          Sandy Bridge Die               38    -10    -5     0    75    85    95
          PCIe Die                       44    -10    -5     0   105   115   125
          Slice 1 PITA Die Remote        46    -10    -5     0   105   110   115
          Slice 1 AMBA Die local         35    -10    -5     0    95   100   105
          Slice 1 AMBA Die Remote        39    -10    -5     0   105   110   115
0/RP1
          Inlet                          21    -10    -5     0    45    55    65
          HotSpot                        32    -10    -5     0    65    75    85
          Outlet                         32    -10    -5     0    65    75    85
          PCIe Die                       36    -10    -5     0   105   115   125
          Chassis local                  22    -10    -5     0    45    55    65
          Chassis remote                 22    -10    -5     0    45    55    65
          Sandy Bridge                   36    -10    -5     0    75    85    95
0/FC0
          Inlet                          30    -10    -5     0    50    60    75

Table 1 describes the significant fields shown in the display.

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

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.

Table 2describes the significant fields shown in the display.

Table 2. 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 # show environment power
CHASSIS LEVEL POWER INFO: chassisinfo
================================================================================
   Total output power capacity (Shelf 0 + Shelf 1) :       0W +   12000W
   Total output power required                     :    6500W
   Total power input                               :    1341W
   Total power output                              :     964W

Power Shelf 0:
================================================================================
   Power       Supply     ------Input----   ------Output---      Status
   Module      Type        Volts     Amps    Volts     Amps
================================================================================
   0/PT1-PM0   3KW-AC      213.5      1.5     55.5      4.1    OK
   0/PT1-PM1   3KW-AC      212.9      1.6     55.4      4.4    OK
   0/PT1-PM2   3KW-AC      212.9      1.6     55.4      4.5    OK
   0/PT1-PM3   3KW-AC      212.0      1.6     55.4      4.4    OK
   0/PT1-PM4      -          0.0      0.0      0.0      0.0    NOT PRESENT
   0/PT1-PM5      -          0.0      0.0      0.0      0.0    NOT PRESENT

Total of Power Shelf 0:        1341W/ 6.3A        964W/17.4A

This table describes the significant fields shown in the display.

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

Power Budget Enforcement

This field displays the Power Budget Enforcement status as Enabled or Disabled.

Power Budget Mode

This field displays the power redundancy mode used (for example, N+1).

N+1 Supply Failure Protected Capacity

This field represents the Supply Protected Power capacity of the chassis with power module redundancy in N+1 mode.

show hw-module profile

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

Syntax Description

feature

Displays information regarding active feature profiles.

location node-id

Displays the active profile for a particular node.

Command Modes

EXEC

Command History

Release Modification

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: 


RP/0/RSP0/CPU0router0# show hw-module profile feature

Thu Dec  9 03:30:42.633 PST

                Node: 0/0/CPU0:
----------------------------------------------------------------

Memory Resources for All NPs
----------------------------
Feature Profile: Default

                Node: 0/1/CPU0:
----------------------------------------------------------------

Memory Resources for All NPs
----------------------------
Feature Profile: Default

                Node: 0/4/CPU0:
----------------------------------------------------------------

Memory Resources for All NPs
----------------------------
Feature Profile: Default

                Node: 0/6/CPU0:
----------------------------------------------------------------

Memory Resources for All NPs
----------------------------
Feature Profile: Default

Related Commands

Command Description

hw-module profile feature

Enables a feature bundle on the router. 

show inventory

To retrieve and display information about all the Cisco products that are installed in the router, use the show inventory command in System Admin EXEC or XR EXEC mode.

System Admin EXEC Mode show inventory [all | chassis | fan | location {node-id} | power | raw]

XR EXEC Mode show inventory [locationspecifier | all | location {locationspecifier | all} | oid | raw]

Syntax Description

all

(Optional) Displays inventory information for all the physical entities in the chassis.

location {node-id}

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

locationspecifier

(Optional) Displays the name of the location.

oid

(Optional) Displays OID information about the chassis.

fan

(Optional) Displays inventory information for the fans.

power

(Optional) Displays inventory information for the power supply.

Command Default

All inventory information for the entire chassis is displayed.

Command Modes

System Admin EXEC

XR EXEC

Command History

Release

Modification

Release 5.0.0

This command was introduced.

Usage Guidelines

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.

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


sysadmin-vm:0_RP0# show inventory raw

Tue Aug  27 13:32:31.730 UTC

 Name: Rack 0-Chassis        Descr: NCS 6008-8-Slot Chassis
 PID: N/A                    VID: N/A                   SN: N/A

 Name: Rack 0-LineCard Chassis backplane  Descr: NCS 6008-8-Slot Chassis Backplane
 PID: N/A                    VID: N/A                   SN: N/A

 Name: Rack 0-MidPlane IDPROM  Descr: NCS 6008-8-Slot Chassis
 PID: NCS-6008        VID: V01                   SN: SAD12345678

 Name: Rack 0-Line Card Slot 0  Descr: NCS 6008-8-Slot Line Card Slot
 PID: N/A                    VID: N/A                   SN: N/A

 Name: 0/0-Card              Descr: NCS 6000 10x100G Multi-Service CXP P0
 PID: N/A                    VID: N/A                   SN: N/A

 Name: 0/0-Motherboard       Descr: Motherboard Module
 PID: N/A                    VID: N/A                   SN: N/A
--More--

Table 1 describes the significant fields shown in the display.

Table 4. 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 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 show led command in System Admin EXEC mode.

show led [location [node-id] | trace {all | trace-name} location node-id [all | trace-attributes]]

Syntax Description

location node-id

Specifies the node for which to display LED information. The node-id argument is entered in the rack/ slot notation.

trace

Displays LED debug traces information.

trace-name

Trace name.

location node-id

Specifies the target location. The node-id argument is expressed in the rack/slot notation.

trace-attribute

Trace attribute.

all

Displays all the details.

Command Default

If no node is specified, information about all LEDs on the router is displayed.

Command Modes

System Admin EXEC

Command History

Release

Modification

Release 3.9.0

No modification.

Release 5.0.0

This command was introduced.

Usage Guidelines

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 show led command with the keyword: 


sysadmin-vm:0_RP0# show led
Tue Aug  27 13:44:33.770 UTC
=============================================================
Location  LED Name                      Mode         Color
=============================================================
0/0
          0/0-Attention LED             WORKING     OFF
          0/0-Status LED                WORKING     GREEN
0/1
          0/1-Attention LED              -           -
          0/1-Status LED                 -           -
0/RP0
          0/RP0-Attention LED           WORKING     OFF
          0/RP0-Status LED              WORKING     GREEN
          0/RP0-Alarm Minor LED         WORKING     AMBER
          0/RP0-Alarm Major LED         WORKING     AMBER
          0/RP0-Alarm Critical LED      WORKING     OFF
0/RP1
          0/RP1-Attention LED           WORKING     OFF
          0/RP1-Status LED              WORKING     GREEN
          0/RP1-Alarm Minor LED         WORKING     AMBER
          0/RP1-Alarm Major LED         WORKING     AMBER
          0/RP1-Alarm Critical LED      WORKING     OFF
0/FC0
          0/FC0-Attention LED           WORKING     OFF
Table 5. show led location Field Descriptions

Field

Description

LOCATION

Location of the node. LOCATION is expressed in the rack/ slot notation.

LED Name

Name of the LED.

MODE

Current operating mode of the specified node.

COLOR

Color of the LED.

show operational

To display all operational data provided as XML schema, use the show operational command in

XR EXEC

mode.

show operational mda-class [mda-class] [mda-class/naming=value] [descriptive]

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

XR EXEC

Command History

Release

Modification

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

Although the show operational 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 show operational 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 show operational command where only the top-level MDA class is specified. Not all of the output is shown. 


RP/0/RP0/CPU0:router# show operational Inventory

Thu Feb 19 00:54:41.251 PST 
[Inventory]
RackTable
  Rack/Number=0
    SlotTable
      Slot/Number=0
        CardTable
          Card/Number=0
            PortSlotTable
              PortSlot/Number=0
                Port
                  BasicAttributes
                    BasicInfo
                      Description: CPU_PORT_0
                      VendorType: 1.3.6.1.4.1.9.12.3.1.10
                      Name: 0/0/SP/0
                      IsFieldReplaceableUnit: false
                      CompositeClassCode: 983040
                BasicAttributes
                  BasicInfo
                    Description: CE Port Slot
                    VendorType: 1.3.6.1.4.1.9.12.3.1.5.115
                    Name: portslot 0/0/SP/0
                    IsFieldReplaceableUnit: false
                    CompositeClassCode: 0
            SensorTable
              Sensor/Number=0
                BasicAttributes
                  BasicInfo
                    Description: Temperature Sensor
                    VendorType: 1.3.6.1.4.1.9.12.3.1.8.42
                    Name: 0/0/* - host - Inlet0
                    CompositeClassCode: 720898
                    EnvironmentalMonitorPath: /admin/oper/inventory/
                     rack/0/entity/0/entity/0/entity/0/entity/0/attrib/
              Sensor/Number=1
                BasicAttributes
                  BasicInfo
                    Description: Temperature Sensor
                    VendorType: 1.3.6.1.4.1.9.12.3.1.8.42
                    Name: 0/0/* - host - Inlet1
                    CompositeClassCode: 720898
                    EnvironmentalMonitorPath: /admin/oper/inventory/
                     rack/0/entity/0/entity/0/entity/0/entity/1/attrib/
              Sensor/Number=2
                BasicAttributes
                  BasicInfo
                    Description: Temperature Sensor
                    VendorType: 1.3.6.1.4.1.9.12.3.1.8.42
                    Name: 0/0/* - host - Exhaust0
                    CompositeClassCode: 720898
 --More--

show platform

To display information and status for each node in the system, use the show platform command in System Admin EXEC or XR EXEC mode.

System Admin EXEC Mode show platform [detail | slices] [location [node-id] ]

XR EXEC Mode show platform

Syntax Description

detail

Displays details of node type and state.

slices

Displays summary of node forwarding slices.

location node-id

Specifies the target node. The node-id argument is entered in the rack/ slot notation.

Command Default

Status and information are displayed for all nodes in the system.

Command Modes

System Admin EXEC

XR EXEC

Command History

Release

Modification

Release 5.0.0

This command was introduced.

Release 5.2.3

The output for the detail keyword captures card failure events and the reason for failure when show platform command is run in System Admin EXEC mode.

Usage Guidelines

The show platform command provides a summary of the nodes in the system, including node type and status.

For NCS 6008, EP1 will be displayed as, Not allowed online, until the required license is bought.

Task ID

Task ID

Operations

Examples

The following example shows sample output from the show platform command: 

sysadmin-vm:0_RP0#show platform
Wed Aug  28 06:49:49.822 UTC
Location  Card Type               HW State      SW State      Config State
----------------------------------------------------------------------------
0/RP0     NC6-RP                  OPERATIONAL   OPERATIONAL   NSHUT
0/RP1     NC6-RP                  OPERATIONAL   OPERATIONAL   NSHUT
0/FC0     NC6-FC                  OPERATIONAL   N/A           NSHUT
0/FT0     P-L-FANTRAY             OPERATIONAL   N/A           NSHUT
0/FT1     P-L-FANTRAY             OPERATIONAL   N/A           NSHUT
0/3       NC6-10X100G-M           OPERATIONAL   OPERATIONAL   NSHUT
0/PT1     NCS-AC-PWRTRAY          OPERATIONAL   N/A           NSHUT

show power allotted

To display the power allotted to the cards in the chassis, use the show power allotted command in administration EXEC mode.

show power allotted {location node-id | rack rack-no | summary}

Syntax Description

location node-id

Displays the power consumption for the specified location. The node-id argument is entered in the rack/ slot notation.

rack rack-no

Displays the power consumption for the specified rack.
summary

Displays summary information for all racks.

Command Default

None

Command Modes

Administration EXEC

Command History

Release Modification

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

The display for modular power supplies is by card. The display for fixed power supplies is by zone and card.

Task ID

Task ID Operation

power

read

Examples

This example shows sample output from the show power allocated command on a modular power supply: 


RP/0/RP0/CPU0:router(admin)# show power allotted location 0/0/*

Sun Nov 18 22:00:51.176 UTC
nodeid = 0x2a00000f
Node              Card Type         State             PID               Power Allotted
----------------- ----------------- ----------------- ----------------- -----------------
0/0/*             FP-140G           POWERED UP        CRS-MSC-FP140       450.0W
0/0/PL0           14-10GbE          POWERED UP        14X10GBE-WL-XF      150.0W

This example shows sample output from the show power allotted command on a fixed power supply: 


RP/0/RP0/CPU0:router(admin)# show power allotted rack 0

Tue Nov 20 18:51:56.404 OST
Zone              Node              Card Type         State             PID               Power Allotted
----------------- ----------------- ----------------- ----------------- ----------------- -----------------
Zone 1:
                   0/FAN-TR0         FAN TRAY          N/A               CRS-8-LCC-FAN-       75.0W
                   0/FAN-TR1         FAN TRAY          N/A               CRS-8-LCC-FAN-       75.0W


Zone 2:
                   0/RP0/*           UNKNOWN           N/A                                   175.0W
                   0/RP1/*           RP(H)-X86v1       N/A               CRS-8-PRP-6G        175.0W
                   0/SM0/*           UNKNOWN           N/A                                   185.0W
                   0/SM1/*           FC-140G/S(H)      N/A               CRS-8-FC140/S       185.0W
                   0/SM2/*           UNKNOWN           N/A                                   185.0W
                   0/SM3/*           FC-140G/S(H)      N/A               CRS-8-FC140/S       185.0W


Zone 3:
                   0/6/*             MSC-B             POWERED UP        CRS-MSC-B           390.0W
                   0/6/PL0           JACKET CARD       POWERED UP                            150.0W
                   0/7/*             MSC-140G          UNPOWERED                               7.0W
                   0/FAN-TR0         FAN TRAY          N/A               CRS-8-LCC-FAN-       75.0W
                   0/FAN-TR1         FAN TRAY          N/A               CRS-8-LCC-FAN-       75.0W

show power capacity

To display the power capacity of the router, use the show power capacity command in administration EXEC mode.

show power capacity {rack rack-no | summary}

Syntax Description

rack rack-no

Displays the power capacity for the specified rack.
summary

Displays summary power capacity for the chassis.

Command Default

None

Command Modes

Administration EXEC

Command History

Release Modification

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

The display for modular power supplies is by card. The display for fixed power supplies is by zone and card.

Task ID

Task ID Operation

power

read

Examples

This example shows sample output from the show power capacity command on a modular power supply: 

RP/0/RP0/CPU0:router(admin)# show power capacity rack 0

Sun Nov 18 22:02:11.394 UTC
---------------------------------------------------------
Rack 0: Cisco CRS Series AC Power System
---------------------------------------------------------
Power Module      State                Power Capacity
----------------- ----------------- ---------------------
0                  OK                 1900.0W
1                  OK                 1900.0W
2                  OK                 1900.0W
3                  OK                 1900.0W
---------------------------------------------------------
Total Rack Power Capacity:            7600.0W

This example shows sample output from the show power capacity command on a fixed power supply: 

RP/0/RP0/CPU0:router(admin)# show power capacity rack 0

Sun Dec  9 02:40:09.464 PST
---------------------------------------------------------------------------
Rack 0: Cisco CRS Fixed AC Power System
---------------------------------------------------------------------------
Zone              Power Module      State             Zone Power Capacity
----------------- ----------------- ----------------- ---------------------
 Zone 1:           A[0]               OK                 1460.0W

                   B[0]               OK
 Zone 2:           A[0]               OK                 1460.0W

                   B[0]               OK
 Zone 3:           A[0]               OK                 1460.0W

                   B[0]               OK
---------------------------------------------------------------------------
Total Rack Power Capacity:                               4380.0W

show power summary

To display a summary of the power information for a rack, use the show power command in administration EXEC mode.

show power summary rack rack-no

Syntax Description

rack rack-no

Displays summary output for the specified rack

Command Default

None

Command Modes

Administration EXEC

Command History

Release

Modification

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

The display for modular power supplies is by card. The display for fixed power supplies is by zone and card.

Task ID

Task ID

Operation

power

read

Examples

This example shows sample output from the show power summary command on a modular power supply. 

RP/0/RP0/CPU0:router(admin)# show power summary rack 0

Sun Nov 18 22:02:40.434 UTC
Location          Power Capacity    Power Allotted    Power Available
----------------- ----------------- ----------------- ------------------
Rack :  0            7600.0W           1285.0W            6315.0W

This example shows sample output from the show power summary command on a fixed power supply. 

RP/0/RP0/CPU0:router(admin)# show power summary rack 0

Wed Nov 14 00:29:06.354 PST
Location          Power Capacity    Power Allotted    Power Available
----------------- ----------------- ----------------- ------------------
Rack 0:

Zone 1:             1460.0W              650.0W              810.0W
Zone 2:             1460.0W             1534.0W              -74.0W
Zone 3:             1460.0W              650.0W              810.0W

show platform slices

To display the status of the slices for an interface, use the show platform slices command in the EXEC mode.

show platform slices [ locationnode-id ]

Syntax Description

location node-id

Interface details.

Command Default

None

Command Modes

EXEC

Command History

Release Modification

Release 5.3.0

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 power saving to power-off / on any of the slices (Slice 0 cannot be powered-off).

Task ID

Task ID Operation

sysmgr

read

Examples

This example shows how to use the show platform slices command: 

RP/0/RP0/CPU0:router # sh plat slices
show_slice nodeid 0x0

Line Card       Slice   Config          Status
0/0/CPU0        0       Power on        Completed     
                1       Power on        Completed     
                2       Power on        Completed     
                3       Power saving    Completed

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 counts location {all | node-id}

Syntax Description

location {all node-id} Displays plugin slot counts on the designated node or all nodes. The node-id argument is expressed in the rack/ slot 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:

Response error: 'ENVMON' detected the 'warning' condition 'Hardware not available'

Task ID

Task ID Operation

sysmgr

read

Examples

This example illustrates sample output from the show plugin slot counts command: 


RP/0/RSP0/CPU0:router(admin)# show plugin slot counts location all        

Tue Oct  6 13:37:15.706 pst

Backplane connector slot plugin counters

             Current         Cumulative
0/0/CPU0         176                176
0/1/CPU0          11                 11
0/2/CPU0           0                  0
0/3/CPU0           0                  0
0/RSP0/CPU0        0                  0
0/RSP1/CPU0        1                  1
0/4/CPU0           9                  9
0/5/CPU0           0                  0
0/6/CPU0          12                 12
0/7/CPU0           0                  0
0/FT0/SP           4                  4
0/FT1/SP          14                 14

Related Commands

Command Description

clear plugin slot counts

Clears the running counts of the backplane connector slot plugins.  

show canbus

  

show redundancy

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

XR EXEC

mode.

show redundancy [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 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

XR EXEC

Command History

Release

Modification

Release 5.0.0

This command was introduced.

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

Use the show redundancy command to display the redundancy status of the . The show redundancy command also displays the boot and switchover history for the . To view the nonstop routing (NSR) status of the standby in the system, use the summary keyword.

Task ID

Task ID

Operations

system

read

basic-services

read (for statistics keyword)

Examples


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