Cisco IOS Multiprotocol Label Switching Command Reference
mpls static binding ipv4 vrf through mpls traffic-eng logging tunnel

Table Of Contents

mpls static binding ipv4 vrf

mpls static crossconnect

mpls traffic-eng

mpls traffic-eng administrative-weight

mpls traffic-eng area

mpls traffic-eng atm cos global-pool

mpls traffic-eng atm cos sub-pool

mpls traffic-eng attribute-flags

mpls traffic-eng auto-bw timers

mpls traffic-eng auto-tunnel backup

mpls traffic-eng auto-tunnel backup config

mpls traffic-eng auto-tunnel backup nhop-only

mpls traffic-eng auto-tunnel backup srlg exclude

mpls traffic-eng auto-tunnel backup timers

mpls traffic-eng auto-tunnel backup tunnel-num

mpls traffic-eng auto-tunnel mesh

mpls traffic-eng auto-tunnel mesh tunnel-num

mpls traffic-eng auto-tunnel primary config

mpls traffic-eng auto-tunnel primary config mpls ip

mpls traffic-eng auto-tunnel primary onehop

mpls traffic-eng auto-tunnel primary timers

mpls traffic-eng auto-tunnel primary tunnel-num

mpls traffic-eng backup-path

mpls traffic-eng backup-path tunnel

mpls traffic-eng ds-te bc-model

mpls traffic-eng ds-te mode

mpls traffic-eng fast-reroute backup-prot-preemption

mpls traffic-eng fast-reroute timers

mpls traffic-eng flooding thresholds

mpls traffic-eng interface

mpls traffic-eng link timers bandwidth-hold

mpls traffic-eng link timers periodic-flooding

mpls traffic-eng link-management timers bandwidth-hold

mpls traffic-eng link-management timers periodic-flooding

mpls traffic-eng logging lsp

mpls traffic-eng logging tunnel


mpls static binding ipv4 vrf

To bind a prefix to a local label, use the mpls static binding ipv4 vrf command in global configuration mode. To remove static binding between the prefix and label, use the no form of this command.

mpls static binding ipv4 vrf vpn-name prefix mask {input label | label}

no mpls static binding ipv4 vrf vpn-name prefix mask [input label | label]

Syntax Description

vpn-name

The VPN routing and forwarding (VRF) instance.

prefix mask

The destination prefix and mask.

input label

A local (incoming) label.

This argument is optional for the no form of the command.

label

A local label.

This argument is optional for the no form of the command.


Command Default

Label bindings are dynamically assigned.

Command Modes

Global configuration

Command History

Release
Modification

12.0(26)S

This command was introduced.

12.3(14)T

This command was integrated into Cisco IOS Release 12.3(14)T.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.2(33)SB

This command was integrated into Cisco IOS Release 12.2(33)SB.


Usage Guidelines

The mpls static binding ipv4 vrf command is used only when you configure input labels.

Depending on how you configure the MPLS LDP VRF-Aware Static Labels feature, static labels are advertised one of the following ways:

By Label Distribution Protocol (LDP) between provider edge (PE) and customer edge (CE) routers within a VRF instance.

In VPNv4 Border Gateway Protocol (BGP) in the service provider's backbone.

If you do not specify the input keyword, an input (local) label is assumed.

The no form of the command functions as follows:

Omitting the prefix and the subsequent parameters removes all static bindings.

Specifying the prefix and mask but no label parameters removes all static bindings for that prefix or mask.

Examples

The following example binds a prefix to local label 17:

Router(config)# mpls static binding ipv4 vrf vpn100 10.66.0.0 255.255.0.0 input 17

Related Commands

Command
Description

show mpls static binding ipv4 vrf

Displays configured static bindings.


mpls static crossconnect

To configure a Label Forwarding Information Base (LFIB) entry for the specified incoming label and outgoing interface, use the mpls static crossconnect command in global configuration mode. To remove the LFIB entry, use the no form of this command.

mpls static crossconnect inlabel out-interface nexthop {outlabel | explicit-null | implicit-null}

no mpls static crossconnect inlabel out-interface nexthop {outlabel | explicit-null | implicit-null}

Syntax Description

inlabel

The incoming label.

out-interface

The outgoing interface.

nexthop

The destination next-hop router. (Use for multiaccess interfaces only.)

outlabel

The outgoing label.

explicit-null

The IETF MPLS IPv4 explicit null label (0).

implicit-null

The IETF MPLS implicit null label (3).


Command Default

Cross connects are not created.

Command Modes

Global configuration

Command History

Release
Modification

12.0(23)S

This command was introduced.

12.3(14)T

This command was integrated into Cisco IOS Release 12.3(14)T.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.2(33)SB

This command was integrated into Cisco IOS Release 12.2(33)SB.


Usage Guidelines

You must specify the nexthop address for multiaccess interfaces.

Examples

In the following example, the mpls static crossconnect command configures a cross connect from incoming label 45 to outgoing label 46 through POS interface POS5/0:

Router(config)# mpls static crossconnect 45 pos5/0 46

Related Commands

Command
Description

show mpls static crossconnect

Displays statically configured LFIB entries.


mpls traffic-eng

To configure a router running Intermediate System-to-Intermediate System (IS-IS) so that it floods Multiprotocol Label Switching (MPLS) traffic engineering (TE) link information into the indicated IS-IS level, use the mpls traffic-eng command in router configuration mode. To disable the flooding of MPLS TE link information into the indicated IS-IS level, use the no form of this command.

mpls traffic-eng {level-1 | level-2}

no mpls traffic-eng {level-1 | level-2}

Syntax Description

level-1

Floods MPLS TE link information into IS-IS level 1.

level-2

Floods MPLS TE link information into IS-IS level 2.


Defaults

Flooding is disabled.

Command Modes

Router configuration

Command History

Release
Modification

12.0(5)S

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

This command, which is part of the routing protocol tree, causes link resource information (such as available bandwidth) for appropriately configured links to be flooded in the IS-IS link-state database.

Examples

The following example shows how to configure MPLS TE link information flooding for IS-IS level 1:

Router(config-router)# mpls traffic-eng level-1

Related Commands

Command
Description

mpls traffic-eng router-id

Specifies that the traffic engineering router identifier for the node is the IP address associated with a given interface.


mpls traffic-eng administrative-weight

To override the Interior Gateway Protocol (IGP) administrative weight (cost) of the link, use the mpls traffic-eng administrative-weight command in interface configuration mode. To disable the override, use the no form of this command.

mpls traffic-eng administrative-weight weight

no mpls traffic-eng administrative-weight

Syntax Description

weight

Cost of the link.


Defaults

IGP cost of the link.

Command Modes

Interface configuration

Command History

Release
Modification

12.0(5)S

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Examples

The following example shows how to override the IGP cost of the link and set the cost to 20:

Router(config-if)# mpls traffic-eng administrative-weight 20

Related Commands

Command
Description

mpls traffic-eng attribute-flags

Sets the user-specified attribute flags for an interface.


mpls traffic-eng area

To configure a router running Open Shortest Path First (OSPF) Multiprotocol Label Switching (MPLS) so that it floods traffic engineering for the indicated OSPF area, use the mpls traffic-eng area command in router configuration mode. To disable flooding of traffic engineering for the indicated OSPF area, use the no form of this command.

mpls traffic-eng area number

no mpls traffic-eng area number

Syntax Description

number

The OSPF area on which MPLS traffic engineering is enabled.


Defaults

Flooding is disabled.

Command Modes

Router configuration

Command History

Release
Modification

12.0(5)S

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

This command is in the routing protocol configuration tree and is supported for both OSPF and IS-IS. The command affects the operation of MPLS traffic engineering only if MPLS traffic engineering is enabled for that routing protocol instance. Currently, only a single level can be enabled for traffic engineering.

Examples

The following example shows how to configure a router running OSPF MPLS to flood traffic engineering for OSPF 0:

Router(config-router)# mpls traffic-eng area 0

Related Commands

Command
Description

mpls traffic-eng router-id

Specifies that the traffic engineering router identifier for the node is the IP address associated with a given interface.

network area

Defines the interfaces on which OSPF runs and defines the area ID for those interfaces.

router ospf

Configures an OSPF routing process on a router.


mpls traffic-eng atm cos global-pool


Note Effective with Cisco IOS Release 12.4(20)T, the mpls traffic-eng atm cos global-pool command is not available in Cisco IOS software.


To specify the class of service for all global pools in traffic engineering tunnels traversing XTagATM interfaces on an ATM-label switch router (LSR), use the mpls traffic-eng atm cos global-pool command in global configuration mode.

mpls traffic-eng atm cos global-pool [available | standard | premium | control]

Syntax Description

available | standard | premium | control

(Optional) Four classes of service, ordered from lowest priority (available) to highest priority (control). The default is available.


Defaults

The default class is the lowest, available.

Command Modes

Global configuration (config)

Command History

Release
Modification

12.2(8)T

This command was introduced.

12.4(20)T

This command was removed.


Usage Guidelines

Because this command works at the global rather than at the interface level, it sets the same class of service for global pool traffic engineering (TE) tunnel traffic on all XTagATM interfaces of the device.

Examples

The following example shows how to specify the second-lowest possible priority class of service for the global pool traffic:

Router(config)# mpls traffic-eng atm cos global-pool standard

Related Commands

Command
Description

mpls traffic-eng atm cos sub-pool

Specifies class of service for subpool traffic traversing XtagATM interfaces.


mpls traffic-eng atm cos sub-pool


Note Effective with Cisco IOS Release 12.4(20)T, the mpls traffic-eng atm cos sub-pool command is not available in Cisco IOS software.


To specify the class of service for all subpools in traffic engineering tunnels traversing XTagATM interfaces on an ATM-label switch router (LSR), use the mpls traffic-eng atm cos sub-pool command in global configuration mode.

mpls traffic-eng atm cos sub-pool [available | standard | premium | control]

Syntax Description

available | standard | premium | control

Four classes of service, ordered from lowest priority (available) to highest priority (control). The default is control.


Defaults

The default class is the highest, control.

Command Modes

Global configuration (config)

Command History

Release
Modification

12.2(8)T

This command was introduced.

12.4(20)T

This command was removed.


Usage Guidelines

Because this command works at the global rather than at the interface level, it sets the same class of service for subpool traffic engineering (TE) tunnel traffic on all XTagATM interfaces of the device.

Examples

The following example shows how to specify the second-highest possible priority class of service for the subpool traffic:

Router(config)# mpls traffic-eng atm cos sub-pool premium

Related Commands

Command
Description

mpls traffic-eng atm cos global-pool

Specifies class of service for global-pool traffic traversing XTagATM interfaces.


mpls traffic-eng attribute-flags

To set the user-specified attribute flags for the interface, use the mpls traffic-eng attribute-flags command in interface configuration mode. To disable the user-specified attribute flags for the interface, use the no form of this command.

mpls traffic-eng attribute-flags attributes

no mpls traffic-eng attribute-flags

Syntax Description

attributes

Links attributes that will be compared to a tunnel's affinity bits during selection of a path.

Valid values are from 0x0 to 0xFFFFFFFF, representing 32 attributes (bits) where the value of an attribute is 0 or 1.


Defaults

0x0

Command Modes

Interface configuration

Command History

Release
Modification

12.0(5)S

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

This 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 is flooded globally so that it can be used as a tunnel head-end path selection criterion.

Examples

The following example shows how to set the attribute flags to 0x0101:

Router(config-if)# mpls traffic-eng attribute-flags 0x0101

Related Commands

Command
Description

mpls traffic-eng administrative-weight

Overrides the IGP administrative weight of the link.

tunnel mpls traffic-eng affinity

Configures affinity (the properties that the tunnel requires in its links) for an MPLS traffic engineering tunnel.


mpls traffic-eng auto-bw timers

To enable automatic bandwidth adjustment for a platform and to start output rate sampling for tunnels configured for automatic bandwidth adjustment, use the mpls traffic-eng auto-bw timers command in global configuration mode. To disable automatic bandwidth adjustment for the platform, use the no form of this command.

mpls traffic-eng auto-bw timers [frequency seconds]

no mpls traffic-eng auto-bw timers

Syntax Description

frequency seconds

(Optional) Interval, in seconds, for sampling the output rate of each tunnel configured for automatic bandwidth. The value must be from 1 through 604800. The recommended value is 300.


Command Default

When the optional frequency keyword is not specified, the sampling interval is 300 seconds (5 minutes).

Command Modes

Global configuration

Command History

Release
Modification

12.2(4)T

This command was introduced.

12.2(11)S

This command was integrated into Cisco IOS Release 12.2(11)S.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.


Usage Guidelines

The mpls traffic-eng auto-bw timers command enables automatic bandwidth adjustment on a platform by causing traffic engineering to periodically sample the output rate for each tunnel configured for bandwidth adjustment.

The no mpls traffic-eng auto-bw timers command disables automatic bandwidth adjustment for a platform by terminating the output rate sampling and bandwidth adjustment for tunnels configured for adjustment. In addition, the no form of the command restores the configured bandwidth for each tunnel where "configured bandwidth" is determined as follows:

If the tunnel bandwidth was explicitly configured via the tunnel mpls traffic-eng bandwidth command after the running configuration was written (if at all) to the startup configuration, the "configured bandwidth" is the bandwidth specified by that command.

Otherwise, the "configured bandwidth" is the bandwidth specified for the tunnel in the startup configuration.

Examples

The following example shows how to designate that for each Multiprotocol Label Switching (MPLS) traffic engineering tunnel, the output rate is sampled once every 10 minutes (every 600 seconds):

Router(config)# mpls traffic-eng auto-bw timers frequency 600

Related Commands

Command
Description

tunnel mpls traffic-eng auto-bw

Enables automatic bandwidth adjustment for a tunnel, specifies the frequency with which tunnel bandwidth can be automatically adjusted, and designates the allowable range of bandwidth adjustments.

tunnel mpls traffic-eng bandwidth

Configures bandwidth required for an MPLS traffic engineering tunnel.


mpls traffic-eng auto-tunnel backup

To automatically build next-hop (NHOP) and next-next hop (NNHOP) backup tunnels, use the mpls traffic-eng auto-tunnel backup command in global configuration mode. To delete the NHOP and NNHOP backup tunnels, use the no form of this command.

mpls traffic-eng auto-tunnel backup

no mpls traffic-eng auto-tunnel backup

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Global configuration

Command History

Release
Modification

12.0(27)S

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.


Usage Guidelines

The no form of this command deletes both NHOP and NNHOP backup tunnels that were configured using either the mpls traffic-eng auto-tunnel backup command or the mpls traffic-eng auto-tunnel backup nhop-only command.

Examples

The following example automatically builds NHOP and NNHOP backup tunnels:

Router# mpls traffic-eng auto-tunnel backup

Related Commands

Command
Description

mpls traffic-eng auto-tunnel backup config

Enables IP processing without an explicit address.

mpls traffic-eng auto-tunnel backup nhop-only

Enables the creation of only dynamic next-hop backup tunnels.

mpls traffic-eng auto-tunnel backup timers

Configures how frequently a timer will scan backup autotunnels and remove tunnels that are not being used.

mpls traffic-eng auto-tunnel backup tunnel-num

Configures the range of tunnel interface numbers for backup autotunnels.


mpls traffic-eng auto-tunnel backup config

To enable IP processing without an explicit address, use the mpls traffic-eng auto-tunnel backup config command in global configuration mode. To disable IP processing without an explicit address, use the no form of this command.

mpls traffic-eng auto-tunnel backup config unnumbered-interface interface

no mpls traffic-eng auto-tunnel backup config unnumbered-interface interface

Syntax Description

unnumbered-interface interface

Interface on which IP processing will be enabled without an explicit address. Default: Loopback0.


Command Default

None

Command Modes

Global configuration

Command History

Release
Modification

12.0(27)S

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.


Examples

The following example enables IP processing on an Ethernet interface without an explicit address:

Router# mpls traffic-eng auto-tunnel backup config unnumbered-interface ethernet1/0

Related Commands

Command
Description

mpls traffic-eng auto-tunnel backup

Automatically builds NHOP and NNHOP backup tunnels.

mpls traffic-eng auto-tunnel backup nhop-only

Enables the creation of only dynamic next-hop backup tunnels.

mpls traffic-eng auto-tunnel backup timers

Configures how frequently a timer will scan backup autotunnels and remove tunnels that are not currently being used.

mpls traffic-eng auto-tunnel backup tunnel-num

Configures the range of tunnel interface numbers for backup autotunnels.


mpls traffic-eng auto-tunnel backup nhop-only

To automatically build next-hop (NHOP) backup tunnels, use the mpls traffic-eng auto-tunnel backup nhop-only command in global configuration mode. To delete the NHOP backup tunnels, use the no form of this command.

mpls traffic-eng auto-tunnel backup nhop-only

no mpls traffic-eng auto-tunnel backup nhop-only

Syntax Description

This command has no arguments or keywords.

Command Default

The dynamically created backup tunnel uses Loopback0.

Command Modes

Global configuration

Command History

Release
Modification

12.0(27)S

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.


Usage Guidelines

This command permits the creation of only NHOP backup tunnels; next-next hop (NNHOP) backup tunnels are not created. The no form of this command deletes only the NHOP backup tunnels; NNHOP backup tunnels are not deleted.

Examples

The following example enables the creation of only dynamic NHOP backup tunnels:

Router# mpls traffic-eng auto-tunnel backup nhop-only

Related Commands

Command
Description

mpls traffic-eng auto-tunnel backup

Automatically builds NHOP and NNHOP backup tunnels.

mpls traffic-eng auto-tunnel backup config

Enables IP processing without an explicit address.

mpls traffic-eng auto-tunnel backup timers

Configures how frequently a timer will scan backup autotunnels and remove tunnels that are not being used.

mpls traffic-eng auto-tunnel backup tunnel-num

Configures the range of tunnel interface numbers for backup autotunnels.


mpls traffic-eng auto-tunnel backup srlg exclude

To specify that autocreated backup tunnels should avoid Shared Risk Link Groups (SRLGs) of the protected interface, use the mpls traffic-eng auto-tunnel backup srlg exclude command in global configuration mode. To disable this feature, use the no form of this command.

mpls traffic-eng auto-tunnel backup srlg exclude [force | preferred]

no mpls traffic-eng auto-tunnel backup srlg exclude [force | preferred]

Syntax Description

force

(Optional) Forces the backup tunnel to avoid SRLGs of its protected interfaces.

preferred

(Optional) Causes the backup tunnel to try to avoid SRLGs of its protected interfaces, but the backup tunnel can be created if SRLGs cannot be avoided.


Command Default

Autocreated backup tunnels are created without regard to SRLGs.

Command Modes

Global configuration (config)

Command History

Release
Modification

12.0(28)S

This command was introduced.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.


Usage Guidelines

If you enter the command with either the force or preferred keyword and then reenter the command with the other keyword, only the last command entered is effective.

Examples

In the following example, backup tunnels must avoid SRLGs of the protected interface:

Router# configure terminal
Router(config)# mpls traffic-eng auto-tunnel backup srlg exclude force 

In the following example, backup tunnels should try to avoid SRLGs of the protected interface:

Router# configure terminal
Router(config)# mpls traffic-eng auto-tunnel backup srlg exclude preferred

Related Commands

Command
Description

mpls traffic-eng srlg

Configures the SRLG membership of a link (interface).


mpls traffic-eng auto-tunnel backup timers

To configure how frequently a timer will scan backup autotunnels and remove tunnels that are not being used, use the mpls traffic-eng auto-tunnel backup timers command in global configuration mode. To disable this configuration, use the no form of this command.

mpls traffic-eng auto-tunnel backup timers removal unused [sec]

no mpls traffic-eng auto-tunnel backup timers removal unused [sec]

Syntax Description

removal unused [sec]

Configures how frequently (in seconds) a timer will scan the backup autotunnels and remove tunnels that are not being used. Valid values are 0 to 604,800.


Command Default

The timer scans backup autotunnels and removes tunnels that are not being used every 3600 seconds (60 minutes).

Command Modes

Global configuration

Command History

Release
Modification

12.0(27)S

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.


Examples

The following example shows that a timer will scan backup autotunnels every 80 seconds and remove tunnels that are not being used:

Router# mpls traffic-eng auto-tunnel backup timers removal unused 80

Related Commands

Command
Description

mpls traffic-eng auto-tunnel backup

Automatically builds NHOP and NNHOP backup tunnels.

mpls traffic-eng auto-tunnel backup config

Enables IP processing without an explicit address.

mpls traffic-eng auto-tunnel backup nhop-only

Enables the creation of only dynamic next-hop backup tunnels.

mpls traffic-eng auto-tunnel backup tunnel-num

Configures the range of tunnel interface numbers for backup autotunnels.


mpls traffic-eng auto-tunnel backup tunnel-num

To configure the range of tunnel interface numbers for backup autotunnels, use the mpls traffic-eng auto-tunnel backup tunnel-num command in global configuration mode. To disable this configuration, use the no form of this command.

mpls traffic-eng auto-tunnel backup tunnel-num [min num] [max num]

no mpls traffic-eng auto-tunnel backup tunnel-num [min num] [max num]

Syntax Description

min num

(Optional) Minimum number of the backup tunnels. Valid values are from 0 to 65535. Default: 65436.

max num

(Optional) Maximum number of the backup tunnels. Valid values are from 0 to 65535. Default: 65535.


Command Default

None

Command Modes

Global configuration

Command History

Release
Modification

12.0(27)S

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.


Examples

The following example configures the range of backup autotunnel numbers to be between 1000 and 1100:

Router# mpls traffic-eng auto-tunnel backup tunnel-num min 1000 max 1100

Related Commands

Command
Description

mpls traffic-eng auto-tunnel backup

Automatically builds NHOP and NNHOP backup tunnels.

mpls traffic-eng auto-tunnel backup config

Enables IP processing without an explicit address.

mpls traffic-eng auto-tunnel backup nhop-only

Enables the creation of only dynamic next-hop backup tunnels.

mpls traffic-eng auto-tunnel backup timers

Configures how frequently a timer will scan backup autotunnels and remove tunnels that are not being used.


mpls traffic-eng auto-tunnel mesh

To enable autotunnel mesh groups globally, use the mpls traffic-eng auto-tunnel mesh command in global configuration mode. To disable autotunnel mesh groups globally, use the no form of this command.

mpls traffic-eng auto-tunnel mesh

no mpls traffic-eng auto-tunnel mesh

Syntax Description

This command has no arguments or keywords.

Command Default

Autotunnel mesh groups are not enabled globally.

Command Modes

Global configuration (config)#

Command History

Release
Modification

12.0(27)S

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.


Examples

The following example shows how to enable autotunnel mesh groups globally:

Router(config)# mpls traffic-eng auto-tunnel mesh

Related Commands

Command
Description

interface auto-template

Creates the template interface.


mpls traffic-eng auto-tunnel mesh tunnel-num

To configure a range of mesh tunnel interface numbers, use the mpls traffic-eng auto-tunnel mesh tunnel-num command in global configuration mode. To use the default values, use the no form of this command.

mpls traffic-eng auto-tunnel mesh tunnel-num min num max num

no mpls traffic-eng auto-tunnel mesh tunnel-num

Syntax Description

min num

Specifies the beginning number of the range of mesh tunnel interface numbers. Valid values are from 1 to 65535. The default value is 64336.

max num

Specifies the ending number of the range of mesh tunnel interface numbers. Valid values are from 1 to 65535. The default value is 65335.


Command Default

The min default is 64336. The max default is 65335.

Command Modes

Global configuration (config)#

Command History

Release
Modification

12.0(27)S

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.


Usage Guidelines

If you change an access control list (ACL) and tunnels are deleted because they no longer match the ACL, tunnels that are re-created might not be numbered sequentially; that is, the range of tunnel numbers might not be sequential.

Examples

The following example shows how to specify 1000 as the beginning number of the mesh tunnel interface and 2000 as the ending number:

Router(config)# mpls traffic-eng auto-tunnel mesh tunnel-num min 1000 max 2000

Related Commands

Command
Description

show mpls traffic-eng auto-tunnel mesh

Displays the cloned mesh tunnel interfaces of each autotemplate interface and the current range of mesh tunnel interface numbers.


mpls traffic-eng auto-tunnel primary config

To enable IP processing without an explicit address, use the mpls traffic-eng auto-tunnel primary config command in global configuration mode. To disable this capability, use the no form of this command.

mpls traffic-eng auto-tunnel primary config unnumbered interface

no mpls traffic-eng auto-tunnel primary config unnumbered interface

Syntax Description

unnumbered interface

Interface on which IP processing will be enabled without an explicit address.


Command Default

Loopback0

Command Modes

Global configuration

Command History

Release
Modification

12.0(27)S

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.


Examples

The following example enables IP processing on an Ethernet interface:

Router# mpls traffic-eng auto-tunnel primary config unnumbered ethernet1/0

Related Commands

Command
Description

mpls traffic-eng auto-tunnel primary config mpls ip

Enables LDP on primary autotunnels.

mpls traffic-eng auto-tunnel primary onehop

Automatically creates primary tunnels to all next-hops.

mpls traffic-eng auto-tunnel primary timers

Configures how many seconds after a failure primary autotunnels are removed.

mpls traffic-eng auto-tunnel primary tunnel-num

Configures the range of tunnel interface numbers for primary autotunnels.

show ip rsvp fast-reroute

Displays information about fast reroutable primary tunnels and their corresponding backup tunnels that provide protection.


mpls traffic-eng auto-tunnel primary config mpls ip

To enable Label Distribution Protocol (LDP) on primary autotunnels, use the mpls traffic-eng auto-tunnel primary config mpls ip command in global configuration mode. To disable LDP on primary autotunnels, use the no form of this command.

mpls traffic-eng auto-tunnel primary config mpls ip

no mpls traffic-eng auto-tunnel primary config mpls ip

Syntax Description

This command has no arguments or keywords.

Command Default

LDP is not enabled.

Command Modes

Global configuration

Command History

Release
Modification

12.0(27)S

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.


Examples

The following example enables LDP on primary autotunnels:

Router# mpls traffic-eng auto-tunnel primary config mpls ip

Related Commands

Command
Description

mpls traffic-eng auto-tunnel primary config

Enables IP processing without an explicit address.

mpls traffic-eng auto-tunnel primary onehop

Automatically creates primary tunnels to all next hops.

mpls traffic-eng auto-tunnel primary timers

Configures how many seconds after a failure primary autotunnels are removed.

mpls traffic-eng auto-tunnel primary tunnel-num

Configures the range of tunnel interface numbers for primary autotunnels.

show ip rsvp fast-reroute

Displays information about fast reroutable primary tunnels and their corresponding backup tunnels that provide protection.


mpls traffic-eng auto-tunnel primary onehop

To automatically create primary tunnels to all next hops, use the mpls traffic-eng auto-tunnel primary onehop command in global configuration mode. To disable the automatic creation of primary tunnels to all next hops, use the no form of this command.

mpls traffic-eng auto-tunnel primary onehop

no mpls traffic-eng auto-tunnel primary onehop

Syntax Description

This command has no arguments or keywords.

Command Default

The dynamically created one-hop tunnels use Loopback0.

Command Modes

Global configuration

Command History

Release
Modification

12.0(27)S

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.


Examples

The following example automatically creates primary tunnels to all next hops:

Router# mpls traffic-eng auto-tunnel primary onehop

Related Commands

Command
Description

mpls traffic-eng auto-tunnel primary config

Enables IP processing without an explicit address.

mpls traffic-eng auto-tunnel primary onehop

Enables LDP on primary autotunnels.

mpls traffic-eng auto-tunnel primary timers

Configures how many seconds after a failure primary autotunnels are removed.

mpls traffic-eng auto-tunnel primary tunnel-num

Configures the range of tunnel interface numbers for primary autotunnels.

show ip rsvp fast-reroute

Displays information about fast reroutable primary tunnels and their corresponding backup tunnels that provide protection.


mpls traffic-eng auto-tunnel primary timers

To configure how many seconds after a failure primary autotunnels are removed, use the mpls traffic-eng auto-tunnel primary timers command in global configuration mode. To disable this configuration, use the no form of this command.

mpls traffic-eng auto-tunnel primary timers removal rerouted sec

no mpls traffic-eng auto-tunnel primary timers removal rerouted sec

Syntax Description

removal rerouted sec

Number of seconds after a failure that primary autotunnels are removed. Valid values are 30 to 604,800. Default: 0.


Command Default

None

Command Modes

Global configuration

Command History

Release
Modification

12.0(27)S

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.


Examples

The following example shows that primary autotunnels are removed 100 seconds after a failure:

Router# mpls traffic-eng auto-tunnel primary timers removal rerouted 100

Related Commands

Command
Description

mpls traffic-eng auto-tunnel primary config

Enables IP processing without an explicit address.

mpls traffic-eng auto-tunnel primary tunnel-num

Enables LDP on primary autotunnels.

mpls traffic-eng auto-tunnel primary onehop

Automatically creates primary tunnels to all next hops.

mpls traffic-eng auto-tunnel primary tunnel-num

Configures the range of tunnel interface numbers for primary autotunnels.

show ip rsvp fast-reroute

Displays information about fast reroutable primary tunnels and their corresponding backup tunnels that provide protection.


mpls traffic-eng auto-tunnel primary tunnel-num

To configure the range of tunnel interface numbers for primary autotunnels, use the mpls traffic-eng auto-tunnel primary tunnel-num command in global configuration mode. To disable this configuration, use the no form of this command.

mpls traffic-eng auto-tunnel primary tunnel-num [min num] [max num]

no mpls traffic-eng auto-tunnel primary tunnel-num [min num] [max num]

Syntax Description

min num

(Optional) Minimum number of the primary tunnels. Valid values are from 0 to 65535. Default: 65436.

max num

(Optional) Maximum number of the primary tunnels. The max number is the minimum number plus 99. Valid values are from 0 to 65535.


Command Default

None

Command Modes

Global configuration

Command History

Release
Modification

12.0(27)S

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.


Examples

The following example shows that the primary tunnel numbers can be between 2000 and 2100:

Router# mpls traffic-eng auto-tunnel primary tunnel-num min 2000 max 2100

Related Commands

Command
Description

mpls traffic-eng auto-tunnel primary config

Enables IP processing without an explicit address.

mpls traffic-eng auto-tunnel primary config mpls ip

Enables LDP on primary autotunnels.

mpls traffic-eng auto-tunnel primary onehop

Automatically creates primary tunnels to all next hops.

mpls traffic-eng auto-tunnel primary timers

Configures how many seconds after a failure primary autotunnels are removed.

show ip rsvp fast-reroute

Displays information about fast reroutable primary tunnels and their corresponding backup tunnels that provide protection.


mpls traffic-eng backup-path

To assign one or more backup tunnels to a protected interface, use the mpls traffic-eng backup-path command in interface configuration mode.

mpls traffic-eng backup-path tunneltunnel-id

Syntax Description

tunneltunnel-id

Tunnel ID of the backup tunnel that can be used in case of a failure.


Command Default

No backup tunnels are used if this interface goes down.

Command Modes

Interface configuration

Command History

Release
Modification

12.0(10)ST

This command was introduced.

12.0(16)ST

With Link Protection, this command selected the one-and-only backup tunnel for a given protected interface. If you enter the command twice, the second occurrence overwrites the first occurrence.

12.0(22)S

You can now enter this command multiple times to select multiple backup tunnels for a given protected interface. This can be done for both Link and Node Protection. The command is supported on the Cisco 10000 series ESRs.

12.2(18)SXD1

This command was integrated into Cisco IOS Release 12.2(18)SXD1.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(31)SB2

This command was integrated into Cisco IOS Release 12.2(31)SB2.


Usage Guidelines

Enter this command on the interface to be protected (Link Protection), or on the interface whose downstream node is being protected (Node Protection). You can enter this command multiple times to select multiple backup tunnels for a given protected interface. An unlimited number of backup tunnels can be assigned to protect an interface. The only limitation is memory. By entering this command on a physical interface, LSPs using this interface (sending data out of this interface) can use the indicated backup tunnels if there is a link or node failure.

Examples

The following example assigns backup tunnel 34 to interface POS5/0:

Router(config)# interface pos5/0
Router(config-if)# mpls traffic-eng backup-path tunnel34

Related Commands

Command
Description

tunnel mpls traffic-eng fast-reroute

Enables an MPLS traffic engineering tunnel to use a backup tunnel if there is a link or node failure (provided that a backup tunnel exists).


mpls traffic-eng backup-path tunnel

To configure the physical interface to use a backup tunnel in the event of a detected failure on that interface, use the mpls traffic-eng backup-path tunnel command in interface configuration mode.

mpls traffic-eng backup-path tunnel interface

Syntax Description

interface

String that identifies the tunnel interface being created and configured.


Command Default

This command is disabled by default.

Command Modes

Interface configuration

Command History

Release
Modification

12.0(8)ST

This command was introduced.

12.2(18)S

This command was integrated into Cisco IOS Release 12.2(18)S.

12.2(18)SXD

This command was implemented on the Catalyst 6000 series with the SUP720 processor.

12.2(28)SB

This command was implemented on the Cisco 10000(PRE-2) router.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.


Examples

The following example specifies the traffic engineering backup tunnel with the identifier 1000:

Router(config-if)# mpls traffic-eng backup-path Tunnel 1000

Related Commands

Command
Description

show mpls traffic-eng fast-reroute database

Displays information about existing Fast Reroute configurations.

tunnel mpls traffic-eng fast-reroute

Enables an MPLS traffic engineering tunnel to use a backup tunnel in the event of a link failure (assuming a backup tunnel exists).


mpls traffic-eng ds-te bc-model

To enable a Bandwidth Constraints Model to be used by a router in DiffServ-aware Traffic Engineering, use the mpls traffic-eng ds-te bc-model global configuration command. (Using the no form of this command selects the default model, which is the Russian Dolls Model.)

mpls traffic-eng ds-te bc-model [rdm | mam]

no mpls traffic-eng ds-te bc-model [ rdm | mam ]

Syntax Description

rdm

Russian Dolls Model. (Described in IETF RFC 4127).

mam

Maximum Allocation Model. (Described in IETF RFC 4125).


Defaults

Russian Dolls Model is the default.

Command Modes

Global configuration

Command History

Release
Modification

12.2(33)SRB

This command was introduced.


Usage Guidelines

1. The Maximum Allocation Model should be selected when the network administrator needs to ensure isolation across all Class Types without having to use pre-emption, and can afford to risk some QoS degradation of Class Types other than the Preimum Class.

2. The Russian Dolls Model should be selected when the network administrator needs to prevent QoS degradation of all Class Types and can impose pre-emption.

Examples

In the following example,the Maximum Allocation Model is being selected:

Router(config)# mpls traffic-eng ds-te bc-model mam

mpls traffic-eng ds-te mode

To configure a router to enter DiffServ-aware Traffic Engineering modes which incorporate degrees of the IETF Standard, use the mpls traffic-eng ds-te mode global configuration command. Use the no form of this command to return the router to the pre-IETF-Standard mode.

mpls traffic-eng ds-te mode [migration | ietf]

no mpls traffic-eng ds-te mode [migration | ietf ]

Syntax Description

migration

A mode by which the router generates IGP and tunnel signalling according to the pre-IETF standard, but adds TE-class mapping and accepts advertisement in both the pre-IETF and the IETF-Standard formats.

ietf

The "Liberal" IETF mode, by which the router generates IGP advertisement and tunnel signalling according to the IETF Standard and responds to TE-class mapping, yet also accepts advertisement in both the pre-IETF-Standard and IETF-Standard formats.


Defaults

Pre-IETF-Standard mode is the default.

Command Modes

Global configuration

Command History

Release
Modification

12.2(33)SRB

This command was introduced.


Usage Guidelines

1. Place the router into Migration Mode only if it is still in the pre-IETF Standard ("Traditional") mode, and you want to begin upgrading its network to operate the IETF-Standard form of DS-TE.

2. Place the router into Liberal-IETF Mode only if its network is already in the Migration Mode, and you want to complete the upgrade of that network so it will operate the IETF-Standard form of DS-TE.

Examples

In the following example, the router is configured to operate in Migration Mode:

Router(config)# mpls traffic-eng ds-te migration

mpls traffic-eng fast-reroute backup-prot-preemption

To change the backup protection preemption algorithm to minimize the amount of bandwidth that is wasted, use the mpls traffic-eng fast-reroute backup-prot-preemption command in global configuration mode. To use the default algorithm of minimizing the number of label-switched paths (LSPs) that are demoted, use the no form of this command.

mpls traffic-eng fast-reroute backup-prot-preemption [optimize-bw]

no mpls traffic-eng fast-reroute backup-prot-preemption

Syntax Description

optimize-bw

(Optional) Minimizes the amount of bandwidth wasted.


Command Default

A minimum number of LSPs are preempted.

Command Modes

Global configuration

Command History

Release
Modification

12.0(29)S

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.


Usage Guidelines

The mpls traffic-eng fast-reroute backup-prot-preemption command allows you to determine the criteria the router will use when selecting the LSPs that will be preempted.

If you enter the command with the optimize-bw keyword, the router chooses LSPs that will waste the least amount of bandwidth.

If you do not enter the mpls traffic-eng fast-reroute backup-prot-preemption optimize-bw command, the router preempts as few LSPs as possible.

Each router in the network does not have to use the same algorithm; that is, you can specify optimize-bw for some routers in the network but not for others.

You can enter the mpls traffic-eng fast-re-route backup-prot-preemption command at any time. If you change the algorithm, it does not affect LSPs that already are protected. It only affects the placement of new LSPs signaled after you enter this command. The command can affect LSPs during the next periodic promotion cycle.

Examples

In the following examples, a next-next hop (NNHOP) backup tunnel has the following characteristics:

Total backup capacity: 240 units

Used backup bandwidth: 220 units

Available backup bandwidth: 20 units

The backup tunnel currently is protecting LSP1 through LSP5, which have the following bandwidth, and do not have backup bandwidth protection (that is, the "bandwidth protection desired" bit was not set via the tunnel mpls traffic-eng fast-reroute command):

LSP1: 10 units

LSP2: 20 units

LSP3: 30 units

LSP4: 60 units

LSP5: 100 units

As shown, LSP1 through LSP5 use 220 units of bandwidth.

LSP6 has backup bandwidth protection and needs 95 units of bandwidth. Twenty units of bandwidth are available, so 75 more units of bandwidth are needed.

In the following example, backup bandwidth protection is enabled and the amount of wasted bandwidth is minimized:

Router(config)# mpls traffic-eng fast-reroute backup-prot-preemption optimize-bw 

LSP2 and LS4 are preempted so that the least amount of bandwidth is wasted.

In the following example, backup protection preemption is enabled and the number of preempted LSPs is minimized:

Router(config)# no mpls traffic-eng fast-reroute backup-prot-preemption 

The router selects the LSP whose bandwidth is next-greater than the required bandwidth. Therefore, the router picks LSP5 because it has the next larger amount of bandwidth over 75. One LSP is demoted. and 25 units of bandwidth are wasted.

Related Commands

Command
Description

show ip rsvp fast bw-protect

Displays information about whether backup bandwidth protection is enabled and the status of backup tunnels that may be used to provide that protection.


mpls traffic-eng fast-reroute timers

To specify how often the router considers switching a label switched path (LSP) to a new (better) backup tunnel if additional backup bandwidth becomes available, use the mpls traffic-eng fast-reroute timers command in global configuration mode. To disable this timer, set the seconds value to zero or use the no form of this command.

mpls traffic-eng fast-reroute timers [promotion seconds]

no mpls traffic-eng fast-reroute timers

Syntax Description

promotion seconds

(Optional) Sets the interval, in seconds, between scans to determine if an LSP should use a new, better backup tunnel. Valid values are from 0 to 604800. A value of 0 disables promotions to a better LSP.


Command Default

The timer is running and is set to a frequency of every 300 seconds (5 minutes). If you enter the no mpls traffic-eng fast-reroute timers command, the router returns to this default behavior.

Command Modes

Global configuration

Command History

Release
Modification

12.0(22)S

This command was introduced.

12.2(18)SXD1

This command was integrated into Cisco IOS Release 12.2(18)SXD1.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(31)SB2

This command was integrated into Cisco IOS Release 12.2(31)SB2.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.


Examples

In the following example, LSPs are scanned every 2 minutes (120 seconds). The router uses this information to consider if the LSPs should be promoted to a better backup tunnel:

Router(config)# mpls traffic-eng fast-reroute timers promotion 120

mpls traffic-eng flooding thresholds

To set a reserved bandwidth thresholds for a link, use the mpls traffic-eng flooding thresholds command in interface configuration mode. To return to the default settings, use the no form of this command.

mpls traffic-eng flooding thresholds {down | up} percent [percent ...]

no mpls traffic-eng flooding thresholds {down | up}

Syntax Description

down

Sets the thresholds for decreased reserved bandwidth.

up

Sets the thresholds for increased reserved bandwidth.

percent [percent]

Bandwidth threshold level. For the down keyword, valid values are from 0 through 99. For the up keyword, valid values are from 1 through 100.


Defaults

The default for down is 100, 99, 98, 97, 96, 95, 90, 85, 80, 75, 60, 45, 30, 15.

The default for up is 15, 30, 45, 60, 75, 80, 85, 90, 95, 97, 98, 99, 100.

Command Modes

Interface configuration

Command History

Release
Modification

12.0(5)S

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

When a threshold is crossed, Multiprotocol Label Switching (MPLS) traffic engineering link management advertises updated link information. If no thresholds are crossed, changes can be flooded periodically unless periodic flooding was disabled.

Examples

The following example shows how to set the reserved bandwidth of the link for decreased (down) and for increased (up) thresholds:

Router(config-if)# mpls traffic-eng flooding thresholds down 100 75 25
Router(config-if)# mpls traffic-eng flooding thresholds up 25 50 100

Related Commands

Command
Description

mpls traffic-eng link timers periodic-flooding

Sets the length of the interval used for periodic flooding.

show mpls traffic-eng link-management advertisements

Displays local link information currently being flooded by MPLS traffic engineering link management into the global traffic engineering topology.

show mpls traffic-eng link-management bandwidth-allocation

Displays current local link information.


mpls traffic-eng interface

To enable Multiprotocol Label Switching (MPLS) Traffic Engineering (TE) link-state advertisement (LSA) for an interface to be advertised into the Open Shortest Path First (OSPF) area 0, use the mpls traffic-eng interface command in router configuration mode. To restore the setting of the MPLS TE LSA to the same area as the router LSA, use the no form of this command.

mpls traffic-eng interface interface area 0

no mpls traffic-eng interface interface area 0

Syntax Description

interface

The interface to be advertised with an MPLS TE LSA into OSPF area 0. The interface may be one or two words.


Defaults

The default is to advertise the area assigned to the interface by the OSPF network configuration.

Command Modes

Router configuration

Command History

Release
Modification

12.0(12)S

This command was introduced.

12.1(5)T

This command was integrated into Cisco IOS Release 12.1(5)T.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

Usually, the MPLS TE LSA is advertised into the same area as the router LSA. If a link between two Area Border Routers (ABRs) is in an OSPF area besides area 0, you can advertise the link between ABRs into area 0. This solves for TE the same problem that virtual links solve for IP routing. This command is valid only for OSPF. Issue the command on both ABRs for the interfaces at both ends of the link.

Examples

In the following example, OSPF advertises the MPLS TE LSA for interface pos2/0 to area 0:

Router(config)# router ospf 1
Router(config-router)# mpls traffic-eng interface pos2/0 area 0

Related Commands

Command
Description

mpls traffic-eng multicast-intact

Enables multicast-intact support from the OSPF routing protocol to maintain and publish the native IP nexthops (paths) for every OSPF route.


mpls traffic-eng link timers bandwidth-hold

To set the length of time that bandwidth is held for a Resource Reservation Protocol (RSVP) PATH (Set Up) message while waiting for the corresponding RSVP RESV message to come back, use the mpls traffic-eng link timers bandwidth-hold command in global configuration mode.

mpls traffic-eng link timers bandwidth-hold hold-time

Syntax Description

hold-time

Sets the length of time that bandwidth can be held. The range is from 1 to 300 seconds.


Defaults

15 seconds

Command Modes

Global configuration

Command History

Release
Modification

12.0(5)S

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Examples

The following example sets the length of time that bandwidth is held to 10 seconds.

Router(config)# mpls traffic-eng link-management timers bandwidth-hold 10

Related Commands

Command
Description

show mpls traffic-eng link-management bandwidth-allocation

Displays current local link information.


mpls traffic-eng link timers periodic-flooding

To set the length of the interval used for periodic flooding, use the mpls traffic-eng link timers periodic-flooding command in global configuration mode.

mpls traffic-eng link timers periodic-flooding interval

Syntax Description

interval

Length of interval used for periodic flooding (in seconds). The range is from 0 to 3600. If you set this value to 0, you turn off periodic flooding. If you set this value anywhere in the range from 1 to 29, it is treated as 30.


Defaults

180 seconds

Command Modes

Global configuration

Command History

Release
Modification

12.0(5)S

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

Use this command to set the interval for periodic flooding of traffic engineering (TE) topology information.

Changes in the Multiprotocol Label Switching (MPLS) TE topology database are flooded by the link state Interior Gateway Protocol (IGP). Some changes, such as those to link status (up/down) or configured parameters, trigger immediate flooding. Other changes are considered less urgent and are flooded periodically. For example, changes to the amount of link bandwidth allocated to TE tunnels are flooded periodically unless the change causes the bandwidth to cross a configurable threshold.

Examples

The following example sets the interval length for periodic flooding to advertise flooding changes to 120 seconds.

Router(config)# mpls traffic-eng timers periodic-flooding 120

Related Commands

Command
Description

mpls traffic-eng flooding thresholds

Sets the reserved bandwidth thresholds of a link.


mpls traffic-eng link-management timers bandwidth-hold

To set the length of time that bandwidth is held for an RSVP path (setup) message while you wait for the corresponding RSVP Resv message to come back, use the mpls traffic-eng link-management timers bandwidth-hold command in global configuration mode. To disable this function, use the no form of this command.

mpls traffic-eng link-management timers bandwidth-hold hold-time

no mpls traffic-eng link-management timers bandwidth-hold

Syntax Description

hold-time

Length of time that bandwidth can be held. Valid values are from 1 to 300 seconds.


Defaults

15 seconds

Command Modes

Global configuration

Command History

Release
Modification

12.0(5)S

This command was introduced.

12.1(3)T

This command was integrated into Cisco IOS Release 12.1(3)T.

12.0(10)ST

This command was integrated into Cisco IOS Release 12.0(10)ST.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Examples

In the following example, bandwidth is set to be held for 10 seconds:

Router(config)# mpls traffic-eng link-management timers bandwidth-hold 10

Related Commands

Command
Description

show mpls traffic-eng link-management bandwidth-allocation

Displays current local link information.


mpls traffic-eng link-management timers periodic-flooding

To set the length of the interval for periodic flooding, use the mpls traffic-eng link-management timers periodic-flooding command in global configuration mode. To disable the specified interval length for periodic flooding, use the no form of this command.

mpls traffic-eng link-management timers periodic-flooding interval

no mpls traffic-eng link-management timers periodic-flooding

Syntax Description

interval

Length of the interval (in seconds) for periodic flooding. Valid values are from 0 to 3600. A value of 0 turns off periodic flooding. If you set this value from 1 to 29, it is treated as 30.


Defaults

180 seconds (3 minutes)

Command Modes

Global configuration

Command History

Release
Modification

12.0(5)S

This command was introduced.

12.1(3)T

This command was integrated into Cisco IOS Release 12.1(3)T.

12.0(10)ST

This command was integrated into Cisco IOS Release 12.0(10)ST.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

Use this command to advertise link state information changes that do not trigger immediate action. For example, a change to the amount of allocated bandwidth that does not cross a threshold.

Examples

The following example shows how to set the interval length for periodic flooding to 120 seconds:

Router(config)# mpls traffic-eng link-management timers periodic-flooding 120

Related Commands

Command
Description

mpls traffic-eng flooding thresholds

Sets a link's reserved bandwidth thresholds.


mpls traffic-eng logging lsp

To log certain traffic engineering label switched path (LSP) events, use the mpls traffic-eng logging lsp command in global configuration mode. To disable logging of LSP events, use the no form of this command.

mpls traffic-eng logging lsp {path-errors | reservation-errors | preemption | setups | teardowns} [acl-number]

no mpls traffic-eng logging lsp {path-errors | reservation-errors | preemption | setups | teardowns} [acl-number]

Syntax Description

path-errors

Logs RSVP path errors for traffic engineering LSPs.

reservation-errors

Logs RSVP reservation errors for traffic engineering LSPs.

preemption

Logs events related to the preemption of traffic engineering LSPs.

setups

Logs events related to the establishment of traffic engineering LSPs.

teardowns

Logs events related to the removal of traffic engineering LSPs.

acl-number

(Optional) Uses the specified access list to filter the events that are logged. Logs events only for LSPs that match the access list.


Defaults

Logging of LSP events is disabled.

Command Modes

Global configuration

Command History

Release
Modification

12.1(3)T

This command was introduced.

12.0(10)ST

This command was integrated into Cisco IOS Release 12.0(10)ST.

12.0(22)S

This command was integrated into Cisco IOS Release 12.0(22)S.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Examples

The following example shows how to log path errors for LSPs that match access list 3:

Router(config)# mpls traffic-eng logging lsp path-errors 3

Related Commands

Command
Description

access-list (extended)

Defines an extended IP access list.

logging console

Limits the number of messages logged to the console.

mpls traffic-eng logging tunnel

Logs certain traffic engineering tunnel events.

show logging

Displays the messages that are logged in the buffer.


mpls traffic-eng logging tunnel

To log certain traffic engineering tunnel events, use the mpls traffic-eng logging tunnel command in global configuration mode. To disable logging of traffic engineering tunnel events, use the no form of this command.

mpls traffic-eng logging tunnel lsp-selection [acl-number]

no mpls traffic-eng logging tunnel lsp-selection [acl-number]

Syntax Description

lsp-selection

Logs events related to the selection of a label switched path (LSP) for a traffic engineering tunnel.

acl-number

(Optional) Uses the specified access list to filter the events that are logged. Logs events only for tunnels that match the access list.


Defaults

Logging of tunnel events is disabled.

Command Modes

Global configuration

Command History

Release
Modification

12.1(3)T

This command was introduced.

12.0(10)ST

This command was integrated into Cisco IOS Release 12.0(10)ST.

12.0(22)S

This command was integrated into Cisco IOS Release 12.0(22)S.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Examples

The following example shows how to log traffic engineering tunnel events associated with access list 3:

Router(config)# mpls traffic-eng logging tunnel lsp-selection 3

Related Commands

Command
Description

access-list (extended)

Creates an extended access list.

logging console

Limits the number of messages logged to the console.

mpls traffic-eng logging lsp

Logs certain traffic engineering LSP events.

show logging

Displays the messages that are logged in the buffer.