Table Of Contents
Cisco 10000 Series Router CLI Command Changes in Cisco IOS Release 12.2(33)SB
Restrictions for CLI Command Changes
Information About CLI Command Changes
debug ipv6 icmp Command Output for IPv6 ICMP
no Commands Removed from the Default Configuration
show controllers and Loopback CLI Commands
show controller and Line Code Information
show policy-map Command and Hierarchical Policies
show policy-map Command and Police Actions
show pxf cpu ipv6 table Command
show pxf cpu queue interface summary Command
show vpdn tunnel summary Command
snmp-server enable traps alarms Command
vpdn enable and vpdn-group Commands
show controllers (line card image)
show interfaces virtual-access
Feature Information for CLI Command Changes
Cisco 10000 Series Router CLI Command Changes in Cisco IOS Release 12.2(33)SB
First Published: April, 2008This feature guide describes changes in command line interface (CLI) command behavior in Cisco IOS Release 12.2(33)SB.
Finding Feature Information in This Module
Your Cisco IOS software release may not support all of the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To reach links to specific feature documentation in this module and to see a list of the releases in which each feature is supported, use the "Feature Information for CLI Command Changes" section.
Finding Support Information for Platforms and Cisco IOS and Catalyst OS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS and Catalyst OS software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Contents
•
Restrictions for CLI Command Changes
•
•
Restrictions for CLI Command Changes
Cisco IOS Release 12.2(33)SB or a later release must be running on the router.
Information About CLI Command Changes
Cisco IOS Release 12.2(33)SB introduces changes to the following CLI commands:
•
•
•
•
•
•
•
•
•
•
card Command
Cisco IOS Release 12.2(33)SB introduces the 4jacket-1 keyword and the spa-type option for the card command. The 4jacket-1 keyword enables you to preprovision a line card slot to accept a Cisco 10000 SIP-600. The spa-type option preprovisions a line card slot to accept a shared port adaptor (SPA) interface.
Use the following syntax to preprovision a line card slot to accept a Cisco 10000 SIP-600:
card slot subslot 4jacket-1Use the following syntax to preprovision a line card slot to accept a SPA interface:
card slot subslot spa-type
The following example preprovisions line card slot 3 to accept a Cisco 10000 SIP-600 and a 2-port Gigabit Ethernet SPA in subslot 0:
Router(config)# card 3 4jacket-1Router(config)# card 3/0 spa-2x1ge-v2CoPP-Related show Commands
The router supports the following CoPP-related show commands:
•
•
•
•
•
debug ipv6 icmp Command Output for IPv6 ICMP
In Cisco IOS Release 12.2(33)SB, output from the debug ipv6 icmp command displays information similar to the following:
ICMPv6: Received echo reply from 2010:1:1:1:1:1:1:2In Cisco IOS Release 12.2(31)SB, the debug ipv6 icmp command output displays information similar to the following:
ICMPv6: Received ICMPv6 packet from 2010:1:1:1:1:1:1:2, type 129frame-relay broadcast-queue
In Cisco IOS Release 12.2(33)SB, the default queue size for the frame-relay broadcast-queue is 256 packets.
In Cisco IOS Release 12.2(31)SB, the default queue size is 64 packets.
frame-relay switching Command
In Cisco IOS Release 12.2(33)SB, you do not need to configure the frame-relay switching command when configuring a Frame Relay interface as the DCE.
In Cisco IOS Release 12.2(31)SB, you must configure the frame-relay switching command when you configure a Frame Relay interface as the DCE.
hw-module slot
In Cisco IOS Release 12.2(33)SB, when you enter the hw-module slot slot-number reset command, the software asks you to confirm the command. In Cisco IOS Release 12.2(31)SB, the software does not ask you to confirm the command.
Cisco IOS Release 12.2(33)SB introduces the hw-module slot slot-number reload command on the router. The reload keyword enables a remote reload of an individual feature board without having to use manual online insertion and removal (OIR).
no Commands Removed from the Default Configuration
In Cisco IOS Release 12.2(33)SB, the router removes the following no commands from the default configuration:
•
•
•
no fair-queue Command
In Cisco IOS Release 12.2(33)SB, the router removes the no fair-queue command from serial interfaces.
plim qos input map Command
Cisco IOS Release 12.2(33)SB introduces the plim qos input map command on the router. This command configures a priority queue on Gigabit Ethernet SPAs, separating high-priority traffic from low-priority traffic and placing the traffic in the appropriate interface queue. The command separates priority and non-priority traffic at the SPA interface processor (SIP) to prevent the dropping of high priority traffic in an oversubscription case. Each shared port adaptor (SPA) supports one priority queue.
The command has the following syntax:
plim qos input map {cos {enable | cos-value queue low-latency} | ip {dscp-based | dscp dscp-value queue low-latency} | ip {precedence-based | precedence precedence-value queue low-latency} | ipv6 tc tc-value queue low-latency | mpls exp exp-value queue low-latency
The router supports the following classification types for the prioritization of ingress traffic on the Gigabit Ethernet SPAs:
•
•
•
•
•
police Command
Cisco IOS Release 12.2(33)SB supports a police submode and dual police actions.
The output from the show policy-map interface command displays the police actions in the police submode, displaying each action on a new line. Regardless of whether you configure a single action or dual actions for the colors, the police actions display on a new line as shown in the following sample output:
Router# show policy-map interface ATM1/0/0.131ATM1/0/0.131: VC 1/131 -Service-policy input: testClass-map: prec1 (match-any)0 packets, 00 bytes5 minute offered rate 0 bps, drop rate 0 bpsMatch: ip precedence 10 packets, 0 bytes5 minute rate 0 bpsPolice:7504000 bps, 100 limit, 10 extended limitconformed 0 packets, 0 bytes; action:set-clp-transmitset-mpls-exp-imposition-transmit 1exceeded 0 packets, 0 bytes; action:set-clp-transmitviolated 0 packets, 0 bytes; action:set-clp-transmitClass-map: class-default (match-any)0 packets, 0 bytes5 minute offered rate 0 bps, drop rate 0 bpsMatch: any0 packets, 0 bytes5 minute rate 0 bpsThe router supports only the following combinations of dual actions:
•
•
•
When configuring the police command, if you specify actions and then later modify the configured rate parameters, but not the actions, the specified actions change to the default values if only one action is specified for each conform, exceed, and violate color. However, if at least one color has dual actions configured, then modifying only the rate parameters does not change the actions to the default value, but instead preserves the previous actions.
For example, the following sample configuration configures the police rate parameters and only one action for each conform, exceed, and violate color:
Router(config)# policy-map testRouter(config-pmap)# class prec1Router(config-pmap-c)# police 500000 100 0 conform-action set-clp-transmit exceed-action set-clp-transmit violate-action set-clp-transmitThe output from the show policy-map command displays the following police configuration:
Router# show policy-map testPolicy Map testClass prec1police 504000 100 0conform-action set-clp-transmitexceed-action set-clp-transmitviolate-action set-clp-transmitThe following configuration modifies the police rate parameters, but not the actions:
Router(config)# policy-map testRouter(config-pmap)# class prec1Router(config-pmap-c)# police 750000 100 0
The following output from the show policy-map command indicates that the color values were changed to the default values. This is because only one action was configured for each color.
Router# show policy-map testPolicy Map testClass prec1police 752000 100 100conform-action transmitexceed-action dropviolate-action dropThe following output from the show policy-map command displays a police configuration in which the conform color has dual actions configured:
Router# show policy-map testPolicy Map testClass prec1police 504000 100 0conform-action set-clp-transmitconform-action set-mpls-exp-imposition-transmit 1exceed-action set-clp-transmitviolate-action set-clp-transmitThe following configuration modifies the police rate parameters, but not the actions:
Router(config)# policy-map testRouter(config-pmap)# class prec1Router(config-pmap-c)# police 7500000 100 10The following output from the show policy-map command indicates that the color values did not change when the rate parameters were modified. Instead, the original values were preserved.
Router# show policy-map testPolicy Map testClass prec1police 7500000 100 10conform-action set-clp-transmitconform-action set-mpls-exp-imposition-transmit 1exceed-action set-clp-transmitviolate-action set-clp-transmitIn Cisco IOS Release 12.2(31)SB and later releases, if you modify the police rate parameters, but not the action parameters, the police actions default to conform-action transmit, exceed-action drop, and violate-action drop.
For example, the following sample configuration shows the police command configured in the policy map named test. The police actions are set to set-clp-transmit for conforming, exceeding, and violating traffic. The police rate parameters are then changed to 500000, 250, and 200, but no actions are modified. When you display the test policy map again, you can see that the police actions default to transmit, drop, and drop.
Router# show policy-map testPolicy Map testClass prec1police 248000 100 10 conform-action set-clp-transmit exceed-action set-clp-transmit violate-action set-clp-transmitRouter#Router(config)# policy-map testRouter(config-pmap)# class prec1Router(config-pmap-c)# police 500000 250 200Router(config-pmap-c)# endRouter# show policy-map testPolicy Map testClass prec1police 504000 250 200 conform-action transmit exceed-action drop violate-action dropservice-policy Command
In Cisco IOS Release 12.2(33)SB and later releases, the router no longer accepts the abbreviated form (ser) of the service-policy command. Instead, you must spell out the command name service- before the router accepts the command.
For example, when attaching a policy map the following error message displays when you attempt to use the abbreviated form of the service-policy command:
Router(config)# interface gigabit1/1/0Router(config-if)# ser out ?% Unrecognized commandRouter(config-if)# ser ?% Unrecognized commandWhen you enter the command as service-, the router accepts the command as shown in the following example:
Router(config-if)# service- ?input Assign policy-map to the input of an interfaceoutput Assign policy-map to the output of an interfacetype Configure CPL Service PolicyIn releases prior to Cisco IOS Release 12.2(33)SB, the router accepts the abbreviated form of the service-policy command. For example, the router accepts the following commands:
Router(config)# interface gigabit1/1/0Router(config-if)# ser out testshow atm vp Command
In Cisco IOS Release 12.2(33)SB, the output from the show atm vp command nolonger displays "ATM" as the type of interface, as shown in the following sample output:
Router# show atm vpData CES PEAK CES Avg/Min Burst MCRInterface VPI SC VCs VCs Kbps Kbps Kbps Cells Kbps CDVT Status3/0/0 200 N/A 0 0 2000 0 NA NA NA 140.0 ACTIVEIn Cisco IOS Release 12.2(31)SB, the output from the show atm vp command displays the ATM interface type:
Router# show atm vpData CES PEAK CES Avg/Min Burst MCR CDVTInterface VPI SC VCs VCs Kbps Kbps Kbps Cells Kbps Usecs StatusATM3/0/0 200 0 0 2000 0 NA NA NA 140.0 ACTIVEshow controller Command
This section describes the following changes in the show controller command:
•
•
show controllers and Loopback CLI Commands
In releases prior to Cisco IOS Release 12.2(33)SB, when you configure the t1 loopback remote command on the local router, the command also displays in the running-config file of the far-end router. This is due to the route processor (RP) updating an incorrect parameter when it receives the loopback event message from the line card for loopback requests from the far end.
In Cisco IOS Release 12.2(33)SB, the RP updates the correct parameter and the show controllers command correctly displays the loopback CLI commands applied on the local end and displays the loopback events and status received from the line card in response to loopback requests from the far end.
This change in behavior affects the following line cards and is documented in the CSCsm84447 caveat:
•
•
•
•
show controller and Line Code Information
In Cisco IOS Release 12.2(33)SB, the output from the show controller command includes line code information for the 6-port channelized T3 line card and the 8-port E3/DS3 line card. However, because SONET line cards do not have a direct physical link at the T3 or E3 level, the output from the show controller t3 command does not include line code information.
In Cisco IOS Release 12.2(31)SB, the output from the show controller command displays line code information. The output of the show controller t3 command for SONET-based T3 also includes line code information.
The following examples from the show controller t3 command show the information that displays when the router is running Cisco IOS Release 12.2(33)SB and Cisco IOS Release 12.2(31)SB:
Cisco IOS Release 12.2(33)SB —No Line Code Information Displays
Router# show controller t3 5/0/0.1T3 5/0/0.1 is up. Hardware is C10K CHOC12 line cardApplique type is Channelized T3.Controller is in unchannelized mode.No alarms detected.MDL transmission is disabled.FEAC code received: No code is being received.Framing is C-BIT Parity (Configured), Clock Source is Internal.DSU mode is cisco, DSU bandwidth is 44210.Cisco IOS Release 12.2(31)SB —Line Code Information Displays
Router# show controller t3 5/0/0.1T3 5/0/0.1 is up. Hardware is C10K CHOC12 line cardApplique type is Channelized T3.Controller is in channelized mode.No alarms detected.MDL transmission is disabled.FEAC code received: No code is being receivedFraming is C-BIT Parity (Configured)Line Code is B3ZS, Clock Source is Internal.show diag Command
The show diag command has a new crashdump option to display any crashdump files collected on the SPA Interface Processor (SIP). The SIP stores the crashdump files by a reference number from 1 to 60.
To view a crashdump file, perform the following steps:
Step 1
a.
b.
Number of crashdumps : output numberStep 2
show diag slot/subslot crashdump number
Note
show interfaces Command
In Cisco IOS Release 12.2(33)SB, when a multilink PPP (MLPPP) interface is down/down, its default bandwidth rate is the sum of the serial interface bandwidths associated with the MLPPP interface.
In Cisco IOS Release 12.2(31)SB, the default bandwidth rate is 64 Kbps.
show policy-map Command and Hierarchical Policies
In Cisco IOS Release 12.2(33)SB, the output of the show policy-map command is slightly different from previous releases when the policy is an hierarchical policy.
For example, in Cisco IOS Release 12.2(33)SB output similar to the following displays when you specify a hierarchical policy in the show policy-map command:
Router# show policy-map Bronzepolicy-map bronzeclass class-defaultshape average 34386000service-policy ChildIn Cisco IOS Release 12.2(31)SB, output similar to the following displays when you specify a hierarchical policy in the show policy-map command:
Router# show policy-map Goldpolicy-map GoldClass class-defaultAverage Rate Traffic Shapingcir 34386000 (bps)service-policy Child2show policy-map Command and Police Actions
In Cisco IOS Release 12.2(33)SB, the output from the show policy-map command displays police actions on separate lines as shown in the following sample output:
Router# show policy-map PremiumPolicy Map PremiumClass P1prioritypolice percent 50 25 ms 0 msconform-action transmitexceed-action transmitviolate-action dropIn Cisco IOS Release 12.2(31)SB, the output from the show policy-map command displays police actions on one line as shown in the following sample output:
Router# show policy-map PremiumPolicy Map PremiumClass P1prioritypolice percent 50 25 ms 0 ms conform-action transmit exceed-action transmit violate- action dropshow pxf cpu ipv6 table Command
In Cisco IOS Release 12.2(33)SB, the show pxf cpu ipv6 table command displays the global table, but does not display the leafs that correspond to the IPv6 prefixes ::1/128 (Loopback) and ::/128 (All Zero). The microcode checks for these prefixes.
The show pxf cpu ipv6 table command replaces the show pxf cpu ipv6 command in Cisco IOS Release 12.2(31)SB.
show pxf cpu queue interface summary Command
In Cisco IOS Release 12.2(33)SB and later releases, the output from the show pxf cpu queue interface summary command displays only the physical interface and the number of logical links. The output does not display the number of priority queues, class queues, and so on. This modification applies to the PRE3 and PRE4.
show vpdn tunnel summary Command
In Cisco IOS Release 12.2(33)SB, the show vpdn tunnel summary command no longer displays the active PPPoE sessions. Instead, use the show pppoe sessions command to display the active sessions.
In Cisco IOS Release 12.2(31)SB, the show vpdn tunnel summary command does display the active PPPoE sessions.
snmp-server enable traps alarms Command
In releases prior to Cisco IOS Release 12.2(33)SB, the snmp-server enable traps alarms command displayed information about major, minor, critical, and informational alarms.
In Cisco IOS Release 12.2(33)SB, by default, the snmp-server enable traps alarms command displays information for informational alarms only. You can enable the following commands separately:
•
•
•
Virtual-Access show Commands
In Cisco IOS Release 12.2(33)SB and later releases, the router no longer allows you to specify a virtual-access interface (VAI) as viX.Y in the show pxf cpu queue and show interfaces commands. Instead, you must spell out the VAI as virtual-access.
For example, when you enter the following commands, the router accepts the commands:
Router# show pxf cpu queue virtual-access2.1Router# show interface virtual-access 2.1In releases prior to Cisco IOS Release 12.2(33)SB, the router accepts the abbreviated form of the VAI. For example, the router accepts the following commands:
Router# show pxf cpu queue vi2.1Router# show interface vi2.1virtual-template snmp Command
The virtual-template snmp command has a new default configuration in Cisco IOS Release 12.2(33)SB. The new default configuration was changed from enabled by default to disabled by default: no virtual-template snmp. This setting enhances scaling and prevents large numbers of entries in the MIB ifTable, thereby avoiding CPU Hog messages as SNMP uses the interfaces MIB and other related MIBs.
If you configure the no virtual-template snmp command, the router no longer accepts the snmp trap link-status command under a virtual-template interface. Instead, the router displays a configuration error message such as the following:
Router(config)# interface virtual-template 1Router(config-if)# snmp trap link-status%Unable set link-status enable/disable for interfaceIf your configuration already has the snmp trap link-status command configured under a virtual-template interface and you upgrade to Cisco IOS Release 12.2(33)SB, the configuration error occurs when the router reloads even though the virtual template interface is already registered in the interfaces MIB.
vpdn enable and vpdn-group Commands
In Cisco IOS Release 12.2(33)SB and later releases, the router no longer accepts the vpdn-group command if you issue the command before you issue the vpdn enable command. Instead, the following warning message displays:
% VPDN configuration is not allowed until VPDN is enabled through `vpdn enable'.In releases prior to Cisco IOS Release 12.2(33)SB, if you issue the vpdn-group command before the vpdn enable command, the router accepts the command and displays the following warning message:
% VPDN is not enabledAdditional References
The following sections provide references related to the CLI command changes.
Related Documents
Standards
No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.
—
MIBs
RFCs
No new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.
—
Technical Assistance
Command Reference
The following commands are modified in the feature documented in this module. For information about all Cisco IOS commands, use the Command Lookup Tool at http://tools.cisco.com/Support/CLILookup.
•
•
•
•
•
card
To preprovision a router slot for a particular interface card so that you can configure the interface without that card being physically present in the slot, use the card command in global configuration mode. To remove the preprovisioning for a card so that the physical slot reports being empty, use the no form of this command.
card {slot/subslot | slot/subslot/bay} card-type
no card {slot/subslot | slot/subslot/bay}
Cisco 10000 Series Router
card slot/subslot {lchoc12-1 | lgigethernet-l | 1gigethernet-hh-1 | loc12atm-1 | loc12pos-1 | 1oc48dpt-pos-1 | 24che1t1-1 | 4chstm-1 | 4cht3-hh-1| 4oc3atm-1 | 4oc3atm_lr-1 | 4jacket-1 | 6cht3-1 | 6oc3pos-1 | 8e3ds3-1 | 8e3ds3atm-1 | 8fastethernet-1 [ mode {e1 | t1}] | spa-type}
no card slot/subslot
Cisco uBR10012 Universal Broadband Router - Cisco IOS Release 12.2(33)SCB
card {slot | slot/bay} card-type
no card {slot | slot/bay}
Syntax Description
slot/subslot
Identifies the chassis slot and subslot for the card. The following are the valid values:
•
•
slot/subslot/bay
(Cisco uBR100012 router) Identifies the chassis slot and subslot for the Cisco Wideband SIP, and the bay number in the SIP where the Cisco Wideband SPA is located. The following are the valid values:
•
•
•
card-type
Specifies the type of card for which to preprovision the slot. See Table 0-1 for a list of the supported cards, which varies by platform.
lchoc12-1
Preprovisions a line card slot for a 1-Port Channelized OC-12/STM-4 line card.
lgigethernet-l
Preprovisions a line card slot for a 1-Port Gigabit Ethernet line card.
1gigethernet-hh-1
Preprovisions a line card slot for a 1-Port Gigabit Ethernet Half-Height line card.
loc12atm-1
Preprovisions a line card slot for a 1-Port OC-12 ATM line card.
loc12pos-1
Preprovisions a line card slot for a 1-Port OC-12 Packet over SONET line card.
1oc48dpt-pos-1
Preprovisions a line card slot for a 1-Port OC-48/STM-16 Packet over SONET line card.
24che1t1-1
Preprovisions a line card slot for a 24-Port Channelized E1/T1 line card.
4chstm-1
Preprovisions a line card slot for a 4-Port Channelized OC-3/STM-1 line card.
4cht3-hh-1
Preprovisions a line card slot for a 4-port Channelized Half-Height line card.
4oc3atm-1
Preprovisions a line card slot for a 4-Port OC-3/STM-1 ATM line card with intermediate-reach optics.
4oc3atm_lr-1
Preprovisions a line card slot for a 4-Port OC-3/STM-1 ATM line card with long-reach optics.
4jacket-1
Preprovisions a line card slot in the Cisco 10000 series router to accept a Cisco 10000 SIP-600.
6cht3-1
Preprovisions a line card slot for a 6-Port Channelized T3 line card.
6oc3pos-1
Preprovisions a line card slot for a 6-Port OC-3/STM-1 Packet over SONET line card.
8e3ds3-1
Preprovisions a line card slot for an 8-Port Unchannelized E3/T3 line card.
8e3ds3atm-1
Preprovisions a line card slot for an 8-Port E3/DS3 ATM line card.
8fastethernet-1
Preprovisions a line card slot for an 8-Port Fast Ethernet Half-Height line card.
mode {e1 | t1}
Indicates the mode of operation of the 24-Port Channelized E1/T1 line card.
spa-type
Specifies the SPA type to preprovision a SPA interface.
Command Default
An empty card slot is not preprovisioned and cannot be configured or displayed.
The default mode of operation for the 24-Port Channelized E1/T1 line card is E1.
Command Modes
Global configuration
Command History
Usage Guidelines
This command is supported on the Cisco uBR10012 Universal Broadband Router and the Cisco 10000 series routers. For platform-specific information about using this command, see the other platform-specific sections of this topic.
Use this command to preprovision a slot in the router to accept a particular line card, so that you can configure the interface without the card being physically present in the chassis. This command allows system administrators to plan for future configurations, without having to wait for the physical hardware to first arrive. When the line card does arrive, the installer can bring the card online by inserting the card into the chassis and connecting the necessary cables, without having to do any further configuration using the command-line interface.
The type of card must be appropriate for the slot being specified. The list of supported card types depends on the Cisco IOS software release in use and your platform. For the latest information about supported hardware for your platform, see the release notes that correspond to your Cisco IOS software release and platform.
Table 0-1 lists the types of cards that are supported as card-types for the card command:
Cisco uBR10012 Universal Broadband Router Usage Guidelines
On the Cisco uBR10012 router, you can use the card command to preprovision a router slot for a line card or to preprovision one or more slots for a SPA interface processor (SIP), such as the Cisco Wideband SIP. You can also use the card command to preprovision a SIP bay for a shared port adapter (SPA), such as the Cisco Wideband SPA.
The Cisco uBR10012 Universal Broadband Router has the following card slot requirements:
Note
•
•
•
•
Tip
When a line card is inserted in the Cisco uBR10012 chassis, the router performs the following actions, depending on whether the card slot is preprovisioned for the card:
•
•
•
Tip
The no version of the command removes the preprovisioning information from the given card slot. This also removes all configuration information for that card slot, as well as any information in the SNMP MIB database about the card and its card slot.
Cisco 10000 Series Router Usage Guidelines
You must specify a line card slot and subslot, and the line card for which you want to preprovision the line card slot.
If you insert a line card into a line card slot that has been preprovisioned for a different line card, the line card will fail.
You can specify a mode of operation for the 24-Port Channelized E1/T1 line card. If you do not, the line card operates in the E1 mode.
In Cisco IOS releases earlier than 12.0(28)S, 12.2(16)BX, and 12.3(7)XI1, you used only the card command to change the provisioning of a line card slot. It was not necessary to remove the old line card before using the card command to change the line card provisioning.
In Cisco IOS releases after 12.0(28)S, 12.2(16)BX, and 12.3(7)XI1, you must deactivate the installed line card using the hw-module and no card commands before using the card command to provision the line card slot for a different line card. This is a general best practice when using the card command.
Examples
Cisco uBR10012 Universal Broadband Router Examples
The following example shows a list of supported card types for Cisco IOS Release 12.2(8)BC1, and then shows that slot 8/0 is being preprovisioned for a Cisco uBR-LCP2-MC28C cable interface line card. The cable interface for slot 8/0 can then be configured.
Router# config tRouter(config)# card 5/0 ?1cable-mc16c create a uBR10000 line card with MC16C1cable-mc16e create a uBR10000 line card with MC16E1gigethernet-1 create a GE_1_PORT cardtype1oc12pos-1 create a OC12POS_1_PORT cardtype2cable-mc28bnc create a uBR10000 line card with MC28C, BNC connector2cable-mc28c create a uBR10000 line card with MC28C2oc12srp-sm-lr create a uBR10000 oc12 SRP card with SM LRRouter(config)# card 8/0 2cable-mc28cRouter(config)# int c8/0Router(config-if)#The following example shows how to preprovision a Cisco Wideband SIP in Cisco IOS Release 12.2(33)SCB:
Router# configure terminalRouter(config)# card 1 2jacket-1The following example shows how to preprovision a Cisco Wideband SPA on a Cisco Wideband SIP in Cisco IOS Release 12.2(33)SCB:
Router# configure terminalRouter(config)# card 1/0 24rfchannel-spa-1The following example shows how to preprovision a Cisco SIP-600 in Cisco IOS Release 12.2(33) SCB:
Router# configure terminalRouter(config)# card 3 4jacket-1The following example shows how to preprovision a Cisco Wideband SPA on a Cisco SIP-600 in Cisco IOS Release 12.2(33) SCB:
Router# configure terminalRouter(config)# card 3/0 24rfchannel-spa-1Cisco 10000 Series Router Examples
The following example preprovisions line card slot 2 to accept a 24-Port Channelized E1/T1 line card operating in E1 mode:
Router(config)# card 2/0 24che1t1-1 mode e1The following example shows how to change the provisioning for line card slot 5 from the 1-Port Gigabit Ethernet Half-Height line card to the 4-Port OC-3/STM-1 ATM line card.
Router(config)# hw-module subslot 5/0 shutAug 22 21:52:19.619 UTC: %IPCOIR-3-TIMEOUT: Timeout waiting for a response from slot 5/0.Aug 22 21:52:19.619 UTC: %IPCOIR-2-CARD_UP_DOWN: Card in slot 5/0 is down. Notifying 1gigethernet-hh-1 driver.Aug 22 21:52:21.627 UTC: %LINK-3-UPDOWN: Interface GigabitEthernet5/0/0, changed state to downAug 22 21:52:22.627 UTC: %LINEPROTO-5-UPDOWN: Line protocol on Interface GigabitEthernet5/0/0, changed state to downRouter(config)# no card 5/0 1gigethernet-hh-1Aug 22 21:53:20.008 UTC: %C10K-3-DEACTIVATED: card in slot [5/0] disabled.Router(config)# card 5/0 4oc3atm-1[ Remove the 1-Port Gigabit Ethernet Half-Height line card andinsert the 4-Port OC-3/STM-1 ATM line card ]Related Commands
show interface
Displays the current configuration and status for a specified interface type.
debug ipv6 icmp
To display debugging messages for IPv6 Internet Control Message Protocol (ICMP) transactions (excluding IPv6 ICMP neighbor discovery transactions), use the debug ipv6 icmp command in privileged EXEC mode. To disable debugging output, use the no form of this command.
debug ipv6 icmp
no debug ipv6 icmp
Syntax Description
This command has no arguments or keywords.
Command Default
Debugging for IPv6 ICMP is not enabled.
Command Modes
Privileged EXEC
Command History
Usage Guidelines
The debug ipv6 icmp command is similar to the debug ip icmp command, except that it is IPv6-specific.
Note
This command helps you determine whether the router is sending or receiving IPv6 ICMP messages. Use it, for example, when you are troubleshooting an end-to-end connection problem.
Note
Cisco 10000 Series Router Usage Guidelines
In Cisco IOS Release 12.2(33)SB, output from the debug ipv6 icmp command displays information similar to the following:
ICMPv6: Received echo reply from 2010:1:1:1:1:1:1:2In Cisco IOS Release 12.2(31)SB, the debug ipv6 icmp command output displays information similar to the following:
ICMPv6: Received ICMPv6 packet from 2010:1:1:1:1:1:1:2, type 129Examples
The following is sample output from the debug ipv6 icmp command:
Router# debug ipv6 icmp13:28:40:ICMPv6:Received ICMPv6 packet from 2000:0:0:3::2, type 13613:28:45:ICMPv6:Received ICMPv6 packet from FE80::203:A0FF:FED6:1400, type 13513:28:50:ICMPv6:Received ICMPv6 packet from FE80::203:A0FF:FED6:1400, type 13613:28:55:ICMPv6:Received ICMPv6 packet from FE80::203:A0FF:FED6:1400, type 135Table 2 describes significant fields shown in the first line of the display.
Following are examples of the IPv6 ICMP messages types that can be displayed by the debug ipv6 icmp command:
•
1w4d:ICMPv6:Sending echo request to 2052::501w4d:ICMPv6:Received echo reply from 2052::50•
1w4d:Received ICMP too big from 2052::52 about 2052::50, MTU=1300•
1w4d:Received ICMP parameter problem from 2052::52•
1w4d:Received ICMP time exceeded from 2052::52•
1w4d:Received ICMP unreachable code 1 from 2052::521w4d:Sending ICMP unreachable code 1 to 2060::20 about 2062::20Table 3 lists the codes for ICMP unreachable messages.
Related Commands
debug ipv6 nd
Displays debugging messages for IPv6 ICMP neighbor discovery transactions.
fair-queue (WFQ)
To enable weighted fair queueing (WFQ), use the fair-queue command in interface configuration or policy-map class configuration mode. To disable WFQ, use the no form of this command.
fair-queue [congestive-discard-threshold [dynamic-queues [reservable-queues]]]
no fair-queue
Syntax Description
Command Default
Fair queueing is enabled by default for physical interfaces whose bandwidth is less than or equal to 2.048 Mbps and that do not use the following:
•
•
•
•
•
•
•
Fair queueing is not an option for the protocols listed above. However, if you enable custom queueing or priority queueing for a qualifying link, it overrides fair queueing, effectively disabling it. Additionally, fair queueing is automatically disabled if you enable the autonomous or silicon switching engine mechanisms.
Note
The number of dynamic queues is derived from the interface or ATM permanent virtual circuit (PVC) bandwidth. See Table 4 in the fair-queue (class-default) command for the default number of dynamic queues that WFQ and class-based WFQ (CBWFQ) use when they are enabled on an interface. See Table 4 in the fair-queue (class-default) command for the default number of dynamic queues used when WFQ and CBWFQ are enabled on an ATM PVC.
Command Modes
Interface configuration (config-if)
Policy-map class configuration (config-pmap-c)Command History
Usage Guidelines
High-Level Overview
This command enables WFQ. With WFQ, packets are classified by flow. For example, packets with the same source IP address, destination IP address, source TCP or User Datagram Protocol (UDP) port, destination TCP or UDP port, and protocol belong to the same flow; see Table 4 for a full list of protocols and traffic stream discrimination fields.
When you enable WFQ on an interface, WFQ provides traffic priority management that automatically sorts among individual traffic streams without requiring that you first define access lists. Enabling WFQ requires use of this command only.
When you enable WFQ on an interface, new messages for high-bandwidth traffic streams are discarded after the configured or default congestive discard threshold has been met. However, low-bandwidth conversations, which include control message conversations, continue to enqueue data. As a result, the fair queue may occasionally contain more messages than its configured threshold number specifies.
WFQ uses a traffic data stream discrimination registry service to determine which traffic stream a message belongs to. For each forwarding protocol, Table 4 shows the message attributes that are used to classify traffic into data streams.
IP Precedence
IP Precedence, congestion in Frame Relay switching, and discard eligible (DE) flags affect the weights used for queueing.
IP Precedence, which is set by the host or by policy maps, is a number in the range from 0 to 7. Data streams of precedence number are weighted so that they are given an effective bit rate of number+1 times as fast as a data stream of precedence 0, which is normal.
FECN and BECN
In Frame Relay switching, message flags for forward explicit congestion notification (FECN), backward explicit congestion notification (BECN), and DE message flags cause the algorithm to select weights that effectively impose reduced queue priority. The reduced queue priority provides the application with "slow down" feedback and sorts traffic, giving the best service to applications within their committed information rate (CIR).
Fair Queueing, Custom Queueing, and Priority Queueing
Fair queueing is supported for all LAN and line (WAN) protocols except X.25, including LAPB and SDLC; see the notes in the section "Command Default." Because tunnels are software interfaces that are themselves routed over physical interfaces, fair queueing is not supported for tunnels. Fair queueing is on by default for interfaces with bandwidth less than or equal to 2 Mbps.
Note
RSVP
When you configure Resource Reservation Protocol (RSVP) on an interface that supports fair queueing or on an interface that is configured for fair queueing with the reservable queues set to 0 (the default), the reservable queue size is automatically configured using the following method: interface bandwidth divided by 32 kbps. You can override this default by specifying a reservable queue other than 0. For more information on RSVP, refer to the chapter "Configuring RSVP" in the Cisco IOS Quality of Service Solutions Configuration Guide.
Cisco 10000 Series Routers
In Cisco IOS Release 12.2(33)SB, the router removes the no fair-queue command from serial interfaces.
HQF
Beginning with Cisco IOS Release 12.4(20)T, if your image has HQF support, the fair-queue command is not enabled automatically under class default. You should enable the fair-queue command and any other supported queueing features before using an HQF-capable image.
Examples
The following example enables WFQ on serial interface 0, with a congestive threshold of 300. This threshold means that messages are discarded from the queueing system only when 300 or more messages have been queued and the message is in a data stream that has more than one message in the queue. The transmit queue limit is set to 2, based on the 384-kilobit (Kb) line set by the bandwidth command:
interface serial 0bandwidth 384fair-queue 300Unspecified parameters take the default values.
The following example requests a fair queue with a congestive discard threshold of 64 messages, 512 dynamic queues, and 18 RSVP queues:
interface serial 3/0ip unnumbered ethernet 0/0fair-queue 64 512 18You can apply the fair-queue command to a user-defined class as shown in the following example:
policy-map p1class c1bandwidth 1000fair-queueRelated Commands
frame-relay broadcast-queue
To create a special queue for a specified interface to hold broadcast traffic that has been replicated for transmission on multiple data-link connection identifiers (DLCIs), use the frame-relay broadcast-queue command in interface configuration mode.
frame-relay broadcast-queue size byte-rate packet-rate
Syntax Description
size
Number of packets to hold in the broadcast queue.
byte-rate
Maximum number of bytes to be sent per second.
packet-rate
Maximum number of packets to be sent per second.
Defaults
size: 64 packets
byte-rate: 256000 bytes per second
packet-rate: 36 packets per secondCommand Modes
Interface configuration
Command History
Usage Guidelines
For purposes of the Frame Relay broadcast queue, broadcast traffic is defined as packets that have been replicated for transmission on multiple DLCIs. However, the broadcast traffic does not include the original routing packet or service access point (SAP) packet, which passes through the normal queue. Because of timing sensitivity, bridged broadcasts and spanning-tree packets are also sent through the normal queue. The Frame Relay broadcast queue is managed independently of the normal interface queue. It has its own buffers and a configurable service rate.
A broadcast queue is given a maximum transmission rate (throughput) limit measured in bytes per second and packets per second. The queue is serviced to ensure that only this maximum is provided. The broadcast queue has priority when transmitting at a rate below the configured maximum, and hence has a guaranteed minimum bandwidth allocation. The two transmission rate limits are intended to avoid flooding the interface with broadcasts. The actual limit in any second is the first rate limit that is reached.
Given the transmission rate restriction, additional buffering is required to store broadcast packets. The broadcast queue is configurable to store large numbers of broadcast packets.
The queue size should be set to avoid loss of broadcast routing update packets. The exact size will depend on the protocol being used and the number of packets required for each update. To be safe, set the queue size so that one complete routing update from each protocol and for each DLCI can be stored. As a general rule, start with 20 packets per DLCI. Typically, the byte rate should be less than both of the following:
•
•
The packet rate is not critical if you set the byte rate conservatively. Set the packet rate at 250-byte packets.
Cisco 10000 Series Router Usage Guidelines
In Cisco IOS Release 12.2(33)SB, the default queue size for the frame-relay broadcast-queue is 256 packets.
In Cisco IOS Release 12.2(31)SB, the default queue size is 64 packets.
Examples
The following example specifies a broadcast queue to hold 80 packets, to have a maximum byte transmission rate of 240000 bytes per second, and to have a maximum packet transmission rate of 160 packets per second:
frame-relay broadcast-queue 80 240000 160frame-relay switching
To enable permanent virtual switching (PVC) switching on a Frame Relay DCE device or a Network-to-Network Interface (NNI), use the frame-relay switching command in global configuration mode. To disable switching, use the no form of this command.
frame-relay switching
no frame-relay switching
Syntax Description
This command has no arguments or keywords.
Defaults
Switching is not enabled.
Command Modes
Global configuration
Command History
Usage Guidelines
You must add this command to the configuration file before configuring the routes.
Cisco 10000 Serie Router Usage Guidelines
In Cisco IOS Release 12.2(33)SB, you do not need to configure the frame-relay switching command when configuring a Frame Relay interface as the DCE.
In Cisco IOS Release 12.2(31)SB, you must configure the frame-relay switching command when you configure a Frame Relay interface as the DCE.
Examples
The following example shows the command that is entered in the configuration file before the Frame Relay configuration commands to enable switching:
frame-relay switchinghw-module slot
To enable the router shelf to restart a stopped Dial Shelf Controller (DSC) card, to stop a DSC card, or to cause a shutdown, reset, or reload of any specified dial shelf feature board, use the hw-module slot command in privileged EXEC mode.
hw-module slot shelf-id/slot-number {reload | reset | shutdown | start | stop}
Syntax Description
Command Modes
Privileged EXEC
Command History
Usage Guidelines
The stop form of this command is issued from the router shelf console instead of by pressing the attention (ATTN) button on the target DSC. Confirmation of when the start or stop took place is displayed. Warnings are issued and confirmation input is required if a stop command will result in a loss of service when backup functionality is not available.
When a DSC card is stopped, removed, and then reinstalled, there is no need to restart the card (whether the card is the original or a replacement) because a freshly installed card reboots as the backup DSC automatically. However, if a DSC is stopped, either by using the ATTN button or by issuing the hw-module slot stop command, it must be restarted by using the start form of the same command, or the DSC must be removed and reinstalled in order to reboot.
Press the ATTN button on the DSCs to shut down a card manually before removing the card. This is equivalent to issuing a hw-module slot command for that card at the router command prompt. Use the ATTN button to shut down the card before it is swapped out or tested in place, or to restart it, if the card has not been removed after having been shut down.
Tip
OIR event in the case of a feature board failure when physical access to the feature board card is restricted.Entering the hw-module slot shelf-id/slot-number reload command initiates the feature board reload process through power cycling. The hw-module slot shelf-id/slot-number reload command cannot be used to reload DSCs.
Use the reset form of this command to reset the specified feature card and drop all active calls.
Use the shutdown form of this command to shut down the specified feature card and drop all active calls.
Cisco 10000 Series Router Usage Guidelines,
In Cisco IOS Release 12.2(33)SB, when you enter the hw-module slot slot-number reset command, the software asks you to confirm the command.
In Cisco IOS Release 12.2(31)SB, the software does not ask you to confirm the hw-module slot slot-number reset command.
Examples
The following example shows how to stop the DSC in slot 13 and start the other DSC in slot 12 (which was previously stopped):
Router# hw-module slot 1/13 stopRouter# hw-module slot 1/12 startThe following example shows how to reload the dial shelf feature board in slot 6:
Router# hw-module slot 1/6 reloadThe following example shows how to reset the card in slot 3:
Router# hw-module slot 1/3 resetThe following example shows how to shut down the PRE card located in slot 3:
Router# hw-module slot 1/3 shutdownRelated Commands
plim qos input map
To configure a priority queue on Gigabit Ethernet SPAs, use the plim qos input map command in interface or subinterface configuration mode. To remove a priority queue, use the no form of this command.
plim qos input map {cos {enable | cos-value queue low-latency} | ip {dscp-based | dscp dscp-value queue low-latency} | ip {precedence-based | precedence precedence-value queue low-latency} | ipv6 tc tc-value queue low-latency | mpls exp exp-value queue low-latency
Syntax Description
Defaults
Disabled
Command Modes
Interface or subinterface configuration
Command History
Usage Guidelines
The plim qos input map command separates high-priority traffic from low-priority traffic and places the traffic in the appropriate interface queue. The command separates priority and non-priority traffic at the SPA interface processor (SIP) to prevent the dropping of high priority traffic in an oversubscription case. Each shared port adaptor (SPA) supports one priority queue.
The router supports the following classification types for the prioritization of ingress traffic on the Gigabit Ethernet SPAs:
•
•
•
•
•
For the plim qos input map ip dscp dscp-value queue low-latency command, valid values for dscp-value are one of the following:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
For the plim qos input map ipv6 tc tc-value queue low-latency command, valid values for tc-value are one of the following:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Examples
The following example enables DSCP-based classification on the SPA that is located in subslot 0 of the SIP in slot 1 of the Cisco 10000 series router:
Router(config)# interface gigabitethernet 3/0/1
Router(config-if)# plim qos input map ip dscp-based
Related Commands
police (policy map)
To create a per-interface policer and configure the policy-map class to use it, use the police command in policy-map class configuration mode. To delete the per-interface policer from the policy-map class, use the no form of this command.
police
police bps [[bc] normal-burst-bytes [maximum-burst-bytes | [be] [burst-bytes]]] [pir bps [be burst-bytes]] [conform-action action [exceed-action action [violate-action action]]]
no police bps
police aggregate
police aggregate name
no police aggregate name
police cir
police cir bps [[bc] normal-burst-bytes [maximum-burst-bytes | [be] [burst-bytes]]] [pir bps [be burst-bytes]] [conform-action action [exceed-action action [violate-action action]]]
no police cir bps
police cir percent
police cir percent percent [burst ms [be] [burst ms]] [pir percent percent [be burst ms]] [conform-action action [exceed-action action [violate-action action]]]
no police cir percent
police flow
police flow bps [normal-burst-bytes] [conform-action action [exceed-action action]]
police flow mask {dest-only | full-flow | src-only} bps [normal-burst-bytes] [conform-action action [exceed-action action]]
no police flow
Syntax Description
Command Default
No policing is performed.
Command Modes
Policy-map class configuration (config-pmap-c)
Command History
Usage Guidelines
In Cisco IOS Release 12.2(17d)SXB3, valid values for the bps argument for the FlexWAN interfaces only are from 8,000 to 4,000,000,000 bps.
Use the mls qos aggregate-policer name command to create a named aggregate policer.
You can create two types of aggregate policers: named and per-interface. Both types can be attached to more than one port as follows:
•
•
Use the no police aggregate name command to clear the use of the named aggregate policer.
Enter the police flow command to define a microflow policer (you cannot apply microflow policing to ARP traffic).
Enter the police command to define per-interface (not named) aggregate policers.
If the traffic is both aggregate and microflow policed, the aggregate and the microflow policers must both be in the same policy-map class and each must use the same conform-action and exceed-action keywords.
Values for the action Argument
The valid values for the action argument are as follows:
•
•
•
•
•
•
–
–
–
–
•
•
•
Note
•
•
•
If the following keywords are not specified, the default actions are as follows:
•
•
•
Cisco 10000 Series Router
In releases earlier than Cisco IOS Release 12.2(31)SB, if you modify the police rate parameters, but not the action parameters, the action parameters revert to the default actions.
For example, the following sample configuration shows the police command configured in the policy map named test. The police actions are set to set-clp-transmit for conforming, exceeding, and violating traffic. The police rate parameters are then changed to 500000, 250, and 200, respectively, but no actions are modified. When you display the test policy map again, you can see that the police actions default to transmit, drop, and drop, respectively.
Router# show policy-map testPolicy Map testClass prec1police 248000 100 10 conform-action set-clp-transmit exceed-action set-clp-transmit violate-action set-clp-transmitRouter# configure terminalEnter configuration commands, one per line. End with CNTL/Z.Router(config)# policy-map testRouter(config-pmap)# class prec1Router(config-pmap-c)# police 500000 250 200Router(config-pmap-c)# endRouter# show policy-map testPolicy Map testClass prec1police 500000 250 200 conform-action transmit exceed-action drop violate-action dropCisco IOS Release 12.2(33)SB and later releases support dual police actions and a police submode; therefore, if you use the police command to modify only the rate parameters, the police actions do not default to the default actions and the previous actions are preserved.
For example, the following sample configuration shows the police command configured under the traffic class named prec1 in the policy map named test. The police rate is specified and the police actions are then specified in police submodes. After you change only the police rate parameters, the police actions do not default, but rather they retain their original settings.
Router# show policy-map testPolicy Map testClass prec1police 248000 1000 100conform-action set-clp-transmitexceed-action set-clp-transmitviolate-action set-clp-transmitRouter# configure terminalEnter configuration commands, one per line. End with CNTL/Z.Router(config)# policy-map testRouter(config-pmap)# class prec1Router(config-pmap-c)# police 500000 100 200Router(config-pmap-c)# endRouter# show policy-map testPolicy Map testClass prec1police 500000 100 200conform-action set-clp-transmitexceed-action set-clp-transmitviolate-action set-clp-transmitExamples
This example shows how to specify a previously defined aggregate-policer name and configure the policy-map class to use the specified aggregate policer:
Router(config-pmap-c)# police aggregate agg1This example shows how to create a policy map named police-setting that uses the class map access-match, which is configured to trust received IP-precedence values and is configured with a maximum-capacity aggregate policer and a microflow policer:
Router# configure terminalEnter configuration commands, one per line. End with CNTL/Z.Router(config)# policy-map police-settingRouter(config-pmap)# class access-matchRouter(config-pmap-c)# trust ip-precedenceRouter(config-pmap-c)# police 1000000000 200000 conform-action set-prec-transmit 6 exceed-action policed-dscp-transmitRouter(config-pmap-c)# police flow 10000000 10000 conform-action set-prec-transmit 6 exceed-action policed-dscp-transmitRouter(config-pmap-c)# exitRelated Commands
scripting tcl encdir
To specify the default location of external encoding files used by the Tool Command Language (Tcl) shell, use the scripting tcl encdir command in global configuration mode. To remove the default location, use the no form of this command.
scripting tcl encdir location-url
no scripting tcl encdir
Syntax Description
Defaults
Tcl does not use external encoding files.
Command Modes
Global configuration
Command History
Usage Guidelines
Character strings in Tcl are encoded using 16-bit Unicode characters. Different operating system interfaces or applications can generate character strings using other encoding methods. Use the scripting tcl encdir command to configure a location URL for the external Tcl character encoding files to support the Tcl encoding command.
Tcl contains only a few character sets within the Tcl shell. Additional characters sets are loaded, as needed, from external files.
Cisco 10000 Series Router Usage Guidelines
In Cisco IOS Release 12.2(33)SB, the router removes the no scripting tcl encdir command from the default configuration.
Examples
The following example shows how to specify a default location for external encoding files to be used by Tcl:
Router# configure terminalRouter(config)# scripting tcl encdir tftp://10.18.117.23/file2/Related Commands
scripting tcl init
Specifies an initialization script for the Tcl shell.
tclsh
Enables the Tcl shell and enters Tcl configuration mode.
scripting tcl init
To specify an initialization script for the Tool Command Language (Tcl) shell, use the scripting tcl init command in global configuration mode. To remove the initialization script, use the no form of this command.
scripting tcl init init-url
no scripting tcl init
Syntax Description
Defaults
Tcl does not run an initialization script.
Command Modes
Global configuration
Command History
Usage Guidelines
Use the scripting tcl init command when you want to predefine Tcl procedures to run in an initialization script. The initialization script runs when the Tcl shell is entered and saves manual sourcing of the individual scripts.
Cisco 10000 Series Router Usage Guidelines
In Cisco IOS Release 12.2(33)SB, the router removes the no scripting tcl init command from the default configuration.
Examples
The following example shows how to specify an initialization script to run when the Tcl shell is enabled:
Router# configure terminalRouter(config)# scripting tcl init ftp://user:password@172.17.40.3/tclscript/initfile3.tclRelated Commands
scripting tcl encdir
Specifies the default location of external encoding files used by the Tcl shell.
tclsh
Enables the Tcl shell and enters Tcl configuration mode.
service-policy
To attach a policy map to an input interface, a virtual circuit (VC), an output interface, or a VC that will be used as the service policy for the interface or VC, use the service-policy command in the appropriate configuration mode. To remove a service policy from an input or output interface or from an input or output VC, use the no form of this command.
service-policy [type access-control] {input | output} policy-map-name
no service-policy [type access-control] {input | output} policy-map-name
Cisco 10000 Series and Cisco 7600 Series Routers
service-policy [history | {input | output} policy-map-name | type control control-policy-name]
no service-policy [history | {input | output} policy-map-name | type control control-policy-name]
Syntax Description
Command Default
No service policy is specified.
A control policy is not applied to a context.
No policy map is attached.Command Modes
ATM bundle-VC configuration (config-atm-bundle)
ATM PVP configuration (config-if-atm-l2trans-pvp)
ATM VC mode (config-if-atm-vc)
Global configuration (config)
Interface configuration (config-if)
Map-class configuration (config-map-class)
PVC-in-range configuration (cfg-if-atm-range-pvc)
PVC range subinterface configuration (config-subif)Command History
Usage Guidelines
Choose the command mode according to the intended use of the command, as follows:
You can attach a single policy map to one or more interfaces or to one or more VCs to specify the service policy for those interfaces or VCs.
A service policy specifies class-based weighted fair queueing (CBWFQ). The class policies that make up the policy map are then applied to packets that satisfy the class map match criteria for the class.
To successfully attach a policy map to an interface or ATM VC, the aggregate of the configured minimum bandwidths of the classes that make up the policy map must be less than or equal to 75 percent (99 percent on the Cisco 10008 router) of the interface bandwidth or the bandwidth allocated to the VC.
To enable Low Latency queueing (LLQ) for Frame Relay (priority queueing [PQ]/CBWFQ), you must first enable Frame Relay Traffic Shaping (FRTS) on the interface using the frame-relay traffic-shaping command in interface configuration mode. You then attach an output service policy to the Frame Relay VC using the service-policy command in map-class configuration mode.
For a policy map to be successfully attached to an interface or ATM VC, the aggregate of the configured minimum bandwidths of the classes that make up the policy map must be less than or equal to 75 percent of the interface bandwidth or the bandwidth allocated to the VC. For a Frame Relay VC, the total amount of bandwidth allocated must not exceed the minimum committed information rate (CIR) configured for the VC less any bandwidth reserved by the frame-relay voice bandwidth or frame-relay ip rtp priority map-class commands. If these values are not configured, the minimum CIR defaults to half of the CIR.
Configuring CBWFQ on a physical interface is possible only if the interface is in the default queueing mode. Serial interfaces at E1 (2.048 Mbps) and below use weighted fair queueing (WFQ) by default. Other interfaces use first-in first-out (FIFO) by default. Enabling CBWFQ on a physical interface overrides the default interface queueing method. Enabling CBWFQ on an ATM permanent virtual circuit (PVC) does not override the default queueing method.
When you attach a service policy with CBWFQ enabled to an interface, commands related to fancy queueing such as those pertaining to fair queueing, custom queueing, priority queueing, and Weighted Random Early Detection (WRED) are available using the modular quality of service command-line interface (MQC). However, you cannot configure these features directly on the interface until you remove the policy map from the interface.
You can modify a policy map attached to an interface or VC, changing the bandwidth of any of the classes that make up the map. Bandwidth changes that you make to an attached policy map are effective only if the aggregate of the bandwidth amount for all classes that make up the policy map, including the modified class bandwidth, is less than or equal to 75 percent of the interface bandwidth or the VC bandwidth. If the new aggregate bandwidth amount exceeds 75 percent of the interface bandwidth or VC bandwidth, the policy map is not modified.
After you apply the service-policy command to set a class of service (CoS) bit to an Ethernet interface, the policy is set in motion as long as there is a subinterface that is performing 8021.Q or Inter-Switch Link (ISL) trunking. Upon reload, however, the service policy is removed from the configuration with the following error message:
Process `set' action associated with class-map voip failed: Set cos supported only with IEEE 802.1Q/ISL interfaces.Cisco 10000 Series Router Usage Guidelines
The Cisco 10000 series router does not support applying CBWFQ policies to unspecified bit rate (UBR) VCs.
For a policy map to be successfully attached to an interface or a VC, the aggregate of the configured minimum bandwidth of the classes that make up the policy map must be less than or equal to 99 percent of the interface bandwidth or the bandwidth allocated to the VC. If you attempt to attach a policy map to an interface when the sum of the bandwidth assigned to classes is greater than 99 percent of the available bandwidth, the router logs a warning message and does not allocate the requested bandwidth to all of the classes. If the policy map is already attached to other interfaces, it is removed from them.
The total bandwidth is the speed (rate) of the ATM layer of the physical interface. The router converts the minimum bandwidth that you specify to the nearest multiple of 1/255 (ESR-PRE1) or 1/65535 (ESR-PRE2) of the interface speed. When you request a value that is not a multiple of 1/255 or 1/65535, the router chooses the nearest multiple.
The bandwidth percentage is based on the interface bandwidth. In a hierarchical policy, the bandwidth percentage is based on the nearest parent shape rate.
By default, a minimum bandwidth guaranteed queue has buffers for up to 50 milliseconds of 256-byte packets at line rate, but not less than 32 packets.
For Cisco IOS Release 12.0(22)S and later releases, to enable LLQ for Frame Relay (priority queueing (PQ)/CBWFQ) on the Cisco 10000 series router, first create a policy map and then assign priority to a defined traffic class using the priority command. For example, the following sample configuration shows how to configure a priority queue with a guaranteed bandwidth of 8000 kbps. In the example, the Business class in the policy map named "map1" is configured as the priority queue. The map1 policy also includes the Non-Business class with a minimum bandwidth guarantee of 48 kbps. The map1 policy is attached to serial interface 2/0/0 in the outbound direction.
class-map Businessmatch ip precedence 3policy-map map1class Businessprioritypolice 8000class Non-Businessbandwidth 48interface serial 2/0/0frame-relay encapsulationservice-policy output map1On the PRE2, you can use the service-policy command to attach a QoS policy to an ATM subinterface or to a PVC. However, on the PRE3, you can attach a QoS policy only to a PVC.
Cisco 7600 Series Routers
The output keyword is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
Do not attach a service policy to a port that is a member of an EtherChannel.
Although the CLI allows you to configure QoS based on policy feature cards (PFCs) on the WAN ports on the OC-12 ATM optical services modules (OSM) and on the WAN ports on the channelized OSMs, PFC-based QoS is not supported on the WAN ports on these OSMs. OSMs are not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 32.
PFC QoS supports the optional output keyword only on VLAN interfaces. You can attach both an input policy map and an output-policy map to a VLAN interface.
Cisco 10000 Series Routers Control Policy Maps
A control policy map must be activated by applying it to a context. A control policy map can be applied to one or more of the following types of contexts, which are listed in order of precedence:
1.
2.
3.
4.
5.
6.
In general, control policy maps that are applied to more specific contexts take precedence over policy maps applied to more general contexts. In the list, the context types are numbered in order of precedence. For example, a control policy map that is applied to a permanent virtual circuit (PVC) takes precedence over a control policy map that is applied to an interface.
Control policies apply to all sessions hosted on the context. Only one control policy map can be applied to a given context.
In Cisco IOS Release 12.2(33)SB and later releases, the router no longer accepts the abbreviated form (ser) of the service-policy command. Instead, you must spell out the command name service- before the router accepts the command.
For example, the following error message displays when you attempt to use the abbreviated form of the service-policy command:
interface GigabitEthernet1/1/0ser out ?% Unrecognized commandser ?% Unrecognized commandAs shown in the following example, when you enter the command as service- followed by a space, the router parses the command as service-policy. Entering the question mark causes the router to display the command options for the service-policy command.
service- ?input Assign policy-map to the input of an interfaceoutput Assign policy-map to the output of an interfacetype Configure CPL Service PolicyIn releases prior to Cisco IOS Release 12.2(33)SB, the router accepts the abbreviated form of the service-policy command. For example, the router accepts the following commands:
interface GigabitEthernet1/1/0ser out testExamples
The following example shows how to attach a policy map to a Fast Ethernet interface:
interface fastethernet 5/20service-policy input pmap1The following example shows how to attach the service policy map named "policy9" to DLCI 100 on output serial interface 1 and enables LLQ for Frame Relay:
interface Serial1/0.1 point-to-pointframe-relay interface-dlci 100class fragmentmap-class frame-relay fragmentservice-policy output policy9The following example shows how to attach the service policy map named "policy9" to input serial interface 1:
interface Serial1service-policy input policy9The following example attaches the service policy map named "policy9" to the input PVC named "cisco":
pvc cisco 0/34 service-policy input policy9vbr-nt 5000 3000 500 precedence 4-7The following example shows how to attach the policy named "policy9" to output serial interface 1 to specify the service policy for the interface and enable CBWFQ on it:
interface serial1service-policy output policy9The following example attaches the service policy map named "policy9" to the output PVC named "cisco":
pvc cisco 0/5 service-policy output policy9 vbr-nt 4000 2000 500 precedence 2-3Cisco 10000 Series Router Examples
The following example shows how to attach the service policy named "userpolicy" to DLCI 100 on serial subinterface 1/0/0.1 for outbound packets:
interface serial 1/0/0.1 point-to-pointframe-relay interface-dlci 100service-policy output userpolicy
Note
The following example shows how to attach a QoS service policy named "map2" to PVC 0/101 on the ATM subinterface 3/0/0.1 for inbound traffic:
interface atm 3/0/0atm pxf queuinginterface atm 3/0/0.1pvc 0/101service-policy input map2
Note
The following example shows how to attach a service policy named "myQoS" to physical Gigabit Ethernet interface 1/0/0 for inbound traffic. VLAN 4, configured on Gigabit Ethernet subinterface 1/0/0.3, inherits the service policy of physical Gigabit Ethernet interface 1/0/0.
interface GigabitEthernet 1/0/0service-policy input myQoSinterface GigabitEthernet 1/0/0.3encapsulation dot1q 4The following example shows how to apply the policy map named "policy1" to the virtual template named "virtual-template1" for all inbound traffic. In this example, the virtual template configuration also includes Challenge Handshake Authentication Protocol (CHAP) authentication and PPP authorization and accounting.
interface virtual-template1ip unnumbered Loopback1no peer default ip addressppp authentication chap vpn1ppp authorization vpn1ppp accounting vpn1service-policy input policy1The following example shows how to attach the service policy map named "voice" to ATM VC 2/0/0 within a PVC range of a total of three PVCs and enable PVC range configuration mode where a point-to-point subinterface is created for each PVC in the range. Each PVC created as part of the range has the voice service policy attached to it.
configure terminalinterface atm 2/0/0range pvc 1/50 1/52service-policy input voiceThe following example shows how to attach the service policy map named "voice" to ATM VC 2/0/0 within a PVC range, where every VC created as part of the range has the voice service policy attached to it. The exception is PVC 1/51, which is configured as an individual PVC within the range and has a different service policy named "data" attached to it in PVC-in-range configuration mode.
configure terminalinterface atm 2/0/0range pvc 1/50 1/52service-policy input voicepvc-in-range 1/51service-policy input dataThe following example shows how to configure a service group named "PREMIUM-SERVICE" and apply the input policy named "PREMIUM-MARK-IN" and the output policy named "PREMIUM-OUT" to the service group:
policy-map type service PREMIUM-SERVICEservice-policy input PREMIUM-MARK-INservice-policy output PREMIUM-OUTRelated Commands
show atm vp
To display the statistics for all virtual paths (VPs) on an interface or for a specific VP, use the show atm vp command in privileged EXEC mode.
show atm vp [vpi]
Syntax Description
vpi
(Optional) ATM network virtual path identifier (VPI) of the permanent virtual path. The range is from 0 to 255. The VPI is an 8-bit field in the header of the ATM cell.
Command Modes
Privileged EXEC
Command History
Usage Guidelines
Cisco 10000 Series Router
In Cisco IOS Release 12.2(33)SB, the output from the show atm vp command nolonger displays "ATM" as the type of interface, as shown in the following sample output:
Router# show atm vpData CES PEAK CES Avg/Min Burst MCRInterface VPI SC VCs VCs Kbps Kbps Kbps Cells Kbps CDVT Status3/0/0 200 N/A 0 0 2000 0 NA NA NA 140.0 ACTIVEIn Cisco IOS Release 12.2(31)SB, the output from the show atm vp command displays the ATM interface type:
Router# show atm vpData CES PEAK CES Avg/Min Burst MCR CDVTInterface VPI SC VCs VCs Kbps Kbps Kbps Cells Kbps Usecs StatusATM3/0/0 200 0 0 2000 0 NA NA NA 140.0 ACTIVEExamples
The following is sample output from the show atm vp command. This output shows the interface name, the status of the interface, the administrative status of the interface, the port type, and the number of channels in use on the interface. The status of the interface can be UP (in operation) or DOWN (not in operation).
Router# show atm vp 1ATM6/0 VPI: 1, PeakRate: 155000, CesRate: 1742, DataVCs: 1, CesVCs:1, Status: ACTIVEVCD VCI Type InPkts OutPkts AAL/Encap Status1 100 PVC n/a n/a CES-AAL1 ACTIVE13 13 PVC 0 0 AAL5-SNAP ACTIVE409 3 PVC 0 0 F4 OAM ACTIVE410 4 PVC 0 0 F4 OAM ACTIVETotalInPkts: 0, TotalOutPkts: 0, TotalInFast: 0, TotalOutFast: 0, TotalBroadcasts: 0Table 6 describes the fields shown in the display.
Related Commands
atm pvp
Creates a PVP used to multiplex (or bundle) one or more VCs (especially CES and data VCs).
show controllers (line card image)
To display information that is specific to the hardware on a line card, use the attach command in privileged EXEC mode to connect to the line card and then use the show controllers command in privileged EXEC mode or the execute-on command in privileged EXEC mode.
show controllers atm [[port-number] [all | sar | summary]]
show controllers fia [register]
show controllers {frfab | tofab} {bma {microcode | ms-inst | register} | qelem start-queue-element [end-queue-element] | qnum start-queue-number [end-queue-number] | queues | statistics}
show controllers io
show controllers l3
show controllers pos {framers | queues | registers | rxsram port-number queue-start-address [queue-length] | txsram port-number queue-start-address [queue-length]}
Syntax Description
Command Modes
Privileged EXEC
Command History
Usage Guidelines
This information displayed by this command is of use only to technical support representatives in analyzing unexpected system failures in the field. It is documented here in case you need to provide the displayed statistics to an technical support engineer.
Cisco 10000 Series Router Usage Guidelines
In releases prior to Cisco IOS Release 12.2(33)SB, when you configure the t1 loopback remote command on the local router, the command also displays in the running-config file of the far-end router. This is due to the route processor (RP) updating an incorrect parameter when it receives the loopback event message from the line card for loopback requests from the far end.
In Cisco IOS Release 12.2(33)SB, the RP updates the correct parameter and the show controllers command correctly displays the loopback CLI commands applied on the local end and displays the loopback events and status received from the line card in response to loopback requests from the far end.
This change in behavior affects the following line cards and is documented in the CSCsm84447 caveat:
•
•
•
•
In Cisco IOS Release 12.2(33)SB, the output from the show controller command includes line code information for the 6-port channelized T3 line card and the 8-port E3/DS3 line card. However, because SONET line cards do not have a direct physical link at the T3 or E3 level, the output from the show controller t3 command does not include line code information.
In Cisco IOS Release 12.2(31)SB, the output from the show controller command displays line code information. The output of the show controller t3 command for SONET-based T3 also includes line code information.
Examples
Because you are executing this command on the line card, you must use the execute-on command to use the show command, or you must connect to the card using the attach command. All examples in this section use the execute-on command
The following is partial sample output from the show controllers atm command:
Router# execute-on slot 4 show controllers atm 0TX SAR (Beta 1.0.0) is Operational;RX SAR (Beta 1.0.0) is Operational;Interface Configuration Mode:STS-12cActive Maker Channels: total # 6VCID ChnnlID Type OutputInfo InPkts InOAMs MacString1 0888 UBR 0C010010 0 0 08882000AAAA0300000008002 0988 VBR 04010020 0 0 098820003 8BC8 UBR 0C010030 0 0 8BC82000AAAA0300000008004 0E08 UBR 0C010040 0 0 0E082000AAAA03000000080010 1288 VBR 040100A0 0 0 1288200011 8BE8 VBR 0C0100B0 0 0 8BE82000AAAA030000000800SAR Total Counters:total_tx_idle_cells 215267 total_tx_paks 0 total_tx_abort_paks 0total_rx_paks 0 total_rx_drop_paks 0 total_rx_discard_cells 15Switching Code Counters:total_rx_crc_err_paks 0 total_rx_giant_paks 0total_rx_abort_paks 0 total_rx_crc10_cells 0total_rx_tmout_paks 0 total_rx_unknown_paks 0total_rx_out_buf_paks 0 total_rx_unknown_vc_paks 0BATMAN Asic Register Values:hi_addr_reg 0x8000, lo_addr_reg 0x000C, boot_msk_addr 0x0780,rmcell_msk_addr 0x0724, rmcnt__msk_addr 0x07C2, txbuf_msk_addr 0x070C,...CM622 SAR Boot Configuration:txind_q_addr 0x14000 txcmd_q_addr 0x20000...SUNI-622 Framer Register Values:Master Rst and Ident/Load Meters Reg (#0x0): 0x10Master Configuration Reg (#0x1): 0x1FMaster Interrupt Status Reg (#0x2): 0x00PISO Interrupt Reg (#0x3): 0x04Master Auto Alarm Reg (#0x4): 0x03Master Auto Alarm Reg (#0x5): 0x07Parallel Output Port Reg (#0x6): 0x02...BERM Line BIP Threshold LSB Reg (#0x74): 0x00BERM Line BIP Threshold MSB Reg (#0x75): 0x00Router#The following is partial sample output from the show controllers command:
Router# execute-on slot 6 show controllersInterface POS0Hardware is BFLC POSlcpos_instance struct 60311B40RX POS ASIC addr space 12000000TX POS ASIC addr space 12000100SUNI framer addr space 12000400SUNI rsop intr status 00CRC32 enabled, HDLC enc, int clockno loopInterface POS1Hardware is BFLC POSlcpos_instance struct 603142E0RX POS ASIC addr space 12000000TX POS ASIC addr space 12000100SUNI framer addr space 12000600SUNI rsop intr status 00CRC32 enabled, HDLC enc, int clockno loop...Router#The following is partial sample output from the show controllers pos framers command:
Router# execute-on slot 6 show controllers pos framersFramer 0, addr=0x12000400:master reset C0master config 1F rrate sts3c trate sts3c fixptrmaster control 00clock rcv cntrl D0RACP control 84RACP gfc control 0FTACP control status 04 hcsaddRACP intr enable 04RSOP cntrl intr enable 00RSOP intr status 00TPOP path sig lbl (c2) 13SPTB control 04 tnullSPTB status 00Framer 1, addr=0x12000600:master reset C0master config 1F rrate sts3c trate sts3c fixptrmaster control 00clock rcv cntrl D0RACP control 84RACP gfc control 0FTACP control status 04 hcsaddRACP intr enable 04RSOP cntrl intr enable 00RSOP intr status 00TPOP path sig lbl (c2) 13SPTB control 04 tnullSPTB status 00Framer 2, addr=0x12000800:master reset C0master config 1F rrate sts3c trate sts3c fixptrmaster control 00clock rcv cntrl D0RACP control 84RACP gfc control 0FTACP control status 04 hcsaddRACP intr enable 04RSOP cntrl intr enable 00RSOP intr status 00TPOP path sig lbl (c2) 13SPTB control 04 tnullSPTB status 00...Router#The following is partial sample output from the show controllers fia command:
Router# execute-on slot 7 show controllers fia========= Line Card (Slot 7) =======Fabric configuration: Full bandwidth redundantMaster Scheduler: Slot 17From Fabric FIA Errors-----------------------redund fifo parity 0 redund overflow 0 cell drops 0crc32 lkup parity 0 cell parity 0 crc32 00 1 2 3 4-------- -------- -------- -------- --------los 0 0 0 0 0crc16 0 0 0 0 0To Fabric FIA Errors-----------------------sca not pres 0 req error 0 uni fifo overflow 0grant parity 0 multi req 0 uni fifo undrflow 0cntrl parity 0 uni req 0 crc32 lkup parity 0multi fifo 0 empty dst req 0 handshake error 0Related Commands
show controllers t3
To display information about the T3 links and to display the hardware and software driver information for the T3 controller, use the show controllers t3 command in privileged EXEC mode.
Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3660 Series, Cisco 3725, and Cisco 3745 Routers
show controllers t3 slot/port [brief | tabular]
Cisco 7200 Series Routers
show controllers t3 [bay/port[/t1-channel]] [brief | errors | tabular | remote performance [brief | tabular]]
Cisco 7500 Series Routers
show controllers t3 [slot/bay/port[/t1-channel]] [brief | errors | tabular | remote performance [brief | tabular]]
Cisco AS5800 Access Servers
show controllers t3 dial-shelf/slot/t3-port
Syntax Description
Command Modes
Privileged EXEC
Command History
Usage Guidelines
Cisco 7500 Series Routers
This command displays controller status that is specific to the controller hardware. The information displayed is generally useful for diagnostic tasks performed by technical support personnel only.
By using the errors keyword, this command displays history that identifies which alarm events caused a T3 or T1 controller of a T3 to go down for the Cisco 7500 and Cisco 7200 series routers.
Note
numbering scheme (0 to 27) used with other Cisco products. This is to ensure consistency with
telco numbering schemes for T1 channels within channelized T3 equipment.The show controllers t3 command also displays Maintenance Data Link (MDL) information (received strings) if MDL is configured and framing is set to C-bit.
Cisco 10000 Series Router Usage Guidelines
In releases prior to Cisco IOS Release 12.2(33)SB, when you configure the t1 loopback remote command on the local router, the command also displays in the running-config file of the far-end router. This is due to the route processor (RP) updating an incorrect parameter when it receives the loopback event message from the line card for loopback requests from the far end.
In Cisco IOS Release 12.2(33)SB, the RP updates the correct parameter and the show controllers command correctly displays the loopback CLI commands applied on the local end and displays the loopback events and status received from the line card in response to loopback requests from the far end.
This change in behavior affects the following line cards and is documented in the CSCsm84447 caveat:
•
•
•
•
In Cisco IOS Release 12.2(33)SB, the output from the show controller command includes line code information for the 6-port channelized T3 line card and the 8-port E3/DS3 line card. However, because SONET line cards do not have a direct physical link at the T3 or E3 level, the output from the show controller t3 command does not include line code information.
In Cisco IOS Release 12.2(31)SB, the output from the show controller command displays line code information. The output of the show controller t3 command for SONET-based T3 also includes line code information.
Examples
Cisco 7200 Series Routers
The following is partial output from the show controllers t3 errors command for Cisco IOS Release 12.2(19c) for a specific T1 controller of a T3 on a Cisco 7200 series router with a bay/port of 4/1, displaying the T1 1 alarm event of OOF:
Router# show controllers t3 4/1/1 errorsT3 4/1: Error Log Informationpresent alarm: NONEError: AIS17:28:08-17:29:18T1 1 Error Log Informationpresent alarm: OOFSince 17:30:55Error: OOF17:30:09-17:30:46The following is partial output from the show controllers t3 errors command from Cisco IOS Release 12.2(19c) for a T3 controller on a Cisco 7200 series router with a bay/port of 4/1, displaying a history of all alarm events on all 28 T1 channels:
Router# show controllers t3 4/1 errorsT3 4/1: Error Log Informationpresent alarm: NONEError: AIS17:28:08-17:29:18T1 1 Error Log Informationpresent alarm: OOFSince 17:30:55Error: OOF17:30:09-17:30:46T1 2 Error Log Informationpresent alarm: NONET1 3 Error Log Informationpresent alarm: NONET1 4 Error Log Informationpresent alarm: NONET1 5 Error Log Informationpresent alarm: NONET1 6 Error Log Informationpresent alarm: NONET1 7 Error Log Informationpresent alarm: NONET1 8 Error Log Informationpresent alarm: NONET1 9 Error Log Informationpresent alarm: NONET1 10 Error Log Informationpresent alarm: NONET1 11 Error Log Informationpresent alarm: NONE....Cisco 7500 Series Routers
The following is partial output from the show controllers t3 errors command from Cisco IOS Release 12.2(19c) for a T3 controller with a slot/bay/port of 1/4/1, displaying a history of all alarm events on all 28 T1 channels:
Router# show controllers t3 1/4/1 errorsT3 1/4/1: Error Log Informationpresent alarm: NONEError: AIS17:28:08-17:29:18T1 1 Error Log Informationpresent alarm: OOFSince 17:30:55Error: OOF17:30:09-17:30:46T1 2 Error Log Informationpresent alarm: NONET1 3 Error Log Informationpresent alarm: NONET1 4 Error Log Informationpresent alarm: NONET1 5 Error Log Informationpresent alarm: NONET1 6 Error Log Informationpresent alarm: NONET1 7 Error Log Informationpresent alarm: NONE...The following is partial output from the show controllers t3 errors command from Cisco IOS Release 12.2(19c) for a specific T1 controller of a T3 on a Cisco 7200 series router with a bay/port of 4/1, displaying the T1 1 alarm event of OOF:
Router# show controllers t3 4/1/1 errorsT3 4/1: Error Log Informationpresent alarm: NONEError: AIS17:28:08-17:29:18T1 1 Error Log Informationpresent alarm: OOFSince 17:30:55Error: OOF17:30:09-17:30:46...Table 7 describes the error field shown in the display.
The following is partial output from the show controllers t3 command from Cisco IOS Release 12.2(19c):
Router# show controllers t3 2/1/0T3 2/1/0 is down. Hardware is 2CT3 single wide port adapterCT3 H/W Version:0.2.2, CT3 ROM Version:1.0, CT3 F/W Version:2.5.1FREEDM version:1, reset 0 resurrect 0Applique type is Channelized T3Transmitter is sending remote alarm.Receiver has loss of signal.FEAC code received:No code is being receivedFraming is M23, Line Code is B3ZS, Clock Source is InternalRx-error throttling on T1's ENABLEDRx throttle total 0, equipment customer loopbackData in current interval (545 seconds elapsed):0 Line Code Violations, 0 P-bit Coding Violation0 C-bit Coding Violation, 0 P-bit Err Secs0 P-bit Severely Err Secs, 0 Severely Err Framing Secs545 Unavailable Secs, 0 Line Errored Secs0 C-bit Errored Secs, 0 C-bit Severely Errored SecsData in Interval 1:0 Line Code Violations, 0 P-bit Coding Violation0 C-bit Coding Violation, 0 P-bit Err Secs0 P-bit Severely Err Secs, 0 Severely Err Framing Secs900 Unavailable Secs, 0 Line Errored Secs0 C-bit Errored Secs, 0 C-bit Severely Errored SecsData in Interval 2:<snip>The following is partial output from the show controllers t3 command from Cisco IOS Release 12.2(19c) for the T1 channel of the T3 controller:
Router# show controllers t3 2/1/0 /1T3 2/1/0 is down. Hardware is 2CT3 single wide port adapterCT3 H/W Version:0.2.2, CT3 ROM Version:1.0, CT3 F/W Version:2.5.1FREEDM version:1, reset 0 resurrect 0T1 1 is downtimeslots:1-24FDL per AT&T 54016 spec.Receiver has loss of signal.Framing is ESF, Clock Source is InternalData in current interval (0 seconds elapsed):0 Line Code Violations, 0 Path Code Violations0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs0 Unavail Secs, 0 Stuffed SecsThe following is partial output from the show controllers t3 command:
Router# show controllers t3 3/0/0T3 3/0/0 is up.CT3 H/W Version: 4, CT3 ROM Version: 0.116, CT3 F/W Version: 0.10.0Mx H/W version: 2, Mx ucode ver: 1.24Applique type is Channelized T3No alarms detected.FEAC code received: No code is being receivedFraming is M23, Line Code is B3ZS, Clock Source is Internal.Ext1: LOS, Ext2: LOS, Ext3: LOS, Test: OKData in current interval (39 seconds elapsed):0 Line Code Violations, 0 P-bit Coding Violation0 C-bit Coding Violation0 P-bit Err Secs, 0 P-bit Severely Err Secs0 Severely Err Framing Secs, 0 Unavailable Secs0 Line Errored Secs, 0 C-bit Errored Secs, 0 C-bit Severely Errored SecsTotal Data (last 1 15 minute intervals):0 Line Code Violations, 0 P-bit Coding Violation,0 C-bit Coding Violation,0 P-bit Err Secs, 0 P-bit Severely Err Secs,0 Severely Err Framing Secs, 0 Unavailable Secs,0 Line Errored Secs, 0 C-bit Errored Secs, 0 C-bit Severely Errored Secs...T1 1 is down, speed: 1536 kbs, non-inverted datatimeslots: 1-24FDL per ANSI T1.403 and AT&T 54016 spec.Configured for FDL Remotely Line LoopedNo alarms detected.Framing is ESF, LineCode is B8ZS, Clock Source is Internal.BERT test result (running)Test Pattern: All 0's, Status: Sync, Sync Detected: 1Interval: 4 minute(s), Tim Remain: 4 minute(s)Bit Errors (Sync BERT Started): 0 bitsBit Errors (Sync last Sync): 0 bits, Bits Received: 7 MbitsThe following is partial output from the show controllers t3 brief command:
Router# show controllers t3 3/0/0 briefT3 3/0/0 is up.CT3 H/W Version: 4, CT3 ROM Version: 0.116, CT3 F/W Version: 0.10.0Mxt H/W version: 2, Mxt ucode ver: 1.24Applique type is Channelized T3No alarms detected.FEAC code received: No code is being receivedFraming is M23, Line Code is B3ZS, Clock Source is Internal.Ext1: LOS, Ext2: LOS, Ext3: LOS, Test: OKT1 1 is up, speed: 1536 kbs, non-inverted datatimeslots: 1-24FDL per ANSI T1.403 and AT&T 54016 spec.Configured for FDL Remotely Line LoopedNo alarms detected.Framing is ESF, LineCode is B8ZS, Clock Source is Internal.BERT test result (done)Test Pattern: All 0's, Status: Not Sync, Sync Detected: 1Interval: 4 minute(s), Tim Remain: 0 minute(s)Bit Errors(Sync BERT Started): 0 bitsBit Errors(Sync last Sync): 0 bits, Bits Received: 368 Mbits...The following is partial output from the show controllers t3 tabular command:
Router# show controllers t3 3/0/0 tabularT3 3/0/0 is up.CT3 H/W Version: 4, CT3 ROM Version: 1.2, CT3 F/W Version: 2.1.0Mx H/W version: 2, Mx ucode ver: 1.25Applique type is Channelized T3No alarms detected.MDL transmission is disabledFEAC code received: No code is being receivedFraming is C-BIT Parity, Line Code is B3ZS, Clock Source is Internal.Ext1: AIS, Ext2: LOS, Ext3: LOS, Test: LOSINTERVAL LCV PCV CCV PES PSES SEFS UAS LES CES CSES08:56-09:11 0 0 0 0 0 0 0 0 0 008:41-08:56 0 0 0 0 0 0 0 0 0 008:26-08:41 0 0 0 0 0 0 0 0 0 0Total 0 0 0 0 0 0 0 0 0 0...T1 2 is up, speed: 1536 kbs, non-inverted datatimeslots: 1-24FDL per AT&T 54016 spec.No alarms detected.Framing is ESF, Line Code is B8ZS, Clock Source is Internal.INTERVAL LCV PCV CSS SELS LES DM ES BES SES UAS SS08:56-09:11 0 0 0 0 0 0 0 0 0 0 008:41-08:56 0 0 0 0 0 0 0 0 0 0 008:26-08:41 0 0 0 0 0 0 0 0 0 0 0Total 0 0 0 0 0 0 0 0 0 0 0The following output shows a controller with a high number of errors on the line, thus showing a throttle count (RX throttles).
Router# show controllers t3 6/0/0 tabularT1 2 is uptimeslots: 1-24FDL per AT&T 54016 spec.No alarms detected.Framing is ESF, Clock Source is Line, Rx throttles 47INTERVAL LCV PCV CSS SELS LES DM ES BES SES UAS SS07:48-07:53 0 0 0 0 0 0 0 0 0 0The following is partial output from the show controllers t3 remote performance command. This information is available if the t1 fdl ansi controller configuration command is enabled for a T1 channel on a CT3IP.
Router# show controllers t3 3/0/0 remote performanceT3 3/0/0 is up.CT3 H/W Version: 4, CT3 ROM Version: 0.116, CT3 F/W Version: 20.2.0Mx H/W version: 2, Mx ucode ver: 1.25T1 1 - Remote Performance DataData in current interval (356 seconds elapsed):0 Line Code Violations, 0 Path Code Violations0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs0 Unavail SecsData in Interval 1:1 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins2 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs0 Unavail SecsData in Interval 2:0 Line Code Violations, 0 Path Code Violations0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs0 Unavail SecsTotal Data (last 2 15 minute intervals):1 Path Code Violations1 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins,2 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs0 Unavail Secs...Table 8 describes the fields shown in the display.
Cisco AS5800 Access Servers
The following example shows the summary status of the T3 controller located in shelf 1, slot 4, port 0:
Router# show controllers t3 1/4/0 briefT3 1/4/0 is up.Applique type is Channelized T3No alarms detected.MDL transmission is disabledFEAC code received: Multiple DS1 LOS/HBERFraming is C-BIT Parity, Line Code is B3ZS, Clock Source is Line.Data in current interval (491 seconds elapsed):0 Line Code Violations, 0 P-bit Coding Violation0 C-bit Coding Violation, 0 P-bit Err Secs0 P-bit Severely Err Secs, 0 Severely Err Framing Secs0 Unavailable Secs, 0 Line Errored Secs0 C-bit Errored Secs, 0 C-bit Severely Errored SecsTotal Data (last 80 15 minute intervals):3 Line Code Violations, 4 P-bit Coding Violation,2 C-bit Coding Violation, 0 P-bit Err Secs,0 P-bit Severely Err Secs, 0 Severely Err Framing Secs,2 Unavailable Secs, 0 Line Errored Secs,0 C-bit Errored Secs, 0 C-bit Severely Errored SecsThe following example shows the detailed status of the T3 controller connected to the Cisco AS5800 in shelf 1, slot 4, port 0. Notice that the detailed information shows the last eighty-six 15-minute time periods.
Router# show controllers t3 1/4/0T3 1/4/0 is up.Applique type is Channelized T3No alarms detected.MDL transmission is disabledFEAC code received: Multiple DS1 LOS/HBERFraming is C-BIT Parity, Line Code is B3ZS, Clock Source is Line.Data in current interval (91 seconds elapsed):0 Line Code Violations, 0 P-bit Coding Violation0 C-bit Coding Violation, 0 P-bit Err Secs0 P-bit Severely Err Secs, 0 Severely Err Framing Secs0 Unavailable Secs, 0 Line Errored Secs0 C-bit Errored Secs, 0 C-bit Severely Errored SecsData in Interval 1:0 Line Code Violations, 0 P-bit Coding Violation0 C-bit Coding Violation, 0 P-bit Err Secs0 P-bit Severely Err Secs, 0 Severely Err Framing Secs0 Unavailable Secs, 0 Line Errored Secs0 C-bit Errored Secs, 0 C-bit Severely Errored SecsData in Interval 2:0 Line Code Violations, 0 P-bit Coding Violation0 C-bit Coding Violation, 0 P-bit Err Secs0 P-bit Severely Err Secs, 0 Severely Err Framing Secs0 Unavailable Secs, 0 Line Errored Secs0 C-bit Errored Secs, 0 C-bit Severely Errored SecsData in Interval 3:0 Line Code Violations, 0 P-bit Coding Violation0 C-bit Coding Violation, 0 P-bit Err Secs0 P-bit Severely Err Secs, 0 Severely Err Framing Secs0 Unavailable Secs, 0 Line Errored Secs0 C-bit Errored Secs, 0 C-bit Severely Errored SecsData in Interval 4:0 Line Code Violations, 0 P-bit Coding Violation0 C-bit Coding Violation, 0 P-bit Err Secs0 P-bit Severely Err Secs, 0 Severely Err Framing Secs0 Unavailable Secs, 0 Line Errored Secs0 C-bit Errored Secs, 0 C-bit Severely Errored Secs...Data in Interval 86:3 Line Code Violations, 4 P-bit Coding Violation2 C-bit Coding Violation, 0 P-bit Err Secs0 P-bit Severely Err Secs, 0 Severely Err Framing Secs2 Unavailable Secs, 0 Line Errored Secs0 C-bit Errored Secs, 0 C-bit Severely Errored SecsTotal Data (last 86 15 minute intervals):3 Line Code Violations, 4 P-bit Coding Violation,2 C-bit Coding Violation, 0 P-bit Err Secs,0 P-bit Severely Err Secs, 0 Severely Err Framing Secs,2 Unavailable Secs, 0 Line Errored Secs,0 C-bit Errored Secs, 0 C-bit Severely Errored SecsTable 9 describes the fields shown in the display.
Cisco 10000 Series Router Examples
The following examples from the show controller t3 command show the information that displays when the router is running Cisco IOS Release 12.2(33)SB and Cisco IOS Release 12.2(31)SB:
Cisco IOS Release 12.2(33)SB —No Line Code Information
Router# show controller t3 5/0/0.1T3 5/0/0.1 is up. Hardware is C10K CHOC12 line cardApplique type is Channelized T3.Controller is in unchannelized mode.No alarms detected.MDL transmission is disabled.FEAC code received: No code is being received.Framing is C-BIT Parity (Configured), Clock Source is Internal.DSU mode is cisco, DSU bandwidth is 44210.Cisco IOS Release 12.2(31)SB —Line Code Information
Router# show controller t3 5/0/0.1T3 5/0/0.1 is up. Hardware is C10K CHOC12 line cardApplique type is Channelized T3.Controller is in channelized mode.No alarms detected.MDL transmission is disabled.FEAC code received: No code is being receivedFraming is C-BIT Parity (Configured)Line Code is B3ZS, Clock Source is Internal.show diag
To display hardware and diagnostic information for a networking device, a line card, a processor, a jacket card, a chassis, or a network module, use the show diag command in privileged EXEC configuration mode.
show diag [slot-number] [details | summary]
Cisco 7304 Router
show diag [slot-number | chassis | subslot slot/subslot] [details | summary]
Shared Port Adapters
show diag [subslot slot/subslot] [details | summary]
Network Module
show diag [slot-number]
Cisco 10000 Series Router
show diag [slot/subslot] [details | summary] [crashdump]
Syntax Description
Defaults
None
Privileged EXEC
Command History
Usage Guidelines
Use this command to determine the type of hardware installed in your router, and to show detailed hardware information and EEPROM version information.
This command displays information for the motherboard, WAN interface cards (WICs), voice interface cards (VICs), high-speed WICs (HWICs), ATM interface cards (AICs), advanced integration modules (AIMs), port adapters, shared port adapters (SPAs), modular services cards (MSCs), SPA interface processors (SIPs), and enhanced network modules (NME).
Cisco 7304 Router Usage Guidelines
For the Cisco 7304 router, this command applies to NEs, line cards, MSCs, and SPAs.
•
•
Shared Port Adapter Usage Guidelines
•
•
Cisco 10000 Series Router Usage Guidelines
The crashdump option of the show diag command enables you to display any crashdump files collected on the SPA Interface Processor (SIP). The SIP stores the crashdump files by a reference number from 1 to 60.
To view a crashdump file, do the following:
Step 1
a.
b.
Number of crashdumps : output numberStep 2
show diag slot/subslot crashdump number
Note
Examples
1-Port T3 Serial Port Adapter: Example
The following is sample output from the show diag command for a 1-port T3 serial port adapter in chassis slot 1 on a Cisco 7200 series router:
Router# show diag 1Slot 1:Physical slot 1, ~physical slot 0xE, logical slot 1, CBus 0Microcode Status 0x4Master Enable, LED, WCS LoadedBoard is analyzedPending I/O Status: NoneEEPROM format version 1VIP2 controller, HW rev 2.4, board revision D0Serial number: 04372053 Part number: 73-1684-03Test history: 0x00 RMA number: 00-00-00Flags: cisco 7000 board; 7500 compatibleEEPROM contents (hex):0x20: 01 15 02 04 00 42 B6 55 49 06 94 03 00 00 00 000x30: 68 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00Slot database information:Flags: 0x4 Insertion time: 0x14A8 (5d02h ago)Controller Memory Size: 16 MBytes DRAM, 1024 KBytes SRAMPA Bay 0 Information:T3 Serial PA, 1 portsEEPROM format version 1HW rev FF.FF, Board revision UNKNOWNSerial number: 4294967295 Part number: 255-65535-255Cisco 12000 Series Internet Router: Example
The following is sample output from the show diag command on a Cisco 12000 series Internet router:
Router# show diag 3SLOT 3 (RP/LC 3 ): 4 Port Packet Over SONET OC-3c/STM-1 Multi ModeMAIN: type 33, 00-0000-00 rev 70 dev 0HW config: 0x01 SW key: 00-00-00PCA: 73-2147-02 rev 94 ver 2HW version 1.0 S/N 04499695MBUS: MBUS Agent (1) 73-2146-05 rev 73 dev 0HW version 1.1 S/N 04494882Test hist: 0x00 RMA#: 00-00-00 RMA hist: 0x00DIAG: Test count: 0x05000001 Test results: 0x00000000MBUS Agent Software version 01.27 (RAM) using CAN Bus AROM Monitor version 00.0DFabric Downloader version used 00.0D (ROM version is 00.0D)Board is analyzedBoard State is Line Card Enabled (IOS RUN )Insertion time: 00:00:10 (00:04:51 ago)DRAM size: 33554432 bytesFrFab SDRAM size: 67108864 bytesToFab SDRAM size: 16777216 bytesThe following is sample output from the show diag command with the summary keyword:
Router# show diag summarySLOT 0 (RP/LC 0 ): Route ProcessorSLOT 2 (RP/LC 2 ): 4 Port Packet Over SONET OC-3c/STM-1 Single ModeSLOT 4 (RP/LC 4 ): 4 Port Packet Over SONET OC-3c/STM-1 Single ModeSLOT 7 (RP/LC 7 ): 4 Port Packet Over SONET OC-3c/STM-1 Single ModeSLOT 9 (RP/LC 9 ): 4 Port Packet Over SONET OC-3c/STM-1 Single ModeSLOT 11 (RP/LC 11): 4 Port Packet Over SONET OC-3c/STM-1 Single ModeSLOT 16 (CSC 0 ): Clock Scheduler CardSLOT 17 (CSC 1 ): Clock Scheduler CardSLOT 18 (SFC 0 ): Switch Fabric CardSLOT 19 (SFC 1 ): Switch Fabric CardSLOT 20 (SFC 2 ): Switch Fabric CardSLOT 24 (PS A1 ): AC Power SupplySLOT 26 (PS B1 ): AC Power SupplySLOT 28 (TOP FAN ): Blower ModuleSLOT 29 (BOT FAN ): Blower ModuleThe following is sample output from the show diag command with the details keyword:
Router# show diag 4 detailsSLOT 4 (RP/LC 4): 4 Port Packet Over SONET OC-3c/STM-1 Single ModeMAIN: type 33, 800-2389-01 rev 71 dev 16777215HW config: 0x00 SW key: FF-FF-FFPCA: 73-2275-03 rev 75 ver 3HW version 1.1 S/N 04529465MBUS: MBUS Agent (1) 73-2146-06 rev 73 dev 0HW version 1.1 S/N 04541395Test hist: 0xFF RMA#: FF-FF-FF RMA hist: 0xFFDIAG: Test count: 0x05000001 Test results: 0x00000000EEPROM contents (hex):00: 01 00 01 00 49 00 08 62 06 03 00 00 00 FF FF FF10: 30 34 35 34 31 33 39 35 FF FF FF FF FF FF FF FF20: 01 01 00 00 00 00 00 FF FF FF FF FF FF FF FF FF30: A5 FF A5 A5 A5 A5 FF A5 A5 A5 A5 A5 A5 A5 A5 A540: 00 21 01 01 00 49 00 08 E3 03 05 03 00 01 FF FF50: 03 20 00 09 55 01 01 FF FF FF 00 FF FF FF FF FF60: 30 34 35 32 39 34 36 35 FF FF FF FF FF FF FF FF70: FF FF FF FF FF FF FF FF 05 00 00 01 00 00 00 00MBUS Agent Software version 01.24 (RAM)Fabric Downloader version 00.0DBoard is analyzedFlags: 0x4Board State is Line Card Enabled (IOS RUN)Insertion time: 00:00:10 (00:04:51 ago)DRAM size: 33554432 bytesFrFab SDRAM size: 67108864 bytesToFab SDRAM size: 16777216 bytesATM SAR AIM in a Cisco 3660: Example
The following is sample output from the show diag command for one ATM Segmentation and Reassembly (SAR) AIM in a Cisco 3660 router:
Router# show diag 03660 Chassis type: ENTERPRISEc3600 Backplane EEPROM:Hardware Revision : 1.0Top Assy. Part Number : 800-04740-02...ATM AIM: 1ATM AIM module with SAR only (no DSPs)Hardware Revision : 1.0Top Assy. Part Number : 800-03700-01Board Revision : A0Deviation Number : 0-0Fab Version : 02PCB Serial Number : JAB9801ABCDNM-AIC-64 Installed in a Cisco 2611: Example
The following is sample output from the show diag command for a Cisco 2611 router with the NM-AIC-64 installed.
Router# show diagSlot 0: C2611 2
Guest
