Guest

Cisco IOS Software Releases 12.0 S

Performance Route Processor (PRP) Software Configuration in Cisco 12000 Series Internet Routers

  • Viewing Options

  • PDF (273.2 KB)
  • Feedback
Performance Route Processor (PRP) Software Configuration in Cisco 12000 Series Routers

Table Of Contents

Performance Route Processor (PRP) Software Configuration in Cisco 12000 Series Routers

Feature Overview

Benefits

Restrictions

Related Documents

Supported Platforms

Supported Standards, MIBs, and RFCs

Prerequisites

Configuration Tasks

Configuring Warmstart

Verifying Warmstart

Monitoring and Maintaining the PRP Software Configuration

Configuration Examples

Command Reference

cache l3 disable

clear psar

exception warmstart

show controllers ethernet

show controllers gt64260

show controllers psar

Glossary


Performance Route Processor (PRP) Software Configuration in Cisco 12000 Series Routers


Feature History

Release
Modification

12.0(22)S

This feature was introduced on Cisco 12000 Series Routers.

12.0(30)S

Disabling of Layer 3 cache added.


This feature module describes the software configuration of the Performance Route Processor (PRP) in Cisco 12000 Series Routers.

This document includes the following sections:

Feature Overview

Supported Platforms

Supported Standards, MIBs, and RFCs

Prerequisites

Configuration Tasks

To monitor the software configuration of the PRP, use the following show commands in EXEC mode:

Command Reference

Glossary

Feature Overview

The Performance Route Processor (PRP) in the Cisco 12000 Series Router is designed to meet the growing demands in the high-end IP routing market due to increased Internet traffic, larger routing tables, acceptance of IP as the common networking layer protocol, and an increasing shift in focus by service providers to IP infrastructures.

The PRP satisfies these demands by providing an evolution from the current Gigabit Route Processor (GRP) card with a faster processor, multilayer cache, improved fabric interface for faster communication between the PRP and line cards, and larger memory capacity.

The PRP is designed to support all IOS software features that are supported on the GRP, such as High Availability and standard routing protocols.


Note The Stateful Switchover with Nonstop Forwarding (SSO/NSF) feature will be supported in IOS Release 12.0(23)S and later.


Benefits

Route Processor Redundancy Plus (RPR+) Support

The PRP supports the High Availability feature, Route Processor Redundancy Plus (RPR+). With RPR+, the standby RP in a Cisco 12000 Series Router is fully initialized and configured.

RPR+ dramatically shortens the switchover time if the active RP fails or if a manual switchover is performed. Because both the startup configuration and running configuration are continually synchronized from the active to the standby RP, line cards are not reset during a switchover. The interfaces remain up during this transfer, so neighboring routers do not detect a link flap (the link does not go down and back up). For more information, refer to:

http://www.cisco.com/univercd/cc/td/doc/product/software/ios120/120newft/120limit/120st/120st17/
r
pr_plus.htm

Faster Recovery After a System Crash

The exception warmstart feature in PRP software minimizes downtime following a system crash. It allows for a faster recovery by avoiding the need to reload the software image from an external device.

Restrictions

PRP and GRP Coexistence

You cannot use the PRP and the GRP at the same time during normal router operation. The only time when a GRP and PRP can be used in the same router is during migration from the GRP to the PRP. For more information about the migration procedure, refer to the Performance Route Processor Installation and Configuration Note.

Supported Software Images

You cannot load a GRP software image (with the naming convention gsr-p-mz) on the PRP. GRP and PRP software images are not interchangeable due to the different types of CPU used in each route processor. The PRP uses a software image with the naming convention c12kprp-p-mz.

Redundant PRP Installations

The Warmstart feature is disabled by default if a second, backup PRP is installed in the router for redundancy.

Related Documents

Cisco IOS Configuration Fundamentals Configuration Guide, Release 12.0

Cisco IOS Configuration Fundamentals Command Reference, Release 12.0

Network Protocols Command Reference, Part 1, Release 11.3
http://www.cisco.com/univercd/cc/td/doc/product/software/ios113ed/113ed_cr/np1_r/1rospf.htm

Cisco 12000 Series Internet Router Flash Disk Information (DOC-7814024)

Cisco 12000 Series Internet Router Memory Replacement Instructions (DOC-784338)

Performance Route Processor Installation and Configuration Note (DOC-7813302)

Route Processor Redundancy Plus for the Cisco 12000 Series Internet Router
http://www.cisco.com/en/US/products/sw/iosswrel/ps1829/products_feature_guide09186a00800a8590.html

Performance Route Processor Installation and Configuration (DOC-7813302)
http://www.cisco.com/univercd/cc/td/doc/product/core/cis12000/otherdoc/13302prp.htm

Supported Platforms

Cisco 12000 Series Routers

Determining Platform Support Through Cisco Feature Navigator

Cisco IOS software is packaged in feature sets that support specific platforms. To get updated information regarding platform support for this feature, access Cisco Feature Navigator. Cisco Feature Navigator dynamically updates the list of supported platforms as new platform support is added for the feature.

Cisco Feature Navigator is a web-based tool that enables you to determine which Cisco IOS software images support a specific set of features and which features are supported in a specific Cisco IOS image. You can search by feature or release. Under the release section, you can compare releases side by side to display both the features unique to each software release and the features in common.

To access Cisco Feature Navigator, you must have an account on Cisco.com. If you have forgotten or lost your account information, send a blank e-mail to cco-locksmith@cisco.com. An automatic check will verify that your e-mail address is registered with Cisco.com. If the check is successful, account details with a new random password will be e-mailed to you. Qualified users can establish an account on Cisco.com by following the directions at http://www.cisco.com/register.

Cisco Feature Navigator is updated regularly when major Cisco IOS software releases and technology releases occur. For the most current information, go to the Cisco Feature Navigator home page at the following URL:

http://www.cisco.com/go/fn

Availability of Cisco IOS Software Images

Platform support for particular Cisco IOS software releases is dependent on the availability of the software images for those platforms. Software images for some platforms may be deferred, delayed, or changed without prior notice. For updated information about platform support and availability of software images for each Cisco IOS software release, refer to the online release notes or, if supported, Cisco Feature Navigator.

Supported Standards, MIBs, and RFCs

Standards

No new or modified standards are supported by this feature.

MIBs

No new or modified MIBs are supported by this feature.

To obtain lists of supported MIBs by platform and Cisco IOS release, and to download MIB modules, go to the Cisco MIB website on Cisco.com at the following URL:

http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml

RFCs

No new or modified RFCs are supported by this feature.

Prerequisites

None.

Configuration Tasks

See the following sections for configuration tasks for the Warmstart feature. Each task in the list is identified as either required or optional.

Configuring Warmstart (required)

Verifying Warmstart (optional)

Configuring Warmstart

You can reconfigure the Warmstart feature only in a single PRP configuration. In a dual (redundant) PRP configuration, the Warmstart feature is disabled by default and should not be enabled.

To configure the Warmstart feature, use the following commands starting in global configuration mode:

 
Command
Purpose

Step 1 

Router(config)# configure terminal

Enters global configuration mode.

Step 2 

Router(config-if)# exception warmstart min-uptime max-restarts

Configures the minimum amount of IOS uptime (in seconds) required and the maximum number of restarts allowed for a warm start to occur.

Verifying Warmstart

To verify the configuration settings for the warmstart feature, use the show run command in global configuration mode. In the following example, the warmstart configuration settings are shown in bold.

Router# show run
...
line con 0
 exec-timeout 0 0
line aux 0
line vty 0 4
 login
...
exception warmstart 60 5 
end

Monitoring and Maintaining the PRP Software Configuration

To monitor the software configuration of the PRP, use the following show commands in EXEC mode:

Command
Purpose

Router# show controllers ethernet

Displays the register values and status of the GT64260 Ethernet controllers.

Router# show controllers gt64260

Displays register values of the GT64260 Discovery System controller.

Router# show controllers psar

Displays statistics about the packets sent and received in the PRP packet segmentation and reassembly (PSAR) controllers.


Configuration Examples

This following example shows how to configure the warmstart feature on a Cisco 12000 Series Router so that the IOS software restarts after a crash if the PRP in the router has already been running for at least 60 seconds and if the IOS software has not been restarted by the Warmstart feature more than 10 times:

Router# configure terminal 
Router# exception warmstart 60 10
Router# end

Command Reference

This section documents new and modified commands. All other commands used with this feature are documented in the Cisco IOS Release 12.0 command reference publications.

cache l3 disable

clear psar

exception warmstart

show controllers ethernet

show controllers gt64260

show controllers psar

cache l3 disable

To disable the Layer 3 cache on the route processor (RP), use the cache l3 disable command in global configuration mode. To reenable the Layer 3 cache, use the no form of this command.

cache l3 disable

no cache l3 disable

Syntax Description

This command has no arguments or keywords.

Defaults

enabled

Command Modes

global configuration

Command History

Release
Modification

12.0(30)S

This command was introduced.


Usage Guidelines

Use this command in instances where cache parity errors are of issue. Disabling the Layer 3 cache on the RP will minimize the chance of soft errors in the CPU.

clear psar

To reset and restart all packet statistics maintained in the PRP segmentation and reassembly (PSAR) drivers, use the clear psar command in global configuration mode.

clear psar

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Global configuration mode.

Command History

Release
Modification

12.0(22)S

This command was introduced.


Usage Guidelines

The clear psar command replaces the clear csar command used on the Gigabit Route Processor.

Examples

The following example shows how to clear all statistics recorded in the PSAR drivers:

Router# clear psar


exception warmstart

To configure a Cisco 12000 Series Router for a warmstart in case of a system crash, use the exception warmstart command in global configuration mode. To remove the warmstart configuration settings, use the no form of this command.

exception warmstart min-uptime max-restarts [d]

no exception warmstart min-uptime max-restarts

Syntax Description

min-uptime

Minimum amount of PRP uptime (in seconds) required before a warmstart is performed. Valid values are from 0 to 1000000.

max-restarts

Maximum number of IOS warmstarts allowed before a warmstart is no longer performed. Valid values are from 0 to 1000000.

d

Optional. Enables a warmstart if a second (dual) Performance Router Processor (PRP) is installed.


Defaults

The default for the minimum uptime is 60 seconds.

The default for the maximum number of restarts allowed is 5.

By default, the warmstart feature is:

Enabled if only one PRP is installed.

Disabled if a second, standby PRP is installed in the router.

Command Modes

Global configuration mode.

Command History

Release
Modification

12.0(22)S

This command was introduced.


Usage Guidelines

The warmstart feature allows the PRP in a Cisco 12000 Series Router to restart the IOS software configuration after a crash, without having to reload the image from an external device.


Note As with other exception commands, use the exception warmstart command only as instructed and when asked to do so by Cisco technical support personnel.


If the PRP has been running for at least the amount of time specified by min-uptime, and if the system has not been restarted more than the number of times specified by max-restarts, the route processor restarts IOS following a system crash.

In a dual PRP configuration (that is, when a redundant PRP is installed in the router), the warmstart feature is disabled by default. For this reason, you must specify d (for dual) when you enter the exception warmstart command to enable a warmstart.

This feature does not affect the behavior of the reload command. Also, you can still perform a "send break" as usual from the console by pressing Ctrl-Z.

Examples

The following example applies to a redundant configuration in which two PRPs are installed. It shows how to configure a warmstart if the IOS software in the PRP has been running for at least 90 seconds, and if the system has not been restarted more than eight times:

Router# configure terminal 
Router# exception warmstart 90 8 d 

show controllers ethernet

To display the register values and status of the GT64260 Ethernet controllers, use the show controllers ethernet command in privileged EXEC mode.

show controllers ethernet [mib | registers | brief]

Syntax Description

mib

Displays MIB statistics of the information communicated by means of the ethernet0 and ethernet1 management interfaces.

registers

Performs a dump of the information collected in the ethernet0 and ethernet1 controller and PHY registers.

brief

Displays information about the MIB, registers, and counters.


Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(22)S

This command was introduced.


Usage Guidelines

Use the show controllers ethernet command for debugging purposes to provide troubleshooting information for a Cisco technical support engineer.

Examples

The following example shows how to display MIB statistics for the ethernet0 and ethernet1 management interfaces:

Router# show controllers ethernet mib
---------------------------------------------------
Ethernet0 - GT64260 10/100 Mbps Ethernet Controller
MIB Counters:
bytes_received           = 0
bytes_sent               = 0
frames_received          = 0
frames_sent              = 0
total_bytes_received     = 0
total_frames_received    = 0
broadcast_frames_received = 0
multicast_frames_received = 0
crc_error                = 0
oversize_frames          = 0
fragments                = 0
jabber                   = 0
collision                = 0
late_collision           = 0
frames_64_bytes          = 0
frames_65_to_127_bytes   = 0
frames_128_to_255_bytes  = 0
frames_256_to_511_bytes  = 0
frames_512_to_1023_bytes = 0
frames_1024_to_max_bytes = 0
rx_error                 = 0
dropped_frames           = 0
out_multicast_frames     = 0
out_broadcast_frames     = 0
out_unicast_frames       = 0
undersize_frames         = 0

---------------------------------------------------
Ethernet1 - GT64260 10/100 Mbps Ethernet Controller
MIB Counters:
bytes_received           = 0
bytes_sent               = 0
frames_received          = 0
frames_sent              = 0
total_bytes_received     = 0
total_frames_received    = 0
broadcast_frames_received = 0
multicast_frames_received = 0
crc_error                = 0
oversize_frames          = 0
fragments                = 0
jabber                   = 0
collision                = 0
late_collision           = 0
frames_64_bytes          = 0
frames_65_to_127_bytes   = 0
frames_128_to_255_bytes  = 0
frames_256_to_511_bytes  = 0
frames_512_to_1023_bytes = 0
frames_1024_to_max_bytes = 0
rx_error                 = 0
dropped_frames           = 0
out_multicast_frames     = 0
out_broadcast_frames     = 0
out_unicast_frames       = 0
undersize_frames         = 0

show controllers gt64260

To display the register values of the GT64260 Discovery System controller, use the show controllers gt64260 command in privileged EXEC mode.

show controllers gt64260 [CPU | IDMA]

Syntax Description

CPU

Displays current register values of the Discovery CPU interface.

IDMA

Displays current register values of the Discovery IDMA interface.


Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(22)S

This command was introduced.


Usage Guidelines

Use the show controllers gt64260 command for debugging purposes to provide troubleshooting information for a Cisco technical support engineer.

Examples

The following example shows how to display the register values of the Discovery CPU interface:

Router# show controllers gt64260 cpu
GT64260 CPU Interface registers:
Access Protection Regs -
  Chan 0 Lo 00000FFF Hi 00000000
  Chan 1 Lo 00000FFF Hi 00000000
  Chan 2 Lo 00000FFF Hi 00000000
  Chan 3 Lo 00000FFF Hi 00000000
  Chan 4 Lo 00000FFF Hi 00000000
  Chan 5 Lo 00000FFF Hi 00000000
  Chan 6 Lo 00000FFF Hi 00000000
  Chan 7 Lo 00000FFF Hi 00000000

show controllers psar

To display statistics about the packets sent and received in the PRP packet segmentation and reassembly (PSAR) controllers, use the show controllers psar command in privileged EXEC mode.

show controllers psar [drop | fromfab | output | queue | register | tofab]

Syntax Description

drop

Displays statistics about packets dropped by PSAR.

fromfab

Displays per-slot statistics about packets received from the fabric interface.

output

Displays time statistics about how long it takes PSAR to process and send packets to the fabric interface.

queue

Displays statistics about PSAR queues.

register

Displays statistics about the PSAR register.

tofab

Displays per-slot statistics about packets sent to the fabric interface.


Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(22)S

This command was introduced.


Usage Guidelines

Use the show controllers psar command for debugging purposes to provide troubleshooting information for a Cisco technical support engineer.

The show controllers psar command replaces the show controllers csar command used on the Gigabit Route Processor.

Examples

The following example shows how to display the number of packets sent to the fabric interface. Note that this command only shows statistics to a given slot that have non-zero statistics. In this example, packets are sent only to slots 2, 4 and 5.

Router# show controllers psar tofab
To Fabric Stats:
---------------
Slot Tx pkts Tx TH pkts Tx dropped Tx DMA
2 		0 		2407 			0 		2407
4 		0 		43 			0 		43
5 		12 		2448 			0 		2460
To Fabric Errors:
----------------
Failed sends because of no header bufs - 0
Failed sends because of no payload bufs - 0
SRAM parity errors - 0
DMA errors - 0

The next example shows how to display the number of packets dropped by the PSAR driver because of lack of buffers, packet headers, no room in the descriptor queues, and so on:

Router# show controllers psar drop
To/From Fabric dropped packets:
------------------------------
Slot Tx pkt Rx pkt
	0 		0 		0
	1 		0 		0
	2 		0 		0
	3 		0 		0
	4 		0 		0
	5 		0 		0
	6 		0 		0
	7 		0 		0
	8 		0 		0
	9 		0 		0
	10 			0 		0
	11 			0 		0
	12 			0 		0
	13 			0 		0
	14 			0		0
	15 			0 		0
mcast 		0 		0

The next example shows how to display statistics for each PSAR queue, including the number of packet headers available in the PSAR driver pool:

Router# show controllers psar queue
To Fabric Queue Stats:
---------------------
Free packet header buffers 9216
Slot 		Cur Entrys Max Entrys Blocked BP count
0 		0 			0 			No 		0
1 		0 			0 			No 		0
2 		0 			4 			No 		0
3 		0 			0 			No 		0
4 		0 			2 			No 		0
5 		0 			4 			No 		0
6 		0 			0 			No 		0
7 		0 			0 			No 		0
8 		0 			0 			No 		0
9 		0			0 			No 		0
10 		0 			0 			No 		0
11 		0 			0 			No 		0
12 		0 			0 			No 		0
13 		0 			0 			No 		0
14 		0 			0 			No 		0
15 		0 			0 			No 		0
mcast 		0 			0 			No 		0

The following example shows how to display information about the PSAR driver register:

Router# show controllers psar register
Chopper Registers:
-----------------
FPGA Version 										00000095
Descriptor fetch enable 										00000000
Descriptor array size 										000003FF
Interrupt cause 										00000000
Interrupt mask 										FC01FFFF
Discovery low control reg base address F1000840
Discovery next desc reg base address 										F1000830
Chopper PCI base address 									F0000000
Descriptor queue empty status 									0001FFFF
Descriptor queue almost full 									00000000
Data queue empty status 									0001FFFF
Data queue almost full 									00000000
SRAM Descriptor threshold 									000003F0
SRAM Data threshold 									000007F0
DMA Control 									000010FF
Back pressure status 									00000000
Fusilli Tx Enable 									0001FFFF
Cell count 									000BB0E1
Reset VOQ 									XXXXXXXX
DMA Busy Status 									00000000
DMA Done Status 									000000FF
Descriptor start addr for queue 0 									0377F980
Descriptor start addr for queue 1 									037B5800
Descriptor start addr for queue 2 									037EB900
Descriptor start addr for queue 3 									03821980
Descriptor start addr for queue 4 									03857A00
Descriptor start addr for queue 5 									0388DA80
Descriptor start addr for queue 6 									038C3B00
Descriptor start addr for queue 7 									038F9B80
Descriptor start addr for queue 8 									0392FC00
Descriptor start addr for queue 9 									03965C80
Descriptor start addr for queue 10 									0399BD00
Descriptor start addr for queue 11 									039D1D80
Descriptor start addr for queue 12 									03A07E00
Descriptor start addr for queue 13 									03A3DE80
Descriptor start addr for queue 14 									03A73F00
Descriptor start addr for queue 15 									03AA9F80
Descriptor start addr for queue 16 									03AE0000

The next example shows how to display statistics about the time it takes (in milliseconds) for PSAR to process and send packets to the fabric interface. The statistics in the Timeouts column show how many times PSAR timed out while sending a packet to the fabric. A timeout to a line card may indicate a problem in communication between the PRP and the line card.

Router# show controllers psar output
To Fabric servicing time statistics:
----------------------------------
Slot    Minimum    Maximum   Average   Timeouts
0 			0 		4 			0  			0
1 			0 		4 			0  			0
2 			0 		4 			0  			2
3 			0 		0 			0  			0
4 			0 		4 			0  			0
5 			0 		4 			0  			0
6 			0 		4 			0  			0
7 			0 		4 			0  			0
8 			0 		4 			0  			0
9 			0 		4 			0  			0
10 			0 		4 			0  			0
11 			0 		4 			0  			0
12 			0 		4 			0  			0
13 			0 		4 			0  			0
14 			0 		4 			0  			0
15 			0 		4 			0  			0
16 			0 		4 			0  			0

Glossary

CGM—Cisco GSR Manager. An element management system for managing Cisco 12000 Series Routers.

BGP—Border Gateway Protocol. An interdomain routing protocol designed for the global Internet. Exterior border gateway protocols (EBGPs) communicate among different autonomous systems. Interior border gateway protocols (IBGPs) communicate among routers within a single autonomous system.

EBGP—Exterior Border Gateway Protocol. EBGPs communicate among different network domains.

GRP—Gigabit Route Processor.

GSR—Gigabit Switch Router. Also known as Cisco 12000 Series Router.

IGP—Interior Gateway Protocol. Internet protocol used to exchange routing information within an autonomous system. Examples of common Internet IGPs include IGRP, OSPF, and RIP.

MIB—Management Information Base. Database of network management information that is used and maintained by a network management protocol such as SNMP. The value of a MIB object can be changed or retrieved using SNMP commands, usually through a network management system (NMS). MIB objects are organized in a tree structure that includes public (standard) and private (proprietary) branches.

NSF—Non-Stop Forwarding. The ability of a router to continue to forward traffic toward a router which may be recovering from a transient failure. Also, the ability of a router recovering from a transient failure in the control plane to continue correctly forwarding traffic sent to it by a peer.

OSPF—Open Shortest Path First. Link-state, hierarchical IGP routing algorithm proposed as a successor to RIP in the Internet community. OSPF features include least-cost routing, multipath routing, and load balancing.

PRP—Performance Route Processor.

RIP—Routing Internet Protocol. IGP supplied with UNIX BSD systems. The most common IGP in the Internet. RIP uses hop count as a routing metric.

RPR+—Route Processor Redundancy Plus: an enhancement to RPR / EHSA in which the standby RP is fully initialized. An RPR+ switchover does not involve line card reset nor line card software reload.

SNMP—Simple Network Management Protocol. Network management protocol used almost exclusively in TCP/IP networks. SNMP provides a means to monitor and control network devices, and to manage configurations, statistics collection, performance, and security.

SSO—Stateful switchover. SSO provides protection for network edge devices with redundant processors (RPs) that represent a single point of failure in the network design, and where an outage might result in loss of service for customers.