PfR Simplification Phase 1

PfR Simplification Phase 1

Last Updated: March 27, 2012

Performance Routing (PfR) is an advanced Cisco technology to allow businesses to complement traditional IP routing technologies such as Enhanced Interior Gateway Routing Protocol (EIGRP), Open Shortest Path First (OSPF), Routing Information Protocol Version 2 (RIPv2), and Border Gateway Protocol (BGP) with additional serviceability parameters to select the best egress or ingress path. It complements these traditional IP routing technologies with additional intelligence. PfR can select an egress or ingress WAN interface based upon parameters like reachability, delay, cost, jitter, Mean Opinion Score (MOS) score, or it can use interface parameters like load, throughput, and monetary cost. Traditional IP routing technologies generally focus on creating a loop-free topology based upon the shortest or least cost path.

Although PfR automatically enables IP SLA or NetFlow technologies, the initial configuration of PfR is more complicated than for traditional IP routing technologies due to PfR policy definition and the setting of many performance parameters. Cisco used feedback from customers to reduce the complexity of PfR configuration and align default values to match customer requirements. Phase 1 of the PfR simplification project introduces dynamic tunnels between PfR border routers, revised default values, removal of some CLI, and changes to default behavior. The changes result in fewer configuration steps before PfR is implemented in your network.

Finding Feature Information

Your software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the Feature Information Table at the end of this document.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.

Information About PfR Simplification Phase 1

CLI and Default Value Changes to Simplify PfR

With CSCtr26978 a series of CLI and default value changes designed to make configuration of PfR simpler were introduced. Some commands and keywords were removed, and defaults changed to reflect customer environments.

Enforce Route Control by Default

In response to customer feedback, with CSCtr26978 the mode route control command is now the default behavior instead of the mode route observe command. In control mode, the master controller coordinates information from the border routers and makes policy decisions. The master controller monitors prefixes and exits based on default and user-defined policies, and implements changes to optimize prefixes and to select the best exit.

If you want to passively monitor and report without making any changes, you can still configure PfR to use the observe mode. In observe mode, the master controller monitors prefixes and exit links based on default and user-defined policies and then reports the status of the network and the decisions that should be made, but it does not implement any changes.

Default Change for Mode Verify Bidirectional CLI

In response to customer feedback, with CSCtr26978 the default behavior changed to disable the verification of bidirectional traffic. If you need to verify bidirectional traffic, configure the mode verify bidirectional command in master controller configuration mode.

CLI Default Value Changes to Simplify PfR

Command Default Before CSCtr26978 Default After CSCtr26978

backoff

300, 3000, 300 seconds

90, 900, 90 seconds

holddown

300 seconds

90 seconds

max-xmit-utilization

75 percent

90 percent

monitor-period

5 minutes

1 minute

periodic-interval

120 minutes

0 minutes

Removal of PfR API and Proxy CLI

All CLI commands and functionality involved with the PfR application programming interface (API) and proxy process were removed to simplify PfR. With CSCtr26978, the following CLI commands were removed:

  • api provider (PfR)

  • debug pfr api

  • host-address (PfR)

  • show api provider (PfR)

  • show pfr proxy

Removal of OER CLI

Although the Optimized Edge Routing (OER) syntax was replaced in most images with the PfR syntax, the OER syntax is still recognized. When you enter OER syntax the software changes the syntax to the new PfR syntax in the running configuration. With CSCtr26978, the OER syntax was removed.

Removal of Mode Select-Exit CLI

For most customer deployments we do not recommend using the passive monitoring mode with the exit selection of select-exit best because the statistics may change by the time all the links have been examined and the decision may not be accurate. To simplify the PfR configuration, with CSCtr26978 the default behavior is now select-exit good where the first in-policy link is selected. The mode select-exit command and best and good keywords have been removed.

Automatic Enable of Throughput Learning

To simplify PfR configuration, CSCtr2697 enabled PfR learn mode using throughput-based learning by default.

After feedback from customers, the default periodic interval of 120 minutes was changed to 90 minutes and the default monitor period was changed from 5 minutes to 1 minute.

The automatic enabling of PfR learn mode can be switched off using the no learn command if manual configuration is preferred.

Automatic PBR Route Control When No Parent Route Exists

When a PfR master controller (MC) decides to control a prefix using a protocol BGP, for example, it sends the control request to a selected PfR border router (BR). If the MC receives the successful control notification from the BR, it will notify all the other BRs to exclude the prefix. Some BRs may not have a parent route to this prefix via the same protocol. When no parent route exists for the prefix, this is detected as a RIB mismatch, the prefix is moved into a default state, and the control procedure begins again.

To simplify PfR, CSCtr26978 introduced new behavior when no parent route is detected. In this situation, PfR automatically switches to using dynamic policy-based routing (PBR) instead of trying all the other routing protocols in the following order; BGP, EIGRP, static, and PBR. With CSCtr26978, the existing mode route protocol pbr command behavior was enabled by default. Configuration of the no mode route protocol pbr command initially sets the traffic classes to be uncontrolled and PfR then uses a single protocol to control the traffic class in the following order: BGP, EIGRP, static, and PBR.

Dynamic PBR Support for PfR

The PfR BR Automatic Adjacencies feature introduces dynamic PBR support. In dynamic route maps, the PBR requirement for both interface and next-hop information is now supplied by PfR in a single set clause. To display the route map or policy information use the show route-map dynamic command or the show ip policy command.

How to Configure PfR Simplification Phase 1

Displaying PfR Border Routers Dynamic Tunnel Information

Enter the commands in this task to verify whether the automatic tunnel mode is on and, if so, display information about the tunnels. The show commands can be entered in any order but steps 1 through 5 are performed on a master controller, and the last three steps are performed on a border router.

SUMMARY STEPS

1.    enable

2.    show pfr master

3.    show pfr master border topology

4.    show pfr master statistics

5.    debug pfr master tunnel

6.   Move to a border router.

7.    show pfr border

8.    show route-map dynamic detail

9.    debug pfr border tunnel


DETAILED STEPS
Step 1   enable

Enables privileged EXEC mode. Enter your password if prompted.



Example:
Router> enable
Step 2   show pfr master

This command is entered on a master controller and displays information about the connection to any border routers, prefix information, PBR status, and whether the automatic tunnel mode is on.



Example:
Router# show pfr master

OER state: ENABLED and ACTIVE
  Conn Status: SUCCESS, PORT: 3949
  Version: 3.1
  Number of Border routers: 3
  Number of Exits: 3
  Number of monitored prefixes: 3 (max 2500)
  Max prefixes: total 2500 learn 2500
  Prefix count: total 3, learn 0, cfg 3
  PBR Requirements met
  Nbar Status: Inactive
  Auto Tunnel Mode: On
Step 3   show pfr master border topology

This command is entered on a master controller and displays information about border routers. When dynamic tunnels are created between border routers, a new type of neighbor, "Tunnel Connected" is indicated.



Example:
Router# show pfr master border topology

LocalBR        LocalEth       RemoteBR       RemoteEth     nbar_type
---------------------------------------------------------------------------
10.1.1.3       Tunnel0        10.1.1.2       Tunnel0       Tunnel Connected    
10.1.1.3       Tunnel0        10.11.1.4      Tunnel0       Tunnel Connected    
10.1.1.2       Tunnel0        10.1.1.3       Tunnel0       Tunnel Connected    
10.1.1.2       Tunnel0        10.11.1.4      Tunnel0       Tunnel Connected    
10.11.1.4      Tunnel0        10.1.1.3       Tunnel0       Tunnel Connected    
10.11.1.4      Tunnel0        10.1.1.2       Tunnel0       Tunnel Connected    
PBR Requirements met
Step 4   show pfr master statistics

This command is entered on a master controller and displays information about the number of tunnel commands and PBR mode messages. .



Example:
Router# show pfr master statistics

**** MC/BR communication statistics ****

   Border: 10.11.1.3

   Messages sent:

    Route Start                         = 6
    Passive monitor status              = 2
    BR keep-alive                       = 6
    Version control                     = 1
    Rsvp data                           = 2
    One application signature           = 124
    TLV-based probe                     = 3
    Interface command                   = 3
    Monitor traffic-class               = 1
    Tunnel commands                     = 2
    Pbr mode command                    = 1
    Total messages sent                 = 151

   Messages received:

    Return status received              = 137
    MD5 authentication                  = 152
    Keep-alive received                 = 4
    Create active probe result          = 2
    TLV interface command               = 4
    TLV probe statistics result         = 1
    Version control                     = 1
    Tunnel commands                     = 3
    Total messages received             = 304
Step 5   debug pfr master tunnel

This command displays debugging messages that can help you to troubleshoot issues. The example below shows the PfR messages displayed after a master controller receives a message from a border router to create a tunnel to another border router.



Example:
Router# debug pfr master tunnel

PfR Master Tunnel debugging is on

*Jun 16 21:40:33.335: PFR MC TUNNEL: Received tunnel create from BR (10.11.1.4) tunnel_id=0
Step 6   Move to a border router.
Step 7   show pfr border

This command is entered on a border router and displays information about the connection to the master controller, NetFlow status, PfR version numbers, and exits. Note the tunnel exit.



Example:
Router# show pfr border

OER BR 10.101.1.2 ACTIVE, MC 10.101.1.1 UP/DOWN: UP 00:02:06,
  Auth Failures: 0
  Conn Status: SUCCESS
  OER Netflow Status: ENABLED, PORT: 3949
  Version: 3.3  MC Version: 3.3
  Exits
  Et0/0           INTERNAL             
  Et1/0           EXTERNAL             
  Tu1             INTERNAL AUTO-TUNNEL
Step 8   show route-map dynamic detail

After verifying that a tunnel has been created, enter this command on a border router to display information about the dynamic route map that was installed to create the tunnel to another border router.



Example:
Router# show route-map dynamic detail

route-map PFR_INTERNAL_RMAP, permit, sequence 0, identifier 2835349507
  Match clauses:
    ip address (access-lists): pfr#3 
      Extended IP access list pfr#3
          268435455 permit ip any 10.100.2.0 0.0.0.255 (5 matches)
          536870911 permit ip any 10.100.1.0 0.0.0.255 (95 matches)
          1073741823 permit ip any 10.0.0.0 0.255.255.255 (769 matches)
  Set clauses:
    interface Tunnel0  ip next-hop 10.101.1.4
 OCE used: 859BC70
  Policy routing matches: 744 packets, 510897 bytes
Current active dynamic routemaps = 1
Step 9   debug pfr border tunnel

This command displays debugging messages that can help you to troubleshoot issues. The example below shows the PfR messages displayed after a border router sends a message to the master controller to destroy a tunnel because the border router is shutting down.



Example:
Router# debug pfr border tunnel

PfR Master Tunnel debugging is on

*Jun 16 21:39:45.827: PFR BR TUNNEL: send the tunnel destroy status back to the MC

Enabling PfR Route Observe Mode

With CSCtr26978, the mode route control command behavior is the default. Perform this task at the master controller to configure PfR to use route observe mode instead of the default route control mode. In route observe mode, the master controller monitors prefixes and exit links based on default and user-defined policies and then reports the status of the network and the decisions that should be made, but it does not implement any changes. In route control mode, the master controller coordinates information from the borders routers in the same way as route observe mode, but commands are sent back to the border routers to alter routing in the PfR managed network to implement the policy decisions.

SUMMARY STEPS

1.    enable

2.    configure terminal

3.    pfr master

4.    mode route observe

5.    end


DETAILED STEPS
 Command or ActionPurpose
Step 1
enable


Example:

Router> enable

 

Enables privileged EXEC mode.

  • Enter your password if prompted.
 
Step 2
configure terminal


Example:

Router# configure terminal

 

Enters global configuration mode.

 
Step 3
pfr master


Example:

Router(config)# pfr master

 

Enters PfR master controller configuration mode to configure a router as a master controller and to configure global operations and policies.

 
Step 4
mode route observe


Example:

Router(config-pfr-mc)# mode route observe

 

Configures PfR to passively monitor and report without making any changes.

 
Step 5
end


Example:

Router(config-pfr-mc)# end

 

Exits PfR master controller configuration mode and returns to privileged EXEC mode.

 

Disabling Automatic PBR Route Control

Perform this task at the master controller to disable the default route control behavior when a RIB mismatch is found and allow PfR to use a single protocol to control a traffic class.


Note


With CSCtr26978, the no mode route protocol pbr command behavior is enabled by default. Perform this task to override the default behavior.
SUMMARY STEPS

1.    enable

2.    configure terminal

3.    pfr master

4.    no mode route protocol pbr

5.    end


DETAILED STEPS
 Command or ActionPurpose
Step 1
enable


Example:

Router> enable

 

Enables privileged EXEC mode.

  • Enter your password if prompted.
 
Step 2
configure terminal


Example:

Router# configure terminal

 

Enters global configuration mode.

 
Step 3
pfr master


Example:

Router(config)# pfr master

 

Enters PfR master controller configuration mode to configure a router as a master controller and to configure global operations and policies.

 
Step 4
no mode route protocol pbr


Example:

Router(config-pfr-mc)# no mode route protocol pbr

 

Disables the automatic PBR route control.

  • Sets the traffic classes to be uncontrolled and PfR then uses a single protocol to control the traffic class in the following order; BGP, EIGRP, static, and PBR.

 
Step 5
end


Example:

Router(config-pfr-mc)# end

 

Exits PfR master controller configuration mode and returns to privileged EXEC mode.

 

Configuration Examples for PfR Simplification Phase 1

Example: Verifying PfR Simplification Default Changes

The following example outputs, from privileged EXEC mode, display the new default values and behavior introduced to simplify PfR.

The following partial output shows that with CSCtq73034, the PfR BR Auto Neighbors feature, the autotunnel mode is introduced and enabled by default and an internal autotunnel has been created on a border router:

Router# show pfr master

OER state: ENABLED and ACTIVE
  Conn Status: SUCCESS, PORT: 3949
  Version: 3.3
  Number of Border routers: 4
  Number of Exits: 4
  Number of monitored prefixes: 4 (max 5000)
  Max prefixes: total 5000 learn 2500
  Prefix count: total 4, learn 4, cfg 4
  PBR Requirements met
  Nbar Status: Inactive
  Auto Tunnel Mode: On

Border        Status                UP/DOWN            AuthFail  Version  DOWN Reason
10.101.1.2    ACTIVE                UP       00:13:55         0  3.3
 Tu1          INTERNAL AUTO-TUNNEL  UP       00:13:55         0  3.3				   
 Et0/0        INTERNAL              UP       00:13:45         0  3.3
 Et1/0        EXTERNAL              UP       00:13:35         0  3.3

Global Settings:
  max-range-utilization percent 20 recv 0
  rsvp post-dial-delay 0 signaling-retries 1
  mode route metric bgp local-pref 5000
  mode route metric static tag 5000
  trace probe delay 1000
  no logging
  exit holddown time 60 secs, time remaining 0
.
.
.

The following partial output shows the default behavior introduced with CSCtr26978; the backoff timer values are 90, 900, and 90 seconds, hold-down is set to 90 seconds, mode route control is enabled, and mode select-exit best is removed.

.
.
.
Default Policy Settings:
  backoff 90 900 90
  delay relative 50
  holddown 90
  periodic 0
  probe frequency 56
  number of jitter probe packets 100
  mode route control
  mode monitor both
  loss relative 10
  jitter threshold 20
  mos threshold 3.60 percent 30
  unreachable relative 50
  resolve delay priority 11 variance 20
  resolve range priority 12 variance 0
  resolve utilization priority 13 variance 20
.
.
.

The following partial output shows the new default behavior introduced with CSCtr26978; learn mode is enabled, the monitor period is set to 1 minute, and the periodic interval is set to 0 minutes:

.
.
.
Learn Settings:
  current state : ENABLED
  time remaining in current state : 0 seconds
  throughput
  no delay
  no inside bgp
  monitor-period 1
  periodic-interval 0
  aggregation-type prefix-length 24
  prefixes 100 appls 100
  expire after time 720

Additional References

Related Documents

Related Topic

Document Title

Cisco IOS commands

Cisco IOS Master Commands List, All Releases

Cisco PfR commands: complete command syntax, command mode, command history, defaults, usage guidelines, and examples

Cisco IOS Performance Routing Command Reference

Basic PfR configuration

"Configuring Basic Performance Routing" module

Concepts required to understand the Performance Routing operational phases

"Understanding Performance Routing" module

Advanced PfR configuration

"Configuring Advanced Performance Routing" module

PfR home page with links to PfR-related content on our DocWiki collaborative environment

PfR:Home

MIBs

MIB MIBs Link

CISCO-PFR-MIB

To locate and download MIBs for selected platforms, Cisco software releases, and feature sets, use Cisco MIB Locator found at the following URL:

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

Technical Assistance

Description

Link

The Cisco Support and Documentation website provides online resources to download documentation, software, and tools. Use these resources to install and configure the software and to troubleshoot and resolve technical issues with Cisco products and technologies. Access to most tools on the Cisco Support and Documentation website requires a Cisco.com user ID and password.

http://www.cisco.com/cisco/web/support/index.html

Feature Information for PfR Simplification Phase 1

The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.

Table 1Feature Information for PfR Simplification Phase 1
Feature Name Releases Feature Information

PfR BR Automatic Adjacencies

15.2(2)S

15.2(3)T

Cisco IOS XE Release 3.6S

The PfR BR Automatic Adjacencies feature introduces dynamic PBR support. In dynamic route maps, the PBR requirement for both interface and next-hop information is supplied by PfR in a single set clause.

No commands were introduced or modified.

PfR BR Auto Neighbors

15.2(3)T

With CSCtq73034, the PfR BR Auto Neighbors feature removes the existing policy-based routing (PBR) requirement that border routers (BRs) be immediate or one-hop away neighbors. The mode auto-tunnels command was introduced and is enabled by default to simplify PfR configuration and allow dynamic PBR requirements to be met even if the border router is multiple hops away from its neighbor BR. Manual configuration of BRs is still available, but the BRs must be immediate neighbors.

The following commands were introduced or modified: debug pfr border tunnel, debug pfr master tunnel, mode auto-tunnels, show pfr border, show pfr master, show pfr master border, and show pfr master statistics.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned 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. (1110R)

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

© 2012 Cisco Systems, Inc. All rights reserved.