The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This module describes the commands used to configure Multiprotocol Label Switching (MPLS) Traffic Engineering (TE) on the Cisco IOS XR Software.
Your network must support the following Cisco features before you can enable MPLS-TE:
MPLS
IP Cisco Express Forwarding (CEF)
Intermediate System-to-Intermediate System (IS-IS) or Open Shortest Path First (OSPF) routing protocol
Resource Reservation Protocol (RSVP)
MPLS Label Distribution Protocol (LDP), Resource Reservation Protocol (RSVP), and Universal Control Plane (UCP) command descriptions are documented separately.
For detailed information about MPLS concepts, configuration tasks, and examples, see Cisco IOS XR MPLS Configuration Guide for the Cisco CRS-1 Router.
To configure the tunnel bandwidth change threshold to trigger an adjustment, use the adjustment-threshold command in MPLS-TE automatic bandwidth interface configuration mode. To disable this feature, use the no form of this command.
adjustment-threshold percentage [ min minimum bandwidth ]
no adjustment-threshold percentage [ min minimum bandwidth ]
percentage |
Bandwidth change percent threshold to trigger an adjustment if the largest sample percentage is higher or lower than the current tunnel bandwidth. The range is from 1 to 100. The default is 5. |
min minimum bandwidth |
(Optional) Configures the bandwidth change value to trigger an adjustment. The tunnel bandwidth is changed only if the largest sample is higher or lower than the current tunnel bandwidth, in kbps. The range is from 10 to 4294967295. The default is 10. |
percentage: 5
minimum bandwidth: 10
MPLS-TE automatic bandwidth interface configuration
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
If you configure or modify the adjustment threshold while the automatic bandwidth is already running, the next band-aids application is impacted for that tunnel. The new adjustment threshold determines if an actual bandwidth takes place.
The following example configures the tunnel bandwidth change threshold to trigger an adjustment:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# auto-bw RP/0/RP0/CPU0:router(config-if-tunte-autobw)# adjustment-threshold 20 min 500
Command |
Description |
---|---|
Configures the application frequency, in minutes, for the applicable tunnel. |
|
Configures automatic bandwidth on a tunnel interface and enters MPLS-TE automatic bandwidth interface configuration mode. |
|
Configures the minimum and maximum automatic bandwidth to set on a tunnel. |
|
Enables only the bandwidth collection without adjusting the automatic bandwidth. |
|
Configures tunnel overflow detection. |
|
Displays information about MPLS-TE tunnels. |
To override the Interior Gateway Protocol (IGP) administrative weight (cost) of the link, use the admin-weight command in MPLS-TE interface configuration mode. To return to the default behavior, use the no form of this command.
admin-weight weight
no admin-weight weight
weight |
Administrative weight (cost) of the link. Range is 0 to 4294967295. |
weight: IGP Weight (default OSPF 1, ISIS 10)
MPLS-TE interface configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
To use MPLS the admin-weight command for MPLS LSP path computations, path-selection metric must be configured to TE.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# interface POS 0/7/0/0 RP/0/RP0/CPU0:router(config-mpls-te-if)# admin-weight 20
Command |
Description |
---|---|
Enables MPLS-TE on an interface and enters MPLS-TE interface configuration mode. |
|
Enters MPLS-TE configuration mode. |
|
Specifies an MPLS-TE tunnel path-selection metric type. |
To configure an affinity (the properties the tunnel requires in its links) for an MPLS-TE tunnel, use the affinity command in interface configuration mode. To disable this behavior, use the no form of this command.
affinity { affinity-value mask mask-value | exclude name | exclude-all | ignore | include name | include-strict name }
no affinity { affinity-value mask mask-value | exclude name | exclude-all | ignore | include name | include-strict name }
affinity-value |
Attribute values that are required for links to carry this tunnel. A 32-bit decimal number. Range is from 0x0 to 0xFFFFFFFF, representing 32 attributes (bits), where the value of an attribute is 0 or 1. |
mask mask-value |
Checks the link attribute. A 32-bit decimal number. Range is 0x0 to 0xFFFFFFFF, representing 32 attributes (bits), where the value of an attribute mask is 0 or 1. |
exclude name |
Configures a particular affinity to exclude. |
exclude-all |
Excludes all affinities. |
ignore |
Ignore affinity attributes. |
include name |
Configures the affinity to include in the loose sense. |
include-strict name |
Configures the affinity to include in the strict sense. |
affinity-value: 0X00000000
mask-value: 0x0000FFFF
Interface configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
Release 3.4.0 |
Support was added for the Name-Based Affinity Constraint scheme. |
Release 3.7.0 |
Affinity colors definition for MPLS-TE was added. |
Release 5.2.2 |
Support was added to start a 5 minute timer to allow reoptimization when affinity failure occurs. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Affinity determines the link attributes of the tunnel (that is, the attributes for which the tunnel has an affinity). The attribute mask determines which link attribute the router should check. If a bit in the mask is 0, the attribute value of a link or that bit is irrelevant. If a bit in the mask is 1, the attribute value of that link and the required affinity of the tunnel for that bit must match.
A tunnel can use a link if the tunnel affinity equals the link attributes and the tunnel affinity mask.
If there is an affinity failure, a 5 minute timer is started at the LSP headend. If the tunnel is not able to reoptimize within the time frame, it is torn down. However, if you execute the mpls traffic-eng reoptimize disable affinity-failure command, no timer is started and the tunnel is not torn down. Note that, at a subsequent time, other triggers for reoptimization may start the timer for the LSPs with affinity failure.
Any properties set to 1 in the affinity should be 1 in the mask. The affinity and mask should be set as follows:
tunnel_affinity=tunnel_affinity and tunnel_affinity_mask
You can configure up to 16 affinity constraints under a given tunnel. These constraints are used to configure affinity constraints for the tunnel:
Specifies that a link is considered for constrained shortest path first (CSPF) if it contains all affinities associated with the include constraint. An acceptable link contains more affinity attributes than those associated with the include statement. You can have multiple include statements under a tunnel configuration.
Specifies that a link is considered for CSPF if it contains only the colors associated with the include-strict statement. The link cannot have any additional colors. In addition, a link without a color is rejected.
Specifies that a link satisfies an exclude constraint if it does not have all the colors associated with the constraint. In addition, a link that does not have any attribute satisfies an exclude constraint.
Specifies that only the links without any attribute are considered for CSPF. An exclude-all constraint is not associated with any color; whereas, all other constraint types are associated with up to 10 colors.
Ignores affinity attributes while considering links for CSPF.
You set one bit for each color; however, the sample output shows multiple bits at the same time. For example, you can configure red and black colors on GigabitEthernet0/4/1/3 from the interface command. The sample output from the show mpls traffic-eng link-management interfaces command shows that the Attributes field is set to 0x21, which means that there are 0x20 and 0x1 bits on the link.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
This example shows how to configure the tunnel affinity and mask:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# affinity 0101 mask 303
This example shows that a link is eligible for CSPF if the color is red. The link can have any additional colors.
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# affinity include red
This example shows that a link is eligible for CSPF if it has at least red and black colors. The link can have any additional colors.
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# affinity include red black
This example shows how to configure a tunnel to ignore the affinity attributes on links.
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# affinity ignore
This sample output shows that the include constraint from the show mpls traffic-eng tunnels command is 0x20 and 0x1:
Name: tunnel-te1 Destination: 0.0.0.0 Status: Admin: up Oper: down Path: not valid Signalling: Down G-PID: 0x0800 (internally specified) Config Parameters: Bandwidth: 0 kbps (CT0) Priority: 7 7 Number of configured name based affinity constraints: 1 Name based affinity constraints in use: Include bit map : 0x21 Metric Type: TE (default) AutoRoute: disabled LockDown: disabled Loadshare: 0 equal loadshares Auto-bw: disabled(0/0) 0 Bandwidth Requested: 0 Direction: unidirectional Endpoint switching capability: unknown, encoding type: unassigned Transit switching capability: unknown, encoding type: unassigned Reason for the tunnel being down: No destination is configured History:
This example shows that a tunnel can go over a link that contains red or black affinity. A link is eligible for CSPF if it has a red color or a black color. Thus, a link with red and any other colors and a link with black and other additional colors must meet the constraint.
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# affinity include red RP/0/RP0/CPU0:router(config-if)# affinity include black
This sample output shows that the include constraint from the show mpls traffic-eng tunnels command is 0x20 or 0x1:
Name: tunnel-te1 Destination: 0.0.0.0 Status: Admin: up Oper: down Path: not valid Signalling: Down G-PID: 0x0800 (internally specified) Config Parameters: Bandwidth: 0 kbps (CT0) Priority: 7 7 Number of configured name based affinity constraints: 2 Name based affinity constraints in use: Include bit map : 0x1 Include bit map : 0x20 Metric Type: TE (default) AutoRoute: disabled LockDown: disabled Loadshare: 0 equal loadshares Auto-bw: disabled(0/0) 0 Bandwidth Requested: 0 Direction: unidirectional Endpoint switching capability: unknown, encoding type: unassigned Transit switching capability: unknown, encoding type: unassigned Reason for the tunnel being down: No destination is configured History:
This example shows that a link is eligible for CSPF if it has only red color. The link must not have any additional colors.
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# affinity include-strict red
This example shows that a link is eligible for CSPF if it does not have the red attribute:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# affinity exclude red
This example shows that a link is eligible for CSPF if it does not have red and blue attributes. Thus, a link that has only a red attribute or only a blue attribute is eligible for CSPF.
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# affinity exclude red blue
This example shows that a link is eligible for CSPF if it does not have either a red or a blue attribute:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# affinity exclude red RP/0/RP0/CPU0:router(config-if)# affinity exclude blue
Command |
Description |
---|---|
Assigns a numerical value to each affinity name. |
|
Configures attribute names for the interface. |
|
Configures an MPLS-TE tunnel interface. |
|
Displays the color name-to-value mappings configured on the router. |
|
Displays information about MPLS-TE tunnels. |
To assign a numerical value to each affinity name, use the affinity-map command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
affinity-map affinity name { affinity value | bit-position value }
no affinity-map affinity name { affinity value | bit-position value }
affinity name |
Affinity map name-to-value designator (in hexadecimal, 0-ffffffff ). |
affinity value |
Affinity map value designator. Range is from 1 to 80000000. |
bit-position |
Configures the value of an affinity map for the bit position of the 32-bit number. |
value |
Bit position value. Range is from 0 to 255. |
No default behavior or values
MPLS-TE configuration
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
![]() Note | The name-to-value mapping must represent a single bit of a 32-bit value. |
Repeat the affinity-map command to define multiple colors up to a maximum of 256 colors.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to assign a numerical value to each affinity name:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# affinity-map red 1 RP/0/RP0/CPU0:router(config-mpls-te)# affinity-map blue 2
The following example shows how to configure the value of 15 for an affinity map by bit position:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# affinity-map red2 bit-position 15
Command |
Description |
---|---|
Configures affinity (the properties that the tunnel requires in its links) for an MPLS-TE tunnel. |
|
Enters MPLS-TE configuration mode. |
|
Displays the color name-to-value mappings configured on the router. |
To configure the application frequency, in minutes, for the applicable tunnel, use the application command in MPLS-TE automatic bandwidth interface configuration mode. To disable this feature, use the no form of this command.
application minutes
no application minutes
minutes |
Frequency, in minutes, for the automatic bandwidth application. The range is from 5 to 10080 (7 days). The default is 1440. |
minutes : 1440 (24 hours)
MPLS-TE automatic bandwidth interface configuration
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
If you configure and modify the application frequency, the application period can reset and restart for that tunnel. The next bandwidth application for the tunnel happens within the specified minutes.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure application frequency to 1000 minutes for MPLS-TE interface 1:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# auto-bw RP/0/RP0/CPU0:router(config-if-tunte-autobw)# application 1000
Command |
Description |
---|---|
Configures the tunnel-bandwidth change threshold to trigger an adjustment. |
|
Configures automatic bandwidth on a tunnel interface and enters MPLS-TE automatic bandwidth configuration mode. |
|
Configures the minimum and maximum automatic bandwidth to set on a tunnel. |
|
Enables only the bandwidth collection without adjusting the automatic bandwidth. |
|
Configures an MPLS-TE tunnel interface. |
|
Configures tunnel overflow detection. |
|
Displays information about MPLS-TE tunnels. |
To configure attribute flags for an interface, use the attribute-flags command in MPLS-TE interface configuration mode. To return to the default behavior, use the no form of this command.
attribute-flags attribute-flags
no attribute-flags attribute-flags
attribute -flags |
Links attributes that are compared to the affinity bits of a tunnel during selection of a path. Range is 0x0 to 0xFFFFFFFF, representing 32 attributes (bits) where the value of an attribute is 0 or 1. |
attributes : 0x0
MPLS-TE interface configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The attribute-flags command assigns attributes to a link so that tunnels with matching attributes (represented by their affinity bits) prefer this link instead of others that do not match.
The interface attribute is flooded globally so that it can be used as a tunnel headend path selection criterion.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to set attribute flags to 0x0101:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# interface POS 0/7/0/0 RP/0/RP0/CPU0:router(config-mpls-te-if)# attribute-flags 0x0101
Command |
Description |
---|---|
Overrides the IGP administrative weight of the link. |
|
Configures affinity (the properties that the tunnel requires in its links) for an MPLS-TE tunnel. |
|
Configures the attribute names for the interface. |
|
Enables MPLS-TE on an interface and enters MPLS-TE interface configuration mode. |
|
Enters MPLS-TE configuration mode. |
To configure attributes for the interface, use the attribute-names command in MPLS-TE interface configuration mode. To return to the default behavior, use the no form of this command.
attribute-names attribute name
no attribute-names attribute name
attribute name |
Attribute name expressed using alphanumeric or hexidecimal characters.Up to 32 attribute-names can be assigned. |
index |
Specifies an entry index for attribute names. |
index-number |
Specifies the index number. Range is from 1 to 8. |
No default behavior or values
MPLS-TE interface configuration
Release |
Modification |
---|---|
Release 3.4.0 |
This command was introduced. |
Release 5.1.1 | Support was added to assign up to 32 names per attribute-set and index for extended admin groups. The index index-value keyword and argument were added to support extended admin groups (EAG) configuration. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The name-to-value mapping must represent a single bit of a 256-bit value.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to assign an attribute name (in this case, red) to a TE link:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# interface pos 0/2/0/1 RP/0/RP0/CPU0:router(config-mpls-te-if)# attribute-name red
Command |
Description |
---|---|
Configures affinity (the properties that the tunnel requires in its links) for an MPLS-TE tunnel. |
|
Configures attribute flags for the interface. |
|
Enables MPLS-TE on an interface and enters MPLS-TE interface configuration mode. |
|
Enters MPLS-TE configuration mode. |
To configure attribute-set for auto-backup tunnels, use the attribute-set command in MPLS-TE configuration mode.
attribute-set auto-backup attribute-set-name { affinity { affinity-value mask mask-value | exclude name | exclude-all | include name | include-strict name } | logging events lsp-status { reoptimize | state } | policy-class { range | default } | priority setup-range hold-range | record-route }
To configure attribute-set for auto-mesh tunnels, use the attribute-set command in MPLS-TE configuration mode.
attribute-set auto-mesh attribute-set-name { affinity { affinity-value mask mask-value | exclude name | exclude-all | include name | include-strict name } | auto-bw collect-bw-only | autoroute announce | bandwidth bandwidth | fast-reroute [ protect { bandwidth node | node bandwidth } ] | logging events lsp-status { insufficient-bandwidth | reoptimize | reroute | state } | policy-class { range | default } | priority setup-range hold-range | record-route | signalled-bandwidth bandwidth [ class-type cl ] | soft-preemption }
To configure attribute-set for a path-option, use the attribute-set command in MPLS-TE configuration mode.
attribute-set path-option attribute-set-name { affinity { affinity-value mask mask-value | exclude name | exclude-all | include name | include-strict name } | signalled-bandwidth bandwidth [ class-type cl ] }
To specify an attribute set for LSP diversity for GMPLS UNI, use the attribute-set command in MPLS-TE configuration mode.
attribute-set xro attribute-set-name
To disable this behavior, use the no form of this command.
auto-backup |
Specifies the values of an attribute set for the auto-backup group. |
auto-mesh |
Specifies the values of an attribute set for the auto-mesh group. |
path-option |
Specifies the values of an attribute set for the path option. |
xro |
Specifies that the attribute-set is used to define an XRO. |
attribute-set-name |
A 32-bit character string, specifies the name of the attribute-set template. |
affinity-value |
Attribute values that are required for links to carry this tunnel. A 32-bit decimal number, representing 32 attributes (bits), where the value of an attribute is 0 or 1. Range is from 0x0 to 0xFFFF. |
mask mask-value |
Checks the link attribute. A 32-bit decimal number, representing 32 attributes (bits), where the value of an attribute mask is 0 or 1. Range is from 0x0 to 0xFFFF. |
exclude name |
Configures a specific affinity that is to be excluded. |
exclude-all |
Excludes all affinities. |
include name |
Configures the affinity to include in the loose sense. |
include-strict name |
Configures the affinity to include in the strict sense. |
logging |
Per-interface logging configuration. |
events |
Per-interface logging events. |
lsp-status |
Enables interface LSP state change alarms. |
reoptimize |
Enables interface LSP REOPT change alarms. |
state |
Enables interface LSP UP/DOWN change alarms. |
policy-class |
Specifies class for policy-based tunnel selection. |
range |
Tunnel policy class range 1 to 7. |
default |
Default class for policy-based tunnel selection. |
priority |
Specifies the tunnel priority. |
setup-range |
Specifies setup priority. Range is 0 to 7. |
hold-range |
Specifies hold priority. Range is 0 to 7. |
record-route |
Records the route used by the tunnel. |
signalled-bandwidth |
Specifies the tunnel bandwidth requirement to be signalled. |
bandwidth |
Bandwidth required for an MPLS-TE tunnel, specified in kilobits per second. By default, bandwidth is reserved in the global pool. Range is from 0 to 4294967295. |
class-type ct |
(Optional) Configures the class type of the tunnel bandwidth request. Range is 0 to 1. Class-type 0 is equivalent to global-pool. Class-type 1 is equivalent to subpool. |
soft-preemption |
Enables the soft-preemption feature on this tunnel. |
affinity-value: 0x0
mask-value: 0xFFFF
MPLS TE configuration
Release | Modification |
---|---|
Release 4.2.0 |
This command was introduced. The sub-pool keyword is not supported. |
Release 4.2.1 |
Support for configuring attribute-set for auto-backup tunnels was added. The policy-class keyword was added for auto-mesh attribute-set. |
Release 4.3.0 |
The xro keyword was added in support of GMPLS UNI feature. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The values specified for an attribute within a path-option attribute-set does not prevent the configuration of the same attribute at the tunnel level. However, only one level is taken into consideration. The configuration at the path-option level is considered more specific than the one at the level of the tunnel, and is therefore used.
Attributes that are not specified within an attribute-set picks their default values, as usual, from the configuration at the tunnel level, the configuration at the global mpls level, or default values.
An XRO attribute-set can be specified as part of the path-option, if required. An empty XRO attribute set results in the GMPLS tunnel being signaled with no exclusions, and therefore no XRO.
Task ID | Operation |
---|---|
mpls-te |
read, write |
ouni |
read, write |
This example shows how to configure an attribute-set to a TE interface for an auto-backup tunnel:
RP/0/RP0/CPU0:router# config RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# interface GigabitEthernet 0/1/0/3 RP/0/RP0/CPU0:router(config-mpls-te-if)# auto-tunnel backup RP/0/RP0/CPU0:router(config-mpls-te-if-auto-backup)# attribute-set ab RP/0/RP0/CPU0:router(config-mpls-te-if-auto-backup)#
This example shows how to configure an attribute-set to a TE interface for an auto-mesh tunnel:
RP/0/RP0/CPU0:router# config RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# auto-tunnel mesh RP/0/RP0/CPU0:router(config-te-auto-mesh)# group 1 RP/0/RP0/CPU0:router(config-te-mesh-group)# attribute-set am1 RP/0/RP0/CPU0:router(config-te-mesh-group)# destination-list dl1
This example shows how to configure the attribute-set for auto-backup tunnels:
RP/0/RP0/CPU0:router# config RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# attribute-set auto-backup ab RP/0/RP0/CPU0:router(config-te-attribute-set)# affinity 0x1 mask 0x1 RP/0/RP0/CPU0:router(config-te-attribute-set)# priority 3 3 RP/0/RP0/CPU0:router(config-te-attribute-set)# policy-class 6 RP/0/RP0/CPU0:router(config-te-attribute-set)# logging events lsp-status reoptimize RP/0/RP0/CPU0:router(config-te-attribute-set)# logging events lsp-status state RP/0/RP0/CPU0:router(config-te-attribute-set)# policy-class default RP/0/RP0/CPU0:router(config-te-attribute-set)# record-route
This example shows how to configure the attribute-set for auto-mesh tunnels:
RP/0/RP0/CPU0:router# config RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# attribute-set auto-mesh mesh1 RP/0/RP0/CPU0:router(config-te-attribute-set)# affinity include red blue RP/0/RP0/CPU0:router(config-te-attribute-set)# affinity include-strict yellow green RP/0/RP0/CPU0:router(config-te-attribute-set)# affinity exclude black RP/0/RP0/CPU0:router(config-te-attribute-set)# affinity exclude-all RP/0/RP0/CPU0:router(config-te-attribute-set)# policy-class default
This example shows how to configure the tunnel affinity and signalled-bandwidth for a path-option:
RP/0/RP0/CPU0:router# config RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# attribute-set path-option myset RP/0/RP0/CPU0:router(config-te-attribute-set)# affinity 0x3 mask 0x3 RP/0/RP0/CPU0:router(config-te-attribute-set)# signalled-bandwidth 2000
The following example shows how to configure attribute set attr01:
RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# attribute-set xro attr01 RP/0/RP0/CPU0:router(config-te-attribute-set)#
Command |
Description |
---|---|
Assigns a numerical value to each affinity name. |
|
Configures attribute names for the interface. |
|
Configures an MPLS-TE tunnel interface. |
|
Displays the color name-to-value mappings configured on the router. |
|
Displays information about MPLS-TE tunnels. |
To configure automatic bandwidth on a tunnel interface and to enter MPLS-TE automatic bandwidth interface configuration mode, use the auto-bw command in MPLS-TE interface configuration mode. To disable the automatic bandwidth on that tunnel, use the no form of this command.
auto-bw
no auto-bw
This command has no arguments or keywords.
By default, automatic bandwidth is not enabled.
MPLS-TE interface configuration
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Use the auto-bw command to enter MPLS-TE automatic bandwidth interface configuration mode.
The auto-bw and load-share unequal commands should not be used together.
The load-share unequalcommand determines the load-share for a tunnel based on the bandwidth. However, the MPLS-TE automatic bandwidth feature changes the bandwidth around. If you are configuring both the load-share unequal command and the MPLS-TE automatic bandwidth feature, we recommend that you specify an explicit load-share value configuration under each MPLS-TE automatic bandwidth tunnel.
The following automatic bandwidth scenarios are described:
![]() Note | Because the collection timer is already running, the first collection event for that tunnel happens in less than C minutes (for example, on an average of C/2 minutes). |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to enter MPLS-TE automatic bandwidth interface configuration mode:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# auto-bw RP/0/RP0/CPU0:router(config-if-tunte-autobw)#
Command |
Description |
---|---|
Configures the tunnel-bandwidth change threshold to trigger an adjustment. |
|
Configures the application frequency, in minutes, for the applicable tunnel. |
|
Configures the minimum and maximum automatic bandwidth to set on a tunnel. |
|
Enables only the bandwidth collection without adjusting the automatic bandwidth. |
|
Configures an MPLS-TE tunnel interface. |
|
Configures tunnel overflow detection. |
|
Displays information about MPLS-TE tunnels. |
To configure the automatic bandwidth collection frequency, use the auto-bw collect frequency command in MPLS-TE configuration mode. To reset the automatic bandwidth frequency to its default value, use the no form of this command.
auto-bw collect frequency minutes
no auto-bw collect frequency minutes
minutes |
Interval between automatic bandwidth adjustments, in minutes. The range is from 1 to 10080. The default is 5. |
minutes: 5
In addition, the no form of this command resets to the default.
MPLS-TE configuration
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The auto-bw collect frequency command configures the automatic bandwidth collection frequency for all the tunnels.
Modifying the global collection frequency does not restart the tunnel for the current application period. The application period continues with the modified collection frequency.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example configures a tunnel for an automatic bandwidth adjustment of 100 minutes:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# auto-bw collect frequency 100
Command |
Description |
---|---|
Enters MPLS-TE configuration mode. |
|
Configures the highest bandwidth available on a tunnel without waiting for the current application period to end. |
|
Displays information about MPLS-TE tunnels. |
To specify that the Interior Gateway Protocol (IGP) should use the tunnel (if the tunnel is up) in its enhanced shortest path first (SPF) calculation, use the autoroute announce command in interface configuration mode. To return to the default behavior, use the no form of this command.
autoroute announce [include-ipv6] [ metric value ]
no autoroute announce
include-ipv6 |
(Optional) Announces the MPLS-TE tunnel to IS-IS IGP for IPv6 routing. |
metric value |
(Optional) Specify the MPLS-TE tunnel metric that the Interior Gateway Protocol (IGP) enhanced Shortest Path First (SPF) calculation uses. |
Announces IPv4 tunnel
Interface configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
Release 5.1.1 |
The include-ipv6 and metric keywords were added to support MPLS-TE tunnel announcements to IS-IS. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
When more than one IGP is configured, the tunnel is announced as autoroute to the IGP that is used to compute the TE tunnel path.
When the autoroute announce command is configured, the route metric of the tunnel path to the destination equals the route metric of the shortest IGP path to that destination.
The autoroute announce metric configuration overrides the autoroute metric configuration, if present.
![]() Note | IS-IS is the only IGP supporting ipv6 MPLS-TE tunnel announcements. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
This example shows how to configure IGP to use the tunnel in its enhanced SPF calculation when the tunnel is up:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# autoroute announce
RP/0/RP0/CPU0:router#configure RP/0/RP0/CPU0:router(config)#interface tunnel-te 65534 RP/0/RP0/CPU0:router(config-if)#autoroute announce RP/0/RP0/CPU0:router(config-if-tunte-aa)#include-ipv6
Command |
Description |
---|---|
Configures an MPLS-TE tunnel interface. |
To install multiple static routes in the routing information base (RIB) per MPLS TE tunnel, use the autoroute destination command in interface TE tunnel configuration mode. To disable autoroute destination, use the no form of this command.
autoroute destination ip-address
no autoroute destination ip-address
ip-address |
Specifies the host address of the route to be installed in the RIB. A maximum of six routes can be specified apart from the default route. |
Autoroute destination is disabled.
Interface Tunnel TE
Release | Modification |
---|---|
Release 5.1.1 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID | Operation |
---|---|
mpls-te |
read, write |
This example shows how to configure installing four routes in RIB for TE tunnel 10:
RP/0/RP0/CPU0:router#configure RP/0/RP0/CPU0:router(config)#interface tunnel-te 10 RP/0/RP0/CPU0:router(config-if)# autoroute destination 192.168.1.2 RP/0/RP0/CPU0:router(config-if)# autoroute destination 192.168.2.2 RP/0/RP0/CPU0:router(config-if)# autoroute destination 192.168.3.2 RP/0/RP0/CPU0:router(config-if)# autoroute destination 192.168.4.2
To specify the MPLS-TE tunnel metric that the Interior Gateway Protocol (IGP) enhanced Shortest Path First (SPF) calculation uses, use the autoroute metric command in interface configuration mode. If no specific metric is to be specified, use the no form of this command.
autoroute metric { absolute | relative } value
no autoroute metric { absolute | relative } value
absolute |
Enables the absolute metric mode; you can enter a positive metric value. |
relative |
Enables the relative metric mode; you can enter a positive, negative, or zero value. |
value |
Metric that the IGP enhanced SPF calculation uses. Relative value range is from –10 to 10. Absolute value range is from 1 to 2147483647. |
The relative value is 0.
Interface configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
Release 3.9.0 |
The absolute value range is defined from 1 to 2147483647. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The autoroute metric command overwrites the default tunnel route metric of the shortest IGP path to the destination.
![]() Note | The autoroute announce configuration overrides the autoroute metric configuration, if present. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure the IGP enhanced SPF calculation using MPLS-TE tunnel metric as relative negative 1:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# autoroute metric relative -1
Command |
Description |
---|---|
Instructs the IGP to use the tunnel (if it is up) in its enhanced SPF calculation. |
|
Configures an MPLS-TE tunnel interface. |
|
Displays the tunnels announced to the IGP, including interface, destination, and bandwidth. |
To enable auto-tunnel stateful PCE client configuration mode, use the auto-tunnel pcc command in MPLS TE configuration mode. To disable auto-tunnel stateful PCE client configuration, use the no form of this command.
auto-tunnel pcc
no auto-tunnel pcc
This command has no keywords or arguments.
Auto-tunnel stateful PCE client mode is disabled.
MPLS TE configuration
Release | Modification |
---|---|
Release 5.1.1 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID | Operation |
---|---|
mpls-te |
read, write |
This example shows how to enable auto-tunnel stateful PCE client configuration mode:
RP/0/RP0/CPU0:router#configure RP/0/RP0/CPU0:router(config)#mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)#auto-tunnel pcc RP/0/RP0/CPU0:router(config-te-auto-pcc)#
To automatically build next-hop (NHOP) and next-next-hop (NNHOP) backup tunnels, and to enter auto-tunnel backup configuration mode, use the auto-tunnel backup command in MPLS-TE configuration mode. To clear the NHOP and NNHOP backup tunnels, use the no form of this command.
auto-tunnel backup
no auto-tunnel backup
This command has no arguments or keywords.
No default behavior or values
MPLS-TE configuration
Release | Modification |
---|---|
Release 4.0.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The range of tunnel-ID is required to be mentioned for the auto-tunnel backup tunnels; otherwise, none of the tunnels are created.
The no form of this command deletes both NHOP and NNHOP backup tunnels that are configured using either the auto-tunnel backup command or the nhop-only command.
Task ID | Operation |
---|---|
mpls-te |
read, write |
The following example automatically builds NHOP and NNHOP backup tunnels:
RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# auto-tunnel backup
Command | Description |
---|---|
Clears the unused automatic backup tunnels. |
|
mpls traffic-eng interface-path-id auto-tunnel backup |
Configures the automatic backup tunnel for a specific interface. |
Displays information about MPLS-TE tunnels. |
|
Configures range of tunnel interface numbers for automatic backup tunnels. |
To configure the backup bandwidth for an MPLS-TE backup tunnel (that is used to protect a physical interface), use the backup-bw command in interface configuration mode. To return to the default behavior, use the no form of this command.
backup-bw { backup bandwidth { any-class-type | class-type ct } | global-pool { bandwidth | unlimited } | sub-pool { bandwidth | unlimited } | unlimited { any-class-type | class-type ct } }
no backup-bw { backup bandwidth { any-class-type | class-type ct } | global-pool { bandwidth | unlimited } | sub-pool { bandwidth | unlimited } | unlimited { any-class-type | class-type ct } }
backup bandwidth |
Backup bandwidth in any-pool provided by an MPLS-TE backup tunnel. Bandwidth is specified in kilobits per second (kbps). Range is 1 to 4294967295. |
any-class-type |
Displays the backup bandwidth assigned to any class-type protected tunnels. |
class-type ct |
Displays the class type of the backup bandwidth. Range is 0 to 1. |
global-pool bandwidth |
(In Prestandard DS-TE with RDM) Displays the backup bandwidth in global pool provided by an MPLS-TE backup tunnel. Bandwidth is specified in kilobits per second. Range is 1 to 4294967295. |
unlimited |
Displays the unlimited bandwidth. |
sub-pool bandwidth |
(In Prestandard DS-TE with RDM) Displays the backup bandwidth in sub-pool provided by an MPLS-TE backup tunnel. Bandwidth is specified in kilobits per second. Range bandwidth is 1 to 4294967295. Only label switched paths (LSPs) using bandwidth from the sub-pool can use the backup tunnel. |
Any class-type unlimited.
Interface configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Backup bandwidth can be limited or unlimited or specific to a global pool, sub-pool, or non-specific any-pool. Backup with backup-bw in global-pool protects global-pool LSPs only; backup-bw in sub-pool protects sub-pool LSPs only.
Backup tunnels configured with limited backup bandwidth (from any/global/sub pool) are not assigned to protect LSPs configured with zero signaled bandwidth.
Backup bandwidth provides bandwidth protection for fast reroute (FRR). Bandwidth protection for FRR supports DiffServ-TE with two bandwidth pools (class-types).
Class-type 0 is strictly equivalent to global-pool; class-type 1 is strictly equivalent to sub-pool bandwidth using the Russian Doll Model (RDM).
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure backup tunnel 1 for use only by LSPs that take their bandwidth from the global pool (class-type 0 tunnels). Backup tunnel 1 does not provide bandwidth protection.
RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# backup-bw global-pool unlimited
or
RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# backup-bw unlimited class-type 0
In the following example, backup tunnel 2 is used by LSPs that take their bandwidth from the sub-pool (class-type 1 tunnels) only. Backup tunnel 2 provides bandwidth protection for up to 1000 units.
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 2 RP/0/RP0/CPU0:router(config-if)# backup-bw sub-pool 1000
or
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 2 RP/0/RP0/CPU0:router(config-if)# backup-bw 1000 class-type 1
Commands |
Description |
---|---|
Assigns one or more backup tunnels to a protected interface. |
|
Enables FRR protection for an MPLS-TE tunnel. |
|
Configures an MPLS-TE tunnel interface. |
To set an MPLS-TE tunnel to protect a physical interface against failure, use the backup-path tunnel-te command in MPLS-TE interface configuration mode. To return to the default behavior, use the no form of this command.
backup-path tunnel-te tunnel-number
no backup-path tunnel-te tunnel-number
tunnel-number |
Number of the tunnel protecting the interface. Range is 0 to 65535. |
No default behavior or values
MPLS-TE interface configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
When the protected interface is down (shut down or removed), the traffic it was carrying (for the other label switched paths [LSPs], referred to as the protected LSPs) is rerouted, using fast reroute (FRR) onto the backup tunnels.
The following guidelines pertain to the FRR process:
![]() Note | You must configure record-route on TE tunnels that are protected by multiple backup tunnels merging at a single node. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to protect PoS interface 0/7/0/0 using tunnel 100 and tunnel 150:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# interface POS 0/7/0/0 RP/0/RP0/CPU0:router(config-mpls-te-if)# backup-path tunnel-te 100 RP/0/RP0/CPU0:router(config-mpls-te-if)# backup-path tunnel-te 150
Command |
Description |
---|---|
Configures backup bandwidth for bandwidth protection. |
|
Enables FRR protection for an MPLS-TE tunnel. |
|
Enables MPLS-TE on an interface and enters MPLS-TE interface configuration mode. |
|
Enters MPLS-TE configuration mode. |
|
Displays information about MPLS-TE tunnels. |
To configure a bidirectional LSP for a MPLS TE tunnel and define other parameters for the LSP, use the bidirectional command in the MPLS-TE interface configuration mode.
bidirectional association { id value | source-address IP address | global-id value | type co-routed | fault-oam }
bidirectional |
Configures a bidirectional LSP. |
association |
Specifies association parameters for the bidirectional LSP. |
id value |
Value number that identifies the association. Range is 0 to 65535. |
source-address value |
Specifies the source IP address of the LSP from which a reverse path is required. |
global-id value |
Value number that identifies the global ID. Range is 0 to 4294967295. The default value is 0. |
co-routed |
Configures co-routed LSPs with bidirectional CSPF. |
fault-oam |
Configures fault OAM for the bidirectional co-routed LSPs. |
Tunnel interfaces are disabled.
Interface configuration mode
Release | Modification |
---|---|
Release 5.2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID | Operation |
---|---|
mpls-te |
read, write |
This example shows you how to configure an associated bidirectional co-routed MPLS-TE tunnel.
RP/0/RSP0/CPU0:router# configure RRP/0/RSP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RSP0/CPU0:router(config-if)# bidirectional RP/0/RSP0/CPU0:router(config-if-bidir)# association id 1 source-address 11.0.0.1 RP/0/RSP0/CPU0:router(config-if-bidir)#association type co-routed
To configure the minimum and maximum automatic bandwidth to be set on a tunnel, use the bw-limit command in MPLS-TE automatic bandwidth interface configuration mode. To disable this feature, use the no form of this command.
bw-limit min bandwidth { max bandwidth}
no bw-limit
min bandwidth |
Configures the minimum automatic bandwidth, in kbps, on a tunnel. The range is from 0 to 4294967295. The default is 0. |
max bandwidth |
Configures the maximum automatic bandwidth, in kbps, on a tunnel. The range is from 0 to 4294967295. The default is 4294967295. |
min: 0
max: 4294967295
MPLS-TE automatic bandwidth interface configuration
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
Release 5.0.0 | This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Both the min and max keywords must be configured.
The bw-limit command automatically sets the minimum bandwidth to the default value of 0, or the bw-limit command automatically sets the maximum to the default value of 4294967295 kbps.
If the value of the min keyword is greater than the max keyword, the bw-limit command is rejected. If you configure and modify the minimum or maximum bandwidth while the automatic bandwidth is already running, the next bandwidth application for that tunnel is impacted. For example, if the current tunnel requested bandwidth is 30 Mbps and the minimum bandwidth is modified to 50 Mbps, the next application sets the tunnel bandwidth to 50 Mbps.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure the minimum and maximum bandwidth for the tunnel:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# auto-bw RP/0/RP0/CPU0:router(config-if-tunte-autobw)# bw-limit min 30 max 80
Command |
Description |
---|---|
Configures the tunnel-bandwidth change threshold to trigger an adjustment. |
|
Configures the application frequency, in minutes, for the applicable tunnel. |
|
Configures automatic bandwidth on a tunnel interface and enters MPLS-TE automatic bandwidth interface configuration mode. |
|
Enables only the bandwidth collection without adjusting the automatic bandwidth. |
|
Configures an MPLS-TE tunnel interface. |
|
Configures tunnel overflow detection. |
|
Displays information about MPLS-TE tunnels. |
To enable stateful PCE capabilities, use the capabilities command in MPLS-TE stateful PCE configuration mode. To disable the stateful PCE capabilities, use the no form of this command.
capabilities { instantiation | update }
no capabilities { instantiation | update }
instantiation |
Enables stateful instantiate capability. |
update |
Enables stateful update capability. |
Stateful PCE capabilities are disabled.
MPLS-TE Stateful PCE
Release | Modification |
---|---|
Release 5.1.1 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
When the stateful-client configuration is added to the node, it will close all existing PCEP peer connections, and add the stateful capabilities TLV to the OPEN object it exchanges during PCEP session establishment.
When the stateful-client configuration is removed from the node, it will delete all PCE instantiated tunnels, close all existing PCEP connections, and no longer add the stateful capabilities TLV to the OPEN object it exchanges during PCEP session establishment.
Task ID | Operation |
---|---|
mpls-te |
read, write |
RP/0/RP0/CPU0:router#configure RP/0/RP0/CPU0:router(config)#mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)#pce stateful-client RP/0/RP0/CPU0:router(config-mpls-te-pce-stateful)#capabilities instantiation
RP/0/RP0/CPU0:router#configure RP/0/RP0/CPU0:router(config)#mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)#pce stateful-client RP/0/RP0/CPU0:router(config-mpls-te-pce-stateful)#capabilities update
To clear Link Management Protocol (LMP) management hello settings, use the clear mpls lmpcommand in EXEC mode.
clear mpls lmp
This command has no arguments or keywords.
EXEC
Release |
Modification |
---|---|
Release 3.3.0 |
This command was introduced |
Release 3.8.0 |
This command was moved under Cisco support. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
![]() Note | The LMP and GMPLS-NNI features are not supported on x86 RPs. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to clear all LMP management hello settings:
RP/0/RP0/CPU0:router# clear mpls lmp
To clear automatic bandwidth sampled output rates and to restart the application period for the specified tunnel, use the clear mpls traffic-eng auto-bw command in EXEC mode.
clear mpls traffic-eng auto-bw { all | internal | tunnel-te tunnel-number }
all |
Clears the automatic bandwidth sampled output rates for all tunnels. |
internal |
Clears all the automatic bandwidth internal data structures. |
tunnel-te tunnel-number |
Clears the automatic bandwidth sampled output rates for a specific tunnel. The tunnel-number argument is the tunnel ID used to clear the sampled output rates. |
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
If no tunnel is specified, the clear mpls traffic-eng auto-bw command clears all the automatic bandwidth enabled tunnels.
For each tunnel in which the automatic bandwidth adjustment is enabled, information is maintained about the sampled output rates and the time remaining until the next bandwidth adjustment. The application period is restarted and values such as the largest collected bandwidth get reset. The tunnel continues to use the current bandwidth until the next application.
Task ID |
Operations |
---|---|
mpls-te |
execute |
The following example displays the information for the automatic bandwidth for tunnel number 0 from the show mpls traffic-eng tunnels auto-bw brief command:
RP/0/RP0/CPU0:router# show mpls traffic-eng tunnels 0 auto-bw brief
Tunnel LSP Last appl Requested Signalled Highest Application
Name ID BW(kbps) BW(kbps) BW(kbps) BW(kbps) Time Left
-------------- ------ ---------- ---------- ---------- ---------- --------------
tunnel-te0 278 100 100 100 150 12m 38s
The following example shows how to clear the automatic bandwidth sampled output rates for tunnel number 0:
RP/0/RP0/CPU0:router# clear mpls traffic-eng auto-bw tunnel-te 0 RP/0/RP0/CPU0:router# show mpls traffic-eng tunnels 0 auto-bw brief Tunnel LSP Last appl Requested Signalled Highest Application Name ID BW(kbps) BW(kbps) BW(kbps) BW(kbps) Time Left -------------- ------ ---------- ---------- ---------- ---------- -------------- tunnel-te0 278 100 100 100 0 24m 0s
Command |
Description |
---|---|
Clears the automatic bandwidth configuration in a tunnel. |
|
Displays the list of automatic-bandwidth-enabled tunnels, and indicates if the current signaled bandwidth of the tunnel is identical to the bandwidth that is applied by the automatic bandwidth. |
To remove unused automatic backup tunnels, use the clear mpls traffic-eng auto-tunnel backup unused command in global configuration mode.
clear mpls traffic-eng auto-tunnel backup unused { all | tunnel-te tunnel-number }
all |
Clears all the unused automatic backup tunnels. |
tunnel-te tunnel-number |
Clears a specific unused automatic backup tunnel. |
No default behavior or values
EXEC
Release | Modification |
---|---|
Release 4.0.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The unused auto-tunnel backup tunnel is the tunnel that is not assigned to protect any FRR tunnel.
The behavior of this command is the same as the expiration of the timers removal unused command in which, when the timeout value is reached, the automatic backup tunnel is removed.
Task ID | Operation |
---|---|
mpls-te |
execute |
The following example displays the information for the unused backup automatic tunnels from the show mpls traffic-eng tunnels unused command:
RP/0/RP0/CPU0:router# show mpls traffic-eng tunnels unused
The following example shows how to clear the unused backup automatic tunnels:
RP/0/RP0/CPU0:router# clear mpls traffic-eng auto-tunnel backup unused all RP/0/RP0/CPU0:router# show mpls traffic-eng tunnels unused
Command | Description |
---|---|
show mpls traffic-eng tunnels | Displays information about MPLS-TE tunnels. |
To clear all unused auto-tunnel mesh destinations, use the clear mpls traffic-eng auto-tunnel meshcommand in EXEC mode.
clear mpls traffic-eng auto-tunnel mesh unused { all | tunnel-te }
all |
Clears all applicable unused auto-tunnel destinations. |
tunnel-te id |
Clears an unused auto-tunnel destinations identified by a tunnel identifier. |
None
EXEC
Release |
Modification |
---|---|
Release 4.1.1 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
mpls-te |
execute |
This is sample output from the clear mpls traffic-eng auto-tunnel mesh command:
clear mpls traffic-eng auto-tunnel mesh
To clear all auto-tunnel mesh counters, use the clear mpls traffic-eng counters auto-tunnel mesh command in EXEC mode.
clear mpls traffic-eng counters auto-tunnel mesh
This command has no arguments or keywords.
None
EXEC
Release |
Modification |
---|---|
Release 4.1.1 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
mpls-te |
execute |
This is sample output from the clear mpls traffic-eng counters auto-tunnel mesh command:
RP/0/RP0/CPU0:routerclear mpls traffic-eng counters auto-tunnel mesh
To clear MPLS-TE automatic tunnel backup counters, use the clear mpls traffic-eng counters auto-tunnel backup command in EXEC mode.
clear mpls traffic-eng counters auto-tunnel backup
This command has no arguments or keywords.
No default behavior or values
EXEC
Release | Modification |
---|---|
Release 4.0.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID | Operation |
---|---|
mpls-te |
execute |
The following example removes all counters for the automatic backup tunnels:
RP/0/RP0/CPU0:router# clear mpls traffic-eng counters auto-tunnel backup
Command | Description |
---|---|
show mpls traffic-eng counters auto-tunnel backup |
Displays the MPLS-TE automatic tunnel backup counters. |
Displays information about MPLS-TE tunnels. |
To clear the internal MPLS-TE tunnel counters, use the clear mpls traffic-eng counters global command in EXEC mode.
clear mpls traffic-eng counters global
This command has no arguments or keywords.
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
mpls-te |
execute |
The following example shows how to clear the internal MPLS-TE tunnel counters:
RP/0/RP0/CPU0:router# clear mpls traffic-eng counters global
To clear (set to zero) the MPLS tunnel signaling counters, use the clear mpls traffic-eng counters signaling command in EXEC mode.
clear mpls traffic-eng counters signaling { all | [ heads | mids | tails ] | name name | summary }
all |
Clears counters for all MPLS-TE tunnels. |
heads |
(Optional) Displays tunnels with their heads at this router. |
mids |
(Optional) Displays tunnels with their midpoints at this router. |
tails |
(Optional) Displays tunnels with their tails at this router. |
name name |
Clears counters for an MPLS-TE tunnel with the specified name. |
summary |
Clears the counter’s summary. |
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced as clear mpls traffic-eng counters tunnels. |
Release 3.5.0 |
Support was added for the middles keyword. |
Release 3.8.0 |
The clear mpls traffic-eng counters tunnels command was replaced by clear mpls traffic-eng counters signaling command. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Use the clear mpls traffic-eng counters signaling command to set all MPLS counters to zero so that changes can be seen easily.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to clear all counters:
RP/0/RP0/CPU0:router# clear mpls traffic-eng counters signaling all
Command |
Description |
---|---|
Displays tunnel signaling statistics. |
To clear (set to zero) the counters for soft-preemption statistics, use the clear mpls traffic-eng counters soft-preemption command in EXEC mode.
clear mpls traffic-eng counters { all | soft-preemption }
all |
Clears counters for all MPLS-TE tunnels. |
soft-preemption |
Clears the statistics for soft preemption counters. |
None
EXEC
Release |
Modification |
---|---|
Release 4.2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
When all counters are cleared using the clear mpls traffic-eng counters all command, the counters for soft-preemption statistics are automatically cleared.
Task ID |
Operations |
---|---|
mpls-te |
execute |
This example shows how to clear all counters:
RP/0/RP0/CPU0:router# clear mpls traffic-eng counters signaling all
Command |
Description |
---|---|
Displays tunnel signaling statistics. |
To clear the log of MPLS fast reroute (FRR) events, use the clear mpls traffic-eng fast-reroute log command in EXEC mode.
clear mpls traffic-eng fast-reroute log
This command has no arguments or keywords.
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows sample output before clearing the log of FRR events:
RP/0/RP0/CPU0:router# show mpls traffic-eng fast-reroute log Node Protected LSPs Rewrites When Switching Time Interface (usec) -------- --------- ----- -------- ---------------------- -------------- 0/0/CPU0 PO0/1/0/1 1 1 Feb 27 19:12:29.064000 147 0/1/CPU0 PO0/1/0/1 1 1 Feb 27 19:12:29.060093 165 0/2/CPU0 PO0/1/0/1 1 1 Feb 27 19:12:29.063814 129 0/3/CPU0 PO0/1/0/1 1 1 Feb 27 19:12:29.062861 128 RP/0/RP0/CPU0:router# clear mpls traffic-eng fast-reroute log
To clear all the MPLS-TE admission control statistics, use the clear mpls traffic-eng link-management statistics command in EXEC mode.
clear mpls traffic-eng link-management statistics
This command has no arguments or keywords.
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to clear all the MPLS-TE statistics for admission control:
RP/0/RP0/CPU0:router# clear mpls traffic-eng link-management statistics
To clear the path computation element (PCE) statistics, use the clear mpls traffic-eng pce command in EXEC mode.
clear mpls traffic-eng pce [ peer ipv4 address ]
peer |
(Optional) Clears the statistics for one peer. |
ipv4 address |
(Optional) Configures the IPv4 address for PCE. |
Clears statistics for all the PCE peers.
EXEC
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
mpls-te |
execute |
The following example shows how to clear the statistics for the PCE:
RP/0/RP0/CPU0:router# clear mpls traffic-eng pce
Command |
Description |
---|---|
Displays the status of the PCE peer address and state. |
To configure only the bandwidth collection without adjusting the bandwidth automatically, use the collect-bw-only command in MPLS-TE automatic bandwidth interface configuration mode. To disable this feature, use the no form of this command.
collect-bw-only
no collect-bw-only
This command has no arguments or keywords.
Bandwidth collection is either enabled or disabled.
MPLS-TE automatic bandwidth interface configuration
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
If you enable the collect-bw-only command while the automatic bandwidth is already running on a tunnel, the bandwidth application is disabled from that moment. Before you enable the actual bandwidth application, you can get the status of the automatic bandwidth behavior.
If you disable the collect-bw-only command on a tunnel from which the automatic bandwidth is already running, the actual bandwidth application takes place on the tunnel at the next application period.
It is also possible to manually activate a bandwidth application regardless of the collect bandwidth only flag that is being specified on a tunnel. To activate the bandwidth application, use the mpls traffic-eng auto-bw apply (MPLS-TE) command in EXEC mode.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to enable only the bandwidth collection without adjusting the automatic bandwidth:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# auto-bw RP/0/RP0/CPU0:router(config-if-tunte-autobw)# collect-bw-only
Command |
Description |
---|---|
Configures the tunnel-bandwidth change threshold to trigger an adjustment. |
|
Configures the application frequency, in minutes, for the applicable tunnel. |
|
Configures automatic bandwidth on a tunnel interface and enters MPLS-TE automatic bandwidth interface configuration mode. |
|
Configures the minimum and maximum automatic bandwidth to set on a tunnel. |
|
Configures an MPLS-TE tunnel interface. |
|
Configures tunnel overflow detection. |
|
Displays information about MPLS-TE tunnels. |
To configure the destination address of a TE tunnel, use the destination command in interface configuration mode. To return to the default behavior, use the no form of this command.
destination ip-address
no destination ip-address
ip-address |
Destination address of the MPLS-TE router ID. |
No default behavior or values
Interface configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
Release 3.9.0 |
The Point-to-Multipoint (P2MP) TE tunnel destination configuration was added. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
![]() Note | The tunnel destination address must be a unique MPLS-TE router ID; it cannot be an MPLS-TE link address on a node. |
Use the interface tunnel-mte command to configure destinations for the Point-to-Multipoint (P2MP) TE tunnel and to enter P2MP destination interface configuration mode. The maximum number of destinations, which are configured under P2MP tunnels, is 500.
For P2MP tunnels, the destination command acts as a configuration mode. The path-option command is under the destination for P2MP; whereas, it is under the tunnel-te interface configuration mode for P2P tunnels.
For Point-to-Point (P2P) tunnels, the destination command is used as a single-line command.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to set the destination address for tunnel-te1 to 10.10.10.10:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te1 RP/0/RP0/CPU0:router(config-if)# destination 10.10.10.10
The following example shows how to set the destination address for tunnel-mte 10 to 150.150.150.150:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-mte10 RP/0/RP0/CPU0:router(config-if)# destination 150.150.150.150 RP/0/RP0/CPU0:router(config-if-p2mp-dest)#
Command |
Description |
---|---|
Configures an MPLS-TE P2MP tunnel interface. |
|
Configures an MPLS-TE tunnel interface. |
|
Configures the primary or fallback path setup option for an P2MP TE tunnel. |
|
Displays information about MPLS-TE tunnels. |
To configure a bidirectional optical tunnel for GMPLS, use the direction command in interface tunnel-gte configuration mode. To return to the default behavior, use the no form of this command.
direction bidirectional
no direction bidirectional
bidirectional |
Enables bidirectional tunneling. |
Default is unidirectional.
Interface tunnel-gte configuration
Release |
Modification |
---|---|
Release 3.3.0 |
This command was introduced. |
Release 3.8.0 |
GMPLS interfaces were supported under the tunnel-gte interface type. |
Release 3.9.0 |
This command was removed. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
![]() Note | The LMP and GMPLS-NNI features are not supported on x86 RPs. |
There are two types of MPLS-TE tunnels:
At the configuration level, you cannot tell the difference between a packet MPLS or a GMPLS-TE tunnel. The packet TE tunnels are unidirectional, whereas GMPLS tunnels are bidirectional; therefore, you can identify the optical GMPLS tunnel by identifying the bidirectional configuration.
The GMPLS-TE tunnel requires that you specify the endpoint and transit switching capability so that the path computation module can determine the links that the tunnel can traverse.
The transit switching capability describes the switching capability of the LSP region that the tunnel crosses. The endpoint switching capability describes the switching capability and encoding required for the tunnel interface associated with the two ends of the bidirectional tunnel (namely, active, and passive side).
Finally, for GMPLS functionality to work, you must configure the direction and switching commands.
![]() Note | Bidirectional tunnel support is available on optical (GMPLS) tunnels only. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to change the tunnel direction from the default (unidirectional) to bidirectional:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-gte 99 RP/0/RP0/CPU0:router(config-if)# direction bidirectional
Command |
Description |
---|---|
Floods selected GMPLS Traffic Engineering links. |
|
Configures an MPLS-TE tunnel interface for GMPLS interfaces. |
|
Configures LMP IPCC management hello settings. |
|
Configures or matches active and passive tunnels. |
|
Configures passive GMPLS tunnels. |
|
Configures remote TE links. |
|
Configures TE-link switching attributes. |
To prevent the path from being used by MPLS-TE tunnels while it is configured, use the disable command in explicit path configuration mode. To return to the default behavior, use the no form of this command.
disable
no disable
This command has no arguments or keywords.
Explicit path is enabled.
Explicit path configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to disable explicit path 200:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# explicit-path identifier 200 RP/0/RP0/CPU0:router(config-expl-path)# disable
Command |
Description |
---|---|
Specifies the next IP address to exclude from the explicit path. |
|
Specifies path entries at a specific index. |
|
Displays the configured IP explicit paths. |
To disable the given destination for the Point-to-Multipoint (P2MP) tunnel interface, use the disable command in P2MP destination interface configuration mode. To return to the default behavior, use the no form of this command.
disable
no disable
This command has no arguments or keywords.
None
P2MP destination interface configuration
Release |
Modification |
---|---|
Release 3.9.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
If the disable command is not configured, the destination is enabled.
We recommend that you disable those destinations about which you have prior knowledge. This is because those destinations do not have valid MPLS-TE paths; therefore these destinations can be excluded from the P2MP tree computation.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to disable destination 140.140.140.140:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-mte 10 RP/0/RP0/CPU0:router(config-if)# destination 140.140.140.140 RP/0/RP0/CPU0:router(config-if-p2mp-dest)# disable
Command |
Description |
---|---|
Configures the destination address of a TE tunnel. |
|
Configures an MPLS-TE P2MP tunnel interface. |
To enable a specific bandwidth constraint model (Maximum Allocation Model or Russian Doll Model) on the entire label switched router (LSR), use the ds-te bc-model command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
ds-te bc-model mam
no ds-te bc-model mam
mam |
Enables the Maximum Allocation Model (MAM) bandwidth constraints model. |
RDM is the default bandwidth constraint model.
MPLS-TE configuration
Release |
Modification |
---|---|
Release 3.7.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
You can configure both the MAM and RDM bandwidth values on a single interface before swapping to an alternate global MPLS-TE BC model.
If you configure bandwidth constraints without configuring the corresponding bandwidth constraint values, the router uses default bandwidth constraint values.
MAM is not supported in prestandard DS-TE mode. MAM and RDM are supported in IETF DS-TE mode; RDM is supported in prestandard DS-TE mode.
![]() Note | Changing the bandwidth constraints model affects the entire router and may have a major impact on system performance as nonzero-bandwidth tunnels are torn down. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to enable the MAM bandwidth constraints model:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# ds-te bc-model mam
Command |
Description |
---|---|
Configures standard DS-TE mode. |
|
Enters DS-TE te-class map configuration mode. |
|
Enters MPLS-TE configuration mode. |
|
Displays the Diff-Serv TE-class map in use. |
To configure standard differentiated-service TE mode (DS-TE), use the ds-te mode command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
ds-te mode ietf
no ds-te mode ietf
ietf |
Enables IETF standard mode. |
Prestandard DS-TE is the default differentiated service mode.
MPLS-TE configuration
Release |
Modification |
---|---|
Release 3.3.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The following two DS-TE modes are supported:
Standard defined extensions are used for IGPs and RSVP signalling and DS-TE in this mode interoperates with third-party equipment.
IETF mode supports two bandwidth constraint models: the Russian Doll Model (RDM) and Maximum Allocation Model (MAM).
RDM is the default model.
Router advertises variable-length bandwidth constraints, max-reservable- bandwidth, and unreserved bandwidths in TE-classes.
tunnels must have valid class-type and priority configured as per TE-class map in use; otherwise, tunnels remain down.
TE-class map (a set of tunnel priority and class-type values) is enabled to interpret unreserved bandwidth values advertised in IGP; therefore, TE-class map must be identical on all nodes for TE tunnels to be successfully established
For DS-TE to function properly, DS-TE modes must be configured identically on all MPLS-TE nodes.
If you need to change the DS-TE mode, you must bring down all tunnel interfaces and after the change, you should flood the updated bandwidth values through the network.
![]() Note | Changing the DS-TE mode affects the entire LSR and can have a major impact on system performance when tunnels are torn down. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to enable IETF standard mode:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# ds-te mode ietf
Command |
Description |
---|---|
Enables a specific bandwidth constraint model (Maximum Allocation Model or Russian Doll Model) on the LSR. |
|
Configures MPLS DS-TE TE-class maps. |
|
Enters MPLS-TE configuration mode. |
|
Configures the router to assign new or more efficient backup MPLS-TE tunnels to protected MPLS-TE tunnels. |
|
Displays the Diff-Serv TE-class map in use. |
To enter DS-TE te-class map configuration mode, use the ds-te te-classes command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
ds-te te-classes te-class te_class_index { class-type class_type_number { priority pri_number } | unused }
no ds-te te-classes te-class te_class_index { class-type class_type_number { priority pri_number } | unused }
te-class |
Configures the te-class map. |
te_class_index |
TE class-map index. Range is 0 to 7. |
class-type |
Configures the class type. |
class_type_number |
Class type value in the te-class map. Range is 0 to 1. |
priority |
Configures the TE tunnel priority. |
pri_number |
TE tunnel priority value. Range is 0 to 7. |
unused |
Marks the TE-class as unused. |
The following default te-class maps are used in IETF DS-TE mode:
te-class index |
class-type |
priority |
---|---|---|
0 |
0 |
7 |
1 |
1 |
7 |
2 |
UNUSED |
— |
3 |
UNUSED |
— |
4 |
0 |
0 |
5 |
1 |
0 |
6 |
UNUSED |
— |
7 |
UNUSED |
— |
![]() Note | The default mapping has 4 TE-classes used with 2 class-types and, 4 TE-classes are unused. TE-class map is not used in prestandard DS-TE mode. |
MPLS-TE configuration
Release |
Modification |
---|---|
Release 3.3.0 |
This command was introduced. |
Release 3.8.0 |
The unused keyword was added. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
In IETF DS-TE mode, modified semantic of the unreserved bandwidth TLV is used. Each of the eight available bandwidth values advertised in the IGP corresponds to a TE class. Because IGP advertises only eight bandwidth values, only eight TE-Classes can be supported in a IETF DS-TE network. The TE-Class mapping must be configured the same way on every router in a DS-TE domain. There is, however, no method to automatically detect or enforce this required consistency.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure a TE-class 7 parameter:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# ds-te te-classes te-class 7 class-type 0 priority 4
Command |
Description |
---|---|
Enables a specific bandwidth constraint model (Maximum Allocation Model or Russian Doll Model) on the LSR. |
|
Configures standard DS-TE mode. |
|
Enters MPLS-TE configuration mode. |
|
Displays the Diff-Serv TE-class map in use. |
To specify that automatic backup tunnels should avoid Shared Risk Link Groups (SRLGs) of protected interface, use the exclude srlg command in auto-tunnel backup configuration mode. To disable this feature, use the no form of this command.
exclude srlg [preferred]
no exclude srlg [preferred]
preferred |
(Optional) Causes the backup tunnel to avoid SRLGs of its protected interface(s); however, the backup tunnel is created if SRLGs are not avoided. |
Strict SRLG
Auto-tunnel backup configuration
Release | Modification |
---|---|
Release 4.0.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Strict SRLG configuration of this command means that the path computed for the backup tunnel that is automatically created, must not contain any links that are part of the excluded SRLG groups. If such a path cannot be found, the backup tunnel does not come up.
Configuration of the preferred option allows the automatic backup tunnel to come up even if a path that excludes SRLGs can not be found.
Task ID | Operation |
---|---|
mpls-te |
read, write |
In the following example, automatic backup tunnels must avoid SRLGs of the protected interface.
RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# interface pos 0/1/0/1 RP/0/RP0/CPU0:router(config-mpls-te-if)# auto-tunnel backup RP/0/RP0/CPU0:router(config-mpls-te-if-auto-backup)# exclude srlg preferred
Command |
Description |
---|---|
Builds automatic next-hop and next-next-hop tunnels, and enters auto-tunnel configuration mode. |
To enable fast-reroute (FRR) protection for an MPLS-TE tunnel, use the fast-reroute command in interface configuration mode. To return to the default behavior, use the no form of this command.
fast-reroute
no fast-reroute
This command has no arguments or keywords.
FRR is disabled.
Interface configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
When a protected link used by the fast-reroutable label switched path (LSP) fails, the traffic is rerouted to a previously assigned backup tunnel. Configuring FRR on the tunnel informs all the nodes that the LSP is traversing that this LSP desires link/node/bandwidth protection.
You must allow sufficient time after an RP switchover before triggering FRR on standby RPs to synchronize with the active RP (verified using the show redundancy command). All TE tunnels must be in the recovered state and the database must be in the ready state for all ingress and egress line cards. To verify this information, use the show mpls traffic-eng tunnels and show mpls traffic-eng fast-reroute database commands.
![]() Note | Wait approximately 60 seconds before triggering FRR after verifying the database state. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to enable FRR on an MPLS-TE tunnel:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# fast-reroute
Command |
Description |
---|---|
Configures node and bandwidth protection for an MPLS-TE tunnel. |
|
Configures an MPLS-TE tunnel interface. |
|
Displays the contents of the FRR database. |
|
Displays information about MPLS-TE tunnels. |
To enable node and bandwidth protection for an MPLS-TE tunnel, use the fast-reroute protect command in interface configuration mode. To return to the default behavior, use the no form of this command.
fast-reroute protect { bandwidth | node }
no fast-reroute protect
bandwidth |
Enables bandwidth protection request. |
node |
Enables node protection request. |
FRR is disabled.
Interface configuration
Release |
Modification |
---|---|
Release 3.6.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to enable bandwidth protection for a specified TE tunnel:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)#interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# fast-reroute protect bandwidth
Command |
Description |
---|---|
Enables FRR protection for an MPLS-TE tunnel. |
|
Configures an MPLS-TE tunnel interface. |
|
Displays information about MPLS-TE tunnels. |
To configure how often the router considers switching a protected MPLS-TE tunnel to a new backup tunnel if additional backup-bandwidth or a better backup tunnel becomes available, use the fast-reroute timers promotion command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
fast-reroute timers promotion interval
no fast-reroute timers promotion
interval |
Interval, in seconds, between scans to determine if a label switched path (LSP) should use a new, better backup tunnel. Range is 0 to 604800. A value of 0 disables backup tunnel promotions. |
interval: 300
MPLS-TE configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Setting the interval to a low value puts more load on the CPU because it has to scan all protected LSPs more frequently. It is not recommended that the timer be configured below the default value of 300 seconds.
Pacing mechanisms have been implemented to distribute the load on the CPU when backup promotion is active. Because of this, when a large number of protected LSPs are promoted, some delay is noticeable in backup promotion. If the promotion timer is configured to a very low value (depending on the number of protected LSPs) some protected LSPs may never get promoted.
To disable the timer, set the value to zero.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to specify that LSPs are scanned every 600 seconds (10 minutes) to determine if they should be promoted to a better backup tunnel:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# fast-reroute timers promotion 600
Command |
Description |
---|---|
Enters MPLS-TE configuration mode. |
|
Configures the router to use a new or more efficient backup MPLS-TE tunnel when a current tunnel is overloaded. |
To flood the GMPLS Traffic Engineering link into a specific OSPF area and instance, use the flooding-igp command in MPLS-TE interface configuration mode. To return to the default behavior, use the no form of this command.
flooding-igp ospf instance area area
no flooding-igp ospf instance area area
ospf |
Floods the interface into an OSPF instance |
instance |
Name of the OSPF instance into which the GMPLS link is to be flooded. |
area area |
Displays the area into which the GMPLS link is to be flooded (where TE is configured). |
No default behavior or values
MPLS-TE interface configuration
Release |
Modification |
---|---|
Release 3.3.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
![]() Note | The LMP and GMPLS-NNI features are not supported on x86 RPs. |
A GMPLS link won't be flooded into any IGP topology unless this command is used.
![]() Note | The flooding-igp command is valid for GMPLS-TE only. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to flood the optical GMPLS link on POS 0/1/0/0 into area 0 of OSPF instance “optical”:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# interface pos0/1/0/0 RP/0/RP0/CPU0:router(config-mpls-te-if)# flooding-igp ospf optical area 0
Command |
Description |
---|---|
Configures bidirectional optical tunnels. |
|
Enables MPLS-TE on an interface and enters MPLS-TE interface configuration mode. |
|
Configures LMP IPCC management hello settings. |
|
Configures or matches active and passive tunnels. |
|
Enters MPLS-TE configuration mode. |
|
Configures passive GMPLS tunnels. |
|
Configures remote TE links. |
|
Configures TE-link switching attributes. |
To set the reserved bandwidth thresholds for a link as a percentage of the total bandwidth change, use the flooding threshold command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
flooding threshold { up | down } percent
no flooding thresholds { up | down } percent
up |
Configures the upward flooding threshold as a percentage of the total link bandwidth change. |
down |
Configures the downward flooding threshold as a percentage of the total link bandwidth change. |
percent |
Bandwidth threshold level. Range is 0 to 100 . |
No default behavior or values.
MPLS-TE configuration
Release |
Modification |
---|---|
Release 5.3.4 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Use the flooding threshold command to set the up and down thresholds as a percentage of the total bandwidth change. If the flooding threshold command is configured, flooding occurs only if the change from the previous flooding is greater than the configured thresholds.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to set the reserved bandwidth thresholds as a percentage of the total bandwidth change. Flooding occurs only if the change from the previous flooding is greater than the configured thresholds. In this example, the up and down thresholds are configured as 10 percent. That means, if the last flooded bandwidth percentage is 50 percent, then the flooding occurs only if the bandwidth goes below 40 percent, or if the bandwidth goes above 60 percent.
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# flooding threshold up 10 down 10
To set the reserved bandwidth thresholds for a link, use the flooding thresholds command in MPLS-TE interface configuration mode. To return to the default behavior, use the no form of this command.
flooding thresholds { down | up } percent [ percent1 | percent2 | percent3 | ... percent 15 ]
no flooding thresholds { down | up }
down |
Configures the threshold for decreased resource availability. |
up |
Configures the threshold for increased resource availability. |
percent [ percent ] |
Bandwidth threshold level. Range is 0 to 100 for all 16 levels. |
down: 100, 99, 98, 97, 96, 95, 90, 85 , 80, 75 , 60, 45, 30, 15
up: 5, 30, 45, 60, 75, 80, 85, 90, 95, 97 , 98, 99, 100
MPLS-TE interface configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
You can configure up to 16 flooding threshold values. The first value is mandatory; the next 15 are optional.
When a threshold is crossed, MPLS-TE link management advertises updated link information. If no thresholds are crossed, changes can be flooded periodically unless periodic flooding was disabled.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to set the reserved bandwidth threshold for the link for decreased resource availability (down) and for increased resource availability (up) thresholds:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# interface POS 0/7/0/0 RP/0/RP0/CPU0:router(config-mpls-te-if)# flooding thresholds down 100 75 25 RP/0/RP0/CPU0:router(config-mpls-te-if)# flooding thresholds up 25 50 100
Command |
Description |
---|---|
Enables MPLS-TE on an interface and enters MPLS-TE interface configuration mode. |
|
Enters MPLS-TE configuration mode. |
|
Sets the length of the interval used for periodic flooding. |
|
Displays local link information currently being flooded by MPLS-TE link management into the global TE topology. |
|
Displays current local link information. |
To configure an MPLS-TE forwarding adjacency, use the forwarding-adjacency command in interface configuration mode. By configuring forwarding adjacency, the MPLS-TE tunnels are considered to be links by the IGP. If no forwarding adjacency is to be defined, use the no form of this command.
forwarding-adjacency [ holdtime time ] [ include-ipv6 ]
no forwarding-adjacency [ holdtime time ] [ include-ipv6 ]
holdtime time |
(Optional) Configures the hold time value, in milliseconds, that is associated with each forwarding-adjacency LSP. The hold time is the duration after which the state change of LSP is advertised to IGP. The default value is 0. |
include-ipv6 |
(Optional) Announces the MPLS-TE tunnel as an IPv6 forwarding adjacency. |
holdtime time: 0
Interface configuration
Release |
Modification |
---|---|
Release 3.4.0 |
This command was introduced. |
Release 5.1.1 |
The include-ipv6 keyword was added to support IPv6 forwarding adjacency announcements. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
If you do not specify a holdtime time value, a delay is introduced with the following results:
The paths that traffic is taking to the destination can be manipulated by adjusting the forwarding adjacency link metric. To do that, use the bandwidth command. The unit of possible bandwidth values is in kbps.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
This example shows how to configure forwarding adjacency with a holdtime value of 60 milliseconds:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 888 RP/0/RP0/CPU0:router(config-if)# forwarding-adjacency holdtime 60
RP/0/RP0/CPU0:router#configure RP/0/RP0/CPU0:router(config)#interface tunnel-te 65534 RP/0/RP0/CPU0:router(config-if)#forwarding-adjacency RP/0/RP0/CPU0:router(config-if-tunte-fwdadj)#include-ipv6
Command |
Description |
---|---|
Configures RSVP bandwidth on an interface using prestandard DS-TE mode. |
|
Configures an MPLS-TE tunnel interface. |
|
Displays forwarding-adjacency information. |
To exclude an address from a tunnel path entry at a specific index, use the index exclude-address command in explicit path configuration mode. To return to the default behavior, use the no form of this command.
index index-id exclude-address{ ipv4 unicast IP address}
no index index-id
index-id |
Index number at which the path entry is inserted or modified. Range is 1 to 65535. |
ipv4 unicast IP address |
Excludes the IPv4 unicast address. |
No default behavior or values
Explicit path configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
Release 3.2 |
Support for the ipv4 unicast keyword was added. |
Release 3.4.0 |
The index (explicit path) command was modified to create two separate commands: index exclude-address and index next-address. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
You cannot include or exclude addresses from an IP explicit path unless explicitly configured using the exclude-address keyword.
Use the exclude-addresskeyword only after entering the explicit path configuration mode.
If you use the exclude-address keyword and specify the IP address of a link, the constraint-based routine does not consider that link when it sets up MPLS-TE paths. If the excluded address is a flooded MPLS-TE router ID, the constraint-based shortest path first (SPF) routine does not consider that entire node.
![]() Note | The person who performs the configuration must know the IDs of the routers, as it may not be apparent if the value refers to the link or to the node. |
MPLS-TE accepts IP explicit paths composed of all excluded addresses configured using the exclude-address keyword.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to exclude address 192.168.3.2 at index 3 of the explicit path 200:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# explicit-path identifier 200 RP/0/RP0/CPU0:router(config-expl-path)# index 3 exclude-address ipv4 unicast 192.168.3.2
Command |
Description |
---|---|
Specifies path entries at a specific index. |
|
Displays the configured IP explicit paths. |
To exclude an address to get SRLGs from a tunnel path entry at a specific index, use the index exclude-srlg command in explicit path configuration mode. To return to the default behavior, use the no form of this command.
index index-id exclude-srlg ipv4 unicast IP address
no index index-id
index-id |
Index number at which the path entry is inserted or modified. Range is 1 to 65535. |
exclude-srlg | Specifies an IP address to get SRLG values from for exclusion. |
ipv4 unicast IP address |
Excludes the IPv4 unicast address. |
No default behavior or values
Explicit path configuration
Release | Modification |
---|---|
Release 4.0.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID | Operation |
---|---|
mpls-te |
read, write |
The following example shows how to exclude the SRLG values from the IP address 192.168.3.2 at index 1 of the explicit path 100:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# explicit-path identifier 100 RP/0/RP0/CPU0:router(config-expl-path)# index 1 exclude-srlg ipv4 unicast 192.168.3.2
To include a path entry at a specific index, use the index next-address command in explicit path configuration mode. To return to the default behavior, use the no form of this command.
index index-id next-address [ loose | strict ] ipv4 unicast IP-address
no index index-id
index-id |
Index number at which the path entry is inserted or modified. Range is 1 to 65535. |
ipv4 unicast IP-address |
Includes the IPv4 unicast address (strict address). |
loose ipv4 unicast IP-address |
(Optional) Specifies the next unicast address in the path as a loose hop. |
strict ipv4 unicast IP-address |
(Optional) Specifies the next unicast address in the path as a strict hop. |
No default behavior or values
Explicit path configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
Release 3.2 |
Support for the ipv4 unicast keyword was added. |
Release 3.4.0 |
The index (explicit path) command was added to create two separate commands: index exclude-address and index next-address. Support was added for loose and strict keywords for the index next-address command. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
You cannot include addresses from an IP explicit path unless explicitly configured using the next-address keyword.
Use the next-address keyword only after entering the explicit path configuration mode.
![]() Note | The person who performs the configuration must know the IDs of the routers, as it may not be apparent if the value refers to the link or to the node. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to insert the next-address 192.168.3.2 at index 3 of the explicit path 200:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# explicit-path identifier 200 RP/0/RP0/CPU0:router(config-expl-path)# index 3 next-address ipv4 unicast 192.168.3.2
Command |
Description |
---|---|
Specifies the next IP address to exclude from the explicit path. |
|
Displays the configured IP explicit paths. |
To enable MPLS-TE on an interface and to enter MPLS-TE interface configuration mode, use the interface command in global configuration mode. To return to the default behavior, use the no form of this command.
interface type interface-path-id
no interface type interface-path-id
type |
Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
No default behavior or values
Global configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
You must enter MPLS-TE interface mode to configure specific interface parameters on physical interfaces.
Configuring MPLS-TE links or a tunnel TE interface begins the TE-control process on RP.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to enter the MPLS-TE interface configuration mode:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# interface POS 0/7/0/1
The following example shows how to remove an interface from the MPLS-TE domain:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# no interface POS 0/7/0/1
To enable Shared Risk Link Groups (SRLGs) on an interface and to enter SRLG interface configuration mode, use the interface command in SRLG configuration mode. To return to the previous configuration mode, use the no form of this command.
interface type interface-path-id
no interface type interface-path-id
type |
Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or virtual interface.
|
No default behavior or values
SRLG configuration
Release | Modification |
---|---|
Release 4.0.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID | Operation |
---|---|
mpls-te |
read, write |
The following example shows how to enter SRLG interface configuration mode:
RP/0/RP0/CPU0:router(config)# srlg RP/0/RP0/CPU0:router(config-srlg)# interface POS 0/1/0/1 RP/0/RP0/CPU0:router(config-srlg-if)# value 10 RP/0/RP0/CPU0:router(config-srlg-if)#value 50
Command |
Description |
---|---|
Enables MPLS-TE on an interface and enters MPLS-TE interface configuration mode. |
|
Enters MPLS-TE configuration mode. |
To configure an MPLS-TE tunnel interface for GMPLS interfaces, use the interface tunnel-gte command in global configuration mode. To return to the default behavior, use the no form of this command.
interface tunnel-gte tunnel-id
no interface tunnel-gte tunnel-id
tunnel-id |
Tunnel number. Range is 0 to 65535. |
Tunnel interfaces are disabled.
Global configuration
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced . |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
![]() Note | The LMP and GMPLS-NNI features are not supported on x86 RPs. |
You cannot have two tunnels using the same encapsulation mode with exactly the same source and destination address. The workaround is to create a loopback interface and use the loopback interface address as the source address of the tunnel.
Configuring MPLS-TE links or a tunnel TE interface begins the TE-control process on RP.
The interface tunnel-gte command indicates that the tunnel interface is for an MPLS-TE tunnel and enables the various tunnel MPLS-TE GMPLS tunnel interface options.
Task ID |
Operations |
---|---|
interface |
read, write |
The following example shows how to configure tunnel-gte interface 1:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-gte 1
Command |
Description |
---|---|
Matches an active tunnel to a passive tunnel. |
|
Configures passive GMPLS tunnels. |
|
Specifies the switching capability and encoding types for all endpoint TE links used to signal the optical tunnel that is mandatory to set up the GMPLS LSP. |
|
Specifies the switching capability and encoding types for all transit TE links used to signal the optical tunnel to configure an optical LSP. |
To configure an MPLS-TE P2MP tunnel interface, use the interface tunnel-mte command in global configuration mode. To return to the default behavior, use the no form of this command.
interface tunnel-mte tunnel-id
no interface tunnel-mte tunnel-id
tunnel-id |
Tunnel number. Range is from 0 to 65535. |
Tunnel interfaces are disabled.
Global configuration
Release |
Modification |
---|---|
Release 3.9.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Configuring MPLS-TE links or tunnel-te, tunnel-gte, or tunnel-mte interfaces begins the TE-control process on route processor (RP).
The interface tunnel-mte command indicates that the tunnel interface is for an MPLS-TE P2MP tunnel and enables these MPLS-TE P2MP configuration options.
![]() Note | You must configure record-route on TE tunnels that are protected by multiple backup tunnels merging at a single node. |
To use the P2MP tunnels, you must configure a Loopback address and use the ipv4 unnumbered command for the Loopback interface type.
Task ID |
Operations |
---|---|
interface |
read, write |
This example shows how to configure tunnel interface 1:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-mte 1 RP/0/RP0/CPU0:router(config-if)# ipv4 unnumbered loopback0
Command |
Description |
---|---|
Configures affinity (the properties that the tunnel requires in its links) for an MPLS-TE tunnel. |
|
Configures backup bandwidth for FRR. |
|
Enables FRR protection for an MPLS-TE tunnel. |
|
Configures a path selection metric—TE or IGP. |
|
Configures setup and reservation priority for an MPLS-TE tunnel. |
|
Configures record-route on an MPLS-TE tunnel. |
|
Configures the bandwidth required for an MPLS-TE tunnel. |
|
Configures the name of the tunnel required for an MPLS-TE tunnel. |
To configure an MPLS-TE tunnel interface, use the interface tunnel-te command in Global Configuration mode. To return to the default behavior, use the no form of this command.
interface tunnel-te tunnel-id
no interface tunnel-te tunnel-id
tunnel-id |
Tunnel number. Range is 0 to 65535. |
Tunnel interfaces are disabled.
Global configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
Release 3.7.0 |
Policy-based tunnel selection example was added. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
You cannot have two tunnels using the same encapsulation mode with exactly the same source and destination address. The workaround is to create a loopback interface and to use the loopback interface address as the source address of the tunnel.
Configuring MPLS-TE links or Tunnel-TE interface begins the TE-control process on RP.
The interface tunnel-te command indicates that the tunnel interface is for an MPLS-TE tunnel and enables the various tunnel MPLS configuration options.
![]() Note | You must configure record-route on TE tunnels that are protected by multiple backup tunnels merging at a single node. |
Task ID |
Operations |
---|---|
interface |
read, write |
The following example shows how to configure tunnel interface 1:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# ipv4 unnumbered loopback0
The following example shows how to set the tunnel-class attribute to map the correct traffic class to the tunnel:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# policy-class 1
Command |
Description |
---|---|
Configures affinity (the properties that the tunnel requires in its links) for an MPLS-TE tunnel. |
|
Instructs the IGP to use the tunnel in its enhanced SPF calculation, if the tunnel is in an up state. |
|
Configures backup bandwidth for FRR. |
|
Enables FRR protection for an MPLS-TE tunnel. |
|
Configures a path option for an MPLS tunnel. |
|
Configures a path selection metric—TE or IGP. |
|
policy-class |
Configures PBTS to direct traffic into specific TE tunnels. |
Configures setup and reservation priority for an MPLS-TE tunnel. |
|
Configures record-route on an MPLS-TE tunnel. |
To configure an interface-bound IP based control channel to a specific LMP neighbor with the option to specify a custom destination address that is useful for GigabitEthernet interfaces, use the ipcc interface command in MPLS-TE neighbor configuration mode. To disable this feature, use the no form of this command.
ipcc interface type interface-path-id [ dest ipv4 address ]
no ipcc interface type interface-path-id [ dest ipv4 address ]
type |
Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
||
dest |
(Optional) Configures the remote endpoint address. |
||
ipv4 address |
(Optional) Configures the IPv4 address. |
No default behavior or values
MPLS-TE neighbor configuration
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure the IPCC interface for Loopback0:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# lmp neighbor OXC1 RP/0/RP0/CPU0:router(config-mpls-te-nbr-OXC1)# ipcc interface Loopback0
Command |
Description |
---|---|
Configures an IPCC that is routable. |
|
Configures or updates an LMP neighbor and its associated parameters and enters MPLS-TE neighbor configuration mode. |
|
Enters MPLS-TE configuration mode. |
|
Displays information about the LMP. |
To configure a routed IP-based control channel for a specific LMP neighbor, use the ipcc routed command in MPLS-TE neighbor configuration mode. To return to the default behavior, use the no form of this command.
ipcc routed
no ipcc routed
This command has no arguments or keywords.
No default behavior or values
MPLS-TE neighbor configuration
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure a routed IPCC for neighbor router1 in which the destination IP address is the node ID of the neighbor router1 on an interface determined dynamically by an IP routing protocol:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# lmp neighbor router1 RP/0/RP0/CPU0:router(config-mpls-te-nbr-router1)# ipcc routed
Command |
Description |
---|---|
Configures an IPCC. |
|
Configures or updates an LMP neighbor and its associated parameters and enters MPLS-TE neighbor configuration mode. |
|
Enters MPLS-TE configuration mode. |
|
Displays information about the LMP. |
To specify the MPLS-TE tunnel Internet Protocol Version 4 (IPv4) address, use the ipv4 unnumbered command in interface configuration mode. To return to the default behavior, use the no form of this command.
ipv4 unnumbered type interface-path-id
no ipv4 unnumbered type interface-path-id
type |
Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
No IP address is set.
Interface configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Tunnel-te is not signaled until an IP address is configured on the tunnel interface; therefore, the tunnel state stays down without IP address configuration.
Loopback is commonly used as the interface type.
Task ID |
Operations |
---|---|
network |
read, write |
The following example shows how to configure the MPLS-TE tunnel to use the IPv4 address used on loopback interface 0:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# ipv4 unnumbered loopback0
To specify the Internet Protocol Version 4 (IPv4) address, use the ipv4 unnumbered mpls traffic-eng command in global configuration mode. To remove the IPv4 address, use the no form of this command.
ipv4 unnumbered mpls traffic-eng interface-path-id
no ipv4 unnumbered mpls traffic-eng
interface-path-id |
Physical interface or virtual interface.
|
No default behavior or values.
Global configuration.
Release |
Modification |
---|---|
Release 4.0.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
network |
read, write |
The following example shows how to specify unnumbered IPv4 address for a GigabitEthernet interface:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# ipv4 unnumbered mpls traffic-eng GigabitEthernet 0/1/0/1
The following example shows how to specify unnumbered IPv4 address for an MPLS-TE tunnel with tunnel ID 200:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# ipv4 unnumbered mpls traffic-eng tunnel-te 200
Command |
Description |
---|---|
Specifies the MPLS-TE tunnel Internet Protocol Version 4 (IPv4) address |
To set the length of time that bandwidth is held for a Resource Reservation Protocol (RSVP) Path (setup) message to wait for the corresponding RSVP Resv message to return, use the link-management timers bandwidth-hold command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
link-management timers bandwidth-hold holdtime
no link-management timers bandwidth-hold holdtime
holdtime |
Number of seconds that bandwidth can be held. Range is 1 to 300. Default is 15. |
holdtime: 15
MPLS-TE configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The link-management timers bandwidth-hold command determines the time allowed for an RSVP message to return from a neighbor RSVP node.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to set the bandwidth to be held for 10 seconds:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# link-management timers bandwidth-hold 10
Command |
Description |
---|---|
Sets the length of the interval used for periodic flooding. |
|
Enters MPLS-TE configuration mode. |
|
Displays current local link information and bandwidth hold time. |
To set the length of the interval for periodic flooding, use the link-management timers periodic-flooding command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
link-management timers periodic-flooding interval
no link-management timers periodic-flooding
interval |
Length of the interval, in seconds, for periodic flooding. Range is 0 to 3600. A value of 0 turns off periodic flooding. The minimum value is 30. |
interval: 180
MPLS-TE configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The link-management timers periodic-flooding command advertises the link state information changes that do not trigger immediate action, such as a change to the allocated bandwidth that does not cross a threshold.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to set the interval length for periodic flooding to 120 seconds:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# link-management timers periodic-flooding 120
Command |
Description |
---|---|
Sets the reserved bandwidth flooding thresholds for a link. |
|
Sets the length of time that bandwidth is held for a RSVP Path (setup) message to wait for the corresponding RSVP Resv message to return. |
|
Enters MPLS-TE configuration mode. |
|
Displays the current periodic flooding interval. |
To set the length of the interval for delaying LSP preemption, use the link-management timers preemption-delay command in MPLS-TE configuration mode. To disable this behavior, use the no form of this command.
link-management timers preemption-delay bundle-capacity sec
bundle-capacity sec |
Specifies the bundle-capacity preemption timer value in seconds. |
None
MPLS-TE configuration
Release | Modification |
---|---|
Release 4.2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The value 0 as bundle-capacity value in the link-management timers preemption-delay command disables this timer. This means there is no delay before preemption sets in when the bundle capacity goes down.
Task ID | Operation |
---|---|
mpls-te |
read, write |
This example shows how to set the interval length for preemption-delay:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# link-management timers preemption-delay bundle-capacity 180
To determine load-sharing balancing parameters for a specified interface, use the load-share command in interface configuration mode. To return to the default behavior, use the no form of this command.
load-share value
no load-share
value |
Load-share value, equivalent to the bandwidth in kbps (that is, the same value in configuration). Range is 1 to 4294967295. Default is 0. |
The default load-share for tunnels with no explicit configuration is the configured signalled bandwidth.
value: 0 (if no value is assigned)
Interface configuration
Release |
Modification |
---|---|
Release 3.5.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Configuration schemas are supported for load balancing.
To enable the load-share command, you must enable unequal load balancing using the load-share unequal command.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure load-sharing parameters on a specified interface:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 100 RP/0/RP0/CPU0:router(config-if)# load-share 100
Command |
Description |
---|---|
Enables unequal load-sharing. |
|
Configures an MPLS-TE tunnel interface. |
|
Configures the bandwidth required for an MPLS-TE tunnel. |
To configure unequal load-sharing for an MPLS-TE tunnel, use the load-share unequal command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
load-share unequal
no load-share unequal
This command has no arguments or keywords.
By default, unequal load-balancing is disabled and equal load-balancing occurs.
MPLS-TE configuration
Release |
Modification |
---|---|
Release 3.5.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The auto-bw and load-share unequal commands should not be used together.
The load-share unequal command determines the load-share for a tunnel based on the bandwidth. However, the MPLS-TE automatic bandwidth feature changes the bandwidth around. If you are configuring both the load-share unequal command and the MPLS-TE automatic bandwidth feature, we recommend that you specify an explicit load-share value configuration under each MPLS-TE automatic bandwidth tunnel.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to enable unequal load-sharing:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# load-share unequal
Command |
Description |
---|---|
Configures load-sharing balancing parameters for a specified interface. |
|
Enters MPLS-TE configuration mode. |
|
Configures the bandwidth required for an MPLS-TE tunnel. |
To configure Link Management Protocol (LMP) IPCC management hello settings, use the lmp hello command in global MPLS-TE neighbor lmp configuration mode. To return to the default behavior, use the no form of this command.
lmp hello hello-send -interval hello-dead-interval
no lmp hello hello-send-interval hello-dead-interval
hello-send-interval |
Time, in milliseconds, between sending hello keep alive message. Range is 100 to 21845. |
hello-dead-interval |
Time, in milliseconds, to wait without receiving a hello from the neighbor before declaring the IPCC down again. Range is 100 to 21845. |
No default behavior or values
MPLS-TE neighbor lmp configuration mode
Release |
Modification |
---|---|
Release 3.3.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
You can disable hellos using the lmp static command.
![]() Note | The LMP and GMPLS-NNI features are not supported on x86 RPs. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure Link Management Protocol (LMP) IPCC management hello settings:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# lmp neighbor lmp RP/0/RP0/CPU0:router(config-mpls-te-nbr-lmp)# lmp hello 400 1200
Command |
Description |
---|---|
Configures bidirectional optical tunnels. |
|
Configures or updates an LMP neighbor and its associated parameters and enters MPLS-TE neighbor configuration mode. |
|
Configures or matches active and passive tunnels. |
|
Enters MPLS-TE configuration mode. |
|
Configures passive GMPLS tunnels. |
|
Configures remote TE links. |
|
Configures TE-link switching attributes. |
To configure or update an LMP neighbor with its associated identifier and enter MPLS-TE neighbor configuration mode, use the lmp neighbor command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
lmp neighbor name
no lmp neighbor name
name |
Text string representing the name of the LMP neighbor. |
No default behavior or values
MPLS-TE configuration
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
![]() Note | The LMP and GMPLS-NNI features are not supported on x86 RPs. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to enter MPLS-TE neighbor configuration mode for router1:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# lmp neighbor router1 RP/0/RP0/CPU0:router(config-mpls-te-nbr-router1)#
Command |
Description |
---|---|
Configures LMP management hello settings. |
|
Enters MPLS-TE configuration mode. |
|
Displays information about the LMP. |
To configure the router ID for the optical instance using the LMP protocol, use the lmp router-id command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
lmp router-id { ipv4 address | type interface-path-id }
no lmp router-id { ipv4 address | type interface-path-id }
ipv4 address |
Router ID expressed as an IPv4 address. |
||
type |
Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
No default behavior or values
MPLS-TE configuration
Release |
Modification |
---|---|
Release 3.3.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
![]() Note | The LMP and GMPLS-NNI features are not supported on x86 RPs. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how configure the LMP router ID for IPv4 address 172.24.20.164:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# lmp router-id router 127.0.0.1
Command |
Description |
---|---|
Clears LMP management hello settings. |
|
Enters MPLS-TE configuration mode. |
To enable the logging events so that the software sends a log message when a tunnel goes up or goes down, use the logging events link-status command in tunnel-mte interface configuration mode. To disable this feature, use the no form of this command.
logging events link-status
nologging events link-status
This command has no arguments or keywords.
By default, no logs are sent out.
Tunnel-mte interface configuration
Release | Modification |
---|---|
Release 3.9.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The logging events link-statuscommand enables the configuration to be notified of tunnel state changes through log messages.
In addition, the logging events link-status command applies to both tunnel-mte and tunnel-te interfaces.
Task ID | Operation |
---|---|
interface |
read, write |
The following example shows how to enable logging events for the interface and line-protocol state change alarms:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-mte 10 RP/0/RP0/CPU0:router(config-if)# logging events link-status
Command |
Description |
---|---|
Configures an MPLS-TE P2MP tunnel interface |
|
Sends out a log message when LSP events occur. |
|
Sends out a log message when a point-to-multipoint sub-lsp goes up or goes down when the software is enabled. |
To send out a log message when LSP events occur, use the logging events lsp-status command in tunnel-mte interface configuration mode. To disable this feature, use the no form of this command.
logging events lsp-status { reoptimize | reroute | state | switchover }
nologging events lsp-status { reoptimize | reroute | state | switchover }
reoptimize |
Sends out the log message when the tunnel LSP is reoptimized when the software is enabled. |
||
reroute |
Sends out the log message when the tunnel LSP is rerouted due to an FRR event when the software is enabled.
|
||
state | Sends out the log message when the tunnel LSP goes up or down when the software is enabled. |
||
switchover | Sends out the log message when the tunnel LSP switches to the standby LSP due to a path protection event when the software is enabled.
|
By default, no logs are sent out.
Tunnel-mte interface configuration
Release | Modification |
---|---|
Release 3.9.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The logging events lsp-status command can be configured to notify the various LSP status changes through log messages. One or several of these LSP status changes can be enabled at once.
In addition, the logging events lsp-status command applies to both tunnel-mte and tunnel-te interfaces.
Task ID | Operation |
---|---|
mpls-te |
read, write |
The following example shows how to enable the interface LSP state change alarms for reoptimization:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-mte 10 RP/0/RP0/CPU0:router(config-if)# logging events lsp-status reoptimize
Command |
Description |
---|---|
Configures an MPLS-TE P2MP tunnel interface |
|
Enables the logging events so that the software sends a log message when a tunnel goes up or goes down. |
|
Sends out a log message when a point-to-multipoint sub-lsp goes up or goes down when the software is enabled. |
To send out a log message when a point-to-multipoint sub-lsp goes up or goes down when the software is enabled, use the logging events sub-lsp-status state command in tunnel-mte interface configuration mode. To disable this feature, use the no form of this command.
logging events sub-lsp-status state
This command has no arguments or keywords.
By default, no logs are sent out.
Tunnel-mte interface configuration
Release | Modification |
---|---|
Release 3.9.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The logging events sub-lsp-status state command can be configured to notify the state changes per-destination for the P2MP tunnel.
logging events sub-lsp-status state command applies only to the tunnel-mte interface.
Task ID | Operation |
---|---|
mpls-te |
read, write |
The following example shows how to enable the console logging for sub-lsp events to change the alarms state:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-mte 10 RP/0/RP0/CPU0:router(config-if)# logging events sub-lsp-status state
Command |
Description |
---|---|
Configures an MPLS-TE P2MP tunnel interface. |
|
Enables the logging events so that the software sends a log message when a tunnel goes up or goes down. |
|
Sends out a log message when LSP events occur. |
To match an active tunnel to a passive tunnel, use the match command in interface tunnel-gte configuration mode. To return to the default behavior, use the no form of this command.
match identifier tunnel-number
no match identifier tunnel-number
identifier |
Configures the identifier of the active tunnel to match with this passive tunnel. |
tunnel-number |
Tunnel number. Range is 0 to 65535. |
No default behavior or values
Interface tunnel-gte configuration
Release |
Modification |
---|---|
Release 3.3.0 |
This command was introduced. |
Release 3.8.0 |
GMPLS interfaces were supported under the tunnel-gte interface type. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
![]() Note | The LMP and GMPLS-NNI features are not supported on x86 RPs. |
GMPLS interfaces are used under the tunnel-gte interface type.
You must enter the hostname for the head router then underscore _t, and the tunnel number for the head router. If tunnel-gte1 is configured on the head router with a hostname of gmpls1, CLI is match identifier gmpls1_t1.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to match the active tunnel ID to the passive tunnel:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-gte 1 RP/0/RP0/CPU0:router(config-if)# match identifier gmpls1_t1
Command |
Description |
---|---|
Configures bidirectional optical tunnels. |
|
Configures an MPLS-TE tunnel interface for GMPLS interfaces. |
|
Configures LMP IPCC management hello settings. |
|
Configures passive GMPLS tunnels. |
|
Configures remote TE links. |
|
Configures TE-link switching attributes. |
To specify the maximum number of MPLS-TE tunnels that can be configured, use the maxabs command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
maxabs tunnels tunnel-limit destinations dest-limit
no maxabs tunnels tunnel-limit destinations dest-limit
tunnels |
Configures all tunnels for MPLS-TE. |
tunnel-limit |
Maximum number of tunnel TE interfaces. Range is 1 to 65536. |
destinations |
Configures all destinations for MPLS-TE. |
dest-limit |
Maximum total number of destinations that can be configured. Range is 1 to 65536. |
tunnel-limit: 4096
dest-limit: 4096
MPLS-TE configuration
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
Release 3.9.0 |
This command was removed. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to set the tunnel-te configuration limit to 1000:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# maxabs tunnels 1000 destinations 1000
Command |
Description |
---|---|
Displays the configuration of the maximum tunnel-te interfaces allowed. |
To enter MPLS-TE configuration mode, use the mpls traffic-eng command in global configuration mode.
mpls traffic-eng
This command has no arguments or keywords.
No default behavior or values
Global configuration
Release |
Modification |
---|---|
Release 3.3.0 |
This command was introduced. |
No specific guidelines impact the use of this command.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to enter MPLS-TE configuration mode:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)#
To apply the highest bandwidth collected on a tunnel without waiting for the current application period to end, use the mpls traffic-eng auto-bw apply command in EXEC mode.
mpls traffic-eng auto-bw apply { all | tunnel-te tunnel-number }
all |
Applies the highest bandwidth collected instantly on all the automatic bandwidth-enabled tunnels. |
tunnel-te tunnel-number |
Applies the highest bandwidth instantly to the specified tunnel. The range is from 0 to 65535. |
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The mpls traffic-eng auto-bw apply command can forcefully expire the current application period on a specified tunnel and immediately apply the highest bandwidth recorded so far instead of waiting for the application period to end on its own.
![]() Note | The predefined threshold check still applies on the configuration, and if the delta is not significant enough, the automatic bandwidth functionality overrides this command. |
The bandwidth application is performed only if at least one output rate sample has been collected for the current application period.
To guarantee the application of a specific signaled bandwidth value when triggering a manual bandwidth application, follow these steps:
Revert the minimum and maximum automatic bandwidth value back to their original value.
Task ID |
Operations |
---|---|
mpls-te |
execute |
The following example applies the highest bandwidth to a specified tunnel:
RP/0/RP0/CPU0:router# mpls traffic-eng auto-bw apply tunnel-te 1
Command |
Description |
---|---|
Configures the automatic bandwidth collection frequency and controls the manner in which the bandwidth for a tunnel collects output rate information, but does not adjust the tunnel bandwidth. |
|
Displays the list of automatic-bandwidth-enabled tunnels, and indicates if the current signaled bandwidth of the tunnel is identical to the bandwidth that is applied by the automatic bandwidth. |
To configure the router to assign new or more efficient backup MPLS-TE tunnels to protected MPLS-TE tunnels, use the mpls traffic-eng fast-reroute promote command in EXEC mode. To return to the default behavior, use the no form of this command.
mpls traffic-eng fast-reroute promote
no mpls traffic-eng fast-reroute promote
This command has no arguments or keywords.
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 3.2 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to initiate backup tunnel promote and assignment:
RP/0/RP0/CPU0:router# mpls traffic-eng fast-reroute promote
Command |
Description |
---|---|
Enables FRR protection for an MPLS-TE tunnel. |
To configure a router running Intermediate System-to-System (IS-IS) MPLS-TE at IS-IS Level 1 and Level 2, use the mpls traffic-eng level command in router configuration mode. To return to the default behavior, use the no form of this command.
mpls traffic-eng level isis-level
no mpls traffic-eng level isis-level
isis-level |
IS-IS level (1, 2, or both) where MPLS-TE is enabled. |
No default behavior or values
Router configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
Release 3.4.0 |
Support was added to enable MPLS Traffic Engineering in both IS-IS Level 1 and Level 2. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The mpls traffic-eng level command is supported for IS-IS and affects the operation of MPLS-TE only if MPLS-TE is enabled for that routing protocol instance.
Task ID |
Operations |
---|---|
isis |
read, write |
The following example shows how to configure a router running IS-IS MPLS to flood TE for IS-IS level 1:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# router isis 1 RP/0/RP0/CPU0:router(config-isis)# address-family ipv4 unicast RP/0/RP0/CPU0:router(config-isis-af)# mpls traffic-eng level 1 RP/0/RP0/CPU0:router(config-isis-af)# metric-style wide
Command |
Description |
---|---|
Specifies that the TE router identifier for the node is the IP address associated with a given interface. |
To enable immediate flooding of all the local MPLS-TE links, use the mpls traffic-eng link-management flood command in EXEC mode. To return to the default behavior, use the no form of this command.
mpls traffic-eng link-management flood
no mpls traffic-eng link-management flood
This command has no arguments or keywords.
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
![]() Note | If there is no change in the LSA since last flooding, IGP may dampen the advertisement. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to initiate flooding of the local MPLS-TE links:
RP/0/RP0/CPU0:router# mpls traffic-eng link-management flood
Command |
Description |
---|---|
Displays MPLS-TE link-management advertisements. |
To trigger a manual switchover for path protection for a GMPLS optical LSP, use the mpls traffic-eng path-protection switchover gmpls command in EXEC mode. To disable this feature, use the no form of this command.
mpls traffic-eng path-protection switchover gmpls tunnel name
no mpls traffic-eng path-protection switchover gmpls tunnel name
tunnel name |
Name of the tunnel that is used for a switchover. |
No manual path protection is invoked on either the head or tail router.
EXEC
Release |
Modification |
---|---|
Release 3.9.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The mpls traffic-eng path-protection switchover gmpls command is used for the following functions:
![]() Note | The LMP and GMPLS-NNI features are not supported on x86 RPs. |
Task ID |
Operations |
---|---|
mpls-te |
execute |
The following example triggers the switchover for path-protection for GMPLS:
RP/0/RP0/CPU0:router# mpls traffic-eng path-protection switchover gmpls
Command |
Description |
---|---|
Configures a path option for an MPLS-TE tunnel. |
To force idle peers to be reestablished without waiting for a timer, use the mpls traffic-eng pce activate-pcep command in EXEC mode. To return to the default behavior, use the no form of this command.
mpls traffic-eng pce activate-pcep { address | all }
no mpls traffic-eng pce activate-pcep { address | all }
address |
Address of the idle peer. |
all |
Activates all the idle peers. |
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 3.5.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
mpls-te |
read, write, execute |
The following example shows how to trigger a path computation client (PCC) or PCE to activate an idle path computation element protocol (PCEP) session:
RP/0/RP0/CPU0:router# mpls traffic-eng pce activate-pcep all
Command |
Description |
---|---|
Triggers reoptimization manually either for all tunnels or a specific PCE-based tunnel. |
To trigger reoptimization manually either for all or a specific PCE-based tunnel, use the mpls traffic-eng pce reoptimize command in EXEC mode. To disable this feature, use the no form of this command.
mpls traffic-eng pce reoptimize [tunnel ID] [force]
no mpls traffic-eng pce reoptimize [tunnel ID] [force]
tunnel ID |
(Optional) Tunnel ID to be reoptimized. Range is from 0 to 65535. |
force |
(Optional) Forces the router to start using the newly calculated route even if the used path has a better metric. |
Reoptimizes all the PCE tunnels.
EXEC
Release |
Modification |
---|---|
Release 3.5.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
If you do not run the mpls traffic-eng pce reoptimize command, the system tries to reoptimize at an interval of 3600 seconds.
Task ID |
Operations |
---|---|
mpls-te |
read, write, execute |
The following example shows how to trigger reoptimization for all PCE-based tunnels:
RP/0/RP0/CPU0:router# mpls traffic-eng pce reoptimize
Command |
Description |
---|---|
Forces idle peers to be re-established without waiting for a timer. |
To trigger the reoptimization interval of all TE tunnels, use the mpls traffic-eng reoptimize command in EXEC mode.
mpls traffic-eng reoptimize [tunnel-id] [tunnel-name] [all] [ p2mp { all | tunnel-id } ] [ p2p { all | tunnel-id } ]
tunnel-id |
(Optional) MPLS-TE tunnel identification expressed as a number. Range is from 0 to 65535. |
tunnel-name |
(Optional) TE tunnel identification expressed as a name. |
all |
(Optional) Forces an immediate reoptimization for all P2MP tunnels. |
p2mp |
(Optional) Forces an immediate reoptimization of all P2MP TE tunnels. |
tunnel-id |
P2MP TE tunnel identification to be reoptimized. Range is from 0 to 65535. |
p2p |
(Optional) Forces an immediate reoptimization of all P2P TE tunnels. |
all |
(Optional) Forces an immediate reoptimization for all P2P tunnels. |
tunnel-id |
P2P TE tunnel identification to be reoptimized. Range is from 0 to 65535. |
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
Release 3.9.0 |
The following keywords and arguments were added to support the P2MP TE feature and P2P feature: |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
mpls-te |
execute |
The following example shows how to immediately reoptimize all TE tunnels:
RP/0/RP0/CPU0:router# mpls traffic-eng reoptimize
The following example shows how to immediately reoptimize TE tunnel-te90:
RP/0/RP0/CPU0:router# mpls traffic-eng reoptimize tunnel-te90
The following example shows how to immediately reoptimize all P2MP TE tunnels that originated from this TE LSR:
RP/0/RP0/CPU0:router# mpls traffic-eng reoptimize p2mp all
The following example shows how to immediately reoptimize all P2P TE tunnels:
RP/0/RP0/CPU0:router# mpls traffic-eng reoptimize p2p all
To trigger the re-setup of TE tunnels, clearing the LSP states, use the mpls traffic-eng resetup command in EXEC mode.
mpls traffic-eng resetup { P2MP | P2P | name }
P2MP tunnel-id |
Re-setup a specific P2MP tunnel by tunnel-id. The P2MP tunnel ID range is from 0 to 65535. |
P2P tunnel-id |
Re-setup a specific P2P tunnel by tunnel-id. The P2MP tunnel ID range is from 0 to 65535. |
name name |
Re-setup a specific tunnel by the given name. |
No default behavior or values
Release |
Modification |
---|---|
Release 5.1.1 |
This command was introduced. |
No specific guidelines impact the use of this command.
Task ID |
Operations |
---|---|
mpls-te |
execute |
The following example shows how to re-setup a specific tunnel by the given name (tunnel-te1):
RP/0/RP0/CPU0:router#mpls traffic-eng resetup name tunnel-te1
The following example shows how to re-setup a specific P2P tunnel based on the specified tunnel-id (tunnel-id 1):
RP/0/RP0/CPU0:router#mpls traffic-eng resetup P2P tunnel-id 1
The following example shows how to re-setup a P2MP tunnel based on the specified tunnel-id (tunnel-id 2):
RP/0/RP0/CPU0:router#mpls traffic-eng resetup P2MP tunnel-id 2
To turn on automatic reoptimization of Multiprotocol Label Switching (MPLS) traffic engineering when certain events occur, such as, when an interface becomes operational, use the mpls traffic-eng reoptimize events link-up command in global configuration mode. To disable automatic reoptimization when link-up event occurs, use the no form of this command.
mpls traffic-eng reoptimize events link-up
no mpls traffic-eng reoptimize events link-up
This command has no arguments or keywords.
Global configuration (config)
Release | Modification |
---|---|
Release 5.2.2 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID | Operation |
---|---|
mpls-te |
read, write |
The following example shows how to turn on automatic reoptimization when an interface becomes operational:
RP/0/RP0/CPU0:router# mpls traffic-eng reoptimize events link-up
Command |
Description |
---|---|
mpls traffic-eng reoptimize timers delay |
Delays removal of old LSPs or installation of new LSPs after tunnel reoptimization. |
To specify that the TE router identifier for the node is the IP address associated with a given interface, use the mpls traffic-eng router-id command in the appropriate mode. To return to the default behavior, use the no form of this command.
mpls traffic-eng router-id type interface-path-id
no mpls traffic-eng router-id type interface-path-id
type |
Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
No default behavior or values
OSPF configuration
IS-IS address family configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
Release 3.9.1 |
The Usage Guidelines was updated |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
A routers identifier acts as a stable IP address for the TE configuration. This IP address is flooded to all nodes. You must set the destination on the destination node TE router identifier for all affected tunnels. This router ID is the address that the TE topology database at the tunnel head uses for its path calculation.
![]() Note | When the mpls traffic-eng router-id command is not configured, global router ID is used by MPLS-TE if there is one configured. |
We suggest that you configure the mpls traffic-eng router-id command explicitly under the IGP; otherwise, TE uses the default algorithm to pick up the TE router-id, which can be the highest IP address of the loopback interfaces or physical interfaces. When TE uses the algorithm to select a TE router-id dynamically, it can be different from what is configured for the static RPF check on the P2MP tunnel tail . If the static RPF check mismatch happens, the P2MP tail does not pass the incoming P2MP traffic to the egress of P2MP tail router.
A TE router-id configuration is highly recommended to ensure that the tunnel head-end picks up the correct source address, and the configured static RPF address at the tail-end matches the tunnel source which avoids unexpected traffic drops.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following examples show how to specify the TE router identifier as the IP address associated with loopback interface:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# router ospf CORE_AS RP/0/RP0/CPU0:router(config-ospf)# mpls traffic-eng router-id 7.7.7.7 RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# router isis 811 RP/0/RP0/CPU0:router(config-isis)# address-family ipv4 unicast RP/0/RP0/CPU0:router(config-isis-af)# mpls traffic-eng router-id 8.8.8.8
Command |
Description |
---|---|
Configures a router running OSPF MPLS so that it floods TE for the indicated IS-IS level. |
To reoptimize all tunnels of a mesh group, use the mpls traffic-eng repotimize mesh groupcommand in EXEC mode.
mpls traffic-eng reoptimize auto-tunnel mesh group group_id
group_id |
Defines auto-tunnel mesh group ID that is to be reoptimized. Range is 0 to 4294967295. |
None
MPLS Transport profile configuration
Release |
Modification |
---|---|
Release 4.1.1 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
mpls-te |
execute |
This is sample out from the mpls traffic-eng reoptimize mesh group command:
RP/0/RP0/CPU0:router mpls traffic-eng reoptimize mesh group 10
To configure only a next-hop automatic backup tunnel with only link protection, use the nhop-only command in MPLS-TE auto-tunnel backup interface configuration mode. To return to the default configuration setting for automatic backup tunnels, use the no form of this command.
nhop-only
no nhop-only
This command has no arguments or keywords.
Both NHOP and NNHOP protection are enabled.
Auto-tunnel backup configuration
Release | Modification |
---|---|
Release 4.0.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
If you configure the nhop-only command, you destroy any next-next-hop (NNHOP) tunnel created to provide node protection for tunnels running over the specified interface.
If you unconfigure the nhop-only command, you trigger a backup assignment on primary tunnels running over that link. The automatic backup tunnel feature attempts to create NNHOP backup tunnnels to provide node protection for the specified tunnels.
Task ID | Operation |
---|---|
mpls-te |
read, write |
In the following example, NNHOP automatic backup tunnels are destroyed and only NHOP tunnels with link protection is configured:
RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# interface pos 0/1/0/1 RP/0/RP0/CPU0:router(config-mpls-te-if)# auto-tunnel backup RP/0/RP0/CPU0:router(config-mpls-te-if-auto-backup)# nhop-only
Command |
Description |
---|---|
Builds automatic NHOP and NNHOP backup tunnels. |
To configure the tunnel overflow detection, use the overflow threshold command in MPLS-TE automatic bandwidth interface configuration mode. To disable the overflow detection feature, use the no form of this command.
overflow threshold percentage [ min bandwidth ] limit limit
no overflow threshold
percentage |
Bandwidth change percent to trigger an overflow. The range is from 1 to 100. |
min bandwidth |
(Optional) Configures the bandwidth change value, in kbps, to trigger an overflow. The range is from 10 to 4294967295. The default is 10. |
limit limit |
Configures the number of consecutive collection intervals that exceeds the threshold. The bandwidth overflow triggers an early tunnel bandwidth update. The range is from 1 to 10. The default is none. |
The default value is disabled.
MPLS-TE automatic bandwidth interface configuration
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
Release 3.9.0 |
The Usage Guidelines was updated to describe overflow detection. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
If you modify the limit keyword, the consecutive overflows counter for the tunnel is also reset.
If you enable or modify the minimum value, the current consecutive overflows counter for the tunnel is also reset, which effectively restarts the overflow detection from scratch.
Several number of consecutive bandwidth samples are greater than the overflow threshold (bandwidth percentage) and the minimum bandwidth configured, then a bandwidth application is updated immediately instead of waiting for the end of the application period.
Overflow detection applies only to bandwidth increase. For example, an overflow can not be triggered even if bandwidth decreases by more than the configured overflow threshold.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure the tunnel overflow detection for tunnel-te 1:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# auto-bw RP/0/RP0/CPU0:router(config-if-tunte-autobw)# overflow threshold 50 limit 3
Command |
Description |
---|---|
Configures the tunnel bandwidth change threshold to trigger an adjustment. |
|
Configures the application frequency in minutes for the applicable tunnel. |
|
Configures automatic bandwidth on a tunnel interface and enters MPLS-TE automatic bandwidth interface configuration mode. |
|
Configures the minimum and maximum automatic bandwidth to set on a tunnel. |
|
Enables only the bandwidth collection without adjusting the automatic bandwidth. |
|
Displays information about MPLS-TE tunnels. |
To configure a passive GMPLS tunnel, use the passive command in interface tunnel-gte configuration mode. To return to the default behavior, use the no form of this command.
passive
no passive
This command has no arguments or keywords.
No default behavior or values
Interface tunnel-gte configuration
Release |
Modification |
---|---|
Release 3.3.0 |
This command was introduced. |
Release 3.8.0 |
GMPLS interfaces were supported under the tunnel-gte interface type. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
GMPLS interfaces are used under the tunnel-gte interface type.
![]() Note | The LMP and GMPLS-NNI features are not supported on x86 RPs. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure a passive GMPLS virtual interface tunnel:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-gte 99 RP/0/RP0/CPU0:router(config-if)# passive
Command |
Description |
---|---|
Configures bidirectional optical tunnels. |
|
Configures an MPLS-TE tunnel interface for GMPLS interfaces. |
|
Configures LMP IPCC management hello settings. |
|
Configures or matches active and passive tunnels. |
|
Configures remote TE links. |
|
Configures TE-link switching attributes. |
To configure a path option for an MPLS-TE tunnel, use the path-option command in tunnel-te interface configuration mode. To return to the default behavior, use the no form of this command.
path-option preference-priority [ protecting number ] { dynamic [ pce [ address ipv4 address ] ] | explicit { name path-name | identifier path-number } [ protected-by path-option-level ] } [attribute-set name] [ isis instance-name level level ] [lockdown] [ ospf instance-name area { value | address } ] [verbatim]
no path-option preference-priority { dynamic [ pce [ address ipv4 address ] ] | explicit { name path-name | identifier path-number } [ protected-by path-option-level ] } [ isis instance-name level level ] [lockdown] [ ospf instance-name area { value | address } ] [verbatim]
preference-priority |
Path option number. Range is from 1 to 1000. |
protecting number |
Specifies a path setup option to protect a path. The range is from 1 to 1000. |
dynamic |
Specifies that label switched paths (LSP) are dynamically calculated. |
pce |
(Optional) Specifies that the LSP is computed by a Path Computation Element (PCE). |
address |
(Optional) Configures the address for the PCE. |
ipv4 address |
Configures the IPv4 address for the PCE. |
explicit |
Specifies that LSP paths are IP explicit paths. |
name path-name |
Specifies the path name of the IP explicit path. |
identifier path-number |
Specifies a path number of the IP explicit path. |
protected-by path-option-level |
(Optional) Configures path protection for an explicit path that is protected by another explicit path. |
isis instance-name |
(Optional) Limits CSPF to a single IS-IS instance and area. |
attribute-set name |
(Optional) Specifies the attribute set for the LSP. |
level level |
Configures the level for IS-IS. The range is from 1 to 2. |
lockdown |
(Optional) Specifies that the LSP cannot be reoptimized. |
ospf instance-name |
(Optional) Limits CSPF to a single OSPF instance and area. |
area |
Configures the area for OSPF. |
value |
Decimal value for the OSPF area ID. |
address |
IP address for the OSPF area ID. |
verbatim |
(Optional) Bypasses the Topology/CSPF check for explicit paths. |
No default behavior or values
Tunnel-te interface configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
Release 3.3.2 |
The protecting keyword was added to support GMPLS protection and restoration. |
Release 3.4.1 |
Both the verbatim and lockdown keywords can be used together. |
Release 3.7.0 |
An IGP-area was specified with the path-option command. Both the isis and the ospf keywords were added. |
Release 3.8.0 |
The pce, address, and ipv4 keywords were added. The address argument was added. |
Release 4.2.0 | The attribute-set keyword was added. |
Release 4.2.3 | The protected-by keyword was added. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
You can configure several path options for a single tunnel. For example, there can be several explicit path options and a dynamic option for one tunnel. The path setup preference is for lower (not higher) numbers, so option 1 is preferred.
When the lower number path option fails, the next path option is used to set up a tunnel automatically (unless using the lockdown option).
The protecting keyword specifies that you can configure path-protection for the primary LSP. The protecting keyword is available only for tunnel-gte interfaces.
You specify the backup path for the path-option command in case of the primary path failure.
CSPF areas are configured on a per-path-option basis.
Any primary explicit path on a path protection enabled tunnel can be configured to be protected by an explicit path option level using protected-by keyword. Only one explicit protecting path is supported per path option.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure the tunnel to use a named IPv4 explicit path as verbatim and lockdown options for the tunnel. This tunnel cannot reoptimize when the FRR event goes away, unless you manually reoptimize it:
RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# path-option 1 explicit name test verbatim lockdown
The following example shows how to enable path protection on a tunnel to configure an explicit path:
RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# path-option 1 explicit name po4 RP/0/RP0/CPU0:router(config-if)# path-option protecting 1 explicit name po6
The following example shows how to limit CSPF to a single OSPF instance and area:
RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# path-option 1 explicit name router1 ospf 3 area 7 verbatim
The following example shows how to limit CSPF to a single IS-IS instance and area:
RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# path-option 1 dynamic isis mtbf level 1 lockdown
Command |
Description |
---|---|
Specifies a switchover for path protection. |
|
Displays the configured IP explicit paths. |
|
Displays information about MPLS-TE tunnels. |
To configure the primary or fallback path setup option for a Point-to-Multipoint (P2MP) TE tunnel, use the path-option command in P2MP destination interface configuration mode. To return to the default behavior, use the no form of this command.
path-option preference-priority { dynamic | explicit { name path-name | identifier path-number } } [verbatim] [lockdown]
no path-option preference-priority { dynamic | explicit { name path-name | identifier path-number } } [verbatim] [lockdown]
preference-priority |
Path option number. Range is from 1 to 1000. |
dynamic |
Specifies that label switched paths (LSP) are dynamically calculated. |
explicit |
Specifies that LSP paths are IP explicit paths. |
name path-name |
Specifies the path name of the IP explicit path. |
identifier path-number |
Specifies a path number of the IP explicit path. |
verbatim |
(Optional) Bypasses the Topology/CSPF check for explicit paths. |
lockdown |
(Optional) Specifies that the LSP cannot be reoptimized. |
None
P2MP destination interface configuration
Release |
Modification |
---|---|
Release 3.9.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
You can configure several path options for each destination of a P2MP tunnel. For example, for one tunnel, there can be several explicit path options and a dynamic option. The path preference is for lower (not higher) numbers, so option 1 is preferred over higher options.
When the lower number path option fails, the next path option under the destination is attempted.
Several path-options can be configured for each destination under a tunnel.
When configuring multiple path-options under each destination of a P2MP tunnel, the PCALC on the TE tunnel source attempts to generate the P2MP tree starting from the preferred path-options (lower numbers) for each destination. If some destinations use explicit paths that cause remerges with the dynamic generated paths for other destinations in the P2MP tree, the PCALC source modifies the dynamic paths (for example, optimal path); therefore, it follows the explicit path to correct the remerge problem.
The path-option command is common for both Point-to-Point (P2P) and P2MP tunnels.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
This example shows how to configure a P2MP tunnel with two destinations and several path-options per destination:
RP/0/RP0/CPU0:router(config)# interface tunnel-mte 100 RP/0/RP0/CPU0:router(config-if)# destination 1.1.1.1 RP/0/RP0/CPU0:router(config-if-p2mp-dest)# path-option 1 explicit name po_dest1 RP/0/RP0/CPU0:router(config-if-p2mp-dest)# path-option 2 dynamic
This example shows that the fallback path option is dynamic:
RP/0/RP0/CPU0:router(config)# interface tunnel-mte 100 RP/0/RP0/CPU0:router(config-if)# destination 2.2.2.2 RP/0/RP0/CPU0:router(config-if-p2mp-dest)# path-option 1 explicit name po_dest2 RP/0/RP0/CPU0:router(config-if-p2mp-dest)# path-option 2 dynamic
Command |
Description |
---|---|
Configures the destination address of a TE tunnel. |
|
mpls traffic-eng path-protection switchover gmpls |
Specifies a switchover for path protection. |
Displays the configured IP explicit paths. |
|
Displays information about MPLS-TE tunnels. |
|
show mrib mpls traffic-eng fast-reroute |
Displays information about Multicast Routing Information Base (MRIB) MPLS traffic engineering fast reroute. |
To set the upper limit on the path aggregate admin-weight when computing paths for MPLS-TE LSPs, use the path-selection cost-limit command in an appropriate configuration mode. To remove the upper limit, use the no form of this command.
path-selection cost-limit cost-limit-value
cost-limit-value |
Configures the path-selection cost-limit value. The range is from 1 to 4294967295. |
The cost-limit is ignored.
Global configuration
Interface tunnel TE configuration
MPLS TE path-option attribute set configuration
Release | Modification |
---|---|
Release 5.1.2 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Path-selection cost-limit configuration works only on MPLS TE tunnels. The cost-limit configured under path-option attribute-set configuration mode takes priority and will be in effect if the cost-limit is configured under global configuration, interface tunnel TE, and path-option attribute-set configuration modes. The cost-limit is ignored by default.
A LSP is created only if its path aggregate admin-weight is less than the specified path cost limit.
Task ID | Operation |
---|---|
mpls-te |
read, write |
This example shows how to set the path-selection cost-limit for under MPLS TE path-option attribute-set PO3AttrSet.
RP/0/RP0/CPU0:router#configure RP/0/RP0/CPU0:router(config)#mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)#attribute-set path-option PO3AttrSet RP/0/RP0/CPU0:router(config-te-attribute-set)#path-selection cost-limit 50000
To ignore the Intermediate System-to-Intermediate System (IS-IS) overload bit setting for MPLS-TE, use the path-selection ignore overload command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
path-selection ignore overload {head | mid | tail}
no path-selection ignore overload {head | mid | tail}
head |
The tunnel stays up if set-overload-bit is set by ISIS on the head router. Ignores overload node during CSPF for the head node. |
mid |
The tunnel stays up if set-overload-bit is set by ISIS on the mid router. Ignores overload node during CSPF for the mid node. |
tail |
The tunnel stays up if set-overload-bit is set by ISIS on the tail router. Ignores overload node during CSPF for the tail node. |
None
MPLS-TE configuration
Release |
Modification |
---|---|
Release 3.4.0 |
This command was introduced. |
Release 4.1.0 |
The head, mid, and tail keywords were added. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Use the path-selection ignore overload command to ensure that label switched paths (LSPs) are not broken because of routers that have IS-IS overload bit as enabled.
When the IS-IS overload bit avoidance (OLA) feature is activated, all nodes with the overload bit set, which includes head nodes, mid nodes, and tail nodes, are ignored. This means that they are still available for use with label switched paths (LSPs). This feature allows you to include an overloaded node in constraint-based shortest path first (CSPF).
Task ID |
Operations |
---|---|
mpls-te |
read, write |
This example shows how to use the path-selection ignore overload head command:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# path-selection ignore overload RP/0/RP0/CPU0:router(config-mpls-te)# path-selection ignore overload head
To configure the path invalidation timer such that when the timer expires, the path is either removed or the data is dropped, use the path-selection invalidation command in MPLS-TE configuration mode. To remove the path invalidation timer, use the no form of this command.
path-selection invalidation path-invalidation-timer-value {drop | tear}
path-invalidation-timer-value |
Configures the path invalidation timer value in milliseconds. The range is from 0 to 60000. |
drop |
The data is dropped after the path invalidation timer expires. |
tear |
The path is torn down after the path invalidation timer expires. |
None
MPLS-TE configuration
Release | Modification |
---|---|
Release 6.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID | Operation |
---|---|
mpls-te |
read, write |
This example shows how to set the path-selection invalidation timer in MPLS TE configuration mode.
RP/0/RP0/CPU0:router#configure RP/0/RP0/CPU0:router(config)#mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)#path-selection invalidation 1 drop
To specify the affinity value to be used to expand a path to the next loose hop for a tunnel on an area border router, use the path-selection loose-expansion affinity command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
path-selection loose-expansion affinity affinity-value mask affinity-mask [ class-type type ]
no path-selection loose-expansion affinity affinity-value mask affinity-mask [ class-type type ]
affinity-value |
Attribute values required for links carrying this tunnel. A 32-bit decimal number. Range is 0x0 to 0xFFFFFFFF, representing 32 attributes (bits), where the value of an attribute is 0 or 1. |
mask affinity-mask |
Checks the link attribute, a 32-bit decimal number. Range is 0x0 to 0xFFFFFFFF, representing 32 attributes (bits), where the value of an attribute mask is 0 or 1. |
class-type type |
(Optional) Requests the class-type of the tunnel bandwidth. Range is 0 to 1. |
affinity-value : 0X00000000
mask-value : 0XFFFFFFFF
MPLS-TE configuration
Release |
Modification |
---|---|
Release 3.4.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
![]() Note | The new affinity scheme (based on names) is not supported for loose-hop expansion. New configuration does not affect the already up tunnels. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure affinity 0x55 with mask 0xFFFFFFFF:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# path-selection loose-expansion affinity 55 mask FFFFFFFF
Command |
Description |
---|---|
Configures a metric type to be used to expand a path to the next loose hop for a tunnel on an area border router. |
|
Configures the MPLS-TE tunnel path-selection metric. |
To configure a metric type to be used to expand a path to the next loose hop for a tunnel on an area border router, use the path-selection loose-expansion metric command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
path-selection loose-expansion metric { igp | te } [ class-type type ]
no path-selection loose-expansion metric { igp | te } [ class-type type ]
igp |
Configures an Interior Gateway Protocol (IGP) metric. |
te |
Configures a TE metric. This is the default. |
class-type type |
(Optional) Requests the class type of the tunnel bandwidth. Range is 0 to 1. |
The default is TE metric.
MPLS-TE configuration
Release |
Modification |
---|---|
Release 3.4.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
![]() Note | New configurations do not affect tunnels that are already up. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to set the path-selection metric to use the IGP metric overwriting default:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# path-selection loose-expansion metric igp
Command |
Description |
---|---|
Specifies the affinity value to be used to expand a path to the next loose hop for a tunnel on an area border router. |
To specify the MPLS-TE tunnel path-selection metric, use the path-selection metric command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
path-selection metric { igp | te }
no path-selection metric { igp | te }
igp |
Configures an Interior Gateway Protocol (IGP) metric. |
te |
Configures a TE metric. |
The default is TE metric.
MPLS-TE configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The metric type to be used for path calculation for a given tunnel is determined as follows:
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to set the path-selection metric to use the IGP metric overwriting default:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# path-selection metric igp
Command |
Description |
---|---|
Specifies the affinity value to be used to expand a path to the next loose hop for a tunnel on an area border router. |
To configure an MPLS-TE tunnel path-selection metric type, use the path-selection metric command in interface configuration mode. To return to the default behavior, use the no form of this command.
path-selection metric { igp | te }
no path-selection metric { igp | te }
igp |
Configures Interior Gateway Protocol (IGP) metrics. |
te |
Configures TE metrics. This is the default. |
The default is TE metrics.
Interface configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The metric type to be used for path calculation for a given tunnel is determined as follows:
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to set the path-selection metric to use the IGP metric overwriting default:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# path-selection metric igp
Command |
Description |
---|---|
Displays the tunnel path used. |
To configure the IPv4 self address for Path Computation Element (PCE), use the pce address command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
pce address ipv4 address
no pce address ipv4 address
ipv4 address |
Configures the IPv4 address for PCE. |
No default behavior or values
MPLS-TE configuration
Release |
Modification |
---|---|
Release 3.5.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The IP address is used in the TCP communication with the other PCEs or PCCs. In addition, this address is advertised using IGP.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure the IPv4 self address for PCE:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# pce address ipv4 10.10.10.10
Command |
Description |
---|---|
Configures a PCEP keepalive interval. |
|
Configures a path option for an MPLS-TE tunnel. |
|
Configures an IPv4 self address for a PCE peer. |
|
Configures a periodic reoptimization timer. |
|
Configures a PCE request-timeout. |
|
Configures a PCE tolerance keepalive (which is the minimum acceptable peer proposed keepalive). |
To configure a path computation element (PCE) deadtimer, use the pce deadtimer command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
pce deadtimer value
no pce deadtimer value
value |
Keepalive dead interval, in seconds. The range is 0 to 255. |
value: 120
MPLS-TE configuration
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
When the dead interval is 0, the LSR does not time out a PCEP session to a remote peer.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure a PCE deadtimer:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# pce deadtimer 50
Command |
Description |
---|---|
Enters MPLS-TE configuration mode. |
|
Configures a path option for an MPLS-TE tunnel. |
|
Configures the IPv4 self address for a PCE. |
|
Configures a PCEP keepalive interval. |
|
Configures an IPv4 self address for a PCE peer. |
|
Configures a periodic reoptimization timer. |
|
Configures a PCE request-timeout. |
|
Configures a PCE tolerance keepalive (which is the minimum acceptable peer proposed keepalive). |
To configure a path computation element protocol (PCEP) keepalive interval, use the pce keepalive command in MPLS-TE configuration mode. To disable this command, use the no form of this command.
pce keepalive interval
no pce keepalive interval
interval |
Keepalive interval, in seconds. The range is 0 to 255. |
interval: 30
MPLS-TE configuration
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
When the keepalive interval is 0, the LSR does not send keepalive messages.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure PCEP keepalive interval for 10 seconds:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router#(config-mpls-te) pce keepalive 10
Command |
Description |
---|---|
Enters MPLS-TE configuration mode. |
|
Configures a path option for an MPLS-TE tunnel. |
|
Configures the IPv4 self address for a PCE. |
|
Configures a PCE deadtimer. |
|
Configures an IPv4 self address for a PCE peer. |
|
Configures a periodic reoptimization timer. |
|
Configures a PCE request-timeout. |
|
Configures a PCE tolerance keepalive (which is the minimum acceptable peer proposed keepalive). |
To configure an IPv4 self address for a path computation element (PCE) peer, use the pce peer command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
pce peer ipv4 address
no pce peer ipv4 address
ipv4 address |
Configures the IPv4 address for PCE. |
TE metric
MPLS-TE configuration
Release |
Modification |
---|---|
Release 3.5.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure an IPv4 self address for a PCE peer:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# pce peer ipv4 11.11.11.11
Command |
Description |
---|---|
Enters MPLS-TE configuration mode. |
|
Configures a path option for an MPLS-TE tunnel. |
|
Configures the IPv4 self address for a PCE. |
|
Configures a PCE deadtimer. |
|
Configures a PCEP keepalive interval. |
|
Configures a periodic reoptimization timer. |
|
Configures a PCE request-timeout. |
|
Configures a PCE tolerance keepalive (which is the minimum acceptable peer proposed keepalive). |
To configure a periodic reoptimization timer, use the pce reoptimize command in MPLS-TE configuration mode. To disable this feature, use the no form of this command.
pce reoptimize value
no pce reoptimize value
value |
Periodic reoptimization timer value, in seconds. The range is 60 to 604800. |
value: 3600
MPLS-TE configuration
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
When the dead interval is 0, the LSR does not time out a path computation element protocol (PCEP) session to a remote peer.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure a periodic reoptimization timer for 200 seconds:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# pce reoptimize 200
Command |
Description |
---|---|
Enters MPLS-TE configuration mode. |
|
Configures a path option for an MPLS-TE tunnel. |
|
Configures the IPv4 self address for a PCE. |
|
Configures a PCE deadtimer. |
|
Configures a PCEP keepalive interval. |
|
Configures an IPv4 self address for a PCE peer. |
|
Configures a PCE request-timeout. |
|
Configures a PCE tolerance keepalive (which is the minimum acceptable peer proposed keepalive). |
To configure a path computation element (PCE) request-timeout, use the pce request-timeout command in MPLS-TE configuration mode. To disable this feature, use the no form of this command.
pce request-timeout value
no pce request-timeout value
value |
PCE request-timeout, in seconds. The range is 5 to 100. |
value: 10
MPLS-TE configuration
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
PCC or PCE keeps a pending path request only for the request-timeout period.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure a PCE request-timeout for 10 seconds:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# pce request-timeout 10
Command |
Description |
---|---|
Enters MPLS-TE configuration mode. |
|
Configures a path option for an MPLS-TE tunnel. |
|
Configures the IPv4 self address for a PCE. |
|
Configures a PCE deadtimer. |
|
Configures a PCEP keepalive interval. |
|
Configures an IPv4 self address for a PCE peer |
|
Configures a periodic reoptimization timer. |
|
Configures a PCE tolerance keepalive (which is the minimum acceptable peer proposed keepalive). |
To enter the stateful PCE client configuration mode and enable stateful PCE capabilities, use the pce stateful-client command in MPLS-TE configuration mode. To disable stateful PCE capabilities, use the no form of this command.
pce stateful-client
no pce stateful-client
This command has no keywords or arguments.
Stateful PCE is disabled.
MPLS-TE configuration
Release | Modification |
---|---|
Release 5.1.1 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
When the stateful-client configuration is added to the TE-node, it will close all existing PCEP peer connections, and add the stateful capabilities TLV to the OPEN object it exchanges during the PCEP session establishment.
When the stateful-client configuration is removed from the TE-node, it will delete all PCE instantiated tunnels, close all existing PCEP connections, and no longer add the stateful capabilities TLV to the OPEN object it exchanges during the PCEP session establishment.
Task ID | Operation |
---|---|
mpls-te |
read, write |
This example shows how to configure stateful PCE mode:
RP/0/RP0/CPU0:router#configure RP/0/RP0/CPU0:router(config)#mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)#pce stateful-client RP/0/RP0/CPU0:router(config-mpls-te-pce-stateful)#
To configure a path computation element (PCE) tolerance keepalive (which is the minimum acceptable peer proposed keepalive), use the pce tolerance keepalive command in MPLS-TE configuration mode. To disable this feature, use the no form of this command.
pce tolerance keepalive value
no pce tolerance keepalive value
value |
PCE tolerance keepalive value, in seconds. The range is 0 to 255. |
value: 10
MPLS-TE configuration
Release |
Modification |
---|---|
Release 3.8.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure a PCE tolerance keepalive for 10 seconds:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# pce tolerance keepalive 10
Command |
Description |
---|---|
Enters MPLS-TE configuration mode. |
|
Configures a path option for an MPLS-TE tunnel. |
|
Configures the IPv4 self-address for a PCE. |
|
Configures a PCE deadtimer. |
|
Configures a PCEP keepalive interval. |
|
Configures an IPv4 self address for a PCE peer |
|
Configures a periodic reoptimization timer. |
|
Configures a PCE request-timeout. |
To configure policy-based tunnel selection (PBTS) to direct traffic into specific TE tunnels, use the policy-class command in interface configuration mode. To disable this feature, use the no form of this command.
Multiple EXP values can be specified as part of a policy-class, separated by spaces. The EXP values configured to a TE tunnel effectively form a monolithic policy-class, which should not overlap with other policy-classes. Once an EXP value is used in a policy-class configuration, it can only be reused if the subsequent policy-class configurations containing that EXP value are identical. For example, if the configuration policy-class 1 2 3 is applied to one or more tunnels, configurations such as policy-class 1, policy-class 2 3, or policy-class 3 4 5 become invalid.
policy-class { 1 - 7 | default }
no policy-class
1 - 7 |
Policy-class attribute to map the correct traffic class to this policy. Multiple EXP values can be specified, separated by spaces. |
default |
Default tunnel policy class. |
Interface configuration
Release |
Modification |
---|---|
Release 3.6.0 |
This command was introduced. |
Release 4.3.1 |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Use the policy-class command to enable policy-based tunnel selection (PBTS). See Cisco IOS XR MPLS Configuration Guide for the Cisco CRS-1 Router for more information on PBTS.
To display the configured PBTS policy-class value, use the show mpls traffic-eng tunnels command.
To display information about PBTS configuration, use the show cef and show cef hardware commands in Cisco IOS XR IP Addresses and Services Command Reference for the Cisco CRS-1 Router.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure a policy class:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# policy-class 7
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# policy-class 1 2 3
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# policy-class default RP/0/RP0/CPU0:router(config-if)# commit
Command |
Description |
---|---|
Configures an MPLS-TE tunnel interface. |
|
show cef |
Displays the IPv4 or IPv6 Cisco Express Forwarding table. |
show cef hardware |
Displays Cisco Express Forwarding IPv4 or IPv6 hardware status and configuration information. |
Displays information about MPLS-TE tunnels. |
To configure the setup and reservation priority for an MPLS-TE tunnel, use the priority command in interface configuration mode. To return to the default behavior, use the no form of this command.
priority setup-priority hold-priority
no priority setup-priority hold-priority
setup-priority |
Priority used when signaling a label switched path (LSP) for this tunnel to determine which existing tunnels can be preempted. Range is 0 to 7 (in which a lower number indicates a higher priority). Therefore, an LSP with a setup priority of 0 can preempt any LSP with a non-0 priority. |
hold-priority |
Priority associated with an LSP for this tunnel to determine if it should be preempted by other LSPs that are being signaled. Range is 0 to 7 (in which a lower number indicates a higher priority). |
setup-priority: 7
hold-priority: 7
Interface configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
When an LSP is signaled and an interface does not currently have enough bandwidth available for that LSP, the call admission software (if necessary) preempts lower-priority LSPs to admit the new LSP. Accordingly, the new LSP priority is the setup priority and the existing LSP priority is the hold priority. The two priorities make it possible to signal an LSP with a low setup priority (so that the LSP does not preempt other LSPs on setup) and a high hold priority (so that the LSP is not preempted after it is established). Setup priority and hold priority are typically configured to be equal, and setup priority cannot be numerically smaller than the hold priority.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure a tunnel with a setup and hold priority of 1:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# priority 1 1
Command |
Description |
---|---|
Configures an MPLS-TE tunnel interface. |
To record the route used by a tunnel, use the record-route command in interface configuration mode. To return to the default behavior, use the no form of this command.
record-route
no record-route
This command has no arguments or keywords.
No default behavior or values
Interface configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
![]() Note | You must configure record-route on TE tunnels that are protected by multiple backup tunnels merging at a single node. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to enable record-route on the TE tunnel:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface tunnel-te 1 RP/0/RP0/CPU0:router(config-if)# record-route
Command |
Description |
---|---|
Displays information about MPLS-TE tunnels. |
To configure Link Management Protocol (LMP) Neighbor remote Traffic Engineering (TE) links, use the remote command in MPLS-TE interface LMP data link adjacency configuration mode. To return to the default behavior, use the no form of this command.
remote { interface-id unnum identifier | switching capability | { fsc | lsc | psc1 } | te-link-id | { ipv4 address | unnum identifier } }
no remote { interface-id unnum identifier | switching capability | { fsc | lsc | psc1 } | te-link-id | { ipv4 address | unnum identifier } }
interface-id |
Configures the LMP neighbor remote interface identifier. |
unnum identifier |
Configures the unnumbered interface identifier. Range is 1 to 4294967295. |
switching-capability |
Configures the remote LMP MPLS-TE interface switching capability. |
fsc | lsc | psc1 |
Configures the capability types: Fiber-Switch Capable, Lambda-Switch Capable, and Packet-Switch Capable. |
te-link-id |
Configures the remote LMP MPLS-TE link ID address. |
ipv4 address |
Configures the IPv4 address. |
unnum identifier |
Configures the unnumbered interface and identifier. |
No default behavior or values
MPLS-TE interface LMP data link adjacency configuration
Release |
Modification |
---|---|
Release 3.3.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
![]() Note | The LMP and GMPLS-NNI features are not supported on x86 RPs. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure LMP Neighbor remote TE links for unnumber interface-id 1066:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# interface POS 0/1/0/0 RP/0/RP0/CPU0:router(config-mpls-te-if)# lmp data-link adjacency RP/0/RP0/CPU0:router(config-mpls-te-if-adj)# remote interface-id unnnum 1066
Command |
Description |
---|---|
Configures bidirectional optical tunnels. |
|
Configures LMP IPCC management hello settings. |
|
Configures or matches active and passive tunnels. |
|
Configures passive GMPLS tunnels. |
|
Configures TE-link switching attributes. |
To force the reoptimization interval for all TE tunnels, use the reoptimize command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
reoptimize frequency
no reoptimize frequency
frequency |
Timer frequency range, in seconds. Range is from 0 to 604800. |
frequency: 3600
MPLS-TE configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to force the reoptimization interval to 60 seconds:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# reoptimize 60
Command |
Description |
---|---|
Triggers the reoptimization interval of all TE tunnels. |
To delay removal or relabeling of the old label switched paths (LSPs) (reoptimized LSP from the forwarding plane) after tunnel reoptimization, use the reoptimize timers delay command in MPLS-TE configuration mode. To restore the default value, use the no form of this command.
reoptimize timers delay { after-frr seconds | cleanup delay-time | installation delay-time | path-protection seconds }
no reoptimize timers delay { after-frr seconds | cleanup delay-time | installation delay-time | path-protection seconds }
after-frr |
Delays the LSP reoptimization in the event of the FRR. |
seconds |
Reoptimization initiation delay time of the tunnel, in seconds, after an FRR event. Range is from 0 to 120. |
cleanup |
Delays removal of the old LSPs after tunnel reoptimization. |
delay-time |
Reoptimization delay time, in seconds. A value of 0 disables delay. The valid range is from 0 to 300 for cleanup time. |
installation |
Delays installation of a new label after tunnel reoptimization. |
delay-time |
Reoptimization delay time, in seconds. A value of 0 disables delay. The valid range is 0 to 3600 for installation time. |
path-protection |
Delays the time between path protection switchover event and tunnel reoptimization. |
seconds |
Time, in seconds, between path protection switchover event and tunnel reoptimization. A value of 0 disables delay. Range is from 0 to 604800. |
after-frr delay: 0
cleanup delay: 20
delay-time: 20
installation delay: 20
path-protection: 180
MPLS-TE configuration
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
Release 3.9.0 |
The after-frr and path-protection keywords were added. |
A device with Multiprotocol Label Switching traffic engineering (MPLS-TE) tunnels periodically examines tunnels with established LSPs to discover whether more efficient LSPs (paths) are available. If a better LSP is available, the device signals the more efficient LSP; if the signaling is successful, the device replaces the older LSP with the new, more efficient LSP.
Sometimes the slower router-point nodes may not yet utilize the new label’s forwarding plane. In this case, if the headend node replaces the labels quickly, it can result in brief packet loss. By delaying the cleanup of the old LSP using the reoptimize timers delay cleanup command, packet loss is avoided.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to set the reoptimization cleanup delay time to 1 minute:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# reoptimize timers delay cleanup 60
The following example shows how to set the reoptimization installation delay time to 40 seconds:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# reoptimize timers delay installation 40
The following example shows how to set the reoptimization delay time after the event of the FRR to 50 seconds:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# reoptimize timers delay after-frr 50
The following example shows how to set the reoptimization delay time between path protection switchover event and tunnel reoptimization to 80:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# reoptimize timers delay path-protection 80
Command |
Description |
---|---|
Reoptimizes all traffic engineering tunnels immediately. |
To enable users to adjust the route-priority given to TE labels into the data plane, compared to labels and route updates from other protocols, use the route-priority command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
route-priority role { middle | head { primary | backup } } queue queue
no route-priority role { middle | head { primary | backup } }
role |
Defines the role of the tunnel to which the label belongs. |
middle |
A tunnel mid-point. |
head backup |
A tunnel head which is assigned as a FRR backup to an interface. |
head primary |
All other tunnel heads. |
queue |
Defines the queue number. Range is from 0 to 12 inclusive; lower values represent higher priority queues. |
head backup: 9
head primary: 10
middle: 10
MPLS-TE configuration
Release | Modification |
---|---|
Release 4.2.4 |
This command was introduced. |
Use this command to change the priority given to TE labels when updates to the forwarding plane are made from the control plane.
![]() Caution | The default prioritization of label updates from the control plane to the forwarding plane has been carefully chosen to avoid traffic loss under both normal operation and high system load, and to balance the needs of the various features that employ label switching. Changing these defaults may cause unpredictable behavior including traffic loss, especially when the router is experiencing high load. Use of this command is not recommended without proper understanding of its effects and possible side-effects. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to enable route-priority:
RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# route-priority role middle queue 7
To configure a secondary TE router identifier in MPLS-TE to be used locally (not advertised through IGP), use the router-id secondary command in MPLS-TE configuration mode. To return to the default behavior, use the no form of this command.
router-id secondary IP address
no router-id secondary IP address
IP address |
IPv4 address to be used as secondary TE router ID. |
No default behavior or values
MPLS-TE configuration
Release |
Modification |
---|---|
Release 3.4.1 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Use the router-id secondary command on tail end nodes to terminate verbatim tunnels to secondary TE RIDs as destinations.
You can configure up to 32 IPv4 addresses as TE secondary router IDs.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure a secondary TE router identifier in MPLS-TE:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# mpls traffic-eng RP/0/RP0/CPU0:router(config-mpls-te)# router-id secondary 1.1.1.1 RP/0/RP0/CPU0:router(config-mpls-te)# router-id secondary 2.2.2.2
Command |
Description |
---|---|
Specifies that the TE router identifier for the node is the IP address associated with a given interface. |
To display the configured IP explicit paths, use the show explicit-paths command in EXEC mode.
show explicit-paths [ name path-name | identifier number ]
name path-name |
(Optional) Displays the name of the explicit path. |
identifier number |
(Optional) Displays the number of the explicit path. Range is 1 to 65535. |
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
An IP explicit path is a list of IP addresses that represent a node or link in the explicit path.
Task ID |
Operations |
---|---|
mpls-te |
read |
The following shows a sample output from the show explicit-paths command:
RP/0/RP0/CPU0:router# show explicit-paths
Path ToR2 status enabled
0x1: next-address 192.168.1.2
0x2: next-address 10.20.20.20
Path ToR3 status enabled
0x1: next-address 192.168.1.2
0x2: next-address 192.168.2.2
0x3: next-address 10.30.30.30
Path 100 status enabled
0x1: next-address 192.168.1.2
0x2: next-address 10.20.20.20
Path 200 status enabled
0x1: next-address 192.168.1.2
0x2: next-address 192.168.2.2
0x3: next-address 10.30.30.30
Field |
Description |
---|---|
Path |
Pathname or number, followed by the path status. |
1: next-address |
First IP address in the path. |
2: next-address |
Second IP address in the path. |
The following shows a sample output from the show explicit-paths command using a specific path name:
RP/0/RP0/CPU0:router# show explicit-paths name ToR3
Path ToR3 status enabled
0x1: next-address 192.168.1.2
0x2: next-address 192.168.2.2
0x3: next-address 10.30.30.30
The following shows a sample output from the show explicit-paths command using a specific path number:
RP/0/RP0/CPU0:router# show explicit-paths identifier 200
Path 200 status enabled
0x1: next-address 192.168.1.2
0x2: next-address 192.168.2.2
0x3: next-address 10.30.30.30
Command |
Description |
---|---|
Specifies the next IP address to exclude from the explicit path. |
|
Specifies path entries at a specific index. |
To display IPv4 and IPv6 statistics for MPLS traffic engineering (TE) tunnels, use the show interfaces tunnel-te accounting command in EXEC mode.
show interfaces tunnel-te tunnel-number accounting [ location location-id | | rates ]
tunnel-number |
Specifies TE tunnel number. Range is from 0 to 6553. |
location location-id |
Specifies fully qualified location of the TE tunnel. |
rates |
Displays interface accounting rates. |
None
EXEC
Release | Modification |
---|---|
Release 5.1.1 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID | Operation |
---|---|
mpls-te |
read |
This example displays accounting information from tunnel-te interface 1:
RP/0/RP0/CPU0:router#show interface tunnel-te 1 accounting
tunnel-te1
Protocol Pkts In Chars In Pkts Out Chars Out
IPV4_UNICAST 0 0 5 520
IPV6_UNICAST 0 0 15 1560
To display the color name-to-value mappings configured on the router, use the show mpls traffic-eng affinity-map command in EXEC mode.
show mpls traffic-eng affinity-map
This command has no arguments or keywords.
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 3.4.0 |
This command was introduced. |
Release 3.9.0 |
The Bit Position field was added to the sample output. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
If the affinity value of an affinity associated with an affinity constraint is unknown, the show mpls traffic-eng affinity-map command output displays: "(refers to undefined affinity name)"
Task ID |
Operations |
---|---|
mpls-te |
read |
The following shows a sample output from the show mpls traffic-eng affinity-map command:
RP/0/RP0/CPU0:router# show mpls traffic-eng affinity-map
Affinity Name Bit-position Affinity Value
---------------------------------- -------------- ----------------
bcdefghabcdefghabcdefghabcdefgha 0 1
red1 1 2
red2 2 4
red3 3 8
red4 4 10
red5 5 20
red6 6 40
red7 7 80
red8 8 100
red9 9 200
red10 10 400
red11 11 800
red12 12 1000
red13 13 2000
red14 14 4000
red15 15 8000
red16 16 10000
cdefghabcdefghabcdefghabcdefghab 17 20000
red18 18 40000
red19 19 80000
red20 20 100000
red21 21 200000
red22 22 400000
red23 23 800000
red24 24 1000000
red25 25 2000000
red26 26 4000000
red27 27 8000000
black28 28 10000000
red28 29 20000000
red30 30 40000000
abcdefghabcdefghabcdefghabcdefgh 31 80000000
Table 1describes the significant fields shown in the display.
Field |
Description |
---|---|
Affinity Name |
Affinity name associated with the tunnel affinity constraints. |
Bit-position |
Bit position set in the 32-bit affinity value |
Affinity Value |
Affinity value associated with the affinity name. |
Command |
Description |
---|---|
Configures an affinity (the properties the tunnel requires in its links) for an MPLS-TE tunnel. |
|
Assigns a numerical value to each affinity name. |
To display the attribute set for MPLS-TE, use the show mpls traffic-eng attribute-set command in EXEC mode.
show mpls traffic-eng attribute-set [ auto-backup | auto-mesh | path-option | xro | [attribute-set-name] ]
auto-backup | Displays information for the auto-backup attribute type. |
auto-mesh | Displays information for the auto-mesh attribute type. |
path-option | Displays information for the path-option attribute type. |
xro | Displays information for the XRO attribute type. |
attribute-set-name | Specifies the name of the attribute set to be displayed. |
Displays information about all types of attribute sets.
EXEC mode
Release |
Modification |
---|---|
Release 4.2.0 |
This command was introduced. |
Release 4.3.0 |
The xro keyword was added. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
To use this command, first enable the MPLS-TE application.
Task ID | Operation |
---|---|
mpls-te |
read |
ouni |
read |
The following command shows the attribute set for auto-backup attribute type.
RP/0/RP0/CPU0:router# show mpls traffic-eng attribute-set auto-backup auto1
Attribute Set Name: auto1 (Type: auto-backup)
Affinity: 0x0/0xffff (Default)
Priority: 7 7 (Default)
Record-route: Enabled
Policy-class: 0 (Not configured)
Logging: None
List of protected interfaces (count 0)
List of tunnel IDs (count 0)
The following command shows the attribute set for auto-mesh attribute type.
RP/0/RP0/CPU0:router# show mpls traffic-eng attribute-set auto-mesh mesh1
Attribute Set Name: mesh1 (Type: auto-mesh)
Bandwidth: 0 kbps (CT0) (Default)
Affinity: 0x0/0xffff (Default)
Priority: 7 7 (Default)
Interface Bandwidth: 0 kbps (Default)
AutoRoute Announce: Disabled
Auto-bw: Disabled
Soft Preemption: Disabled
Fast Reroute: Disabled, Protection Desired: None
Record-route: Disabled
Policy-class: 0 (Not configured)
Logging: None
List of Mesh Groups (count 0)
The following command shows the attribute set for path-option attribute type.
RP/0/RP0/CPU0:router# show mpls traffic-eng attribute-set path-option path1
Attribute Set Name: path1 (Type: path option)
Bandwidth: 0 kbps (CT0) (Default)
Affinity: 0x0/0xffff (Default)
List of tunnel IDs (count 0)
The following command shows the attribute set for xro.
RP/0/RP0/CPU0:router# show mpls traffic-eng attribute-set xro
Attribute Set Name: foo (Type: XRO)
Number of XRO constraints : 2
LSP, best-effort, LSP-id used
Specified by FEC: tunnel-id 55, LSP-id 88, ext. id 10.10.10.10
source 10.10.10.10, destination 20.20.20.20
LSP, strict, LSP-id ignored
Specified by FEC: tunnel-id 3, LSP-id 0, ext. id 1.1.1.1
source 1.1.1.1, destination 2.2.2.2
To display tunnels that are announced to the Interior Gateway Protocol (IGP), including information about next hop and destinations, use the show mpls traffic-eng autoroute command in EXEC mode.
show mpls traffic-eng autoroute [ name tunnel-name ] [IP-address]
IP-address |
(Optional) Tunnel leading to this address. |
name tunnel-name |
(Optional) Specifies a tunnel by name. |
None
EXEC
Release |
Modification |
---|---|
Release 2.0 |
This command was introduced. |
Release 5.1.1 |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The traffic-engineering tunnels are taken into account for the enhanced shortest path first (SPF) calculation of the IGP. The show mpls traffic-eng autoroute command displays those tunnels that IGP is currently using in its enhanced SPF calculation (that is, those tunnels that are up and have autoroute configured).
Tunnels are organized by destination. All tunnels to a destination carry a share of the traffic tunneled to that destination.
Task ID |
Operations |
---|---|
mpls-te |
read |
The following shows a sample output from the show mpls traffic-eng autoroute command:
RP/0/RP0/CPU0:router# show mpls traffic-eng autoroute
Destination 103.0.0.3 has 2 tunnels in OSPF 0 area 0
tunnel-te1 (traffic share 1, nexthop 103.0.0.3)
tunnel-te2 (traffic share 1, nexthop 103.0.0.3)
Field |
Description |
---|---|
Destination |
Multiprotocol Label Switching (MPLS) TE tail-end router ID. |
traffic share |
A factor, based on bandwidth, indicating how much traffic this tunnel should carry, relative to other tunnels, to the same destination. If two tunnels go to a single destination, one with a traffic share of 200 and the other with a traffic share of 100, the first tunnel carries two-thirds of the traffic. |
Nexthop |
Next-hop router ID of the MPLS-TE tunnel. |
absolute metric |
Metric with mode absolute for the MPLS-TE tunnel. |
relative metric |
Metric with mode relative for the MPLS-TE tunnel. |
RP/0/RP0/CPU0:router# show mpls traffic-eng autoroute
Destination 192.168.0.4 has 1 tunnels in OSPF ring area 0
tunnel-te1 (traffic share 0, nexthop 192.168.0.4)
Signalled-Name: rtrA_t1
RP/0/RP0/CPU0:router#show mpls traffic-eng autoroute
Destination 192.168.0.1 has 1 tunnels in IS-IS ring level 1
tunnel-te1 (traffic share 0, nexthop 192.168.0.1)
(IS-IS ring level-1, IPV4 Unicast)
(IS-IS ring level-1, IPV6 Unicast)
Command |
Description |
---|---|
Specifies the MPLS-TE tunnel metric that the IGP-enhanced SPF calculation uses. |
|
Displays information about MPLS-TE tunnels. |
|
Specifies the time that a router should ignore a link in its TE topology database in tunnel path CSPF computations following a TE tunnel signalling error on the link. |
To display information about automatically build MPLS-TE backup tunnels, use the show mpls traffic-eng auto-tunnel backup command in EXEC mode.
show mpls traffic-eng auto-tunnel { backup [ private | summary | unused ] }
backup | Displays information about auto-tunnel backup. |
private |
(Optional) Displays private information about the automatically build MPLS-TE backup tunnels. |
summary |
(Optional) Displays the automatically build MPLS-TE backup tunnels summary information. |
unused | (Optional) Displays only unused MPLS-TE backup tunnels. |
No default behavior or values
EXEC
Release | Modification |
---|---|
Release 4.0.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID | Operation |
---|---|
mpls-te |
read |
This is sample output from the show mpls traffic-eng auto-tunnel backup command:
AutoTunnel Backup Configuration: Interfaces count: 4 Unused removal timeout: 1h 0m 0s Configured tunnel number range: 2000-2500 AutoTunnel Backup Summary: AutoTunnel Backups: 1 created, 1 up, 0 down, 0 unused 1 NHOP, 0 NNHOP, 0 SRLG strict, 0 SRLG preferred Protected LSPs: 1 NHOP, 0 NHOP+SRLG 0 NNHOP, 0 NNHOP+SRLG Protected S2L Sharing Families: 0 NHOP, 0 NHOP+SRLG 0 NNHOP, 0 NNHOP+SRLG Protected S2Ls: 0 NHOP, 0 NHOP+SRLG 0 NNHOP, 0 NNHOP+SRLG Cumulative Counters (last cleared 05:17:19 ago): Total NHOP NNHOP Created: 1 1 0 Connected: 1 1 0 Removed (down): 0 0 0 Removed (unused): 0 0 0 Removed (in use): 0 0 0 Range exceeded: 0 0 0 AutoTunnel Backups: Tunnel State Protection Prot. Protected Protected Name Offered Flows* Interface Node -------------- ------- ------------ ------- --------------- --------------- tunnel-te2000 up NHOP 1 Gi0/2/0/2 N/A *Prot. Flows = Total Protected LSPs, S2Ls and S2L Sharing Families
This is sample output from the show mpls traffic-eng auto-tunnel mesh command:
RP/0/RP0/CPU0:router#show mpls traffic-eng auto-tunnel mesh
Auto-tunnel Mesh Global Configuration:
Unused removal timeout: 2h
Configured tunnel number range: 10000-12000
Auto-tunnel Mesh Groups Summary:
Mesh Groups count: 5
Mesh Groups Destinations count: 50
Mesh Group 40 (2 Destinations, 1 Up, 1 Down):
Destination-list: dl-40
Attribute-set: ta_name
Destination: 40.40.40.40, tunnel-id: 10000, State: Up
Destination: 10.10.10.10, tunnel-id: 10001, State: Down
Mesh Group 41 (3 Destinations, 2 Up, 1 Down):
Destination-list: dl-40
Attribute-set: ta_name
Destination: 4.4.4.4, tunnel-id: 10005, State: Up
Destination: 3.3.3.3, tunnel-id: 10006, State: Up
Destination: 1.1.1.1, tunnel-id: 10007, State: Down
Mesh Group 51 (0 Destinations, 0 Up, 0 Down):
Destination-list: Not configured
Attribute-set: Not configured
Mesh Group 52 (0 Destinations, 0 Up, 0 Down):
Destination-list: NAME1 (Not defined)
Attribute-set: NAME2 (Not defined)
Mesh Group 53 (2 Destinations, 1 Up, 1 Down):
Destination-list: dl-53
Attribute-set: Not configured
Destination: 40.40.40.40, tunnel-id: 10000, State: Up
Destination: 10.10.10.10, tunnel-id: 10001, State: Down
Cumulative Counters (last cleared 7h ago):
Total
Created: 100
Connected: 50
Removed (unused): 50
Removed (in use): 0
Range exceeded: 0
This is sample output from the show mpls traffic-eng auto-tunnel private command:
Auto-tunnel Mesh Private Information: ID allocator overall maximum ID: 4096 ID allocator last allocated ID: 50999 ID allocator number IDs allocated: 1000
To display information about automatically built MPLS-TE mesh tunnels, use the show mpls traffic-eng auto-tunnel mesh command in EXEC mode.
show mpls traffic-eng auto-tunnel mesh { mesh-value | unused | summary | attribute-set name | destination address | destination-list name | down | up | tunnel { created | not-created } | | onehop }
mesh mesh-value |
Displays the tunnels that belong to the specified auto-tunnel mesh group. The range of mesh group ID is from 0 to 4294967295. |
attribute-set name |
Displays mesh-groups configured with a specific attribute set. |
destination address |
Displays only the destinations with a specified address. |
destination-list name |
Displays mesh-groups configured with a specified prefix-list. |