PBR
PBR Sup
Suppo
port fo
rt for M
r M ultiple
ultiple Track
Tracking O
ing Option
ptionss
Th
Thee PBRPBR SupSupporportt forfor MulMultitipleple TrTrackackiningg OptOptioionsns fefeatatureure exextetendsnds ththee cacapabpabililititieiess ofof obobjejectct trtracackinkingg ususiningg Cisco Discovery Protocol (CDP) to allow the policy-based routing (PBR) process to verify object 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 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.
Protocol (ICMP) ping, User Datagram Protocol (UDP) ping, or an HTTP GET request. Feature History for PBR
Feature History for PBR Support foSupport for Mr M ultiple ultiple TrackiTracki ng Opng Optionstions
Finding Sup
Finding Support Information for Platforms and Cisco IOS Softwaport Information for Platforms and Cisco IOS Softwa re Ire I magesmages Us
Usee CisCiscoco FeFeatatureure NaNavivigatgatoror toto ffinindd ininforformamatitionon aboaboutut plplatatforformm susuppopportrt anandd CisCiscoco IOSIOS sosoftftwawarere imimagagee support. Access Cisco Feature Navigator at
support. Access Cisco Feature Navigator at http://www.cisco.com/go/fnhttp://www.cisco.com/go/fn. You must have an account on. You must have an account on Ci
Ciscsco.o.cocom.m. IfIf yoyouu dodo nonott hahaveve anan acaccocoununtt oror hahaveve foforgrgotottetenn yoyourur ususerernanameme oror papasssswowordrd,, clclicick k CancelCancel atat the login dialog box and follow the instructions that appear.
the login dialog box and follow the instructions that appear.
Contents
Contents
•• InformaInformation About PBR Support for Multiple Traction About PBR Support for Multiple Tracking Options, pageking Options, page22
•• How to ConfHow to Configure PBR Support for Multiple Tigure PBR Support for Multiple Tracking Options, pageracking Options, page22
•• Configuration Examples Configuration Examples for PBR Support for for PBR Support for Multiple Tracking Multiple Tracking Options, pageOptions, page 55
•• AdditionAdditional Referal References, pagences, pagee 66
•• Command Command ReferenReference, pagce, pagee77
R
Reelleeaassee MM ooddiiffiiccaattiioonn
1
122..33((44))TT TThhiis s ffeeaattuurre e wwaas s iinnttrroodduucceedd.. 1
122..22((2255))SS TThhiis s ffeeaattuurre e wwaas s iinntteeggrraatteed d iinntto o CCiisscco o IIOOS S RReelleeaasse e 1122..22((2255))SS.. 1
122..44 TThhe e SSAAA A ((rrttrr) ) ffeeaattuurre e wwaas s rreeppllaacceed d bby y tthhe e IIP P SSLLAAs s ffeeaattuurree. . SSeeee http://www.cisco.com/go/ipsla/ for updated documentation. http://www.cisco.com/go/ipsla/ for updated documentation.
Information About PBR
Information About PBR Support for Support for MM ultiple ultiple TrackiTracki ng Optionsng Options
Information Abou
Information About PBR
t PBR Supp
Support f
ort for M
or M ulti
ultiple
ple Trac
Tracki
king
ng O
Options
ptions
To configure the PBR Support for Multiple Tracking Options feature, you should understand the To configure the PBR Support for Multiple Tracking Options feature, you should understand the following concepts:following concepts:
•• Object Object TrackTracking, paging, pagee 22
•• PBR Support for MultipPBR Support for Multiple Trackile Tracking Options Featurng Options Feature Design, pagee Design, page22
O
Objec
bject T
t Track
racking
ing
Object tracking is an independent process that monitors objects such as the following: Object tracking is an independent process that monitors objects such as the following:
•• State of the line protocol of an interfaceState of the line protocol of an interface
•• Existence of an entry in the routing tableExistence of an entry in the routing table
•• Results of an IP SLA monitoring operation, such as a pingResults of an IP SLA monitoring operation, such as a ping
Clients such as Hot Standby Router Protocol (HSRP), Virtual Router Redundancy Protocol (VRRP), 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 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.
specific, tracked objects and then take action when the state of the objects changes.
PBR
PBR Suppo
Support fo
rt for M
r M ulti
ultiple Tra
ple Track
cking Op
ing Options F
tions Fea
eature Design
ture Design
The PBR Support for Multiple Tracking Options feature gives PBR access to all the objects that are 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 available through the tracking process. The tracking process provides the ability to track individual ob
objejectscts susuchch asas ICICMPMP pinpingg reareachchabiabililityty,, rouroutitingng adadjacjacenencycy,, anan apappliplicacatitionon rurunninningng onon aa reremotmotee dedevivicece,, aa route in the Routing Information Base (RIB), or to track the state of an interface line protocol.
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 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 object should be tracked. The tracking process will in turn notify PBR when the state of that object changes.
changes.
How
How to C
to Con
onfigur
figure
e PBR
PBR Sup
Suppo
port fo
rt for M
r M ultiple
ultiple Track
Tracking O
ing Opt
ptions
ions
This section contains the following procedure:This section contains the following procedure:
•• Configuring PBR Configuring PBR Support for Multiple Support for Multiple Tracking Options, pageTracking Options, page22 (required)(required)
C
Configuring PBR
onfiguring PBR Supp
Support fo
ort for M
r M ulti
ultiple
ple Track
Tracking Op
ing Options
tions
This task configures PBR support for multiple tracking options. This task configures PBR support for multiple tracking options.SUM
How
How to Confto Configure PBR Suppoigure PBR Support for Mrt for M ultiple ultiple Tracking OptionsTracking Options
5. 5. exitexit
6.
6. rtr schedulertr schedule operation-number operation-number [[lifelife {{foreverforever || secondsseconds}] [}] [start-timestart-time {{hhhh::mmmm[[::ssss] [] [month daymonth day|| day
day monmonthth] |] | pendingpending || nownow || afterafter hhhh::mmmm::ssss}] [}] [ageoutageout secondsseconds]]
7.
7. tracktrack object-number object-number rtrrtr entry-number entry-number [[reachabilityreachability]]
8. 8. exitexit
9.
9. interfaceinterface type number type number
10.
10. ip addressip address ip-address mask ip-address mask [[secondarysecondary]]
11.
11. ip policy route-map map-tagip policy route-mapmap-tag
12. 12. exitexit
13.
13. route-maproute-map map-tagmap-tag [[permitpermit || denydeny] [] [sequence-number sequence-number ]]
14.
14. set ip next-hop verify-availabilityset ip next-hop verify-availability [[next-hop-address sequencenext-hop-address sequence tracktrack object object ]]
DETAILED STEPS
DETAILED STEPS
C
Coommmmaannd d oor r AAccttiioonn PPuurrppoossee
St
Stepep 11 enableenable
Example: Example:
Rou
Routerter>> enaenableble
Enables privileged EXEC mode. Enables privileged EXEC mode.
•• Enter your password if prompted.Enter your password if prompted.
St
Stepep 22 configure terminalconfigure terminal
Example: Example:
Rout
Router#er# confconfigurigure terme terminalinal
Enters global configuration mode. Enters global configuration mode.
St
Stepep 33 rtrrtr operation-number operation-number
Example: Example:
Rout
Router(cer(confionfig)#g)# rtr rtr 11 OR
OR
Router(config)# ip sla monitor 1 Router(config)# ip sla monitor 1
Enters SAA RTR configuration mode and configures an Enters SAA RTR configuration mode and configures an SAA operation.
SAA operation.
Note
Note This command is replaced by the ‘ip sla monitorThis command is replaced by the ‘ip sla monitor operation-number
operation-number’ command in Release’ command in Release 12.3(14)T and
12.3(14)T and laterlater..
St
Stepep 44 type echo protocoltype echo protocol protocol-type targetprotocol-type target
[
[source-ipaddrsource-ipaddr ip-addressip-address]]
Example: Example:
Router
Router (config-r(config-rtr)#tr)# type type echo echo protocolprotocol ipicmpecho 10.1.1.10
ipicmpecho 10.1.1.10
Configures an SAA end-to-end echo response time probe Configures an SAA end-to-end echo response time probe operation.
operation.
St
Stepep 55 exitexit
Example: Example:
Rout
Router(cer(confionfig-rtg-rtr)#r)# exitexit
Exits SAA RTR configuration mode and returns the router Exits SAA RTR configuration mode and returns the router to global configuration mode.
How
How to Coto Configure PBR Suppnfigure PBR Support for Multiort for Multi ple Trackple Track ing Optionsing Options
St
Stepep 66 rtr schedulertr schedule operation-number operation-number [[lifelife {{foreverforever ||
seconds
seconds}] [}] [start-timestart-time {{hhhh::mmmm[[::ssss] [] [month day month day ||
day month
day month] |] | pendingpending || nownow || afterafter hhhh::mmmm::ssss}]}] [
[ageoutageout secondsseconds]]
Example: Example:
Router(co
Router(config)#nfig)# rtr scrtr schedule hedule 1 life 1 life foreverforever start-time now
start-time now
Configures the time parameters for the SAA operation. Configures the time parameters for the SAA operation.
Note
Note This command is replaced by theThis command is replaced by the ip sla monitorip sla monitor schedule
schedule command in Release 12.3(14)T and later.command in Release 12.3(14)T and later.
St
Stepep 77 tracktrack object-number object-number rtrrtr entry-number entry-number
[
[reachabilityreachability]]
Example: Example:
Router(co
Router(config)#nfig)# track track 123 rtr 123 rtr 1 reach1 reachabilityability
Tracks the reachability of an Response Time Reporter Tracks the reachability of an Response Time Reporter (RTR) object and enters tracking configuration mode. (RTR) object and enters tracking configuration mode.
St
Stepep 88 exitexit
Example: Example:
Rout
Router(cer(confionfig-trg-track)ack)## exitexit
Ex
Exititss trtracackikingng conconffigigurauratitionon momodede,, anandd reretuturnsrns ththee rorouteuterr toto global configuration mode.
global configuration mode.
St
Stepep 99 interfaceinterface type number type number
Example: Example:
Router(co
Router(config)#nfig)# interface interface ethernet ethernet 00
Sp
Specieciffieiess anan intintererfafacece tytypepe andand numnumberber,, anandd enentetersrs intintererfafacece configuration mode.
configuration mode.
St
Stepep 1010 ip addressip address ip-address maskip-address mask [[secondary secondary ]]
Example: Example:
Router(co
Router(config-if)#nfig-if)# ip ip address address 10.1.1.1110.1.1.11 255.0.0.0
255.0.0.0
Sp
Specieciffieiess aa prprimimararyy oror secseconondardaryy IPIP adaddredressss foforr anan ininteterfrfaceace..
•• RefeReferr toto thethe “Con“Conffiguriguringing IPIP AddrAddressiessing”ng” chapchapterter ofof thethe Release 12.3
Release 12.3 Cisco IOS IP Configuration GuideCisco IOS IP Configuration Guide forfor information on configuring IP addresses.
information on configuring IP addresses.
St
Stepep 1111 ip policy route-mapip policy route-map map-tag map-tag
Example: Example:
Router(co
Router(config-if)#nfig-if)# ip poip policy licy route-map route-map alphaalpha
En
Enablableses polpolicicyy roroututinging anandd ideidentntififieiess aa rorouteute mamapp toto bebe ususeded for policy routing.
for policy routing.
St
Stepep 1212 exitexit
Example: Example:
Rout
Router(cer(confionfig-ifg-if)#)# exitexit
Exi
Exitsts inteinterfarfacece conconffiguriguratiationon modmodee andand retreturnsurns thethe rourouterter toto global configuration mode.
global configuration mode.
St
Stepep 1313 route-maproute-map map-tag map-tag [[ permit permit || denydeny]] [
[sequence-number sequence-number ]]
Example: Example:
Rout
Router(cer(confionfig)#g)# routroute-mae-map p alphalphaa
Specifies a route map and enters route-map configuration Specifies a route map and enters route-map configuration mode.
mode.
St
Stepep 1414 set ip next-hop verify-availabilityset ip next-hop verify-availability [
[next-hop-address sequencenext-hop-address sequence tracktrack objectobject]]
Configures the route map to verify the reachability of the Configures the route map to verify the reachability of the tracked object.
tracked object.
C
Configuration Examples for PBR
Configuration Examples for PBR Support for Support for MM ultiplultipl e Trackie Tracki ng Optionsng Options
C
Configuration E
onfiguration Exa
xample
mples
s for
for PBR
PBR Supp
Support
ort for
for M
M ulti
ultiple
ple Trac
Tracki
king
ng
Options
Options
This section provides the following configuration example: This section provides the following configuration example:
•• PBR Support for MultipPBR Support for Multiple Trackile Tracking Options: Exampng Options: Example, pagele, page55
PBR
PBR Supp
Support fo
ort for M
r M ulti
ultiple
ple Track
Tracking Opt
ing Options:
ions: E
Exa
xample
mple
In the following example, object tracking is configured for PBR. In the following example, object tracking is configured for PBR. ThThee popolilicycy isis ththatat papackcketetss rerececeiivevedd onon EtEthehernrnetet 0,0, shshououldld bebe foforwrwarardededd toto 1010.1.1.1.1.1.1 ononlyly ifif ththatat dedevivicece isis re
reacachahablblee (r(resespopondndiningg toto pipingngs)s).. IfIf 1010.1.1.1.1.1.1 isis nonott upup,, ththenen ththee papackcketetss shshououldld bebe foforwrwarardededd toto 1010.2.2.2.2.2.2.. If
If 1010.2.2.2.2.2.2 isis alalsoso nonott rereacachahablble,e, ththenen ththee popolilicycy roroututiningg fafaililss anandd ththee papackcketetss araree roroututeded acaccocordrdiningg toto ththee routing table.
routing table.
Two SAA Echo operations are configured to ping the remote devices. The SAA operations are then 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 tracked. Policy routing will monitor the state of the tracked operations and make forwarding decisions based on their state.
based on their state.
! define and start the SAA operations ! define and start the SAA operations rtr 1
rtr 1
type echo protocol ipicmpecho 10.1.1.1 type echo protocol ipicmpecho 10.1.1.1 rtr schedule 1 start-time now life forever rtr schedule 1 start-time now life forever !
! rtr 2 rtr 2
type echo protocol ipicmpecho 10.2.2.2 type echo protocol ipicmpecho 10.2.2.2 rtr schedule 2 start-time now life forever rtr schedule 2 start-time now life forever !
!
!track the SAA operations !track the SAA operations track 123 rtr 1 reachability track 123 rtr 1 reachability track 124 rtr 2 reachability track 124 rtr 2 reachability ! !
! enable policy routing on the incoming interface ! enable policy routing on the incoming interface interface ethernet 0
interface ethernet 0
ip address 10.4.4.4 255.255.255.0 ip address 10.4.4.4 255.255.255.0 ip policy route-map alpha
ip policy route-map alpha !
!
! 10.1.1.1 is via this interface ! 10.1.1.1 is via this interface interface ethernet 1 interface ethernet 1 ip address 10.1.1.254 255.255.255.0 ip address 10.1.1.254 255.255.255.0 ! !
! 10.2.2.2 is via this interface ! 10.2.2.2 is via this interface interface ethernet 2 interface ethernet 2 ip address 10.2.2.254 255.255.255.0 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 ! define a route-map to set the next-hop depending on the state of the tracked rtrs route-map alpha
route-map alpha
set ip next-hop verify-availability 10.1.1.1 10 track 123 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 set ip next-hop verify-availability 10.2.2.2 20 track 124
Additional References Additional References
Additional References
Additional References
The following sections provide references related to the PBR Support for Multiple Tracking Options The following sections provide references related to the PBR Support for Multiple Tracking Options feature. feature.
Related Documents
Related Documents
Standards
Standards
MIBs
MIBs
RReellaatteed d TTooppiicc DDooccuummeennt t TTiittllee
Object tracking within Cisco IOS software
Object tracking within Cisco IOS software Enhanced Object Tracking Enhanced Object Tracking feature feature documendocument, Ciscot, Cisco IOSIOS Rele
Releasease 12.212.2(15)(15)TT C
Coonnffiigguurriinng g IIP P aaddddrreesssseess ““CCoonnffiigguurriinng g IIP P AAddddrreessssiinngg” ” cchhaapptteer r iin n tthhee Cisco IOS IPCisco IOS IP Configuration Guide
Configuration Guide, Release 12.3, Release 12.3
S
Sttaannddaarrddss TTiittllee
No new or modified standards are supported by this No new or modified standards are supported by this fe
feataturure,e, andand supsupporportt foforr exexisistitingng ststandandarardsds hashas nonott beebeenn modified by this feature.
modified by this feature.
— —
M
M IIBBss MM IIBBssLLiinnkk
No new or modified MIBs are supported by this No new or modified MIBs are supported by this feature, and support for existing MIBs has not been feature, and support for existing MIBs has not been modified by this feature.
modified by this feature.
To
To locate and download MIBs for locate and download MIBs for selected platforms, Ciscoselected platforms, Cisco IOSIOS release
releases, and feature sets, use Ciscos, and feature sets, use Cisco MIB Locator found at theMIB Locator found at the following URL:
following URL:
http://www.cisco.com/go/mibs
Command Reference Command Reference
RFCs
RFCs
Technical
Technical Ass
Assistance
istance
C
Comm
ommand
and R
Refe
eferenc
rencee
The following modified command is pertinent to this feature. To see the command pages for this 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
command and other commands used with this feature, go to the Cisco IOS Master Commands List Cisco IOS Master Commands List ,, Release 12.4, at
Release 12.4, at http://www.cisco.com/univercd/cc/td/doc/product/software/ios124/124mindx/ http://www.cisco.com/univercd/cc/td/doc/product/software/ios124/124mindx/
124index.htm
124index.htm..
•• set ip next-hop verify-availabilityset ip next-hop verify-availability
© 2004 Cisco Systems, Inc. All r
© 2004 Cisco Systems, Inc. All r ights reserved.ights reserved.
R
RFFCCss TTiittllee
No new or modified RFCs are supported by this No new or modified RFCs are supported by this feature, and support for existing RFCs has not been feature, and support for existing RFCs has not been modified by this feature.
modified by this feature.
— —
D
Deessccrriippttiioonn LLiinnkk
Technical Assistance Center (TAC) home page, Technical Assistance Center (TAC) home page, containing 30,000 pages of searchable technical containing 30,000 pages of searchable technical content, including links to products, technologies, content, including links to products, technologies, solutions, technical tips, and tools. Registered solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access Cisco.com users can log in from this page to access even more content.
even more content.
http://www.cisco.com/public/support/tac/home.shtml
http://www.cisco.com/public/support/tac/home.shtml
CCSP
CCSP, CCVP, the Cisco Square , CCVP, the Cisco Square Bridge logo, Follow Bridge logo, Follow Me Browsing, and Me Browsing, and StackWise are trademarks StackWise are trademarks of Cisco Systems, of Cisco Systems, Inc.; Changing the Inc.; Changing the Way WWay We Work,e Work,
Live, Play, and Learn, and iQuick Study are
Live, Play, and Learn, and iQuick Study are service marks of service marks of Cisco Systems, Inc.; and Access Cisco Systems, Inc.; and Access Registrar, Aironet, BPX, Catalyst, CCDA, CCDPRegistrar, Aironet, BPX, Catalyst, CCDA, CCDP,,
CCIE, CCIP
CCIE, CCIP, CCNA, CCNP, CCNA, CCNP, Cisco, the Cisco , Cisco, the Cisco Certified Internetwork Expert logo, Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Cisco Systems, Cisco Systems Capital,Capital,
the Cisco Systems logo,
the Cisco Systems logo, Cisco Unity, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, FormShare, GCisco Unity, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, FormShare, GigaDrive, GigaStack, HomeLink,igaDrive, GigaStack, HomeLink,
Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, LightStream, Linksys, MeetingPlace, MGX, the Networkers logo,
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,
Networking Academy, Network Registrar,Packet Packet , PIX, Post-Routing, Pre-Routing, , PIX, Post-Routing, Pre-Routing, ProConnect, RateMUX, ScriptShare, SlideCast, SMARTnet,ProConnect, RateMUX, ScriptShare, SlideCast, SMARTnet,
The Fastest Way to Increase Y
The Fastest Way to Increase Your Internet Quotient, our Internet Quotient, and TransPath are registered trademarks of and TransPath are registered trademarks of Cisco Systems, Inc. and/or Cisco Systems, Inc. and/or its affiliates in its affiliates in thethe
United States and certain other countries.
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
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
Comm