Table Of Contents
mpls static binding ipv4 vrf
mpls static crossconnect
mpls tp
mpls tp link
mpls tp lsp
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 config affinity
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 promote
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 tp
To configure Multiprotocol Label Switching (MPLS) transport profile (TP) parameters and enter MPLS-TP configuration mode, use the mpls tp command in global configuration mode. To remove all MPLS-TP forwarding, use the no form of this command.
mpls tp
no mpls tp
Syntax Description
This command has no arguments or keywords.
Command Default
No MPLS-TP parameters are configured.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
15.1(1)SA
|
This command was introduced.
|
15.1(3)S
|
This command was integrated.
|
Usage Guidelines
Use this command to enter MPLS-TP configuration mode. From that mode, you can configure the following parameters:
Command
|
Parameter
|
fault-oam refresh-timer secs
|
(Optional) Specifies the maximum time between successive fault Operations, Administration, and Maintenance (OAM) messages specified in seconds. Range: 1 to 20. Default 20.
|
global-id num
|
(Optional) Specifies the default global ID used for all endpoints and midpoints. Range: 0 to 2147483647. Default: 0.
This command makes the router ID globally unique in a multiprovider tunnel. Otherwise, the router ID is only locally meaningful. The global ID is an autonomous system number, which is a controlled number space by which providers can identify each other.
|
protection trigger [ais | ldi | lkr]
|
(Optional) Specifies protection triggers for Alarm Indication Signal (AIS), Link Down Indication (LDI), Lock Report (LKR) messages.
These triggers should be used in rare cases. They allow you to change the default protection-switching behavior for fault notifications on all tunnels. The default for these global settings is to trigger protection on receipt of LDI and LKR, but not AIS. (AIS is a nonfatal indication of potential issues, which turns into LDI when it is known to be fatal.)
This command is useful when other devices send AIS or LDI in unexpected ways. For example, you can configure the protection trigger ais command to interoperate with another vendor whose devices send AIS when there are link failures and never send AIS with the LDI flag.
Another example is if a device sends LDI when there is no actual failure, but there is a possible failure, and you want BFD to detect the actual failure and cause protection switching, you can configure the no protection trigger ldi command.
To undo these configuration settings and revert to the default settings, issue the default protection trigger [ais | ldi | lkr] command.
|
router-id router-id
|
(Required) Specifies the default MPLS-TP router ID, which is used as the source node ID for all MPLS-TP tunnels configured on the router. This is required for MPLS-TP forwarding.
This router ID is used in fault OAM messaging to identify the source of a fault on a midpoint router.
|
wtr-timer
|
Specifies the wait-to-restore (WTR) timer. This timer controls the length of time to wait before reversion following the repair of a fault on the original working path.
|
Examples
The following example shows how to enter MPLS-TP configuration mode and set the default router ID:
Router(config-mpls-tp)# router-id 10.10.10.10
Router(config-mpls-tp)# exit
Related Commands
Command
|
Description
|
mpls tp lsp
|
Specifies the parameters for two ends of the MPLS-TP tunnel from the tunnel midpoint.
|
interface tunnel-tp
|
Specifies the parameters for the MPLS tunnel.
|
mpls tp link
To configure Multiprotocol Label Switching (MPLS) transport profile (TP) link parameters, use the mpls tp link command in interface configuration mode.
mpls tp link link-num {ipv4 ip-address | tx-mac mac-address} rx-mac mac-address
no mpls tp link link-num
Syntax Description
link-num
|
Number assigned to the link. It must be unique on the device. Only one link number can be assigned per interface. Range: 1 to 2147483647.
|
ipv4 ip-address
|
The next-hop address that Address Resolution Protocol (ARP) uses to discover the destination MAC address.
|
tx-mac mac-address
|
Specifies a per-interface transmit multicast MAC address.
This keyword is available on point-to-point Ethernet interfaces and non point-to-point interfaces where the MAC address is a unicast address. It is not available on serial interfaces.
|
rx-mac mac-address
|
Specifies a per-interface receive multicast MAC address.
This keyword is available only when the tx-mac keyword is used. It is not available on serial interfaces.
|
Command Default
No MPLS-TP link parameters are configured.
Command Modes
Interface configuration (config-if)
Command History
Release
|
Modification
|
15.1(1)SA
|
This command was introduced.
|
15.1(3)S
|
This command was integrated.
|
Usage Guidelines
The link number must be unique on the device. Only one link number can be assigned per interface.
MPLS-TP link numbers may be assigned to physical interfaces only. Bundled interfaces and virtual interfaces are not supported for MPLS-TP link numbers.
When an MPLS-TP link is configured without an IP address on an Ethernet interface, Cisco uses an IEEE Bridge Group MAC address (0180.c200.0000) for communication by default.
Examples
This example creates an MPLS-TP link without an IP address:
This example configures the unicast MAC address of the next-hop device:
mpls tp link 1 tx-mac 0000.0c00.1234
This example configures transmit and receive parameters for a different multicast address:
mpls tp link 1 tx-mac 0100.0c99.8877 rx-mac 0100.0c99.8877
This example configures a link with an IP adress:
ip address 10.0.0.1 255.255.255.0
mpls tp link 1 ipv4 10.0.0.2
Related Commands
Command
|
Description
|
mpls tp lsp
|
Specifies the parameters for forwarding of a MPLS-TP LSP at the tunnel midpoint.
|
interface tunnel-tp
|
Specifies the parameters for the MPLS tunnel.
|
mpls tp lsp
To configure Multiprotocol Label Switching (MPLS) transport profile (TP) midpoint connectivity, use the mpls tp lsp command in global configuration mode.
mpls tp lsp source node-id [global-id num] tunnel-tp num lsp {lsp-num | protect | working}
destination node-id [global-id num] tunnel-tp num
Syntax Description
source node-id
|
Specifies the source node ID of the MPLS-TP tunnel.
|
global-id num
|
(Optional) Specifies the global ID of the tunnel source.
|
tunnel-tp num
|
Specifies the tunnel-TP number of MPLS-TP tunnel source.
|
lsp {lsp-num | protect | working}
|
Specifies the label switched path (LSP) within the MPLS-TP tunnel.
• lsp-num—the number of the LSP.
• protect—Indicates that the LSP is a backup for the primary, or working, LSP. When you specify the protect keyword, the LSP number is 1.
• working—Indicates that the LSP is the primary LSP. When you specify the working keyword, the LSP number is 0.
A protect LSP is a backup for a working LSP. When the working LSP fails, traffic is switched to the protect LSP until the working LSP is restored, at which time forwarding reverts back to the working LSP.
|
destination node-id
|
Specifies the destination node ID of the MPLS-TP tunnel.
|
global-id num
|
(Optional) Specifies the global ID of the tunnel destination. Range: 0 to 2147483647 Default: 0.
|
tunnel-tp num
|
Specifies the tunnel number of MPLS-TP tunnel destination.
|
Command Default
No MPLS-TP parameters are configured.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
15.1(1)SA
|
This command was introduced.
|
15.1(3)S
|
This command was integrated.
|
Usage Guidelines
Use this command on midpoint routers to specify the source and destination parameters of the MPLS-TP tunnel. You can use the mpls trace command from the MPLS-TP endpoint to validate that traffic is traversing the correct tunnel at each midpoint.
This command also enters MPLS-TP LSP configuration mode (config-mpls-tp-lsp). From that mode, you can configure the following parameters:
Command
|
Parameter
|
forward-lsp
|
Enters MPLS-TP LSP forward LSP configuration mode (config-mpls-tp-lsp-forw). From this mode, you can configure the following parameters:
• Bandwidth (bandwidth)
• Incoming label (in-label) and outgoing label and link numbers (out-label out-link)
|
reverse-lsp
|
Enters MPLS-TP LSP reverse LSP configuration mode (config-mpls-tp-lsp-rev). From this mode, you can configure the following parameters:
• Bandwidth (bandwidth)
• Incoming label (in-label) and outgoing label and link numbers (out-label out-link)
|
tunnel-name name
|
Specifies the name of the MPLS-TP tunnel.
|
Examples
The following examples show the configuration of an MPLS-TP LSP midpoint.
The following example configures a midpoint LSP carrying the working LSP of an MPLS-TP tunnel between node 10.10.10.10, tunnel-number 1 and 10.11.11.11, tunnel-number 2, using 1000 kbits/sec bandwidth in both directions:
Router(config)# mpls tp lsp source 10.10.10.10 tunnel-tp 1 lsp working destination
10.11.11.11 tunnel-tp 2
Router(config-mpls-tp-lsp)# forward-lsp
Router(config-mpls-tp-lsp-forw)# bandwidth 1000
Router(config-mpls-tp-lsp-forw)# in-label 20 out-label 40 out-link 10
Router(config-mpls-tp-lsp-forw)# exit
Router(config-mpls-tp-lsp)# reverse-lsp
Router(config-mpls-tp-lsp-rev)# bandwidth 1000
Router(config-mpls-tp-lsp-rev)# in-label 21 out-label 50 out-link 11
The following example configures a midpoint LSP on the protect LSP between node 10.10.10.10, tunnel 4 and 10.11.11.11, tunnel 12. No bandwidth is reserved:
Router(config)# mpls tp lsp source 10.10.10.10 global-id 2 tunnel-tp 4 lsp protect
destination 10.11.11.11 global-id 14 tunnel-tp 12
Router(config-mpls-tp-lsp)# forward-lsp
Router(config-mpls-tp-lsp-forw)# in-label 30 out-label 100 out-link 27
Router(config-mpls-tp-lsp-forw)# exit
Router(config-mpls-tp-lsp)# reverse-lsp
Router(config-mpls-tp-lsp-rev)# in-label 31 out-label 633 out-link 30
Related Commands
Command
|
Description
|
interface tunnel-tp
|
Specifies the parameters for the MPLS-TP tunnel.
|
mpls tp
|
Specifies the parameters for the MPLS-TP tunnel and enters MPLS-TP configuration mode.
|
mpls tp link
|
Specifies MPLS-TP link parameters.
|
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.
|
Command Default
Flooding is disabled.
Command Modes
Router configuration (config-router)
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.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA.
|
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
Command Default
None
Command Modes
Interface configuration (config-if)
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.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA.
|
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
|
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.
|
Command Default
None
Command Modes
Interface configuration (config-if)
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.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA.
|
Usage Guidelines
This command assigns attributes to a link so that tunnels with matching attributes (represented by their affinity bits) prefer this link to 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 configure a specific unnumbered interface for all backup auto-tunnels, use the mpls traffic-eng auto-tunnel backup config command in global configuration mode. To remove the specific interface and resume the default interface for all backup auto-tunnels, 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
Syntax Description
unnumbered-interface interface
|
Interface for all backup auto-tunnels. Default: Loopback0.
|
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.
|
15.1(1)S
|
This command was modified. In Cisco IOS Release 15.1(1)S, this command changed so that you do not need to specific the interface name when you specify the no form of this command. In releases prior to 15.1(1)S, you had to specify the interface name as part of the no form of the command.
|
Usage Guidelines
In Cisco IOS Release 15.1(1)S, this command changed so that you do not need to specific the interface name when you specify the no form of this command. In release prior to 15.1(1)S, you had to specify the interface name as part of the no form of the command. If you upgrade to Cisco IOS Release 15.1(1)S, check that your configuration does not contain the interface name as part of the no mpls traffic-eng auto-tunnel backup config command.
Examples
The following example assigns interface Ethernet 1/0 to all backup auto-tunnels:
Router# mpls traffic-eng auto-tunnel backup config unnumbered-interface ethernet1/0
The following example assigns the default interface of loopback0 to all backup auto-tunnels:
Router# no mpls traffic-eng auto-tunnel backup config unnumbered-interface
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 config affinity
To specify an affinity on dynamically created Multiprotocol Label Switching (MPLS) Traffic Engineering (TE) backup tunnels, use the mpls traffic-eng auto-tunnel backup config affinity command in global configuration mode. To return to the default values, use the no form of the command.
mpls traffic-eng auto-tunnel backup config affinity affinity-value [mask mask-value]
no mpls traffic-eng auto-tunnel backup config affinity
Syntax Description
affinity-value
|
Values that will be compared to the link attributes 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.
|
mask mask-value
|
(Optional) Affinity value flag. A 32-bit decimal number. Valid values are from 0x0 to 0xFFFFFFFF, representing 32 attributes (bits), where the value of the affinity bit is 0 or 1. A value of 0 means ignore the corresponding affinity bit.
|
Command Default
Affinity: 0x0
mask: 0xFFFF
Command Modes
Global configuration
Command History
Release
|
Modification
|
15.1(1)S
|
This command was introduced.
|
Usage Guidelines
This command is used with the mpls traffic-eng attribute-flags command, which specifies attributes for a link so that tunnels with matching affinity bits will use that link.
With the autotunnel backup feature, you can use the mpls traffic-eng attribute-flags and mpls traffic-eng auto-tunnel backup config affinity commands to include or exclude links when calculating a path for a dynamically created backup tunnel.
The affinity determines the attributes of the links that this tunnel will use (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, an attribute value of a link or that bit is irrelevant. If a bit in the mask is 1, the attribute value of a link and the required affinity of the tunnel for that bit must match.
A tunnel can use a link if:
tunnel affinity = the link attributes && the tunnel affinity mask
Any properties set to 1 in the affinity should also be 1 in the mask.
Examples
The following example configures all dynamically created backup with affinity 0x22, mask 0x22:
Router (config)# mpls traffic-eng auto-tunnel backup config affinity 0x22 mask 0x22
Related Commands
Command
|
Description
|
mpls traffic-eng attribute-flags
|
Specifies attributes for a link so that tunnels with matching affinity bits will use that link.
|
mpls traffic-eng auto-tunnel backup
|
Automatically builds NHOP and NNHOP backup tunnels.
|
show mpls traffic-eng auto-tunnel backup
|
Displays information about dynamically created backup tunnels.
|
tunnel mpls traffic-eng affinity
|
Configure an affinity for the interface.
|
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
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 promote
To configure the router to assign new or more efficient backup Multiprotocol Label Switching traffic engineering (MPLS-TE) tunnels to protect MPLS-TE tunnels, use the mpls traffic-eng fast-reroute promote command in privileged EXEC mode.
mpls traffic-eng fast-reroute promote
Syntax Description
This command has no arguments or keywords.
Command Default
No MPLS-TE backup tunnels are assigned.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
15.0(1)M
|
This command was introduced in a release earlier than Cisco IOS Release 15.0(1)M.
|
12.2(33)SRC
|
This command was integrated into a release earlier than Cisco IOS Release 12.2(33)SRC.
|
12.2(33)SXI
|
This command was integrated into a release earlier than Cisco IOS Release 12.2(33)SXI.
|
Cisco IOS XE Release 2.1
|
This command was implemented on Cisco ASR 1000 Series Aggregation Services Routers.
|
Usage Guidelines
To use the mpls traffic-eng fast-reroute promote command, you must be in a user group associated with a task group.
Examples
The following example shows how to initiate backup tunnel promote and assignment:
Router# mpls traffic-eng fast-reroute promote
Related Commands
Command
|
Description
|
mpls traffic-eng fast-reroute backup-prot-preemption
|
Changes the backup protection preemption algorithm to minimize the amount of bandwidth that is wasted.
|
mpls traffic-eng fast-reroute timers
|
Specifies how often the router considers switching an LSP to a new (better) backup tunnel if additional backup bandwidth becomes available.
|
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.
|
Command Default
None
Command Modes
Interface configuration (config-if)
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.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA.
|
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 is 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.
|