PBR Support for Multiple Tracking Options

PBR Suppo Support rt for for M ultiple Tracking Track ing Option Optionss The The PBR Suppor Supportt for Multi Multiple ple Track Trackin ing g Optio Options ns feat feature ure exte extends nds the the capab capabil ilit itie iess of obje object ct trac trackin king g usin using g Cisco Discovery Protocol (CDP) to allow the policy-based routing (PBR) process to verify object availability by using additional methods. The verification method can be an Internet Control Message Protocol (ICMP) ping, User Datagram Protocol (UDP) ping, or an HTTP GET request.

Feature History for PBR Support for for M ultiple Tracki ng Options Options

Re l e a se

M odi fi c a ti on

1 2. 3(4 )T

T his featu re was introd uced .

1 2. 2(2 5)S

This featu re was integ rated into Cisco IOS Release 12.2(25 )S.

1 2. 4

T he SA A (rtr) feature wa s replac ed by th e IP S LA s featu re. See http://www.cisco.com/go/ipsla/ for updated documentation.

Finding Support Support Information for Platforms and Cisco IOS Softwa re I mages Use Use Cisco Cisco Feat Feature ure Navi Navigat gator or to find ind infor informa mati tion on about about plat platfor form m suppo support rt and and Cisco Cisco IOS soft softwa ware re imag imagee support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn http://www.cisco.com/go/fn.. You must have an account on Cisc Cisco. o.co com. m. If you you do not not have have an acco accoun untt or have have forg forgot otte ten n your your user userna name me or pass passwo word rd,, clic click  k Cancel Cancel at the login dialog box and follow the instructions that appear.

Contents •

Information Informa tion About PBR Support for Multiple Tracking Tracking Options, page 2

•

How to Configure Configure PBR Support for Multiple Tracking Tracking Options, page 2

•

Configuration Examples for PBR Support for Multiple Tracking Options, page 5

•

Additional Addition al References, References, page page 6

•

Command Referen Reference, ce, page page 7

Corporate Headquarters: Cisco Cisco Systems, Systems, Inc., Inc., 170 West Tasman Tasman Drive, San San Jose, Jose, CA 9513 4-1706 USA

Copyright © 2004 Cisco Cisco Systems, Systems, Inc. All right s reserved. reserved.

PBR Support Support for M ultiple Tracking Options Information About PBR Support for M ultiple Tracki ng Options

Information About About PBR Support Support for for M ultiple ulti ple Tracki Trac king ng Options To configure the PBR Support for Multiple Tracking Options feature, you should understand the following concepts: •

Object Track Tracking, ing, page page 2

•

PBR Support for Multiple Multiple Tracking Tracking Options Feature Feature Design, page 2

Object bjec t Track Tracking ing Object tracking is an independent process that monitors objects such as the following: •

State of the line protocol of an interface

•

Existence of an entry in the routing table

•

Results of an IP SLA monitoring operation, such as a ping

Clients such as Hot Standby Router Protocol (HSRP), Virtual Router Redundancy Protocol (VRRP), Gateway Load Balancing Protocol (GLBP), and (with this feature) PBR can register their interest in specific, tracked objects and then take action when the state of the objects changes.

PBR Support Support for for M ultiple ulti ple Track Tra cking ing Options Options Fea Feature ture Design The PBR Support for Multiple Tracking Options feature gives PBR access to all the objects that are available through the tracking process. The tracking process provides the ability to track individual obje objects cts such such as ICMP ICMP ping ping reach reachabi abili lity ty,, routi routing ng adjac adjacen ency cy,, an appli applica cati tion on runni running ng on a remot remotee devi device ce,, a route in the Routing Information Base (RIB), or to track the state of an interface line protocol. Object tracking functions in the following manner. PBR will inform the tracking process that a certain object should be tracked. The tracking process will in turn notify PBR when the state of that object changes.

How to Con Configur figuree PBR Suppo Support rt for for M ultiple Tracking Track ing Opt Options ions This section contains the following procedure: •

Configuring PBR Support for Multiple Tracking Options, page 2 (required)

Configuring PBR Support Support for for M ultiple ulti ple Tracking Track ing Options Options This task configures PBR support for multiple tracking options.

SUM M ARY STEPS STEPS

Book Title 2

1.

enable

2.

configure terminal

3.

rtr operation-number 

4.

 protocol-type type target  target  [source-ipaddr ip-address ] type echo protocol  protocol-

PBR Support Support for M ultiple Tracki ng Options How to Configure Configure PBR Support Support for M ultiple Tracking Options

5.

exit

6.

[ start-time {hh :mm [:ss ] [ month day | rtr schedule operation-number  [life {forever | seconds }] [start-time day month month] | pending | now | after hh :mm :ss }] [ageout [ ageout seconds ]

7.

track object-number  rtr entry-number  [reachability] reachability]

8.

exit

9.

interface type number 

secondary ] 10. ip address ip-address mask  [secondary] 11. ip policy route-map map-tag 12. exit

deny] [ sequence-number ] 13. route-map map-tag [permit | deny] 14. set ip next-hop verify-availability [next-hop-address sequence track object ]

DETAILED STEPS

Step Step 1

Comma nd or A c ti on

Purpose

enable

Enables privileged EXEC mode. •

Enter your password if prompted.

Example: Router Router> > enable enable

Step Step 2

configure terminal

Enters global configuration mode.

Example: Router# Router# configur configure e terminal terminal

Step Step 3

rtr operation-number 

Enters SAA RTR configuration mode and configures an SAA operation.

Example:

Note

Router(c Router(confi onfig)# g)# rtr 1 OR Router(config)# ip sla monitor 1

Step Step 4

type echo protocol protocol-type target [source-ipaddr ip-address ]

This command is replaced by the ‘ip sla monitor  operation-number’  operation-number ’ command in Release 12.3(14)T and later. later.

Configures an SAA end-to-end echo response time probe operation.

Example: Router (config-rtr)# (config-rtr)# type echo protocol ipicmpecho 10.1.1.10

Step Step 5

exit

Exits SAA RTR configuration mode and returns the router to global configuration mode.

Example: Router(c Router(confi onfig-rt g-rtr)# r)# exit

Book Title 3

PBR Support Support for M ultiple Tracking Options How to Configure Configure PBR Support Support for Multi ple Track ing Options

Step Step 6

Comma nd or A c ti on

Purpose

rtr schedule operation-number  [life {forever | seconds }] [start-time [start-time {hh:mm[:ss] [month day  | day month ] | pending | now | after hh:mm:ss}] [ageout seconds ]

Configures the time parameters for the SAA operation. Note

This command is replaced by the ip sla monitor schedule command in Release 12.3(14)T and later.

Example: Router(config)# Router(config)# rtr schedule schedule 1 life forever start-time now

Step Step 7

track object-number  rtr entry-number  reachability ] [reachability]

Tracks the reachability of an Response Time Reporter (RTR) object and enters tracking configuration mode.

Example: Router(config)# Router(config)# track 123 rtr 1 reachability reachability

Step Step 8

Exit Exitss trac tracki king ng conf configura igurati tion on mode mode,, and and retu returns rns the the route routerr to global configuration mode.

exit

Example: Router(c Router(confi onfig-tr g-track) ack)# # exit

Step Step 9

interface type number 

Speci Speciffies ies an inter interfa face ce type type and number number,, and and ente enters rs inter interfa face ce configuration mode.

Example: Router(config)# Router(config)# interface ethernet 0

Step Step 10

ip address ip-address mask [secondary ]

Speci Speciffies ies a prim primar ary y or secon secondar dary y IP addre address ss for for an inte interf rface ace.. •

Example: Router(config-if)# Router(config-if)# ip address 10.1.1.11 255.0.0.0

Step Step 11

ip policy route-map map-tag 

Refer Refer to the “Conf “Configuring iguring IP Addressi Addressing” ng” chapter chapter of the Release 12.3 Cisco IOS IP Configuration Guide for information on configuring IP addresses.

Enabl Enables es polic policy y rout routing ing and and ident identif ifie iess a route route map map to be used used for policy routing.

Example: Router(config-if)# Router(config-if)# ip policy policy route-map alpha

Step Step 12

Exits Exits interfa interface ce conf configurati iguration on mode mode and returns returns the router router to global configuration mode.

exit

Example: Router(c Router(confi onfig-if g-if)# )# exit

Step Step 13

route-map map-tag   permit   deny] [permit | deny] [sequence-number ]

Specifies a route map and enters route-map configuration mode.

Example: Router(c Router(confi onfig)# g)# route-ma route-map p alpha alpha

Step Step 14

set ip next-hop verify-availability [next-hop-address sequence track object ]

Example: Router(config-route Router(config-route-map)# -map)# set ip next-hop verify-availability 10.1.1.1 10 track 123

Book Title 4

Configures the route map to verify the reachability of the tracked object.

PBR Support Support for M ultiple Tracki ng Options Configuration Examples for PBR Support for M ultipl e Tracki ng Options

Configuration Exa Example mpless for PBR Support Support for M ultiple ulti ple Tracki Trac king ng Options This section provides the following configuration example: •

PBR Support for Multiple Multiple Tracking Tracking Options: Example, Example, page 5

PBR Support Support for for M ultiple ulti ple Tracking Track ing Options: Options: Example xa mple In the following example, object tracking is configured for PBR. The The poli policy cy is that that pack packet etss rece receiived ved on Ethe Ethern rnet et 0, shou should ld be forw forwar arde ded d to 10.1 10.1.1 .1.1 .1 only only if that that devi device ce is reac reacha habl blee (res (respo pond ndin ing g to ping pings) s).. If 10.1 10.1.1 .1.1 .1 is not not up, up, then then the the pack packet etss shou should ld be forw forwar arde ded d to 10.2 10.2.2 .2.2 .2.. If 10.2 10.2.2 .2.2 .2 is also also not not reac reacha habl ble, e, then then the the poli policy cy rout routin ing g fail failss and and the the pack packet etss are are rout routed ed acco accord rdin ing g to the the routing table. Two SAA Echo operations are configured to ping the remote devices. The SAA operations are then tracked. Policy routing will monitor the state of the tracked operations and make forwarding decisions based on their state. ! define and start the SAA operations rtr 1 type echo protocol ipicmpecho 10.1.1.1 rtr schedule 1 start-time now life forever ! rtr 2 type echo protocol ipicmpecho 10.2.2.2 rtr schedule 2 start-time now life forever ! !track the SAA operations track 123 rtr 1 reachability track 124 rtr 2 reachability ! ! enable policy routing on the incoming interface interface ethernet 0 ip address 10.4.4.4 255.255.255.0 ip policy route-map alpha ! ! 10.1.1.1 is via this interface interface ethernet 1 ip address 10.1.1.254 255.255.255.0 ! ! 10.2.2.2 is via this interface interface ethernet 2 ip address 10.2.2.254 255.255.255.0 ! ! define a route-map to set the next-hop depending on the state of the tracked rtrs route-map alpha set ip next-hop verify-availability 10.1.1.1 10 track 123 set ip next-hop verify-availability 10.2.2.2 20 track 124

Book Title 5

PBR Support Support for M ultiple Tracking Options Additional References

Additional References The following sections provide references related to the PBR Support for Multiple Tracking Options feature.

Related Documents Re l a te d Topi c

D oc ume nt Ti tl e

Object tracking within Cisco IOS software

document, Cisco IOS  Enhanced Object Tracking feature document, Release Release 12.2(15) 12.2(15)T T

Con figuring IP addresses

“Con figuring IP A ddressing” chapter in the Cisco IOS IP Configuration Guide , Release 12.3

Standards Sta nda rds

Ti tl e

 — No new or modified standards are supported by this feat featur ure, e, and suppor supportt for for exis existi ting ng stand standar ards ds has not not been been modified by this feature.

MIBs M I Bs

M I B s Li nk

No new or modified MIBs are supported by this feature, and support for existing MIBs has not been modified by this feature.

To locate and download MIBs for selected platforms, Cisco IOS releases, releases, and feature sets, use Cisco MIB Locator found at the following URL: http://www.cisco.com/go/mibs

Book Title 6

PBR Support Support for M ultiple Tracki ng Options Command Reference

RFCs RFCs

Ti tl e

No new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.

 —

Technical Assistance Assistance De sc ri pti on

Li nk

Technical Assistance Center (TAC) home page, containing 30,000 pages of searchable technical content, including links to products, technologies, solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access even more content.

http://www.cisco.com/public/support/tac/home.shtml

Command ommand Referenc efe rencee The following modified command is pertinent to this feature. To see the command pages for this command and other commands used with this feature, go to the Cisco IOS Master Commands List , Release 12.4, at http://www.cisco.com/univercd/cc/td/doc/product/software/ios124/124mindx/  124index.htm.. 124index.htm •

set ip next-hop verify-availability

CCSP, CCVP, the Cisco Square Bridge logo, Follow Me Browsing, and StackWise are trademarks of Cisco Systems, Inc.; Changing the Way We CCSP, We Work, Live, Play, and Learn, and iQuick Study are service marks of Cisco Systems, Inc.; and Access Registrar, Aironet, BPX, Catalyst, CCDA, CCDP, CCDP, CCIE, CCIP, CCIP, CCNA, CCNP, CCNP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, FormShare, G igaDrive, GigaStack, HomeLink, Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, LightStream, Linksys, MeetingPlace, MGX, the Networkers logo, Networking Academy, Network Registrar, Packet , PIX, Post-Routing, Pre-Routing, ProConnect, RateMUX, ScriptShare, SlideCast, SMARTnet, The Fastest Way to Increase Your Your Internet Quotient, and TransPath 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 company.. (0601R)

© 2004 Cisco Systems, Inc. All r ights reserved.

Book Title 7

PBR Support Support for M ultiple Tracking Options Command Command Referenc e

Book Title 8