MPLS Traffic Engineering (TE)--Automatic Bandwidth Adjustment for TE Tunnels
Last Updated: March 1, 2012
The MPLS Traffic Engineering (TE)--Automatic Bandwidth Adjustment for TE Tunnels feature provides the means to automatically adjust the bandwidth allocation for traffic engineering tunnels based on their measured traffic load. The configured bandwidth in the running configuration is changed due to the automatic bandwidth behavior.
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.
Prerequisites for MPLS TE--Automatic Bandwidth Adjustment for TE Tunnels
Intermediate System-to-Intermediate System (IS-IS) or Open Shortest Path First (OSPF)
MPLS TE must be configured on the interface and on the tunnels.
Restrictions for MPLS TE--Automatic Bandwidth Adjustment for TE Tunnels
The automatic bandwidth adjustment feature treats each tunnel for which it has been enabled independently. That is, it adjusts the bandwidth for each such tunnel according to the adjustment frequency configured for the tunnel and the sampled output rate for the tunnel since the last adjustment without regard for any adjustments previously made or pending for other tunnels.
If a tunnel is brought down to calculate a new label switched path (LSP) because the LSP is not operational, the configured bandwidth is not saved. If the router is reloaded, the last saved automatic bandwidth value is used.
You cannot configure MPLS TE over the logical generic routing encapsulation (GRE) tunnel interface.
MPLS traffic engineering supports only a single IGP process/instance. Multiple IGP processes/instances are not supported and MPLS traffic engineering should not be configured in more than one IGP process/instance.
Information About MPLS TE--Automatic Bandwidth Adjustment for TE Tunnels
MPLS TE--Automatic Bandwidth Adjustment for TE Tunnels Overview
Traffic engineering autobandwidth samples the average output rate for each tunnel marked for automatic bandwidth adjustment. For each marked tunnel, the feature periodically (for example, once per day) adjusts the tunnel's allocated bandwidth to be the largest sample for the tunnel since the last adjustment.
The frequency with which tunnel bandwidth is adjusted and the allowable range of adjustments is configurable on a per-tunnel basis. In addition, the sampling interval and the interval over which to average tunnel traffic to obtain the average output rate is user-configurable on a per-tunnel basis.
MPLS TE--Automatic Bandwidth Adjustment for TE Tunnels Benefits
The automatic bandwidth feature allows you to configure and monitor the bandwidth for MPLS TE tunnels. If automatic bandwidth is configured for a tunnel, TE automatically adjusts the tunnel's bandwidth.
How to Configure MPLS TE--Automatic Bandwidth Adjustment for TE Tunnels
Specifies that the TE router identifier for the node is the IP address associated with interface loopback0.
Step 6
metric-stylewide
Example:
Router(config-router)# metric-style wide
Configures a router to generate and accept only new-style type, length, value objects (TLVs).
Step 7
exit
Example:
Router(config-router)# exit
Exits to global configuration mode.
Step 8
exit
Example:
Router(config)# exit
Exits to privileged EXEC mode.
Configuring OSPF for MPLS Traffic Engineering
SUMMARY STEPS
1.enable
2.configureterminal
3.routerospfprocess-id
4.mplstraffic-engareanumber
5.mplstraffic-engrouter-idloopback0
6.exit
7.exit
DETAILED STEPS
Command or Action
Purpose
Step 1
enable
Example:
Router> enable
Enables privileged EXEC mode.
Enter your password if prompted.
Step 2
configureterminal
Example:
Router# configure terminal
Enters global configuration mode.
Step 3
routerospfprocess-id
Example:
Router(config)# router ospf 200
Configures an OSPF routing process for IP and enters router configuration mode.
The value for the process-id argument is an internally used identification parameter for an OSPF routing process. It is locally assigned and can be any positive integer. Assign a unique value for each OSPF routing process.
Enables Resource Reservation Protocol (RSVP) for IP on an interface.
The interface-kbps argument specifies the maximum amount of bandwidth (in kbps) that may be allocated by RSVP flows. The range is from 1 to 10000000.
The single-flow-kbpsargument is the maximum amount of bandwidth, in kbps, that may be allocated to a single flow. The range is from 1 to 10000000.
Step 6
exit
Example:
Router(config-if)# exit
Exits to global configuration mode.
Step 7
exit
Example:
Router(config)# exit
Exits to privileged EXEC mode.
Configuring an MPLS Traffic Engineering Tunnel
To configure an MPLS TE tunnel, perform the following task. The MPLS TE tunnel has two path setup options: a preferred explicit path and a backup dynamic path.
Note
The configuration applies only to the TE head-end node. The configuration applies to all nodes and interfaces in the network.
The bandwidth argument is the bandwidth, in kilobits per second, set for the MPLS TE tunnel. The range is from 1 to 4294967295. The default is 0.
If automatic bandwidth is configured for the tunnel, the tunnelmplstraffic-engbandwidth command configures the initial tunnel bandwidth, which will be adjusted by the autobandwidth mechanism.
Note
If you configure a tunnel's bandwidth with the tunnelmplstraffic-engbandwidth command and the minimum amount of automatic bandwidth with the tunnelmplstraffic-engauto-bwcommand, the minimum amount of automatic bandwidth adjustment is the lower of those two configured values.
Each tunnelmplstraffic-engauto-bw command supersedes the previous one. Therefore, if you want to specify multiple options for a tunnel, you must specify them all in a single tunnelmplstraffic-engauto-bw command.
Enabling Automatic Bandwidth Adjustment on a Platform
To enable automatic bandwidth adjustment on a platform and initiate sampling the output rate for tunnels configured for bandwidth adjustment, perform the following task.
Note
This task is applicable only to the TE head-end router. The configuration applies to all locally-configured TE head-end interfaces.
SUMMARY STEPS
1.enable
2.configureterminal
3.mplstraffic-engauto-bwtimers [frequencyseconds]
4.nomplstraffic-engauto-bwtimers
5.exit
DETAILED STEPS
Command or Action
Purpose
Step 1
enable
Example:
Router> enable
Enables privileged EXEC mode.
Enter your password if prompted.
Step 2
configureterminal
Example:
Router# configure terminal
Enters global configuration mode.
Step 3
mplstraffic-engauto-bwtimers [frequencyseconds]
Example:
Router(config)# mpls traffic-eng auto-bw timers frequency 300
Enables automatic bandwidth adjustment on a platform and begins sampling the output rate for tunnels that have been configured for automatic bandwidth adjustment.
The frequency keyword specifies the interval, in seconds, for sampling the output rate of each tunnel configured for automatic bandwidth. The range is 1 through 604800. The recommended value is 300.
Step 4
nomplstraffic-engauto-bwtimers
Example:
Router(config)# no mpls traffic-eng auto-bw timers
(Optional) Disables automatic bandwidth adjustment on a platform.
Use the no version of the command, whichterminates output rate sampling and bandwidth adjustment for tunnels. In addition, the no form of the command restores the configured bandwidth for each tunnel where the configured bandwidth is determined as follows:
If the tunnel bandwidth was explicitly configured via the tunnelmplstraffic-engbandwidth command after the running configuration was written to the startup configuration, the configured bandwidth is the bandwidth specified by that command.
Otherwise, the configured bandwidth is the bandwidth specified for the tunnel in the startup configuration.
Step 5
exit
Example:
Router(config)# exit
Exits to privileged EXEC mode.
Enabling Automatic Bandwidth Adjustment for a Tunnel
Enables automatic bandwidth adjustment for the tunnel and controls the manner in which the bandwidth for a tunnel is adjusted.
Step 5
exit
Example:
Router(config-if)# exit
Exits to global configuration mode.
Step 6
exit
Example:
Router(config)# exit
Exits to privileged EXEC mode.
Configuring the Interval for Computing the Tunnel Average Output Rate
SUMMARY STEPS
1.enable
2.configureterminal
3.interfacetunnelnumber
4.load-intervalseconds
5.exit
6.exit
DETAILED STEPS
Command or Action
Purpose
Step 1
enable
Example:
Router> enable
Enables privileged EXEC mode.
Enter your password if prompted.
Step 2
configureterminal
Example:
Router# configure terminal
Enters global configuration mode.
Step 3
interfacetunnelnumber
Example:
Router(config)#interface tunnel 1
Configures a tunnel interface and enters interface configuration mode.
Step 4
load-intervalseconds
Example:
Router(config-if)# load-interval 90
Configures the interval over which the input and output rates for the interface are averaged.
The seconds argument is the length of time for which data is used to compute load statistics. The value is a multiple of 30, from 30 to 600 (30, 60, 90, 120, and so on). The default is 300.
Step 5
exit
Example:
Router(config-if)# exit
Exits to global configuration mode.
Step 6
exit
Example:
Router(config)# exit
Exits to privileged EXEC mode.
Verifying Automatic Bandwidth Configuration
SUMMARY STEPS
1.showmplstraffic-engtunnels
2.showrunning-config
DETAILED STEPS
Step 1
showmplstraffic-engtunnels
Use this command to display information about tunnels, including automatic bandwidth information for tunnels that have the feature enabled. For example:
Example:
Router# show mpls traffic-eng tunnels
Name:tagsw4500-9_t1 (Tunnel1) Destination:10.0.0.4
Status:
Admin:up Oper:up Path:valid Signalling:connected
path option 1, type explicit pbr_south (Basis for Setup, path weight 30)
path option 2, type dynamic
Config Parameters:
Bandwidth:13 kbps (Global) Priority:7 7 Affinity:0x0/0xFFFF
AutoRoute: disabled LockDown:disabled Loadshare:13 bw-based
auto-bw:(300/265) 53 Bandwidth Requested: 13
Adjustment threshold: 5%
Overflow Limit: 4 Overflow Threshold: 25%
Overflow Threshold Crossed: 1
Sample Missed: 1 Samples Collected: 1
Active Path Option Parameters:
State: dynamic path option 1 is active
BandwidthOverride: disabled LockDown: disabled Verbatim: disabled
InLabel : -
OutLabel : Serial3/0, 18
RSVP Signalling Info:
Src 10.0.0.1, Dst 10.0.0.4, Tun_Id 2, Tun_Instance 2
RSVP Path Info:
My Address: 10.105.0.1
Explicit Route: 10.105.0.2 104.105.0.1 10.0.0.4
Record Route: NONE
Tspec: ave rate=13 kbits, burst=1000 bytes, peak rate=13 kbits
Record Route: NONE
Tspec: ave rate=13 kbits, burst=1000 bytes, peak rate=13 kbits
RSVP Resv Info:
Record Route: NONE
Fspec: ave rate=13 kbits, burst=1000 bytes, peak rate=13 kbits
Shortest Unconstrained Path Info:
Path Weight: 128 (TE)
Explicit Route: 10.105.0.2 104.105.0.1 10.0.0.4
History:
Tunnel:
Time since created: 7 minutes, 56 seconds
Time since path change: 7 minutes, 18 seconds
Number of LSP IDs (Tun_Instances) used: 2
Number of Auto-bw Adjustment resize requests: 1
Time since last Auto-bw Adjustment resize request: 1 minutes, 7 seconds
Number of Auto-bw Overflow resize requests: 1
Time since last Auto-bw Overflow resize request: 52 seconds
Current LSP:
Uptime: 52 seconds
Selection: reoptimization
Prior LSP:
ID: path option 1 [1]
Removal Trigger: configuration changed
In the command output:
The auto-bw line indicates that automatic bandwidth adjustment is enabled for the tunnel.
300 is the time, in seconds, between bandwidth adjustments.
265 is the time, in seconds, remaining until the next bandwidth adjustment.
53 is the largest bandwidth sample since the last bandwidth adjustment.
13 is the last bandwidth adjustment and the bandwidth currently requested for the tunnel.
The adjustment threshold is 5 percent.
The overflow limit is 4.
The overflow threshold is 25 percent.
The overflow crossed is 1.
Example:
Step 2
showrunning-config
Use this command to verify that thetunnelmplstraffic-engautobw command is as you expected. For example:
The sample output from the showrunning-config command shows that the value 1500, in the tunnelmplstraffic-engbandwidth1500 command, changes after an adjustment is made.
Example:
Configuration Examples for MPLS TE--Automatic Bandwidth Adjustments for TE Tunnels
The figure below illustrates a sample MPLS topology. The following sections contain sample configuration examples to configure automatic bandwidth adjustment for MPLS TE tunnels originating on Router 1 and to enable automatic bandwidth adjustment for Tunnel 1.
The examples omit some configuration required for MPLS TE, such as the required RSVP and Interior Gateway Protocol (IGP) (IS-IS or OSPF) configuration, because the purpose of these examples is to illustrate the configuration for automatic bandwidth adjustment.
Configuring MPLS Traffic Engineering Automatic Bandwidth Example
The following example shows how to use the mplstraffic-engauto-bwtimers command to enable automatic bandwidth adjustment for Router 1. The command specifies that the output rate is to be sampled every 10 minutes for tunnels configured for automatic bandwidth adjustment.
configure terminal
!
ip cef distributed
mpls traffic-eng tunnels
mpls traffic-eng auto-bw timers frequency 600 !Enable automatic bandwidth adjustment
interface loopback 0
ip address 192.168.11.11 255.255.255.0
Tunnel Configuration for Automatic Bandwidth Example
The following example shows how to use the tunnelmplstraffic-engauto-bw command to enable automatic bandwidth adjustment for Tunnel 1. The command specifies a maximum allowable bandwidth of 2000 kbps, a minimum allowable bandwidth of 1000 kbps, and that the default automatic bandwidth adjustment frequency of once a day be used.
No new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified.
--
Technical Assistance
Description
Link
The Cisco Support website provides extensive online resources, including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies.
To receive security and technical information about your products, you can subscribe to various services, such as the Product Alert Tool (accessed from Field Notices), the Cisco Technical Services Newsletter, and Really Simple Syndication (RSS) Feeds.
Access to most tools on the Cisco Support website requires a Cisco.com user ID and password.
Feature Information for MPLS TE--Automatic Bandwidth Adjustment for TE Tunnels
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 1
Feature Information for MPLS TE--Automatic Bandwidth Adjustment for TE Tunnels
Feature Name
Releases
Feature Information
MPLS Traffic Engineering (TE)--Automatic Bandwidth Adjustment for TE Tunnels
Release 12.2(33)SRE
The MPLS Traffic Engineering (TE)--Automatic Bandwidth Adjustment for TE Tunnels feature provides the means to automatically adjust the bandwidth allocation for traffic engineering tunnels based on their measured traffic load. The configured bandwidth in the running configuration is changed due to the automatic bandwidth behavior.
The following commands were introduced or modified to support automatic bandwidth adjustment threshold and overflow threshold:
mplstraffic-englspattributes,
showmplstraffic-engtunnels,and
tunnelmplstraffic-engauto-bw.
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.