Table Of Contents
Release Notes for Cisco IOS XR Release 3.7.1
Key Changes from Previous Releases in Cisco IOS XR Release 3.7.1
Determining Your Software Version
New Software Features in Cisco IOS XR Software Release 3.7.1
Both Cisco CRS-1 and Cisco XR 12000 Series Router Platforms
Cisco CRS-1 Router-Specific Software Features
Cisco XR 12000 Series Router Software Features
New Hardware Features in Cisco IOS XR Software Release 3.7.1
Enhanced Tuning of SPF LSA Counts for OSPF Topology
Configuration Changes to the SONET Delay Timer CLI
Minimum Flash Disk Requirements When Upgrading to Release 3.7.0 and Later Releases
Cisco CRS-1 and Cisco XR 12000 Series Router Caveats
Caveats Specific to the Cisco CRS-1 Router
Caveats Specific to the Cisco XR 12000 Series Router
Upgrading Cisco IOS XR Software
Obtaining Documentation and Submitting a Service Request
Release Notes for Cisco IOS XR Release 3.7.1
January 14, 2009
Cisco IOS XR Software Release 3.7.1
Text Part Number OL-17922-02
These release notes describe the features provided in the Cisco IOS XR Software Release 3.7.1 and are updated as needed.
Note
For information on Cisco IOS XR Software Release 3.7.1, see the "Important Notes" section.
You can find the most current Cisco IOS XR software documentation on the World Wide Web at http://www.cisco.com/en/US/partner/products/ps5845/tsd_products_support_series_home.html. These electronic documents may contain updates and modifications. For more information on obtaining Cisco documentation, see the "Obtaining Documentation and Submitting a Service Request" section on page 25.
For a list of software caveats that apply to Cisco IOS XR Software Release 3.7.1, see the "Caveats" section. The caveats are updated for every release and are described on the World Wide Web at www.cisco.com.
We recommend that you view the field notices for this release to see if your software or hardware platforms are affected at http://www.cisco.com/public/support/tac/fn_index.html.
Key Changes from Previous Releases in Cisco IOS XR Release 3.7.1
The PCMCIA 1-GB Flash Disk is the default flash disk size for a Cisco CRS-1 router, running Cisco IOS XR Software Release 3.6. However, at minimum, the PCMCIA 2-GB Flash Disk is required for Release 3.7.0 and later releases. Customers must upgrade the PCMCIA 1-GB Flash Disk on their Cisco CRS-1 router to 2 GB before upgrading from Cisco IOS XR Software Release 3.6 to Cisco IOS XR Software Release 3.7.0 and later releases.
Upgrade instructions for the Cisco CRS-1 router are available from http://www.cisco.com/web/Cisco_IOS_XR_Software/pdf/ReplacingPCMCIACardOnCRS-1.pdf. See also the "Minimum Flash Disk Requirements When Upgrading to Release 3.7.0 and Later Releases" section.
Contents
These release notes contain the following sections:
•
•
•
Introduction
Cisco IOS XR software is a distributed operating system designed for continuous system operation combined with service flexibility and high performance.
Cisco IOS XR software provides the following features and benefits:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
–
–
–
•
•
•
•
For more information about new features provided on various platforms for Cisco IOS XR Software Release 3.7.1, see the "New Features and Enhancements" section in this document.
System Requirements
Cisco IOS XR Software Release 3.7.1 supports the following platforms:
To determine the software versions or levels of your current system, see the "Determining Your Software Version" section.
Cisco CRS-1
This section describes the system requirements for Cisco IOS XR Software Release 3.7.1 supported on the Cisco CRS-1 router. The system requirements include the following information:
To determine the software versions or levels of your current system, see Determining Your Software Version.
Feature Set Table
Cisco IOS XR software is packaged in feature sets (also called software images). Each feature set contains a specific set of Cisco IOS XR Software Release 3.7.1 features. Table 1 lists the Cisco IOS XR software feature set matrix (PIE files) and associated filenames available for the Cisco IOS XR Software Release 3.7.0 supported on the Cisco CRS-1 router.
Table 1 Cisco CRS-1 Supported Feature Sets
(Cisco IOS XR Software Release 3.7.1 PIE Files)Cisco IOS XR IP Unicast Routing Core Bundle
comp-hfr-mini.pie-3.7.1
Contains the required core packages, including OS, Admin, Base, Forwarding, Modular Services Card, Routing, SNMP Agent, and Alarm Correlation.
Cisco IOS XR IP Unicast Routing Core Bundle
comp-hfr-mini.vm-3.7.1
Contains the required core packages including OS, Admin, Base, Forwarding, Modular Services Card, Routing, SNMP Agent, and Alarm Correlation.
Cisco IOS XR Manageability Package
hfr-mgbl-p.pie-3.7.1
Cisco IOS XR MPLS Package
hfr-mpls-p.pie-3.7.1
MPLS-TE,4 LDP,5 MPLS Forwarding, MPLS OAM,6 LMP,7 OUNI,8 RSVP,9 and Layer-2 VPN and Layer-3 VPN.
Cisco IOS XR Multicast Package
hfr-mcast-p.pie-3.7.1
Multicast Routing Protocols (PIM, MSDP,10 IGMP,11 Auto-RP), Tools (SAP, MTrace), and Infrastructure (MRIB,12 MURIB13 , MFWD14 ), and BIDIR-PIM.15
Cisco IOS XR Security Package
hfr-k9sec-p.pie-3.7.1
Support for Encryption, Decryption, IPSec,16 SSH,17 SSL,18 and PKI19 (Software based IPSec support—maximum of 500 tunnels)
Cisco IOS XR Documentation Package
hfr-doc.pie-3.7.1
Man pages for Cisco IOS XR CLI commands
Cisco IOS XR FPD Package
hfr-fpd.pie-3.7.1
Firmware for Fixed PLIM20 and SPA21 modules as well as ROMMON22 images for CRS chassis.
Cisco IOS XR Diagnostic Package
hfr-diags-p.pie-3.7.1
Diagnostic utilities for Cisco IOS XR routers.
1 Packages are installed individually
2 Common Object Request Broker Architecture
3 Extensible Markup Language
4 MPLS Traffic Engineering
5 Label Distribution Protocol
6 Operations, Administration, and Maintenance
7 Link Manager Protocol
8 Optical User Network Interface
9 Resource Reservation Protocol
10 Multicast Source Discovery Protocol
11 Internet Group Management Protocol
12 Multicast Routing Information Base
13 Multicast-Unicast RIB
14 Multicast forwarding
15 Bidirectional Protocol Independent Multicast
16 IP Security
17 Secure Shell
18 Secure Socket Layer
19 Public-key infrastructure
20 Physical layer interface module
21 Shared port adapters
22 ROM monitor
Table 2 lists the Cisco CRS-1 TAR files.
Memory Requirements
Caution
The minimum memory requirements for Cisco CRS-1 routers running Cisco IOS XR Software Release 3.7.1 consist of the following:
•
•
•
Note
Hardware Supported
Cisco IOS XR Software Release 3.7.1 supports the Cisco CRS-1 router. All hardware features are supported on Cisco IOS XR software, subject to the memory requirements specified in the "Memory Requirements" section.
Table 3 lists the supported hardware components on the Cisco CRS-1 router and the minimum required software versions. For more information, see the "Other Firmware Support" section.
Software Compatibility
Cisco IOS XR Software Release 3.7.1 is compatible with the following Cisco CRS-1 systems:
•
•
•
•
Other Firmware Support
The Cisco CRS-1 router supports the following firmware code:
•
•
Cisco XR 12000 Series Router
This section describes the system requirements for Cisco IOS XR Software Release 3.7.1 supported on the Cisco XR 12000 Series Router. The system requirements include the following information:
To determine the software versions or levels of your current system, see "Determining Your Software Version" section.
Feature Set Table
Cisco IOS XR software is packaged in feature sets (also called software images). Each feature set contains a specific set of Cisco IOS XR Software Release 3.7.1 features. Table 4 lists the Cisco IOS XR software feature set matrix (PIE files) and associated filenames available for Cisco IOS XR Software Release 3.7.1, supported on the Cisco XR 12000 Series Router.
Table 4 Cisco XR 12000 Series Router Supported Feature Set (Cisco IOS XR Software
Release 3.7.1 PIE Files)Cisco IOS XR IP Unicast Routing Core Bundle
c12k-mini.pie-3.7.1
Contains the required core packages, including OS, Admin, Base, Forwarding, Routing, SNMP Agent, and Alarm Correlation.
Cisco IOS XR IP Unicast Routing Core Bundle
c12k-mini.vm-3.7.1
Contains the required core packages including OS, Admin, Base, Forwarding, and Routing SNMP Agent, and Alarm Correlation.
Cisco IOS XR Manageability Package
c12k-mgbl.pie-3.7.1
CORBA2 agent, XML Parser, and HTTP server packages.
Cisco IOS XR MPLS Package
c12k-mpls.pie-3.7.1
MPLS-TE,3 LDP, 4 MPLS Forwarding, MPLS OAM,5 LMP,6 OUNI,7 and RSVP.8
Cisco IOS XR Multicast Package
c12k-mcast.pie-3.7.1
Multicast Routing Protocols (PIM,9 MSDP,10 IGMP,11 Auto-RP, BSR12 ), Tools (SAP, MTrace, MRINFO), and Infrastructure (MRIB,13 MURIB,14 MFWD)15 .
Cisco IOS XR Security Package
c12k-k9sec.pie-3.7.1
Support for Encryption, Decryption, IPSec16 , SSH,17 SSL,18 and PKI.19
Software based IPSec support: maximum of 500 tunnels or Hardware based IPSec: maximum of 64K tunnels using the SPA-IPSEC-2G-2Cisco IOS XR Standby RP Boot Image
mbiprp-rp.vm-3.7.1
Support for booting the Standby RP on a Cisco XR 12000 Series Router.
Cisco IOS XR Session Border Controller Package
c12k-sbc.pie-3.7.1
Session Border Controller Package for a Cisco XR 12000 Series Router.
Cisco IOS XR Service IPsec Controller Package
c12k-ipsec-service.pie-3.7.1
Support for service-ipsec and service-gre interfaces in Cisco IOS XR software.
Cisco IOS XR Firewall Package
c12k-firewall.pie-3.7.1
Support for Virtual Firewall (vFW) on a Cisco XR 12000 Series Router.
Cisco IOS XR Documentation Package
c12k-doc.pie-3.7.1
Man pages for Cisco IOS XR CLI commands.
Cisco IOS XR FPD Package
c12k-fpd.pie-3.7.1
Firmware for shared port adapters (SPA) and for fixed port line cards supported in Cisco IOS XR.
Cisco IOS XR Diagnostic Package
c12k-diags.pie-3.7.1
Diagnostic utilities for Cisco IOS XR routers.
1 Packages are installed individually
2 Common Object Request Broker Architecture
3 MPLS Traffic Engineering
4 Label Distribution Protocol
5 Operations, Administration, and Maintenance
6 Link Manager Protocol
7 Optical User Network Interface
8 Resource Reservation Protocol
9 Protocol Independent Multicast
10 Multicast Source Discovery Protocol
11 Internet Group Management Protocol
12 Bootstrap router
13 Multicast Routing Information Base
14 Multicast-Unicast RIB
15 Multicast forwarding
16 IP Security
17 Secure Shell
18 Secure Socket Layer
19 Physical layer interface module
Table 5 lists the Cisco XR 12000 Series Router TAR files.
Memory Requirements
Caution
The minimum memory requirements for Cisco XR 12000 Series Routers running Cisco IOS XR Software Release 3.7.1 consist of the following:
•
Note
•
•
•
–
–
Note
•
Note
Hardware Supported
Cisco IOS XR Software Release 3.7.1 supports the Cisco XR 12000 Series Router. All hardware features are supported on Cisco IOS XR software, subject to the memory requirements specified in the "Memory Requirements" section.
Table 6 lists the supported hardware components on the Cisco XR 12000 Series Router and the minimum required software versions. For more information, see the "Determining Your Software Version" section.
Software Compatibility
Cisco IOS XR Software Release 3.7.1 is compatible with the following Cisco XR 12000 Series Router systems:
•
•
•
•
•
•
•
•
•
•
The following chassis are supported for an existing installed base:
•
•
•
Note
Other Firmware Support
The Cisco XR 12000 Series Router supports the following firmware:
•
–
–
–
For Engine 3 line card:
–
–
–
For Engine 5 line card:
–
–
–
•
–
–
Requirement of Cisco IOS Image Level and Boot Helper Version for Migration
If you are migrating from Cisco IOS to Cisco IOS XR software on the Cisco XR 12000 Series Router, you must have the following minimum Cisco IOS image level and Boothelper version to support Release 3.7.1:
•
•
If you have an earlier version of this system, you must upgrade to the minimum supported level before performing a migration. Otherwise, your migration fails. For more information, see the Migrating from Cisco IOS to Cisco IOS XR Software on the Cisco XR 12000 Series Router document.
Determining Your Software Version
To determine the version of Cisco IOS XR software running on your router, log into the router and enter the show version command:
Step 1
Step 2
Cisco CRS-1
On the Cisco CRS-1, you should see a response similar to the following (which has been abbreviated for the Release Notes):
Cisco IOS XR Software, Version 3.7.1[00]Copyright (c) 2008 by Cisco Systems, Inc.ROM: System Bootstrap, Version 1.50(20080718:154546) [CRS-1 ROMMON],PINOT_IP_PE1 uptime is 5 hours, 22 minutesSystem image file is "disk0:hfr-os-mbi-3.7.1/mbihfr-rp.vm"cisco CRS-16/S (7455) processor with 2097152K bytes of memory.7455 processor at 800Mhz, Revision 2.12 Ethernet/IEEE 802.3 interface(s)16 GigabitEthernet/IEEE 802.3 interface(s)32 SONET/SDH Port controller(s)32 Packet over SONET/SDH network interface(s)8 TenGigabitEthernet/IEEE 802.3 interface(s)1019k bytes of non-volatile configuration memory.2052832k bytes of disk0: (Sector size 512 bytes).1000592k bytes of disk1: (Sector size 512 bytes).Configuration register on node 0/1/CPU0 is 0x102Boot device on node 0/1/CPU0 is bootflash:Package active on node 0/1/CPU0:hfr-infra-test, V 3.7.1[00], Cisco Systems, at disk0:hfr-infra-test-3.7.1Built on Mon Oct 27 04:20:27 EDT 2008By zamboni in /auto/srcarchive3/production/3.7.1/hfr/workspace for c2.95.3-p8hfr-diags, V 3.7.1[00], Cisco Systems, at disk0:hfr-diags-3.7.1Built on Mon Oct 27 03:43:26 EDT 2008By zamboni in /auto/srcarchive3/production/3.7.1/hfr/workspace for c2.95.3-p8hfr-mcast, V 3.7.1[00], Cisco Systems, at disk0:hfr-mcast-3.7.1Built on Mon Oct 27 09:20:24 EDT 2008By zamboni in /auto/srcarchive3/production/3.7.1/hfr/workspace for c2.95.3-p8...Cisco XR 12000 Series Router
On the Cisco XR 12000 Series Router, you should see a response similar to the following (which has been abbreviated for the Release Notes):
Cisco IOS XR Software, Version 3.7.1[00]Copyright (c) 2008 by Cisco Systems, Inc.ROM: System Bootstrap, Version 12.0(20040624:164256) [assafb-misc1 1.14dev(0.91)] DEVELOPMENT SOFTWARECopyright (c) 1994-2004 by cisco Systems, Inc.PINOT_IP_PE3 uptime is 1 hour, 19 minutesSystem image file is "disk0:c12k-os-mbi-3.7.1/mbiprp-rp.vm"cisco 12416/PRP (7457) processor with 3670016K bytes of memory.7457 processor at 1266Mhz, Revision 1.22 Cisco 12000 Series Performance Route Processors2 1 Port ISE Packet Over SONET OC-48c/STM-16 Controllers (2 POS)2 Cisco 12000 4 Port Gigabit Ethernet Controllers (8 GigabitEthernet)1 4 Port ISE Packet Over SONET OC-12c/STM-4 Controller (4 POS)1 Cisco 12000 Series SPA Interface Processor-6003 Cisco 12000 Series SPA Interface Processor-601/501/4011 Cisco 12000 Series - Multi-Service Blade Controller6 Ethernet/IEEE 802.3 interface(s)10 SONET/SDH Port controller(s)9 Packet over SONET/SDH network interface(s)16 PLIM QoS controller(s)18 GigabitEthernet/IEEE 802.3 interface(s)8 FastEthernet/IEEE 802.3 interface(s)1 Controller for the management of multilink interfacess3 T3 Port controller(s)44 Multilink network interface(s)1 Serial network interface(s)56 T1 Port controller(s)370 Serial network interface(s)1018k bytes of non-volatile configuration memory.2052832k bytes of disk0: (Sector size 512 bytes).2052832k bytes of disk1: (Sector size 512 bytes).65536k bytes of Flash internal SIMM (Sector size 256k).Configuration register on node 0/0/CPU0 is 0x2Boot device on node 0/0/CPU0 is disk0:Package active on node 0/0/CPU0:c12k-sbc, V 3.7.1[00], Cisco Systems, at disk0:c12k-sbc-3.7.1Built on Mon Oct 27 11:15:33 EDT 2008By edde-bld1 in /auto/srcarchive3/production/3.7.1/c12k/workspace for c2.95.3-p8c12k-ipsec-service, V 3.7.1[00], Cisco Systems, at disk0:c12k-ipsec-service-3.7.1Built on Mon Oct 27 05:14:07 EDT 2008By edde-bld1 in /auto/srcarchive3/production/3.7.1/c12k/workspace for c2.95.3-p8c12k-infra-test, V 3.7.1[00], Cisco Systems, at disk0:c12k-infra-test-3.7.1Built on Mon Oct 27 06:35:36 EDT 2008By edde-bld1 in /auto/srcarchive3/production/3.7.1/c12k/workspace for c2.95.3-p8c12k-diags, V 3.7.1[00], Cisco Systems, at disk0:c12k-diags-3.7.1Built on Mon Oct 27 07:41:35 EDT 2008By edde-bld1 in /auto/srcarchive3/production/3.7.1/c12k/workspace for c2.95.3-p8c12k-mgbl, V 3.7.1[00], Cisco Systems, at disk0:c12k-mgbl-3.7.1Built on Mon Oct 27 04:42:05 EDT 2008By edde-bld1 in /auto/srcarchive3/production/3.7.1/c12k/workspace for c2.95.3-p8c12k-mcast, V 3.7.1[00], Cisco Systems, at disk0:c12k-mcast-3.7.1Built on Mon Oct 27 04:41:35 EDT 2008By edde-bld1 in /auto/srcarchive3/production/3.7.1/c12k/workspace for c2.95.3-p8c12k-mpls, V 3.7.1[00], Cisco Systems, at disk0:c12k-mpls-3.7.1Built on Mon Oct 27 04:41:06 EDT 2008By edde-bld1 in /auto/srcarchive3/production/3.7.1/c12k/workspace for c2.95.3-p8c12k-rout, V 3.7.1[00], Cisco Systems, at disk0:c12k-rout-3.7.1Built on Mon Oct 27 04:52:02 EDT 2008By edde-bld1 in /auto/srcarchive3/production/3.7.1/c12k/workspace for c2.95.3-p8c12k-k9sec, V 3.7.1[00], Cisco Systems, at disk0:c12k-k9sec-3.7.1Built on Mon Oct 27 04:42:30 EDT 2008By edde-bld1 in /auto/srcarchive3/production/3.7.1/c12k/workspace for c2.95.3-p8c12k-lc, V 3.7.1[00], Cisco Systems, at disk0:c12k-lc-3.7.1Built on Mon Oct 27 04:51:15 EDT 2008By edde-bld1 in /auto/srcarchive3/production/3.7.1/c12k/workspace for c2.95.3-p8c12k-fwdg, V 3.7.1[00], Cisco Systems, at disk0:c12k-fwdg-3.7.1Built on Mon Oct 27 04:50:10 EDT 2008By edde-bld1 in /auto/srcarchive3/production/3.7.1/c12k/workspace for c2.95.3-p8c12k-admin, V 3.7.1[00], Cisco Systems, at disk0:c12k-admin-3.7.1Built on Mon Oct 27 04:49:21 EDT 2008By edde-bld1 in /auto/srcarchive3/production/3.7.1/c12k/workspace for c2.95.3-p8c12k-base, V 3.7.1[00], Cisco Systems, at disk0:c12k-base-3.7.1Built on Mon Oct 27 04:47:48 EDT 2008By edde-bld1 in /auto/srcarchive3/production/3.7.1/c12k/workspace for c2.95.3-p8...
New Features and Enhancements
The following sections contain information on new features and enhancements in Cisco IOS XR Software Release 3.7.1:
•
•
New Software Features in Cisco IOS XR Software Release 3.7.1
Both Cisco CRS-1 and Cisco XR 12000 Series Router Platforms
Cisco CRS-1 and Cisco XR 12000 Series Router platforms support the following new features in Cisco IOS XR Software Release 3.7.1:
•
Cisco CRS-1 Router-Specific Software Features
The following new features in Cisco IOS XR Software Release 3.7.1 are supported only on the Cisco CRS-1 platform:
•
Note
Cisco XR 12000 Series Router Software Features
The following new features in Cisco IOS XR Software Release 3.7.1 are supported only on the Cisco XR 12000 Series Router platform:
•
Cisco XR 12000 Series Router Services
•
New Hardware Features in Cisco IOS XR Software Release 3.7.1
There were no new hardware features introduced in Cisco IOS XR Software Release 3.7.1 on either the Cisco CRS-1 platform or the Cisco XR 12000 Series Router platform.
Note
For detailed information on the shared port adapters (SPAs) and SPA interface processors (SIPs), see the following documents:
•
•
Feature Documentation
The following documentation about how to use the features introduced in the current maintenance release, is organized by the feature name for which it has been introduced:
•
•
Note
Enhanced Tuning of SPF LSA Counts for OSPF Topology
Three new commands have been added to enhance the tuning of link-state advertisements (LSAs) processed per shortest path first (SPF) counts on OSPF topology:
•
queue dispatch rate-limited-lsa
To set the maximum number of rate-limited link-state advertisements (LSAs) processed per run, use the queue dispatch rate-limited-lsa command in router configuration mode. To return to the system default value, use the no form of this command.
queue dispatch rate-limited-lsa count
no queue dispatch rate-limited-lsa
Syntax Description
Defaults
The default number of rate-limited LSAs processed per run is 300 (when this count is not configured).
Command Modes
Router configuration
Command History
Release 3.7.1
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs.If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to set the maximum number of rate-limited LSAs to 30:
RP/0/RP0/CPU0:router(config-ospf)# queue dispatch rate-limited-lsa 30queue dispatch incoming
To limit the number of continuous incoming events processed, use the queue dispatch incoming command in router configuration mode. To return to the system default value, use the no form of this command.
queue dispatch incoming count
no queue dispatch incoming
Syntax Description
Command Default
The default incoming count is 300 packets (when the count is not configured).
Command Modes
Router configuration
Command History
Release 3.7.1
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs.If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The follwing example shows how to limit the number of continuous incoming events processed to 30:
RP/0/RP0/CPU0:router(config-ospf)# queue dispatch incoming 30Use the show ospf message-queue command to see the queue dispatch values, peak lengths, and limits.
queue dispatch spf-lsa-limit
To change the maximum number of Type 3-4 and Type 5-7 link-state advertisements (LSAs) processed per shortest path first (SPF) run, use the queue dispatch spf-lsa-limit command in router configuration mode. To return to the system default value, use the no form of this command.
queue dispatch spf-lsa-limit count
no queue dispatch spf-lsa-limit
Syntax Description
count
Maximum number of continuous Type 3-4 and Type 5-7 LSAs processed per SPF in each scheduled run. Range is 30 to 3000.
Defaults
The default number of Type 3-4 and Type 5-7 processed per run is 150 LSAs (when this command is not configured).
Command Modes
Router configuration
Command History
Release 3.7.1
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs.If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to limit the number of continuous Type 3-4 and Type 5-7 LSAs processed by SPF per scheduling run, to 100:
RP/0/RP0/CPU0:router(config-ospf)# queue dispatch spf-lsa-limit 100MPLS Tunnel Drop Counts
Two new fields displaying drop and error packets were added to the output of the show interfaces tunnel-te command, which runs only on the Cisco CRS-1 router.
show interfaces tunnel-te
To verify whether or not there are drop or error packets on MPLS traffic engineering (TE) tunnel interfaces, use the show interfaces tunnel-te command in EXEC mode.
show interfaces tunnel-te tunnel-number
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs.If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS XR System Security Configuration Guide.
The show interfaces tunnel-te command, which runs only on the Cisco CRS-1 router, was modified by the addition of two new fields, drop counter and error counter.
Note
Field Descriptions
drop counter
Displays dropped packets that result from oversubscription of the egress link hosting the TE-tunnel in an MPLS network
error counter
Displays packets dropped during a fast-reroute (FRR) on the line card hosting the primary TE tunnel in an MPLS network.
1 These are not the names of the fields, but rather their purpose.
Task ID
Examples
The following example shows sample output from the show interfaces tunnel-te command with the newly added information in boldface:
RP/0/RP0/CPU0:router# show interfaces tunnel-te 1RP/0/RP0/CPU0:router# tunnel-te1 is down, line protocol is downInterface state transitions: 1Hardware is Tunnel-TEInternet address is UnknownMTU 1500 bytes, BW 0 Kbitreliability 255/255, txload Unknown, rxload UnknownEncapsulation TUNNEL, loopback not set,Last clearing of "show interface" counters never5 minute input rate 0 bits/sec, 0 packets/sec5 minute output rate 0 bits/sec, 0 packets/sec0 packets input, 0 bytes, 0 total input drops0 drops for unrecognized upper-level protocolReceived 0 broadcast packets, 0 multicast packets0 packets output, 0 bytes, 0 total output dropsOutput 0 broadcast packets, 0 multicast packets0 output errorsConfiguration Changes to the SONET Delay Timer CLI
Changes were made to value ranges for configurable SONET delay timers in the Channelized CHOC48 SPA and Channelized CHOC12 SPA on the SIP401/501/601 line cards:
SONET controller alarm timer changes to CLI value ranges:
Alarm Declare
Default = 0 ms
line delay trigger 0-60000 ms
path delay trigger 0-60000 ms
Alarm Debounce
Default = 10 sec
line delay clear 1000-180000 ms
path delay clear 1000-180000 ms
T3/E3/T1/E1 controller timer changes to CLI value ranges:
Alarm Declare
Default = 0 sec
delay trigger 0-60000 ms
Alarm Clear
Default = 10 sec
delay clear 0-180000 ms
Important Notes
•
•
•
•
•
RP/0/0/CPU0:router# adminRP/0/0/CPU0:router# show environment power-supply table48V CurrentR/S/I Module (V) (A)0/24/* PEM1 54 4PEM2 53 40/25/* PEM1 54 4PEM2 53 4Total Power Supplies: 3200WRedundant Power Supplies: 1600WWorst Case Power Used: 621WCurrent Power Used: 428WCurrent Redundant Power Available: 1172WCurrent Total Power Available: 2772WWorst Case Redundant Power Available: 979WWorst Case Total Power Available: 2579WPID Description Watts--- ----------- -----GRP-B Route Processor 38PRP-1 Cisco 12000 Series Performance Route Processor 60LC-4OC-3-POS-SM 4 Port Packet Over SONET OC-3c/STM-1 804OC3X/POS-MM-MJ-B 4 port ISE OC3 90If you plan to insert a new card, locate the entry for the card to be inserted and note the power consumed by it. If this power is less than the figure given in Worst Case Redundant Power Available (the figure is displayed in the show environment power-supply table command output), the card can be safely inserted. As long as the Worst Case Redundant Power Available is not zero, a PEM can be powered down for replacement without impact.
Note
•
•
•
•
Minimum Flash Disk Requirements When Upgrading to Release 3.7.0 and Later Releases
The PCMCIA 1-GB Flash Disk is the default flash disk size for the Cisco CRS-1 IOS for Cisco IOS XR Software Release 3.6. However, the PCMCIA 2-GB Flash Disk is required for Release 3.7.0 and later releases. The PCMCIA 2-GB Flash Disk is supported in Cisco IOS XR Software Release 3.6 for customers who need to upgrade their PCMCIA flash disk to the higher-capacity disk.
To upgrade from a 1-GB flash disk to a 2-GB or greater flash disk, refer to the Cisco XR12000 and CRS-1 Flash Disk Upgrade Tasks document at http://www.cisco.com/en/US/docs/routers/xr12000/xr_line_cards/flashdisk/flashdisk.pdf.
Caveats
Caveats describe unexpected behavior in Cisco IOS XR software releases. Severity-1 caveats are the most serious.
The following caveats are open for Cisco IOS XR Software Release 3.7.1 on the router platforms indicated:
•
•
•
Cisco CRS-1 and Cisco XR 12000 Series Router Caveats
The following caveats apply to both platforms:
•
Basic Description:
Physical layer interface Modules (PLIMs), such as Xenpak, XFP, or SFP, cannot be identified in the router. Instead, the PLIM interface inventory appears as optical ports.
Symptoms:
Neither serial number nor component name of pluggable interface equipment are visible. No card out/card in SNMP traps for pluggable interface equipment in Cisco CRS-1 PLIM. Link down/link up SNMP traps and interface up/down events remain unaffected by this issue. Using management applications supporting fault coloration technology, such as Cisco Active Network Abstract (ANA), may not be reliable.
Workaround
None.
•
Basic Description:
MFIB VRF table goes remote on line card, instead of local, in MVPN stress.
Symptom:
In a scaled setup, under certain stress scenarios, MFIB VRF table goes remote on the line card, instead of local. As a result, no routes are programmed on the line card. The command show mfib table-info vrf-name location node-id should show location: local if there are interfaces from that line card on any multicast route. Instead, you see location: remote.
Conditions:
The exact condition leading to the empty MFIB is not known, but the problem has been observed on an MVPNv4 scale testbed with different stress conditions of interface flaps, process restart, addition/removal of multicast configurations, and in interfaces.
Workaround:
Clear MFIB data (clear MFIB database location location-id) on the line card or line card reload.
•
Basic Description:
Users with Cisco routers running Cisco IOS XR software with MPLS TE configured and using IS-IS as the IGP protocol may observe IS-IS sending the TE tunnel metric to RIB instead of the IGP metric.
Conditions:
Configuration of MPLS TE using IS-IS as IGP protocol.
Workaround:
None.
Caveats Specific to the Cisco CRS-1 Router
The following caveats are specific to the Cisco CRS-1 platform:
•
Basic Description:
After upgrade, a service policy cannot be associated with an interface.
Conditions:
Each class that requires a queue must have some bandwidth made available to it, using the bandwidth or bandwidth remaining command, otherwise the class is "starved." If a class does not have any bandwidth assigned to it using the bandwidth command, then bandwidth remaining should not be set to 0% (effectively starving the queue). A minimum of 1% bandwidth should either be assigned explicitly using the bandwidth remaining command or implicitly by ensuring that the total value of the bandwidth remaining commands within the policy is less than 100%, thereby leaving 1% available to the class.
Prior to Release 3.7.0, explicitly configuring bandwidth remaining 0 for a particular class was not supported. As of Release 3.7.1, explicitly or implicitly configuring bandwidth remaining 0 for a class is supported if bandwidth has been reserved for that class using the bandwidth command.
Workaround:
None.
Special Preventative Measures:
To avoid this issue, take one of the following steps:
–
–
–
•
Basic Description:
Copying a very large prefix set (or a configuration with a very large prefix set) to the running configuration takes 30 minutes or more due to the prefix set verification process.
Prefix list verification happens before bringing the prefix set into running configuration, regardless of its association with an RPL or a stand alone prefix list.
Conditions:
This condition is seen when applying a very large prefix list to the running configuration, or when rolling back the configuration when the prefix list has been deleted.
Workaround:
None.
•
Basic Description:
Cisco Express Forwarding (CEF) entries on some of the line cards and route processors remain unresolved.
Conditions:
The problem is observed only very rarely during a reload of an entire line card chassis on a Cisco CRS-1 multichassis system.
Workaround:
1. Identify the LCs/RPs with unresolved CEF entries using the command:
show cef summary loc all | inc unresolved2. Clear the CEF entries on the affected entities , using the command:
clear cef linecard location location•
Basic Description:
An unexpected restart of the lspv_server process occurs when the show mpls oam database request command is issued.
Conditions:
The unexpected restart was observed after the foregoing command was used during an IP/SLA echo request transmissions from lspv_server.
Workaround:
No explicit user action is needed. The lspv_server process automatically respawns after the abnormal termination and IP/SLA MPLS operations resume.
•
Basic Description:
On a Cisco CRS-1 router chassis with traffic passing on GigE SPA, traffic restoration takes a long time after removing and inserting the SPA. The SPA may be observed to reboot before coming back online and passing traffic again.
Symptom:
Port deletion timeout after GigE SPA removal and insertion. Stale backpressure state remains present in the EgressQ ASIC.
Conditions:
GigE SPA online insertion and removal operation while passing traffic.
Workaround:
Reload the line card.
•
Basic Description:
The show tech multicast command takes up to several hours to complete.
Conditions:
This issue was seen during regular usage of the show tech multicast command. Depending on the router scale, it can take multiple hours to complete.
Workaround:
Reduce the amount of data collected by the show tech multicast command by using relevant filters for location, group_address, source_address, and VRF. The reduced data reduces the time required to compute the command.
•
Basic Description:
Unexpected restart of BGP process on enabling distributed BGP.
Symptom:
An unexpected restart of the BGP process occurs after enabling distributed BGP.
Conditions:
The unexpected restart of the BGP process was seen after a change in configuration of distributed-mode BGP to standalone-mode BGP on the Cisco CRS-1 router.
Workaround:
There is no known workaround. However, the process respawns automatically after the unexpected termination and recovers.
•
Basic Description:
The rdsfs_svr process crashes on the standby distributed route processor (DRP)/route processor (RP) after a router reload.
Symptom:
The rdsfs_svr process crashes on the RP/DRP, and a voluntary dump occurs.
Conditions:
Due to a temporary transport error, the standby DRP/RP reloads.
Workaround:
Process comes back up with no problems after the crash.
•
Basic Description:
The command show tech fabric fabric-support location has no pipeline option.
Symptom:
RP/0/RP0/CPU0:router(admin)# show tech fabri fabric-snapshot location 0/5/CPU0 include-fabric-cards include-rp ?
CLI does not have pipeline option.
Workaround:
Specify the output option prior to specifying the location:
RP/0/RP0/CPU0:router(admin)# show tech fabri fabric-snapshot file harddisk:/tmp/snapshot location 0/5/CPU0 include-fabric-cards include-rp ?
Apart from the inconsistency in command structure, the showtech fabric snapshot command is fully functional. You should be able to save output to the file, e-mail the output, or page output on the console as designed.
Only in some situations, must the output option be specified prior to the location, as well as other options.
•
Basic Description:
The cfgmgr-lc process is unable to process configuration restoration requests.
Symptom:
Restoration of interface configuration for the specified node in the event message fails and shows the error message:
A client of SysDB attempted to start a transaction or bulk operation while it was already in a transaction''. Please see event message below:LC/3/4/CPU0:Apr 11 17:27:38.701 : cfgmgr-lc[114]:
%MGBL-CONFIG-3-INTERFACE_ERROR : Error encountered while restoring configuration for ''bulk restore''. Some configuration may not have been applied and any missing configuration needs to be reapplied manually. Error: ''''sysdb'' detected the ''warning'' condition ''A client of SysDB attempted to start a transaction or bulk operation while it was already in a transaction''
Additional things to look for:
–
–
Note
Conditions:
In a scaled Cisco CRS-1 multishelf system, after an non-DSC online insertion and removal, some interface configurations were not restored as a result of a lower-layer SysDB issue.
This also had the side-effect of causing cfgmgr-lc to retry restoration of configuration for a node, causing it to create a new configuration session each time. The logic in cfgmgr-lc is to retry indefinitely, because there might legitimately be a large configuration being committed with a configuration write-lock that is causing delay to the line card restoration. The stale configuration sessions resulted from the lower layer returning an incorrect error code when this condition happened.
Workaround:
1.
This should clear the SysDB issue and cause configuration restoration to continue.
2.
Caveats Specific to the Cisco XR 12000 Series Router
The following caveats are specific to the Cisco XR 12000 Series Router platform:
•
Basic Description:
IKE fails during Phase 1 and generates the following error message:
%SECURITY-IKE-3-RETRANSMISSION_LIMITThe IPSec tunnel goes down and crypto traffic is lost.
Conditions:
A restart of User Datagram Protocol (UDP) process causes IKE to fail during Phase 1.
Symptoms:
IKE fails during Phase 1 and all IPSec security associations disappear and IPSec traffic is lost. ISAKMP remains in MM_NO_STATE.
Workaround:
Restart the IPSec and IKE MP processes as many times as needed to bring IKE up.
Note
•
Basic Description:
Some Bidirectional Forwarding Detection (BFD) protocol sessions remain down after restarting the fabric_driver_lc process on the line card.
Conditions:
After restart of the fabric_driver_lc process on the line card, the BFD sessions remained down. This was because bug CSCsr07960 in qad-infra led to incorrect queuing of BFD packets to netio qad instead of BFD private qad queue.
Workaround:
Restart BFD process.
•
Basic Description:
Unexpected restart of ipv6_ma process on line card admin shut/noshut.
Symptom:
An unexpected restart of the ipv6_ma process following admin shut/unshut of a line card.
Conditions:
On rare occasions, an abnormal restart of the ipv6_ma process has been observed following admin shut/noshut of a line card.
Workaround:
No explicit workaround is necessary. The process ipv6_ma respawns automatically and recovers from this error.
•
Basic Description:
The show tech install file tftp command pauses indefinitely.
Symptom:
The show tech install file tftp command pauses in some cases indefinitely.
Conditions:
The problem happens when the output of the show tech install command is directed to a TFTP server on the network. The foregoing operation is, however, successful for other show tech commands. The difference in outcome appears to result from the larger size of the show tech install output and from the multiple scripts running behind the CLI.
Workaround:
The ctrl+c command kills the show tech install command and returns the console prompt to the user.
To copy the show tech install command out of the router, use show tech install file disk.... to first save the show output to local disk, then copy that file from disk to the TFTP server.
•
Basic Description:
The show services redundancy summary command displays unnecessary zeros.
Symptom:
The output of show services redundancy summary displays unnecessary zeros before the count of services. For example, the following output appears for a configuration with 100 firewall services.
RP/0/15/CPU0:PE1#show services redundancy summary
Service type Offline Act Only Act+Stby Total
----------------------------------------------------
Firewall 00000000 00000100 00000000 00000100
Conditions:
This problem is observed in Cisco XR 12000 Series Routers running Release 3.7.1.
Workaround:
No workaround is required for this issue, because it causes no problems on the router. The configured services behave correctly and the numbers of services displayed in the show command output are correct. The only issue is with the output format.
Upgrading Cisco IOS XR Software
Cisco IOS XR software is installed and activated from modular packages, allowing specific features or software patches to be installed, upgraded, or downgraded without affecting unrelated processes. Software packages can be upgraded or downgraded on all supported card types, or on a single card (node).
Software packages are installed from package installation envelope (PIE) files that contain one or more software components.
The following URL contains links to information about how to upgrade Cisco IOS XR software:
http://www.cisco.com/web/Cisco_IOS_XR_Software/index.html
Note
Troubleshooting
For information on troubleshooting Cisco IOS XR software, see Cisco IOS XR Getting Started Guide and Cisco IOS XR Troubleshooting Guide.
Related Documentation
The following sections describe the documentation available for the Cisco CRS-1 router and the Cisco XR 12000 Series Router. Documentation is available in the form of PDF and HTML files and is available on www.Cisco.com:
Hardware Documents
You can find the most current hardware documentation at the following URLs:
Cisco CRS-1:
http://www.cisco.com/en/US/products/ps5763/tsd_products_support_series_home.html
Cisco XR 12000 Series Router:
http://www.cisco.com/en/US/products/ps6342/tsd_products_support_series_home.html
Software Documents
The Cisco IOS XR software documentation set includes the Cisco IOS XR software configuration guides and command references, as well as a getting started guide. For a full list, see About Cisco IOS XR Software Documentation for Release 3.7 for a list of Cisco IOS XR software documentation for Release 3.7.0.
You can find the most current software documentation at the following URL:
http://www.cisco.com/en/US/products/ps5845/tsd_products_support_series_home.html
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Subscribe to the What's New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS Version 2.0.
This document is to be used in conjunction with the documents listed in the "Related Documentation" section.
CCDE, CCENT, Cisco Eos, Cisco HealthPresence, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco StadiumVision, Cisco TelePresence, Cisco WebEx, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn and Cisco Store are service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0812R)
© 2009 Cisco Systems, Inc. All rights reserved.
Guest
