RSVP-TE Commands

RSVP-TECommands

administrative-group

The administrative-group command specifies the inclusion or exclusion of links that are part of an administrative group. The administrative group IDs are global and the specification contains lists and ranges of admin groups to include or exclude.

Every chosen link for a dynamic path must be in all of the admin groups specified in the include all range or must be in one of the admin groups specified in the include any range. A chosen link must not be in the exclude range. The administrative group range is 0 to 511.

Administrative groups can be specified using a name as an alias mapped to a numerical value. The mapping can be configured under the global Traffic-Engineering (TE) mode. For more information, refer to the IS-IS Traffic-Engineering TOI.

Command Mode

Traffic Engineering RSVP Dynamic Path Configuration

Command Syntax

administrative-group [ include any <RANGE>] | [include all <RANGE>] | [exclude <RANGE>] with RANGE being: ( <0x0-0xFFFFFFFF> | <0-511> | <0-511>-<0-511> | WORD )

[no | default] administrative-group

Parameters

exclude - Excludes the specified administrative group identified by either a group name or number.

include all - Includes the specified administrative groups identified by either a group name or number.

include any - Includes any of the specified range of administrative groups identified by either a group name or number.

Example

The following example states the path must include links from administrative group 1 and any link from an administrative group within groups 2, 3, or 4. The path must exclude links from administrative groups 7 and 9.
switch(config-te-rsvp-path-dyn-MyPath)# administrative-group include all 1 include any 2-4 exclude 7,9

alias endpoint

The alias endpoint command configures a tunnel endpoint alias for both IPv4 and IPv6 endpoints and allows the additional next-hops to resolve using the existing tunnel. A maximum of 15 alias endpoints per tunnel can be configured.

Command Mode

Traffic Engineering RSVP P2P Tunnel Configuration

Command Syntax

alias endpoint ( ipv4_address | ipv6_address)

[no|default] alias endpoint

Parameters
  • alias endpoint - Specify adding a tunnel endpoint.
  • ipv4_address - Specify an IPv4 address in the format A.B.C.D.
  • ipv6_address - Specify an IPv6 address in the format A:B:C:D:E:F:G:H.

Example

Use the following commands to add an alias endpoint, 192.168.11.5 to the existing MyTunnel configuration:
switch(config-te-rsvp-tunnel-MyTunnel)# alias endpoint 192.168.11.5

authentication index active

The command authentication index index_num active configures the MPLS RSVP cryptographic authentication password used globally for signing outgoing messages to neighbors that do not have per-neighbor authentication configuration. The active password must also be configured with the authentication index index_num password command to have any effect. Note that per-neighbor authentication takes precedence over global authentication.

Command Mode

MPLS RSVP Configuration

Command Syntax

[ no | default ] authentication index <INDEX_NUM> active

Example

The following commands globally enable cryptographic authentication (RFC 2747) for MPLS RSVP messages sent from the switch and establish the authentication index 755 and the password s3cr3t for outgoing messages:
switch(config)# mpls rsvp
switch(config-mpls-rsvp)# authentication type md5
switch(config-mpls-rsvp)# authentication index 755 password s3cr3t
switch(config-mpls-rsvp)# authentication index 755 active

authentication index password

The command authentication index index_num password is used to create the password with a given index. This can be done with different indices to create multiple passwords. All configured passwords are used to authenticate incoming messages from neighbors that do not have per-neighbor authentication configuration.

Command Mode

MPLS RSVP Configuration

Command Syntax

authentication index <INDEX> password( PASSWORD_CLEARTEXT | 0 PASSWORD_TYPE0KEY | 7 PASSWORD_TYPE7KEY | 8a PASSWORD_TYPE8AKEY )

[ no | default ] authentication index <INDEX> password

Example

The following commands globally enable cryptographic authentication (RFC 2747) for MPLS RSVP messages sent from the switch and establish the authentication index 755 and the password s3cr3t for outgoing messages:

switch(config)# mpls rsvp

switch(config-mpls-rsvp)# authentication type md5

switch(config-mpls-rsvp)# authentication index 755 password s3cr3t

switch(config-mpls-rsvp)# authentication index 755 active

authentication sequence-number window

The authentication sequence-number window command configures the size of the sequence number reorder window for incoming MPLS RSVP messages. Increasing the size of the window allows RSVP to accommodate a larger number of out-of-order packets. A value of N means that a packet is accepted if all previously received packets with a higher sequence number are within the preceding N-1 packets. The default value is 5. A value of 1 effectively turns off support for packet reordering.
Note: This command only has an effect if the authentication type is not none.

The no authentication sequence-number window and default authentication sequence-number window commands reset the size of the window to 5.

Command Mode

MPLS RSVP Configuration

Command Syntax

authentication sequence-number window size_num

no authentication sequence-number window

default authentication sequence-number window

Parameter

size_num - Sequence-number window size. Values range from 1-255. The default value is 5. A value of 1 disables packet reordering.

Example

The following commands set the sequence-number window to 50:
switch(config)# mpls rsvp
switch(config-mpls-rsvp)# authentication sequence-number window 50

authentication type

The authentication type command configures the MPLS RSVP cryptographic authentication type globally. Setting the type to md5 enables cryptographic authentication (RFC 2747) for MPLS RSVP messages sent from the switch. Setting the type to none disables authentication globally. Note that per-neighbor authentication settings take precedence over global settings.

The no authentication type and default authentication type commands disable authentication. Cryptographic authentication is disabled by default. These commands are functionally the same as authentication type none.

Command Mode

MPLS RSVP Configuration

Command Syntax

authentication type (md5 | none)

no authentication type (md5 | none)

default authentication type (md5 | none)

Parameters
  • md5 - enables MPLS RSVP cryptographic authentication (RFC 2747) for the specified neighbor. A password for outgoing messages must also be configured using the authentication index command.
  • none - disables MPLS RSVP cryptographic authentication for messages sent to the specified neighbor.
Examples
  • The following commands globally enable cryptographic authentication (RFC 2747) for MPLS RSVP messages sent from the switch and establish index 755 as the password for outgoing messages:
    switch(config)# mpls rsvp
    switch(config-mpls-rsvp)# authentication type md5
    switch(config-mpls-rsvp)# authentication index 755  password s3cr3t 
    switch(config-mpls-rsvp)# authentication index 755 active
  • The following commands disable cryptographic authentication globally:
    switch(config)# mpls rsvp
    switch(config-mpls-rsvp)# authentication type none
    

bandwidth

The bandwidth command configures the reserve bandwidth within the tunnel. The bandwidth can be set explicitly by setting a bandwidth value and the unit. When a bandwidth value of 0 is entered no bandwidth reservation is signalled. An alternative to explicit bandwidth configuration is to use the autobandwidth feature which specifies the minimum and maximum bandwidth to be used for the tunnel and otherwise adjusts bandwidth based on the observed traffic going over the tunnel.

Command Mode

Traffic Engineering RSVP P2P Tunnel Configuration

Traffic Engineering RSVP P2P Tunnel Profile Configuration

Command Syntax

bandwidth 0-1000 (bps | kbps | mbps | gbps | tbps)

bandwidth auto min 0-1000 ( bps | kbps | mbps | gbps | tbps ) max 0-1000 ( bps | kbps | mbps | gbps | tbps ) [ adjustment-period <1-4294967295> ] [ sensitivity ( <1-10> | dynamic ) ]

no bandwidth

default bandwidth

Parameters
  • (bps | kbps | mbps | gbps | tbps) - Bandwidth values require the units of the value. The range of available units are bps, kbps, mbps, gbps, or tbps.
  • auto - Using the auto keyword configures autobandwidth within the configured minimum and maximum bandwidth and unit values. The tunnel adjusts the bandwidth based on the observed traffic going over the tunnel. This happens at most every adjustment interval, if configured.
  • The min sets the minimum value and max sets the maximum value for the autobandwidth range. Each of the values require a unit to be selected.
  • adjustment-period - The keyword adjustment-period sets the minimal time between bandwidth adjustments. Bandwidth will not change more frequently than the adjustment period. If unset, the auto-bandwidth algorithm will adjust as often as it deems necessary based on the sensitivity. The interval is in units of seconds. Range: 1-4294967295
  • sensitivity - The keyword sensitivity sets parameter sets the algorithm's sensitivity to flow rate changes. The value is an integer with 1 (least sensitive) to 10 (most sensitive). Range: 1-10.The keyword dynamic can be used to adjust sensitivity dynamically based on the traffic.
Examples
  • The following command explicitly configure the bandwidth of the tunnel to 10 mbps.
    switch(config-te-rsvp-tunnel-myTunnel)# bandwidth 10 mbps
  • The following command configures autobandwidth with a minimum of 1 mbps and maximum of 5 mbps. The bandwidth can change at most every 60 seconds.
    switch(config-te-rsvp-tunnel-myTunnel)# bandwidth auto min 1 mbps max 5 mbps adjustment-period 60
    

bandwidth signaling

The bandwidth signaling command is used to enable bandwidth signaling (default behaviour) for the tunnel in cases where the LSP is used for UCMP weights and reserves bandwidth.

The bandwidth signaling disabled command is used to disable bandwidth signaling for the tunnel in cases where the LSP is used for UCMP weights but does not actually reserve bandwidth.

Command Mode

Traffic Engineering RSVP P2P Tunnel Configuration

Traffic Engineering RSVP P2P Tunnel Profile Configuration

Command Syntax

bandwidth signaling [ disabled ]

no bandwidth signaling

default bandwidth signaling

Parameters

disabled - Disables bandwidth signaling.

Examples

The following example enables bandwidth signaling for MyTunnel, if it was disabled:

switch(config-te-rsvp-tunnel-MyTunnel)# bandwidth signaling

The following example disables bandwidth signaling for MyTunnel:

switch(config-te-rsvp-tunnel-MyTunnel)# bandwidth signaling disabled

clear mpls rsvp counters

The clear mpls rsvp counters command clears RSVP message counters. The clear mpls rsvp counters ( ip | ipv6 ) access-list command clears the ACL counters.

Command Mode

PrivilegedEXEC

Command Syntax

clear mpls rsvp counters

clear mpls rsvp counters ( ip | ipv6 ) access-list

Parameters
  • ip - Filter by IPv4.
  • ipv6 - Filter by IPv6.

Example

The following command clears RSVP message counters:
switch# clear mpls rsvp counters 
The following command clears RSVP IPv4 ACL counters:
switch# clear mpls rsvp counters ip access-list 
The following command clears RSVP IPv6 ACL counters:
switch# clear mpls rsvp counters ipv6 access-list 

clear mpls rsvp session

The clear mpls rsvp session command can be used to clear RSVP sessions. Clearing a session will remove the current state for the LSPs and send the appropriate TEAR messages. This can be useful for cleaning up stale sessions, renegotiating a session immediately after a config change, or forcing a recreation of an LSP that could be in an error state.

Command Mode

Privileged EXEC

Command Syntax

clear mpls rsvp session ( <filters> | all ) [ detail ]

Parameters

all - Clears all RSVP sessions.

<filters> -a list of one or more of: ( destination <ipv4> | id <id> ) | ( name <name> |lsp <lsp> |bypass ) | ( role <role> ) | ( state <state> )

  • bypass - Filter for bypass LSPs. Only applicable on the ingress node.
  • destination - Filter by destination address.
  • id - Filter by Session ID.
  • lsp- Filter by LSP number.
  • name - Filter by session name.
  • role - Filter by session role.
  • state - Filter by LSP state.

detail - Can be specified after all or any filters. When the command is run with detail, the names of the sessions that are cleared are displayed, not just the count.

Examples

The following examples are on a switch with two RSVP sessions (sessionA and sessionB).
  • This command clears all RSVP sessions on the switch.
    switch# clear mpls rsvp session all
    Cleared 2 sessions
  • The detail keyword can be added to the end of the command to output the session name of all sessions being cleared.
    switch# clear mpls rsvp session all detail
    Clearing sessionA
    Clearing sessionB
    Cleared 2 sessions
  • The all keyword can be replaced with filters to clear specific sessions. In the following example, the name sessionA filter is used to clear just sessionA.
    switch# clear mpls rsvp session name sessionA detail
    Clearing sessionA
    Cleared 1 sessions
    
  • The following is a list of the supported filters for the clear command. Some filters can be combined in a single command. For example, both the bypass and state up filters can be used in the same command to clear all bypass sessions which are in the up state.
    switch# clear mpls rsvp session ?
      all          Clear all RSVP sessions
      bypass       Filter for bypass LSPs
      destination  Filter by destination address
      id           Filter by Session ID
      lsp          Filter by LSP#
      name         Filter by session name
      role         Filter by router role
      state        Filter by LSP state

color

The color command assigns a color to a tunnel to publish the tunnel to the system-colored-tunnel-rib, to help steer traffic into the tunnel.

Command Mode

Traffic Engineering RSVP P2P Tunnel Configuration

Traffic Engineering RSVP P2P Tunnel Profile Configuration

Command Syntax

color ( <color value> | disabled )

[no | default] color

color disabled - explicitly disables the color configuration irrespective of a profile being configured

Parameters
  • <color value> - numerical value in the range of 0 - 4292967295.
  • disabled - explicitly disables the color configuration irrespective of profile configuration.

Example

The following example assigns color 60 to the tunnel named MyTunnel:
switch(config-te-rsvp-tunnel-MyTunnel)# color 60

cspf delay

RSVP-TE uses CSPF to compute the FRR backup path. CSPF can be throttled to avoid frequent path changes when frequent network events occur. The cspf delay command configures the frequency of CSPF running after a network event by specifying the initial wait interval, back-off interval, and maximum wait interval for CSPF. The no form of the command removes the CSPF delay. The default cspf delay values are 100 for initial wait interval, 200 for back-off interval, and 1000 for maximum wait interval.

Command Mode

Traffic Engineering Configuration

Command Syntax

cspf delay [initial n back-off n] max n

no cspf delay

default cspf delay

Parameters
  • initial - Specify initial wait interval for CSPF.
    • n - Specify the time in milliseconds. 1-300000.
      • back-off - Specify the back-off interval for CSPF.
        • n - Specify the time in milliseconds. 1-300000.
  • max - Specify the maximum wait interval for CSPF.
    • n - Specify the time in milliseconds. 1-300000.

Example

The following commands configure an initial wait interval, back-off interval, and maximum wait interval of 200, 400, and 2000 milliseconds respectively for CSPF delay:

switch(config-te)#cspf delay initial 200 back-off 400 max 2000

cspf ecmp tie-break

The cspf ecmp tie-break command disables bandwidth least-fill when the random option is selected, and enables bandwidth least-fill when least-fill is selected. Bandwidth least-fill is enabled by default.

The no and default forms of the command restore bandwidth least-fill.

Command Mode

Traffic Engineering RSVP Configuration

Command Syntax

cspf ecmp tie-break (least-fill|random)

no cspf ecmp tie-break

default cspf ecmp tie-break

Parameters
  • least-fill - Enables bandwidth least-fill. This is the default configuration.
  • random - Disables bandwidth least-fill.

Example

The following command disables bandwidth least-fill on the switch:
switch(config-te-rsvp)# cspf ecmp tie-break random

destination ip

Each P2P tunnel requires a destination IP to function. The destination ip command assigns a destination IP to the tunnel. For P2MP, this can be set multiple times, one for each of the multicast destinations.

Command Mode

Traffic Engineering RSVP P2P Tunnel Configuration

Traffic Engineering RSVP P2MP Tunnel Configuration

Command Syntax

destination ip IP_address

no destination ip

default destination ip

Parameters

IP_address - The destination IPv4 address for the tunnel.

Example

The following command assigns destination IP 10.2.2.2 to the tunnel named MyTunnel:
switch(config-te-rsvp-tunnel-MyTunnel)# destination ip 10.2.2.2

disabled (P2MP)

The disabled command in the MPLS RSVP P2MP mode can be used to disable P2MP functionality without clearing the configuration in the mode.

Command Mode

MPLS RSVP P2MP Configuration

Command Syntax

disabled

no disabled

default disabled

Example

The following command disables P2MP functionality for RSVP-TE but retains the configuration currently in the MPLS RSVP P2MP mode:

switch(config-mpls-rsvp-p2mp)# disabled 

fast-reroute bypass tunnel optimization interval

The fast-reroute bypass tunnel optimization interval command configures the interval at which paths used for bypass tunnels are re-optimized. Paths are re-optimized every 30 seconds by default.

The no fast-reroute bypass tunnel optimization interval and default fast-reroute bypass tunnel optimization interval commands return the optimization interval to the default value of 30 seconds.

Command Mode

MPLS RSVP Configuration

Command Syntax

fast-reroute bypass tunnel optimization interval < number of seconds > seconds

no fast-reroute bypass tunnel optimization interval

default fast-reroute bypass tunnel optimization interval

Parameters

seconds - The time between re-optimizations of bypass tunnel paths in seconds. The values range from 1 to 65535. The default is 30 seconds.

Example

The following commands set the bypass tunnel optimization interval to 45 seconds:
switch(config-mpls-rsvp)# fast-reroute bypass tunnel optimization interval 45 seconds 

fast-reroute mode

The fast-reroute mode command configures fast-reroute (FRR) (RFC 4090). The link-protection option protects against failure of the next link, the node-protection option protects against failure of the next node, and the none option disables the feature. Fast reroute is disabled by default.

On the headend, this knob acts as the global configuration which determines the type of protection requested by any LSPs originating there. This is superseded if the tunnels have a fast-reroute mode specified in the tunnel configuration (see fast-reroute mode (RSVP tunnel)) or in an associated profile.

On transit and headend, it also determines which type of bypass tunnels will be created at that node.

If node-protection is configured and requested by the LSP, then both node and link protection bypass tunnels will be created, with the node bypass being preferred if it's available.

If link-protection is configured or requested by the LSP, then only link-protection bypasses are created and used.

If the FRR mode is set to none or not requested at all by the LSP, then no bypass tunnels are created.

The no and default versions of the command disable fast reroute.

Command Mode

MPLS RSVP Configuration

Command Syntax

fast-reroute mode (link-protection | node-protection | none)

no fast-reroute mode

default fast-reroute mode

Parameters
  • link-protection - Protects against failure of the next link.
  • node-protection - Protects against failure of the next node.
  • none - Disables fast reroute.
Examples
  • The following command enables fast reroute (FRR) link protection/NHOP (RFC 4090):
    switch(config-mpls-rsvp)# fast-reroute mode link-protection
  • The following command enables fast reroute (FRR) node protection/NNHOP (RFC 4090):
    switch(config-mpls-rsvp)# fast-reroute mode node-protection
  • The following command disables FRR:
    switch(config-mpls-rsvp)# fast-reroute mode none

fast-reroute mode (RSVP tunnel)

By default, RSVP tunnels inherit fast-reroute settings from the global RSVP configuration. The fast-reroute mode can also be configured for a specific RSVP tunnel by issuing the command in Traffic Engineering RSVP Tunnel configuration mode. Note that this only modifies the type of protection requested by the tunnel. If the requested protection is not enabled by the global RSVP configuration, it may not be provided to the tunnel.

The link-protection option protects against failure of the next link, the node-protection option protects against failure of the next node, and the none option disables the feature.

The default is no fast-reroute mode whichmeans that the inherit fast-reroute settings from the global RSVP configuration.

Command Mode

Traffic Engineering RSVP P2P Tunnel Configuration

Traffic Engineering RSVP P2P Tunnel Profile Configuration

Command Syntax

fast-reroute mode (link-protection | node-protection | none)

no fast-reroute mode

default fast-reroute mode

Parameters
  • link-protection - Protect against failure of the next link.
  • mode node-protection - Protect against failure of the next node.
  • mode none - Disable fast reroute.
Examples
  • The following command enables fast reroute (FRR) link protection for the tunnel:
    switch(config-te-rsvp-tunnel-MyTunnel)# fast-reroute mode link-protection
  • The following command enables fast reroute (FRR) node protection for the tunnel:
    switch(config-te-rsvp-tunnel-MyTunnel)# fast-reroute mode node-protection
  • The following command disables FRR for the tunnel:
    switch(config-te-rsvp-tunnel-MyTunnel)# fast-reroute mode none

fast-reroute reversion

You can change the revertive behavior of the FRR from the global revertive mode to the local revertive mode. In the global revertive mode, an LSP re-routed over a bypass tunnel because the downstream link became unavailable keeps using the bypass tunnel after the link recovers. This expects the headend router to set up a new LSP upon notification that a link became unavailable. In the local revertive mode, the LSP switches back to using the primary link after recovery.

The default for reversion is global.

Command Mode

MPLS RSVP Configuration

Command syntax

fast-reroute reversion (global | local)

default fast-reroute reversion

no fast-reroute reversion

Parameters
  • global - Global revertive mode.
  • local - Local revertive mode.
Examples
  • Set the fast-reroute reversion to local:
    switch(config-mpls-rsvp)# fast-reroute reversion local
  • The default for reversion is global.
    switch(config-mpls-rsvp)# fast-reroute reversion global

graceful-restart role helper

The graceful-restart role helper command leads to the MPLS RSVP Graceful Restart Helper Configuration Mode. Under this mode we have the timer restart maximum and timer recovery maximum commands. These are used to set the maximum values accepted by helpers. If the helper receives larger values from the speaker, then it will use the configured maximum.

The maximum accepted restart time value is configurable under the graceful-restart role helper configuration mode, timer restart maximum time seconds.

The maximum accepted recovery time value is configurable under the graceful-restart role helper configuration mode, timer recovery maximum time seconds.

Command Mode

MPLS RSVP Configuration

Command Syntax

graceful-restart role helper

no graceful-restart role helper

default graceful-restart role helper

timer restart maximum time seconds - The maximum accepted restart time value.

default timer restart maximum

no timer restart maximum

timer recovery maximum time seconds - The maximum accepted recovery time value.

default timer recovery maximum

no timer recovery maximum

Example

The following command enables graceful restart in the helper role and enters the configuration mode for that role:
switch(config-mpls-rsvp)#graceful-restart role helper
switch(config-mpls-rsvp-gr-helper)#

graceful-restart role speaker

The graceful-restart role speaker command leads to the MPLS RSVP Graceful Restart Speaker Configuration Mode. Under this mode we have the timer restart and timer recover commands. These are used to set the time values sent to helpers to advertise how long the speaker will remain in the restart and recovery phases.

The restart time value is configurable under the graceful-restart role speaker configuration mode, timer restart time seconds

The recovery time value is configurable under the graceful-restart role speaker configuration mode, timer recovery time seconds.

Command Mode

MPLS RSVP Configuration Mode

Command Syntax

graceful-restart role speaker

no graceful-restart role speaker

default graceful-restart role speaker

timer restart time seconds - The restart time value.

default timer restart

no timer restart

timer recovery time seconds- The recovery time value.

default timer recovery

no timer recovery

Example

The following command enables graceful restart in the speaker role and enters the configuration mode for that role:
switch(config-mpls-rsvp)#graceful-restart role speaker
switch(config-mpls-rsvp-gr-speaker)#

hardware next-hop fast-failover

The hardware next-hop fast-failover command enables hardware-accelerated next-hop failover on the switch. This should be enabled in every case where FRR is desired, especially for sub-50ms in the case of link protection and sub-150ms in the case of node protection.

It is disabled by default. Bypass tunnels can still be created even without this knob and FRR will still work on the software side, but on the hardware this is necessary for fast convergence.

The no and default forms of the command disable hardware-accelerated next-hop failover and fast-reroute bypass tunnels.

Command Mode

Router General Configuration

Command Syntax

hardware next-hop fast-failover

no hardware next-hop fast-failover

default hardware next-hop fast-failover

Example

The following commands enable hardware-accelerated next-hop failover on the switch:
switch(config)#router general
switch(config-router-general)#hardware next-hop fast-failover

hello interval

The hello interval command sets the time between the hello packets. The no form of the command explicitly disables the Hello messages, while the default form of the command resets to the default setting of 10 seconds with a multiplier of 4.

Command Mode

MPLS RSVP Configuration

Command Syntax

hello interval <interval> multiplier <num>

no hello interval

default hello interval

Parameters
  • interval sec - The interval in units of seconds.
    • multiplier num - The number of intervals after which communication with a neighbor is declared lost if no hello messages are received.
Examples
  • In this example, EOS sends hello messages to all known neighbors every 10 seconds. If the switch does not receive hello responses from a neighbor for 4*10=40 seconds, the switch considers communication with the neighbor to have been lost.
    switch(config-mpls-rsvp)# hello interval 10 multiplier 4
  • In this example, the hello interval is set to a default of 10 seconds with multiplier 4.
    switch(config-mpls-rsvp)# default hello interval
  • In this example, the Hello messages are explicitly disabled.
    switch(config-mpls-rsvp)# no hello interval

hitless-restart

The hitless-restart command enables RSVP hitless restart. Hitless restart allows RSVP agents to restart without interrupting data-plane traffic. When hitless restart is enabled, the switch observes a recovery period after RSVP restarts. The switch preserves existing installed RSVP states until they are refreshed by neighbors. If RSVP states have not been refreshed before the expiration of the recovery period, they are cleared. The recovery period is 90 seconds by default when hitless restart is enabled, but can be configured using the timer recovery command. Hitless restart is disabled by default.

The no hitless-restart and default hitless-restart commands disable hitless restart.

The recovery time value timer recovery time seconds is configurable under the hitless-restart mode.

Command Mode

MPLS RSVP Configuration

Command Syntax

hitless-restart

no hitless-restart

default hitless-restart

Example

The following command enables RSVP hitless restart and enters the configuration mode:
switch(config-mpls-rsvp)# hitless-restart
switch (config-mpls-rsvp-hr)#

hop (dynamic path)

The hop command adds a hop to the path in the dynamic path configuration mode. If entered without options, it is configured as a strict include hop and appended at the end of the path. A strict include hop must be directly reachable after the previously specified hop in the path (or from the ingress if it is the first hop). The loose keyword configures the hop as a loose include hop, which does not have to be directly reachable from the previous hop. The before and after options can be used to reorder include hop constraints in relation to another include hop in an existing path.

The exclude keyword configures an exclude hop constraint which indicates that neither end of a link in the path may have the specified address. Unlike strict and loose hops, exclude hops cannot be reordered with before and after keywords.

The no and default forms of the command remove the specified hop constraint.

Command Mode

Traffic Engineering RSVP Dynamic Path Configuration

Command Syntax

hop IPv4_address [ exclude | ( [ loose ] [ ( before | after ) IPv4_address ] ) ]

default hop [IPv4_address] - The address is optional, if no address is supplied then all hops are removed.

no hop [IPv4_address] - The address is optional, if no address is supplied then all hops are removed.

Parameters
  • exclude - Specifies that CSPF must not choose the specified address on the path.
  • loose - Defines the hop as a loose hop, which allows other hops to be filled by the CSPF procedure to get to it.
  • before - Specifies the hop before which this hop will be placed.
  • after - Specifies the hop after which this hop will be placed.
Examples
  • The following example excludes 10.0.56.6 from being used as a hop.
    switch(config-te-rsvp-path-dyn-MyPath)# hop 10.0.56.6 exclude
  • The following example configures 10.0.23.3 as a strict include hop. Hop 10.0.45.5 is configured as a loose include hop, which allow other hops to be filled in before it. Hop 10.0.12.2is added as a strict include hop and uses the before keyword to placed it before hop 10.0.23.3.
    switch(config-te-rsvp-path-dyn-MyPath)# hop 10.0.23.3
    switch(config-te-rsvp-path-dyn-MyPath)# hop 10.0.45.5 loose
    switch(config-te-rsvp-path-dyn-MyPath)# hop 10.0.12.2 before 10.0.23.3

hop (explicit path)

The hop command adds a hop to the path in the explicit path configuration mode. If entered without options, the command places the specified hop at the end of the path. The before and after options can be used to insert the specified hop in relation to another existing hop in the existing path.

Command Mode

Traffic Engineering RSVP Explicit Path Configuration

Command Syntax

hop IPv4_address [ ( before | after ) ] IPv4_address

[no | default] hop [IPv4_address] - If no address is supplied then all hops are removed.

Parameters
  • before - Specifies the hop before which this hop will be placed.
  • after - Specifies the hop after which this hop will be placed.
Examples
  • The following commands create hop 10.0.12.2 followed by hop 10.0.34.4.
    switch(config-te-rsvp-path-expl-MyPath)# hop 10.0.12.2
    switch(config-te-rsvp-path-expl-MyPath)# hop 10.0.34.4
  • The following example places hop 10.0.23.3 before hop 10.0.34.4 and hop 10.0.45.5 is placed after hop 10.0.34.4.
    switch(config-te-rsvp-path-expl-MyPath)# hop 10.0.23.3 before 10.0.34.4
    switch(config-te-rsvp-path-expl-MyPath)# hop 10.0.45.5 after 10.0.34.4

igp shortcut

The igp shortcut command is used to specify whether an RSVP tunnel should participate in Interior Gateway Protocol (IGP) shortcuts.

Command Mode

Traffic Engineering RSVP P2P Tunnel Configuration

Traffic Engineering RSVP P2P Tunnel Profile Configuration

Command Syntax

igp shortcut [ disabled ]

default igp shortcut

no igp shortcut

Parameters

disabled - explicitly disables the IGP shortcut configuration irrespective of profile configuration.

Example

The following example configures the tunnel named MyTunnel to participate in IGP shortcuts.
switch(config-te-rsvp-tunnel-MyTunnel)# igp shortcut

ip access-group

The ip access-group command can be used to apply IPv4 access-lists to RSVP. Access-lists can be configured with the ​​ip access-list command.

Command Mode

MPLS RSVP Configuration

Command Syntax

ip access-group ACL_NAME

no ip access-group ACL_NAME

default ip access-group ACL_NAME

Parameters

ACL_NAME - Access list name.

Example

The following command applies the IPv4 access-list MyACL to RSVP.
switch#(config-mpls-rsvp)#ip access-group MyACL

ipv6 access-group

The ipv6 access-group command can be used to apply IPv6 access-lists to RSVP. Access-lists can be configured with the ​ipv6 access-list command.

Command Mode

MPLS RSVP Configuration

Command Syntax

ipv6 access-group ACL_NAME

no ipv6 access-group ACL_NAME

default ipv6 access-group ACL_NAME

Parameters

ACL_NAME - Access list name.

Example

The following command applies the IPv6 access-list MyACL to RSVP.
switch#(config-mpls-rsvp)#ipv6 access-group MyACL

label local-termination

The label local-termination commandcan be used to configure the termination mode advertised by an egress node. Using the explicit-null option will enable the egress node to advertise an IPv4 explicit-null label (Label 0) to its upstream router.

The no label local-termination or default label local-termination or label local-termination implicit-null commands can be used to return the switch to the default state of advertising implicit-null labels (Label 3).

Note: When another label (e.g., VPN) is present, only switches that support multiple label termination can add an explicit-null label. These switches include the 7800R3, 7500R3 and 7280R3.

Command Mode

MPLS RSVP Configuration

Command Syntax

label local-termination (explicit-null | implicit-null)

no label local-termination

default label local-termination

Parameters
  • explicit-null - Advertises an explicit-null label to upstream RSVP router.
  • implicit-null - Advertises an implicit-null label. This is the default.

Example

The following command configures the switch to advertise an explicit null label to its upstream RSVP router when it is an egress node:
switch(config-mpls-rsvp)# label local-termination explicit-null

leaf

The leaf command can be used in explicit tree specifications to configure the path to leaves in the tree. Leaves are specified by their destination IP address. Hops in the leaf’s path can be configured with the hop command and can either be interface or node hops (the latter being configured with the node keyword).

Command Mode

Traffic Engineering RSVP Explicit Tree Configuration

Command Syntax

leaf IP_ADDR

no leaf IP_ADDR

default leaf IP_ADDR

Parameters

IP_ADDR - Destination IP address of the leaf in the tree.

Example

The following command creates a leaf to 4.4.4.4 in the tree named myTree and enters the configuration mode for that leaf.
switch(config-te-rsvp-tree-expl-myTree)#leaf 4.4.4.4
switch(config-te-rsvp-tree-expl-myTree-leaf-4.4.4.4)#

local-interface

The local-interface command specifies a local interface from which to derive the source IP address for RSVP-TE tunnels.

Command Mode

Traffic Engineering RSVP Configuration

Command Syntax

local-interface

no local-interface

default local-interface

Parameters
  • intf Interface type and number for the local interface.

Example

The following command specifies loopback interface 0 as the local interface:

switch(config-te-rsvp)# local-interface Loopback0

lsp no-path preservation timer

The lsp no-path preservation timer command in the Traffic-Engineering RSVP Configuration Mode configures a timer to control how long the switch maintains an original Label Switched Path (LSP) if a Make-Before-Break (MBB) attempt fails due to CSPF finding no replacement path for it.

The [no | default] versions of the command restores the default preservation timer of 0 seconds, meaning an LSP will be taken down immediately if no new path is found.

Command Mode

Traffic-Engineering RSVP Configuration

Command Syntax

lsp no-path preservation timer ( PRESERVATION_TIME seconds| infinite )

[ no | default ]lsp no-path preservation timer

Parameters

seconds seconds - Specify the time in seconds, 0 - 3600, to preserve an existing LSP after an MBB failure if no replacement path is found.

infinite - An existing LSP will be preserved indefinitely even if no replacement path is found.

Example

The Preservation Timer can be configured using the following command to set the timer to 300 seconds:
 switch(config-te-rsvp)# lsp no-path preservation timer 300 seconds

lsp self-ping

The lsp self-ping command enables LSP self-ping (RFC 7746). When enabled, all new LSPs created by RSVP-TE LER tunnels will perform self-ping. LSP self-ping verifies end-to-end establishment of the LSP by sending a self-ping message through the LSP before sending regular traffic. When LSP self-ping is enabled, an LSP created by an RSVP-TE tunnel will only be considered up and ready to carry traffic when a self-ping message successfully returns to the head end. LSP self-ping is disabled by default.

The no and default forms of the command disable LSP self-ping.

Command Mode

Traffic Engineering RSVP Configuration

Command Syntax

lsp self-ping

default lsp self-ping

no lsp self-ping

Example

The following command enables LSP self-ping:
switch(config-te-rsvp)# lsp self-ping

metric

The metric command configures a per RSVP tunnel metric to allow specific tunnels to an endpoint to take precedence over other tunnels to the same endpoint when forming ECMP. The tunnel metric is published to the tunnel RIB for BGP cost calculations.

The tunnel metric can alsobe set to dynamically track the IGP SPF metric for the tunnel destination IP regardless of the changes in the Constrain-based Shortest Path First (CSPF) path to the destination. This can be done with the igp keyword.

Command Mode

Traffic Engineering RSVP P2P Tunnel Configuration

Traffic Engineering RSVP P2P Tunnel Profile Configuration

Command Syntax

metric ( igp | metric_value)

[no | default] metric

Parameters
  • igp - Specify to use the IPG SPF metric.
  • metric_value - Specify a static metric value between 0 and 4294967295.
Examples
  • Use the following command to add a static metric, 10 to the existing MyTunnel configuration:
    switch(config-te-rsvp-tunnel-MyTunnel)# metric 10
  • Use the following command to add the IGP SPF metric, igp, to the existing MyTunnel configuration:
    switch(config-te-rsvp-tunnel-MyTunnel)# metric igp

mpls rsvp

The mpls rsvp command places the switch in the MPLS RSVP configuration mode.

Note: Use caution when using the no and default mpls rsvp versions of this command. The whole mode will be removed. Use with care.

Command Mode

Global Configuration

Command Syntax

mpls rsvp

[no | default] mpls rsvp - Will wipe the configuration in the mode and disable RSVP.

Example

The following command places the switch in the MPLS RSVP configuration mode:
switch(config)# mpls rsvp

mtu signaling

The mtu signaling command configures RSVP to enable MTU discovery. MTU signaling is disabled by default. The MTU is discovered with the AdSpec object in the Path message, which contains the minimum MTU seen in the path so-far, and is then reported back in the Resv message. If the config knob is not set on a transit node, then the MTU in the AdSpec is not updated on the node (essentially ignoring the node for MTU discovery). If it is not set on the ingress node, then MTU discovery is not done for any LSPs originating at that node.

The no and default forms of the command disable MTU signaling.

Command Mode

MPLS RSVP Configuration

Command Syntax

mtu signaling

no mtu signaling

default mtu signaling

Example

The following command enables MTU signaling on the switch:
switch(config-mpls-rsvp)# mtu signaling

neighbor authentication index active

The neighbor authentication index active command configures the MPLS RSVP cryptographic authentication password used for incoming and outgoing messages to and from the specified neighbor. Per-neighbor authentication takes precedence over global authentication. The per-neighbor authentication password must also be configured globally with the authentication index password command.

The no and default versions of the command remove neighbor-specific authentication password configuration; the neighbor then inherits the global configuration.

Command Mode

MPLS RSVP Configuration

Command Syntax

neighbor neighbor_address authentication index index_num active

no neighbor neighbor_address authentication index index_num active

default neighbor neighbor_address authentication index index_num active

Parameters
  • neighbor_address - address of the MPLS RSVP neighbor.
  • index_num - index number chosen as the password for cryptographic authentication for messages sent to and received from the specified neighbor.

Example

The following commands enable cryptographic authentication for the neighbor at 172.16.0.0 and establishes index 755 as the password for outgoing messages to that neighbor:
switch(config-mpls-rsvp)# neighbor 172.16.0.0 authentication type md5
switch(config-mpls-rsvp)# neighbor 172.16.0.0 authentication index 755 active

neighbor authentication type

The neighbor authentication type command configures the MPLS RSVP cryptographic authentication type for the specified neighbor. Setting the type to md5 enables cryptographic authentication (RFC 2747) for MPLS RSVP messages sent to the specified neighbor. Setting the type to none disables authentication for the neighbor. Note that per-neighbor authentication takes precedence over global authentication.

The no and default versions of the command remove neighbor-specific authentication type configuration; the neighbor then inherits the global configuration.

Command Mode

MPLS RSVP Configuration

Command Syntax

neighbor neighbor_address authentication type (md5 | none)

no neighbor neighbor_address authentication type

default neighbor neighbor_address authentication type

Parameters
  • neighbor_address - address of the MPLS RSVP neighbor.
  • md5 - enables MPLS RSVP cryptographic authentication (RFC 2747) for the specified neighbor. A password for outgoing messages must also be configured using the neighbor authentication index active command.
  • none - disables MPLS RSVP cryptographic authentication for messages sent to the specified neighbor.
Examples
  • The following commands enable cryptographic authentication for the neighbor at 172.16.0.0 and establishes index 755 as the password for outgoing messages to that neighbor:
    switch(config-mpls-rsvp)# neighbor 172.16.0.0 authentication type md5
    switch(config-mpls-rsvp)# neighbor 172.16.0.0 authentication index 755 active
    
  • The following commands disable cryptographic authentication for the neighbor at 172.16.0.0:
    switch(config-mpls-rsvp)# neighbor 172.16.0.0 authentication type none

optimization interval

Periodic tunnel optimization can be configured globally or individually for a specific tunnel using the optimization interval command. This configuration is applied to all RSVP tunnels.

The optimization interval can also be configured on an individual tunnel by entering the command in the tunnel mode. The optimization interval configured in the tunnel mode overrides the optimization interval configured globally.

Optimization can also be disabled on a specific tunnel or globally, which is the default.

Command Mode

Traffic Engineering RSVP P2P Configuration

Traffic Engineering RSVP P2P Tunnel Configuration

Command Syntax

optimization interval numerical value seconds

default optimization

no optimization

Parameters

numerical value - enter the optimization interval in seconds.

disabled - explicitly disables periodic optimization irrespective of global or profile configuration. Not available for the global optimization interval.

Example
  • The following command configures all RSVP tunnels to be re-optimized every 3600 seconds:
    switch(config-te-rsvp)# optimization interval 3600 seconds
  • The following command configures an optimization interval of 3600 seconds on the tunnel named myTunnel. This tunnel-specific configuration overrides the global optimization configuration for that tunnel.
    switch(config-te-rsvp-tunnel-myTunnel)# optimization interval 3600 seconds
  • The following commands configure an optimization interval of 3600 seconds for all tunnels but disables periodicoptimization on the tunnel named myTunnel:
    switch(config-te-rsvp)# optimization interval 3600 seconds
    switch(config-te-rsvp)# tunnel myTunnel
    switch(config-te-rsvp-tunnel-myTunnel)# optimization disabled

p2mp

From the config-mpls-rsvp configuration mode, the p2mp command places the switch in config-mpls-rsvp-p2mp configuration mode.

Command Mode

MPLS RSVP Configuration

Command Syntax

p2mp - Enters the mode and enables RSVP P2MP.

default p2mp - Will wipe the configuration in the mode and disable RSVP P2MP.

no p2mp- Will wipe the configuration in the mode and disable RSVP P2MP.

Examples

  • RSVP P2MP signaling functionality is enabled using the p2mp command , which also enters the config-mpls-rsvp-p2mp mode.
    switch(config-mpls-rsvp)# p2mp
    switch(config-mpls-rsvp-p2mp)#
  • P2MP functionality is disabled by issuing the disabled command in the p2mp mode. This allows disabling RSVP P2MP without wiping any active configuration in the p2mp mode.
    switch(config-mpls-rsvp-p2mp)# disabled
  • The no p2mp will remove all configuration in the mode and also disable RSVP P2MP.
    switch(config-mpls-rsvp)# no p2mp
  • The exit command will leave the mode but will retain the configuration in it.
    switch(config-mpls-rsvp-p2mp)# exit
    switch(config-mpls-rsvp)#

path (path specification)

The path command in Traffic Engineering RSVP configuration mode creates path specifications and enters the configuration mode for the path. These path specifications define the constraints for paths used by RSVP tunnels. If the path does not already exist, the path command creates it. Path configuration modes are group-change modes: changes take effect only when exiting the mode. To exit the mode without saving changes, use the abort command.

The no path and default path commands delete the specified path.

Note: A path of a specific name can only be explicit or dynamic, and once a path is created its type cannot be changed. To change a named path from explicit to dynamic or vice versa, delete the path by using the no form of the command and create it again with the desired mode.

Command Mode

Traffic Engineering RSVP Configuration

Command Syntax

path path_name (dynamic | explicit)

no path path_name

default path path_name

Parameters
  • path_name - Specification name for the path.
  • dynamic - Establishes a dynamic path specification.
  • explicit - Establishes an explicit path specification.

Example

The following command creates an explicit path named spec1 and enters the configuration mode for that path.
switch(config-te-rsvp)#path spec1 explicit
switch(config-te-rsvp-path-expl-spec1)# 
The following command creates a dynamic path named spec2 and enters the configuration mode for that path.
switch(config-te-rsvp)#path spec2 dynamic  
switch(config-te-rsvp-path-dyn-spec2)#

path (RSVP tunnel)

The path command in the Traffic Engineering RSVP P2P Tunnel configuration mode specifies a primary or secondary path along which the LSPs are established for the tunnel.

The no and default forms of the command remove the specified path from the tunnel configuration.

Command Mode

Traffic Engineering RSVP P2P Tunnel Configuration

Command Syntax

path path_name (secondary pre-signaled)

no path path_name (secondary)

default path path_name(secondary)

Parameters

  • pathspec_name - Specification name for the path to use for this tunnel.

  • secondary - Use the path specification to create a secondary path.

  • pre-signaled - Indicates the secondary path should be pre-signaled. The default behaviour without this is to only signal a secondary path when the primary path is down or encounters an error.

Examples
  • The following command specifies that tunnel13 should use path6 for its primary path:
    switch(config-te-rsvp-tunnel-tunnel13)# path path6
  • The following command specifies that tunnel13 should use path7 to create a pre-signaled secondary path:
    switch(config-te-rsvp-tunnel-tunnel13)# path path7 secondary pre-signaled
    

ping mpls rsvp session

The ping mpls rsvp session command allows the user to check if the remote endpoint of an RSVP session is reachable through the LSP. Running ping on an RSVP LSP creates an LSP Ping Request packet with the label programmed by RSVP and that packet will follow the MPLS path until it reaches the end of the tunnel. If the node that receives this Request is the intended destination, it replies with an RSVP Ping Reply through normal IP routing. When the source receives the Reply it indicates that there are no apparent data plane failures and that the endpoint of that LSP is reachable.

Command Mode

Privileged EXEC

Command Syntax

ping mpls rsvp session ( ( id SESSION_ID [ lsp LSP ] ) | ( name SESSION_NAME ) ) [ ( { ( source SRC_IP ) | ( standard STANDARD ) | ( traffic-class TRAFFIC_CLASS ) | ( tos ( TOS_VAL | ( dscp ( DSCP | DSCP_ACL ) ) ) ) | pad-reply | ( size SIZE ) | ( repeat REPEAT ) | ( interval INTERVAL ) } ) ]

Parameters

  • id - Specifies the session by ID.

  • SESSION_ID - RSVP session ID.

  • lsp - Specifies LSP. This parameter can only be specified with the id parameter.

  • LSP - RSVP LSP ID.

  • name - Specifies session by name.

  • SESSION_NAME - RSVP session name.

  • pad-reply - Indicates that the reply should copy the pad TLV.

  • repeat - Specifies repeat count.

  • source - Specifies the source address.

  • standard - Sets the standard to comply with.

  • tos - Specifies ToS value.

  • traffic-class - Specifies the MPLS traffic class field.

  • interval - Specify interval between requests.

  • size - Specify packet size in bytes.

Examples
  • In the following example, the ping utility checks if the remote endpoint of an RSVP session is reachable through the LSP, sending three ping requests through LSP 1 of session 1.
    switch# ping mpls rsvp session id 1 lsp 1 repeat 3
    LSP ping to RSVP session #1 LSP #1
       timeout is 5000ms, interval is 1000ms
    Via 10.0.12.2, Ethernet1, label 100000
       Reply from 10.0.34.4: seq=1, time=53.294ms, success: egress ok
    Via 10.0.12.2, Ethernet1, label 100000
       Reply from 10.0.34.4: seq=2, time=75.329ms, success: egress ok
    Via 10.0.12.2, Ethernet1, label 100000
       Reply from 10.0.34.4: seq=3, time=85.574ms, success: egress ok
    
    --- RSVP target fec 0.4.4.4 : lspping statistics ---
    Via 10.0.12.2, Ethernet1, label 100000
       3 packets transmitted, 3 received, 0% packet loss, time 2272ms
       3 received from 10.0.34.4, rtt min/max/avg 53.294/85.574/71.399 ms
  • For the ping mpls rsvp session command, the argument lsp is optional. If unspecified, the utility pings all LSPs within that session.
    switch# ping mpls rsvp session id 1 repeat 2
    LSP ping to RSVP session #1
       timeout is 5000ms, interval is 1000ms
    LSP 1
    Via 10.0.12.2, Ethernet1, label 100000
       Reply from 10.0.34.4: seq=1, time=60.28ms, success: egress ok
    LSP 2
    Via 10.0.12.2, Ethernet1, label 100002
       Reply from 10.0.34.4: seq=1, time=81.701ms, success: egress ok
    LSP 1
    Via 10.0.12.2, Ethernet1, label 100000
       Reply from 10.0.34.4: seq=2, time=52.807ms, success: egress ok
    LSP 2
    Via 10.0.12.2, Ethernet1, label 100002
       Reply from 10.0.34.4: seq=2, time=62.814ms, success: egress ok
    
    --- RSVP target fec 0.4.4.4 : lspping statistics ---
    LSP 1
    Via 10.0.12.2, Ethernet1, label 100000
       2 packets transmitted, 2 received, 0% packet loss, time 1262ms
       2 received from 10.0.34.4, rtt min/max/avg 52.807/60.280/56.544 ms
    
    LSP 2
    Via 10.0.12.2, Ethernet1, label 100002
       2 packets transmitted, 2 received, 0% packet loss, time 1262ms
       2 received from 10.0.34.4, rtt min/max/avg 62.814/81.701/72.257 ms
  • In the following example, the session is specified by name and the utility pings all the LSPs within that session.
    switch# ping mpls rsvp session name Session1to4 repeat 2
    LSP ping to session Session1to4
       timeout is 5000ms, interval is 1000ms
    LSP 1
    Via 10.0.12.2, Ethernet1, label 100000
       Reply from 10.0.34.4: seq=1, time=63.314ms, success: egress ok
    LSP 2
    Via 10.0.12.2, Ethernet1, label 100002
       Reply from 10.0.34.4: seq=1, time=75.639ms, success: egress ok
    LSP 1
    Via 10.0.12.2, Ethernet1, label 100000
       Reply from 10.0.34.4: seq=2, time=60.875ms, success: egress ok
    LSP 2
    Via 10.0.12.2, Ethernet1, label 100002
       Reply from 10.0.34.4: seq=2, time=77.135ms, success: egress ok
    
    --- RSVP target fec 0.4.4.4 : lspping statistics ---
    LSP 1
    Via 10.0.12.2, Ethernet1, label 100000
       2 packets transmitted, 2 received, 0% packet loss, time 1262ms
       2 received from 10.0.34.4, rtt min/max/avg 60.875/63.314/62.094 ms
    
    LSP 2
    Via 10.0.12.2, Ethernet1, label 100002
       2 packets transmitted, 2 received, 0% packet loss, time 1262ms
       2 received from 10.0.34.4, rtt min/max/avg 75.639/77.135/76.387 ms

preemption method

The preemption method command can be used to set the desired preemption method on a node. Soft preemption enables deferred failure of RSVP-TE LSPs on link oversubscription. When an LSP loses its bandwidth reservation, the LSP is torn down only after a delay in order to give a chance for the headend to replace it. The delay is configurable with the timer parameter. Hard preemption will result in the LSP being torn down immediately once the preemption algorithm chooses to preempt it.

This configuration is also used on the headend to determine the desired preemption methods for LSPs originating there.

The default preemption method is soft preemption with a timer value of 30 seconds.

Command Mode

MPLS RSVP Configuration

Command Syntax

preemption method (hard | soft ) [timer <seconds>]

no preemption method

default preemption method

Parameters
  • hard - Hard preemption. The timer value is ignored.
  • soft - Soft preemption.
    • timer - Time limit for LSP teardown. Only applies to soft-preemption. If the timer keyword is not used the default timer of 30 seconds is used.
      • <seconds> 1-65535 - Timer value in units of seconds.
Examples
  • In this example, the preemption method is set to soft preemption with a timer value of 10 seconds.
    switch(config-mpls-rsvp)# preemption method soft timer 10
  • Setting the preemption method to hard preemption results in a timer value of 0 seconds and disables the soft preemption feature.
    switch(config-mpls-rsvp)# preemption method hard

priority

The priority command configures the tunnel priority. The setup keyword is used to set the setup priority of the tunnel; the priority used when the tunnel’s LSPs are being established.The hold keyword sets the hold priority of the tunnel; the priority used when the tunnel’s LSPs are up. The priority value range is 0 (highest priority) to 7 (lowest priority).

The hold priority should be a higher priority (lower value) than the setup priority to avoid cycles where an LSP is continuously established and immediately preempted.

Command Mode

Traffic Engineering RSVP P2P Tunnel Configuration

Traffic Engineering RSVP P2P Tunnel Profile Configuration

Command Syntax

priority setup SETUP_PRIORITY hold HOLD_PRIORITY

no priority

default priority

Parameters
  • SETUP_PRIORITY - Priority value 0-7
  • HOLD_PRIORITY - Priority value 0-7

Example

The following example configures a setup priority 5 and a hold priority 3. The hold priority is a lower value, meaning it has a higher priority when the tunnel is up.
switch(config-te-rsvp-tunnel-myTunnel)# priority setup 5 hold 3

profile

The profile command associates a specified tunnel profile with the tunnel specification. The tunnel will inherit configuration from the tunnel profile. If a config command is configured in both the tunnel specification and the tunnel profile with differing parameters, then the configuration in the tunnel specification takes precedence.

Command Mode

Traffic Engineering RSVP P2P Tunnel Configuration

Traffic Engineering RSVP P2MP Tunnel Configuration

Command Syntax

profile PROFILE_NAME

no profile

default profile

Parameters

PROFILE_NAME - name of the tunnel profile.

Example

The following command associates the tunnel profile MyProfile with the tunnel specification MyTunnel:
switch(config-te-rsvp-tunnel-MyTunnel)# profile MyProfile

refresh interval

The refresh interval command configures the interval at which RSVP Path and Resv or Srefresh messages are sent to refresh the state. Refresh messages are sent at a randomly selected interval between 0.5 and 1.5 times the configured value. The default value is 30 seconds.

The no and default versions of the command reset the refresh interval to 30 seconds.

Command Mode

MPLS RSVP Configuration

Command Syntax

refresh interval seconds

no refresh interval

default refresh interval

Parameters

seconds - Refresh interval in seconds. The actual refresh interval is randomly generated in the range of 0.5 to 1.5 times this value for each refresh message. Values range from 1 to 65535. The default value is 30 seconds.

Example

The following command configures an interval of 100 seconds at which RSVP Path and Resv or Srefresh messages are sent to refresh the state:
switch(config-mpls-rsvp)#refresh interval 100

refresh method

Using the refresh method command with the bundled keyword enables the Refresh Overhead Reduction which supports refreshing the state for several LSPs in a single message using message IDs bundled in Srefresh messages. The explicit keyword disables Refresh Overhead Reduction, meaning that each LSP refreshes its state individually with Path and Resv messages.

Command Mode

MPLS RSVP Configuration

Command Syntax

refresh method (bundled | explicit)]

no refresh method

default refresh method

Parameters
  • bundled - Refresh states using message identifiers lists. This is the default setting.
  • explicit - Send each refresh message individually.
Examples
  • Use the bundled keyword to enable Refresh Overhead Reduction.

    switch(config-mpls-rsvp)# refresh method bundled
  • To turn off Refresh Overhead Reduction, use the explicit keyword.
    switch(config-mpls-rsvp)# refresh method explicit

refresh rsvp tunnel optimization

RSVP-TE tunnels can be optimized on-demand by using the refresh rsvp tunnel optimization command. This can be used to optimize a specific tunnel by name or all tunnels.

Command Mode

Privileged Exec

Command Syntax

refresh rsvp tunnel optimization (all | ( name tunnel_name [avoid ecmp hop ecmp_hops] ))

Parameters
  • all Optimizes all tunnels.
  • name tunnel_name Optimizes the named tunnel.
  • avoid ecmp hop ecmp_hops The on-demand optimization can also be used to move a tunnel between different equal-cost options. A set of links can be passed to CSPF to avoid while finding another equal-cost path. This operation works only on equal-cost paths and will not switch the tunnel to a less optimal path. The variable ecmp_hops is a list of IPv4 addresses.
Example
  • The following command optimizes the tunnel named myTunnel:
    switch# refresh rsvp tunnel optimization name myTunnel
  • The following command optimizes the tunnel named myTunnel and recomputes the tunnel path to avoid 198.51.100.17 and 198.51.100.18:
    switch# refresh rsvp tunnel optimization name myTunnel avoid ecmp hop 198.51.100.17 198.51.100.18
  • The following command performs optimization on all tunnels:
    switch# refresh rsvp tunnel optimization all

rsvp

The rsvp command places the switch in Traffic Engineering RSVP configuration mode.

Note: Use caution when using the no and defaultversions of this command. The whole mode will be removed. Use with care.

Command Mode

Traffic Engineering Configuration

Command Syntax

rsvp

default rsvp- Will wipe the configuration in the mode.

no rsvp - Will wipe the configuration in the mode.

Example

The following commands place the switch in Traffic Engineering RSVP configuration mode:
switch(config)#router traffic-engineering
switch(config-te)#rsvp
switch(config-te-rsvp)#

rsvp bypass administrative-group

The rsvp bypass administrative-group command specifies administrative groups that must be included in, or excluded from, path specification for bypass tunnels. The restrictions specified for an interface apply to all bypass tunnels that bypass that interface. This includes both link and node protection. A single command can incorporate ranges for include any, include all, and exclude administrative groups.

The no rsvp bypass administrative-group and default rsvp bypass administrative-group commands remove bypass restrictions for the interface.

Command Mode

Interface Configuration

Command Syntax

rsvp bypass administrative-group [ include any <RANGE>] | [include all <RANGE>] | [exclude <RANGE>] with <RANGE> being: ( <0x0-0xFFFFFFFF> | <0-511> | <0-511>-<0-511> | WORD )

no rsvp bypass administrative-group

default rsvp bypass administrative-group

Parameters

exclude - Excludes the specified administrative group identified by either a group name or number.

include all - Includes the specified administrative groups identified by either a group name or number.

include any - Includes any of the specifiedrange of administrative groups identified by either a group name or number.

Example

The following command specifies that the path for bypass tunnels created on the node which bypass interface Ethernet 1/1 must include all administrative groups in the range from 5 to 16 and any group from the range from 8 to 75, and must exclude groups 82, 93, 115 to 168, and 255:
switch(config-if-Et1/1)#rsvp bypass administrative-group include all 5-16 include any 8-75 exclude 82,93,115-168,255

show mpls rsvp

Use the show mpls rsvp command to display the overall RSVP-TE state on the device.

Command Mode

EXEC

Command Syntax

show mpls rsvp

Example

The following example displays the overall RSVP-TE state on the device.
switch> show mpls rsvp   	 
Administrative state: enabled
Operational state: up
Refresh interval: 30 seconds
Refresh reduction: disabled
Hello messages: disabled
Fast Re-Route: disabled
   Mode: none
   Hierarchical FECs: enabled
   Bypass tunnel optimization interval: 30 seconds
Cryptographic authentication: disabled
SRLG mode: none
Soft preemption: enabled
   Preemption timer: 30 seconds
MTU signaling: disabled
Label type for local termination: implicit null
Hitless restart: disabled
Graceful restart: disabled
P2P
   Number of sessions: 6
      Ingress/Transit/Egress: 6/0/0
   Number of LSPs: 6
      Operational: 6
      Ingress/Transit/Egress: 6/0/0
      Currently using bypass tunnels: 0
P2MP
   Number of sessions: 0
   Number of LSPs: 0
      Operational: 0
      Ingress/Transit/Egress/Bud: 0/0/0/0
      Currently using bypass tunnels: 0
   Number of sub-LSPs: 0
      Operational: 0
      Ingress/Transit/Egress: 0/0/0
      Currently using bypass tunnels: 0
Number of bypass tunnels: 0
Number of neighbors: 1
Number of interfaces: 1

show mpls rsvp bandwidth

Use the show mpls rsvp bandwidth command to display the current RSVP-TE bandwidth reservations on the device per interface.

Command Mode

EXEC

Command Syntax

show mpls rsvp bandwidth [ summary ] [ INTF ]

Parameters

  • summary - Displays bandwidth information per interface in a summarized format.
  • INTF - Filter by interface.

Example

The following example displays the current RSVP-TE bandwidth reservations on the device per interface.
switch> show mpls rsvp bandwidth  
Interface Priority Bandwidth
                        Mbps     %
--------- -------- --------- -----
Ethernet1        0     840.0  84.0
                 1       0.0   0.0
                 2       0.0   0.0
                 3       0.0   0.0
                 4       0.0   0.0
                 5       0.0   0.0
                 6       0.0   0.0
                 7       0.0   0.0
             Total     840.0  84.0

Ethernet2        0    1000.0 100.0
                 1       0.0   0.0
                 2       0.0   0.0
                 3       0.0   0.0
                 4       0.0   0.0
                 5       0.0   0.0
                 6       0.0   0.0
                 7       0.0   0.0
             Total    1000.0 100.0
The following example displays the current RSVP-TE bandwidth reservations on the device per interface in a summarized format.
switch> show mpls rsvp bandwidth summary 
Interface Reserved bandwidth Percentage used Total bandwidth
                        Mbps               %            Mbps
--------- ------------------ --------------- ---------------
Ethernet1              840.0            84.0          1000.0
Ethernet2             1000.0           100.0          1000.0

show mpls rsvp counters

Use the show mpls rsvp counters command to display RSVP message counters, per interface, and counters for RSVP errors.

Command Mode

EXEC

Command Syntax

show mpls rsvp counters [ ipv4 | ipv6 ] [ interface INTF ]

Parameters

Note: The available interface filters are dependent on the platform support. Available filters may be different than the following examples.
  • interface Filter message counters by interface.
  • ipv4 - Filter by IPv4 messages.
  • ipv6 - Filter by IPv6 messages.

Example

The following example displays RSVP message counters for each interface and error counters.

switch> show mpls rsvp counters
Received Messages:

Interface  Path  PathTear  PathErr  Resv  ResvTear  ResvErr  Srefresh  Other  Errors  
---------  ----  --------  -------  ----  --------  -------  --------  -----  ------  
Ethernet1  5     0         0        0     0         0        8         51     1  	 
Ethernet2  0     0         0        14    0         0        0         0      0  	 

Sent Messages:

Interface  Path  PathTear  PathErr  Resv  ResvTear  ResvErr  Srefresh  Other  Errors  
---------  ----  --------  -------  ----  --------  -------  --------  -----  ------  
Ethernet1  0     0         0        4     0         0        9         49     0  	 
Ethernet2  13    0         0        0     0         0        0         4      0  	


Error counters during message processing:

Error             On receive  On send
-----             ----------  -------
Unknown neighbor           5        6

show mpls rsvp ip access-list

The show mpls rsvp ip access-list command shows information about the IPv4 access list used by RSVP-TE.

Command Mode

EXEC

Command Syntax

show mpls rsvp ip access-list [ACL_NAME] [summary]

Parameters

  • ACL_NAME - Filter the output by access-list name.

  • summary - Displays the output in a summarized format.

Example

Use the show mpls rsvp ip access-list command to display information about the IPv4 access list used by RSVP-TE.
switch> show mpls rsvp ip access-list
IP Access List myAcl [dynamic]
        10 permit ip any 0.0.0.0/0
Total rules configured: 1
        Configured on VRFs: default VRF

show mpls rsvp ipv6 access-list

The show mpls rsvp ipv6 access-list command shows information about the IPv6 access list used by RSVP-TE.

Command Mode

EXEC

Command Syntax

show mpls rsvp ipv6 access-list [ACL_NAME] [summary]

Parameters

  • ACL_NAME - Filter the output by access-list name.

  • summary - Displays the output in a summarized format.

Example

Use the show mpls rsvp ipv6 access-list command to display information about the IPv6 access list used by RSVP-TE.
switch> show mpls rsvp ipv6 access-list
IPV6 Access List myAcl
        10 deny ipv6 any any
Total rules configured: 1
        Configured on VRFs: default VRF

show mpls rsvp neighbor

Use the show mpls rsvp neighbor command to display information about RSVP neighbors.

Command Mode

EXEC

Command Syntax

show mpls rsvp neighbor[[ipv4_address | ipv6_address] [ summary]

Parameters
    • ipv4_address - Show information for a specific neighbor with an IPv4 address in the format A.B.C.D.

    • ipv6_address - Show information for a specific neighbor with an IPv6 address in the format A:B:C:D:E:F:G:H.

  • summary - Displays summarized information for RSVP neighbors.
Examples
  • Use the show mpls rsvp neighbor command to display information about all RSVP neighbors.

    switch> show mpls rsvp neighborNeighbor 10.0.1.1 
    Local interface: Ethernet1
    Upstream for
    Session #1 LSP #1 
    Downstream for
    Backup upstream for
    Backup downstream for
    Neighbor creation: 0:25:22 ago 
    Authentication type: disabled
    Hello capabilities: none
    Graceful restart: disabled
    Last hello received: 1 seconds ago 
    Last hello sent: 1 seconds ago 
    Bypass tunnel for link-protection: not requested
    Neighbor 10.0.2.2 
    Local interface: Ethernet2
    Upstream for 
    Downstream for 
    	Session #1 LSP #1
    Backup upstream for
    Backup downstream for
    Neighbor creation: 0:29:37 ago 
    Authentication type: disabled
    Hello capabilities: none
    Graceful restart: disabled 
    Last hello received: -
    Last hello sent: 31 seconds ago 
    Bypass tunnel for link-protection: not requested
    
  • Use the show mpls rsvp neighbor summary command to display summarized information for all RSVP neighbors.
    switch> show mpls rsvp neighbor summary
    Neighbor             Role       Sessions LSPs
    ==================== ========== ======== ========
    10.0.1.1             Upstream   1    	1
    10.0.2.2             Downstream 1    	1

show mpls rsvp session

The show mpls rsvp session command displaysinformation about RSVP sessions.

Command Mode

EXEC

Command Syntax

show mpls rsvp session [ <filters> ] [detail | history| summary])

Parameter

  • <filters>- available filter include:
    • bypass - Filter for bypass LSPs. Only applicable on the ingress node.

    • destination - Filter by destination address.

    • id - Filter by session ID.

    • lsp - Filter by LSP number.

    • name - Filter by session name.

    • role - Filter by session role.

    • state - Filter by LSP state.

    • detail - Displays more verbose information about RSVP sessions.

    • history - Display history events for RSVP sessions.

    • summary - Displays summarized information for RSVP sessions.

Examples
  • The following command displays RSVP session information:
    switch>show mpls rsvp session
    Session #1Destination address: 4.4.4.4
    Tunnel ID: 0
    Extended Tunnel ID: 1.1.1.1 
    State: up
    Session creation: 00:32:16 ago
    Role: transit
    LSP #1
         State: up 
         Type: primary
         Source address: 1.1.1.1
         LSP ID: 1
         LSP creation: 00:34:07 agoLSP uptime: 00:02:38 
         Session name: Session1 
         Local label: 100000
         Downstream label: 100000
         Upstream neighbor: 10.0.1.1
            Local interface: Ethernet1
            Last refresh received: 17 seconds ago 
            Last refresh sent: 10 seconds ago
         Downstream neighbor: 10.0.2.2
            Local interface: Ethernet2
            Last refresh received: 7 seconds ago 
            Last refresh sent: 9 seconds ago
         Bypass tunnel: not requested
            Fast re-route mode requested: none
            Fast re-route mode operational: none
    
  • The following command displays detailed RSVP session information:
    switch>show mpls rsvp session detail
    Session #1
       Destination address: 4.4.4.4
       Tunnel ID: 0
       Extended Tunnel ID: 1.1.1.1
       State: up
       Session creation: 00:35:36 ago
       Role: transit
       LSP #1
            State: up 
            [...]
            MTU Signaling: enabled
               Received Path MTU: 1800 bytes Sent Path MTU: 1500 bytes
            Explicit Route:
                10.0.12.2/32
                10.0.25.5/32
                10.0.45.4/32
            Record Route (from upstream):
                10.0.12.1
            Record Route (from downstream):
                10.0.25.5 [label: 516384]
                10.0.45.4 [label: 3]
      [...]
    
  • The following command displays history information for RSVP sessions:
    switch>show mpls rsvp session history
    Session #0, Session1Wed 2026-09-30 20:48:04.163 Session created
    Wed 2026-09-30 20:48:04.163 LSP ID 2 added
    Wed 2026-09-30 20:48:04.174 LSP ID 2: State change: down (path: received-only, resv: down)
    Wed 2026-09-30 20:48:04.210 LSP ID 2: State change: path-only (path: up, resv: down)
    Wed 2026-09-30 20:48:04.211 LSP ID 2: Bandwidth state change: pending on Ethernet1
    Wed 2026-09-30 20:48:08.000 LSP ID 2: State change: up
    Wed 2026-09-30 20:48:08.007 LSP ID 2: Bandwidth state change: reserved on Ethernet1
    
  • The following command displays a summary of RSVP session information:
    switch>show mpls rsvp session summaryrtrrsvp2#show mpls rsvp session summary
    P2P
    Session  Destination     LSP      Name                                    Role    Bypass        State
    -------- --------------- -------- --------------------------------------- ------- ------------- ---------
    1        4.4.4.4         1        Session1                                transit n/req         up
    
    P2MP
    Ext Tunnel Id   LSP      Name                                    Role    Sub-LSPs         Bypass                       State
    --------------- -------- --------------------------------------- ------- ---------------- ---------------------------- ---------
    

show traffic-engineering rsvp

The show traffic-engineering rsvp command displays the overall status of RSVP-TE tunnels on the device.

Command Mode

EXEC

Command Syntax

show traffic-engineering rsvp

Example

The following example displays the overall status of RSVP-TE tunnels on the device.
switch> show traffic-engineering rsvp
Local interface: Loopback0 (configured)
IP address: 1.1.1.1
Auto bandwidth: unsupported
Periodic optimization: disabled
LSP self-ping: disabled

P2P
   Number of tunnels: 6
      Operational: 6
   Secondary path enabled: 0
   Secondary path in use: 0
   Number of LSPs: 6
      Operational: 6

P2MP
   Number of tunnels: 0
      Operational: 0
   Number of LSPs: 0
      Operational: 0
   Number of sub-LSPs: 0
      Operational: 0

show traffic-engineering rsvp tunnel

The show traffic-engineering rsvp tunnel command displays information about RSVP tunnels.

Command Mode

EXEC

Command Syntax

show traffic-engineering rsvp tunnel [ <filters> ] [ detail | history | lsp | ( [ sub-tunnel ] summary ) ]

Parameters

  • <filters> - Available filters include:

    • name - Filter by tunnel name.

  • detail - Displays more verbose information about RSVP tunnels. The detail keyword can also be used with the history keyword to generate a composite output with both detailed tunnel information and history events.

  • history - Display history events for RSVP tunnels. The history keyword can also be used with the detail keyword to generate a composite output with both detailed tunnel information and history events.

  • lsp - Displays LSP information for RSVP tunnels.

  • summary - Displays summarized information for RSVP tunnels.

  • sub-tunnelsummary - Displays summarized information for RSVP sub-tunnels.

Example

The following command displays the status of RSVP tunnels.
switch> show traffic-engineering rsvp tunnel
switch> show traffic-engineering rsvp tunnel
Tunnel TestTunnel 
   Source address: 10.1.1.1
   Destination address: 10.4.4.4
   Color: 60, Metric: 0 
   State: up
   Bandwidth: 0.0 bps, mode explicit 
   LSPs: 2
   Active path: primary 
   Path changes: 1
   Primary path: Path2to4
      State: up, in use 
      Path (dynamic):
         10.0.12.2
         10.0.23.3
         10.0.34.4
   Secondary path: Path2to4detour 
      State: up
      Path (explicit): 
         10.0.16.6
         10.0.67.7
         10.0.37.3
         10.0.34.4
The following command displays detailed RSVP tunnel information:
switch#show traffic-engineering rsvp tunnel detail 
Tunnel TestTunnel 
   Source address: 10.1.1.1
   Destination address: 10.4.4.4
   Config source: CLI
   Color: 60, Metric: 0 
   State: up
   Bandwidth: 0.0 bps, mode explicit
      Setup priority: 7
      Hold priority: 0
   MTU signaling: disabled
   Fast re-route mode: none
   Periodic optimization: disabled
   Tunnel index: 3
   LSPs: 2
   LSP IDs: 1, 2
   LDP tunneling: disabled
   IGP shortcut: disabled
   Active path: primary 
   Path changes: 1
   Primary path: Path2to4
      State: up, in use
      CSPF Path ID: 3 
      Path (dynamic):
         10.0.12.2
         10.0.23.3
         10.0.34.4
   Secondary path: Path2to4detour 
      State: up
      Path (explicit): 
         10.0.16.6
         10.0.67.7
         10.0.37.3
         10.0.34.4
The following command displays history information for RSVP tunnels:
switch> show traffic-engineering rsvp tunnel history 
Tunnel TestTunnel 
Wed 2026-09-30 20:48:01.433 Tunnel created
Wed 2026-09-30 20:48:01.447 CSPF query on primary path
Wed 2026-09-30 20:48:01.448 State change: down
Wed 2026-09-30 20:48:01.449 CSPF reply for primary path, path not found
Wed 2026-09-30 20:48:01.450 LSP ID 1 added
Wed 2026-09-30 20:48:01.450 LSP ID 1 error: Network error, No path found (local error)
Wed 2026-09-30 20:48:04.158 CSPF reply for primary path, path found
   Path:
      10.0.12.2
      10.0.25.5
      10.0.45.4
Wed 2026-09-30 20:48:04.163 LSP ID 1 removed
Wed 2026-09-30 20:48:04.163 LSP ID 2 added
Wed 2026-09-30 20:48:08.005 LSP ID 2 state change: up
Wed 2026-09-30 20:48:08.005 LSP ID 2 in use
Wed 2026-09-30 20:48:08.008 State change: up using primary path
The following command displays information for RSVP tunnels with more detailed information about their LSPs:
switch> show traffic-engineering rsvp tunnel lsp 
Tunnel TestTunnel 
   Source address: 10.1.1.1
   Destination address: 10.4.4.4
   Color: 60, Metric: 0 
   State: up
   Bandwidth: 0.0 bps, mode explicit 
   LSPs: 2
   Active path: primary 
   LSP 1:
      Path specification: Path2to4, primary 
      CSPF Path ID: 10001
      Bandwidth: 0.0 bps
      State: up, in use
      Path (dynamic):
         10.0.12.2 
         10.0.23.3 
         10.0.34.4 
   LSP 2: 
      Path specification: Path2to4detour, secondary 
      Bandwidth: 0.0 bps 
      State: up 
      Path (explicit): 
         10.0.16.6 
         10.0.67.7 
         10.0.37.3 
         10.0.34.4
The following command displays a summary of RSVP tunnel information:
switch> show traffic-engineering rsvp tunnel summary 
P2P
Tunnel Name          Destination Color Index Active Path Reserved BW LSPs State
-------------------- ----------- ----- ----- ----------- ----------- ---- -----
TestTunnel           10.4.4.4        -     1 primary        0.00 bps    2 up

P2MP
Tunnel Name P2MP ID Index Reserved BW LSPs State Leaves
----------- ------- ----- ----------- ---- ----- ------
The following command displays a summary of RSVP sub-tunnel information:
switch> show traffic-engineering rsvp tunnel sub-tunnel summary
Tunnel: TestTunnel
Sub Tunnel Session ID Index Active Path Reserved BW Sampled BW LSPs State
---------- ---------- ----- ----------- ----------- ---------- ---- -----
         1          0     1 primary       1.00 Gbps   0.00 bps    1 up
         2          1     2 primary       1.00 Gbps   0.00 bps    1 up

shutdown (MPLS RSVP)

The shutdown command disables the RSVP-TE protocol instance. This command allows shutting down RSVP, but retaining the configuration in the MPLS RSVP config mode, as opposed to no mpls rsvp, which would disable RSVP but also wipe the config.

RSVP-TE is enabled globally by issuing the no shutdown command in the configuration sub-mode. RSVP also needs MPLS to be enabled globally.

There is no per-interface knob to enable or disable RSVP. However, RSVP will not work on interfaces on which MPLS has been disabled.

Command Mode

MPLS RSVP Configuration

Command Syntax

shutdown

no shutdown

Examples
  • The following example enables RSVP-TE globally with the no shutdown command.
    switch(config-mpls-rsvp)# no shutdown
  • The following example disables RSVP-TE globally with the shutdown command, which is the default.
    switch(config-mpls-rsvp)# shutdown

shutdown (tunnel)

A tunnel is not enabled by default, it must be explicitly enabled using the no shutdown command.

The shutdown command can be used to disable a tunnel while preserving its config, as opposed to the no tunnel command which would disable the tunnel but also wipe the config.

Command Mode

Traffic Engineering RSVP P2P Tunnel Configuration

Traffic Engineering RSVP P2MP Tunnel Configuration

Command Syntax

shutdown

no shutdown

Example
  • The following example enables a tunnel.
    switch(config-te-rsvp-tunnel-MyTunnel)# no shutdown
    
  • The following example disables a tunnel while preserving its config.
    switch(config-te-rsvp-tunnel-MyTunnel)# shutdown

split-tunnel

The split-tunnel command enables and configures RSVP sub-tunnels. Using the quantum keyword enables fixed-bandwidth sub-tunnels. Specifying a bandwidth minimum and maximum enables adaptive sub-tunnels which grow or shrink in response to changes in bandwidth.

The no split-tunnel and default split-tunnel commands disable split tunnels for the tunnel.

Command Mode

Traffic Engineering RSVP P2P Tunnel Configuration

Traffic Engineering RSVP P2P Tunnel Profile Configuration

Command Syntax

split-tunnel ( ( quantum bandwidth_num units [ sub-tunnels { ( minimum min_tunnels ) | ( limit max_tunnels ) | ( initial initial_tunnels ) } ] ) | ( min bandwidth_num units max bandwidth_num units [ sub-tunnels { ( minimum min_tunnels ) | ( limit max_tunnels ) | ( initial initial_tunnels ) } ] [ reduction-delay time time_units ] ) | disabled )

no split-tunnel

default split-tunnel

Parameters
  • quantum bandwidth_num units - Enables fixed-bandwidth sub-tunnels and specifies the bandwidth to reserve for each tunnel. Values range from 0.01 to 1000.00, and the units may be bps, gbps, kbps, mbps, or tbps.
  • min bandwidth_num units - Enables adaptive sub-tunnels. Configures the minimum bandwidth for each sub-tunnel. Values range from 0.00 to 1000.00 and the units may be bps, kbps, mbps, gbps, or tbps.
  • max bandwidth_num units - Enables adaptive sub-tunnels. Configures the maximum bandwidth for each sub-tunnel. Values range from 0.01 to 1000.00 and the units may be bps, kbps, mbps, gbps, or tbps.
  • reduction-delay time time_units - Optionally configures the amount of time before unused sub-tunnels are removed when traffic drops. Values range from 1 to 9999, and the units may be hours, minutes, or seconds. The default delay is 1 hour.
  • minimum min_tunnels - Optionally sets the minimum number of sub-tunnels to min_tunnels. Values range from 1 to 100. The default value is 1.
  • limit max_tunnels - Optionally limits the number of sub-tunnels to max_tunnels. Values range from 1 to 100. The default value is 10.
  • minimum min_tunnels - Optionally sets the minimum number of sub-tunnels to min_tunnels. Values range from 1 to 100. The default value is 1.
  • initial initial_tunnels - Optionally set the initial number of sub-tunnels to initial_tunnels. When a split-tunnel is first created, it will start with at least the configured initial number of sub-tunnels, and this level will be maintained for the first 10 minutes. After that, the number may drop to the configured minimum. Values range from 1 to 100. The default value is 1.
  • disabled - Explicitly disables split-tunnel irrespective of profile configuration.
Examples
  • The following command enables fixed-bandwidth split-tunnel for tunnel17, with each sub-tunnel reserving 500 kps, and also sets a maximum of 20 sub-tunnels for the tunnel:
    switch(config-te-rsvp-tunnel-tunnel17)#split-tunnel quantum 500 kbps sub-tunnels limit 20
    
  • The following command enables adaptive split-tunnels for tunnel17, with each sub-tunnel reserving between 500 kbps and 100 gbps, and also sets a maximum of 75 sub-tunnels for the tunnel:
    switch(config-te-rsvp-tunnel-tunnel17)#split-tunnel min 500 kbps max 100 gbps sub-tunnels limit 75
    

srlg

The srlg command specifies if link SRLGs of a primary LSP are to be considered as constraints while creating a fast-reroute bypass tunnel. This applies to both link and node protection. When the srlg command is entered with the strict option, then when a path for a bypass tunnel excluding SRLGs of the next-hop interface of the primary LSP can not be found, RSVP does not set up the bypass tunnel. When the srlg command is entered without the strict option, then a bypass tunnel is set up with as many links as possible that exclude the SRLGs of the next-hop interface of the primary LSP. Where such links are not available, links with the fewest excluded SRLGs are used.

The no srlg and default srlg commands restore the default state by turning off SRLG processing.

Command Mode

MPLS RSVP Configuration

Command Syntax

srlg [strict]

no srlg

default srlg

Parameters

strict - Applies strict SRLG constraints.

Example
  • The following command enables SRLG processing:
    switch(config-mpls-rsvp)#srlg
    

sub-group limit

The sub-group limit command configures the maximum number of sub-LSPs per sub-group that will be signaled for P2MP LSPs originating on the node. A higher number reduces the control plane traffic overhead for establishing new P2MP LSPs, since more sub-LSPs can be signaled per Path and Resv message. This results in larger packet sizes so the number may have to be reduced depending on the configured MTU. The default is a maximum of 20 sub-LSPs per sub-group.

Configuring the sub-group limit to 1 may be necessary for interoperability with some routers that only support a single sub-LSP per sub-group.

Command Mode

MPLS RSVP P2MP Configuration

Command Syntax

sub-group limit SIZE sub-lsps

no sub-group limit

default sub-group limit

Parameters

SIZE - The maximum number of sub-LSPs per sub-groups that will be signaled for P2MP LSPs originating on this device. The range is 1 to 1000.

Example

The following command configures the sub-LSP per sub-group maximum to 1 sub-LSP:
switch(config-mpls-rsvp-p2mp)# sub-group limit 1 sub-lsps

timer recovery

The timer recovery command configuration determines how long the existing RSVP state persists during the recovery phase, after which any state which has not been refreshed by the neighbors is cleared.

The no timer recovery and default timer recovery commands restore the maximum recovery timer value to its default. The default is 90 seconds.

Command Mode

  • MPLS RSVP Graceful Restart Speaker Configuration
  • MPLS RSVP Hitless Restart Configuration

Command Syntax

timer recovery RECOVERY seconds

no timer recovery

default timer recovery

Parameters
  • RECOVERY - Time neighbors should preserve stale states from this node after restart. Range: <1-320>

Example

The following command configures the recovery timer to 45 seconds in RSVP for a switch in MPLS RSVP Graceful Restart Speaker mode:
switch(config-mpls-rsvp-gr-speaker)#timer recovery 45 seconds

timer recovery maximum

The timer recovery maximum configuration determines the maximum accepted recovery time a device accepts from a neighbor going through graceful restart. This puts an upper bound on how long the device will accept a neighbor to recover for, after which it will consider a neighbor to have recovered and will return to normal operation. If the helper does not receive a refresh for an LSP from the neighbor by the end of the recovery phase, then it will timeout the LSP.

The no timer recovery and default timer recovery commands restore the maximum recovery timer value to its default. The default is to accept all recovery time values.

Command Mode

  • MPLS RSVP Graceful Restart Helper Configuration

Command Syntax

timer recovery maximum MAX_RECOVERY seconds

default timer recovery maximum

no timer recovery maximum

Parameters
  • MAX_RECOVERY - Maximum accepted recovery time in seconds. Range: <1-320>

Example

The following command configures the maximum accepted recovery time to 120 seconds for a switch in MPLS RSVP Graceful Restart Helper mode:
switch(config-mpls-rsvp-gr-helper)#timer recovery maximum 120 seconds

timer restart

In the speaker role, the timer restart command is used to set the restart time. This is advertised to neighbors as how long to wait after losing communication with a speaker before considering it timed out, in order to give time to restart.

The no timer restart and no timer restart commands restore the restart time value to its default. The default is 90 seconds.

Command Mode

  • MPLS RSVP Graceful Restart Speaker Configuration

Command Syntax

timer restart RESTART seconds

default timer restart

no timer restart

Parameters
  • RESTART - Time neighbors should keep this node alive during restart. Range: <1-320>

Example

The following command configures the restart timer to 45 seconds in RSVP for a switch in MPLS RSVP Graceful Restart Speaker mode:
switch(config-mpls-rsvp-gr-speaker)#timer restart 45 seconds

timer restart maximum

In the helper role, the timer restart maximum command sets the maximum accepted restart time value from a speaker.

The no timer restart maximum and no timer restart maximum commands restore the maximum restart time value to its default. The default is to accept all restart time values.

Command Mode

MPLS RSVP Graceful Restart Helper Configuration

Command Syntax

timer restart maximum RESTART seconds

default timer restart maximum

no timer restart maximum

Parameters
  • RESTART - Maximum accepted restart timer value. Range: <1-320>

Example

The following command configures the timer restart maximum to 90 seconds:
switch(config-mpls-rsvp-gr-helper)#timer restart maximum 90 seconds

tree (tree specification)

The tree command in Traffic Engineering RSVP Configuration Mode creates tree specifications and enters the configuration mode for the tree. These tree specifications define the constraints for trees used by RSVP P2MP tunnels. If the tree specification does not already exist, the tree command creates it. Tree configuration modes are group-change modes: changes take effect only when the mode is exited. To exit the mode without saving changes, use the abort command.

The no tree and default tree commands delete the specified tree.

Note: A tree of a specific name can only be explicit or dynamic, and after a tree is created, its type cannot be changed. To change a named tree from explicit to dynamic or vice versa, delete the tree by using the no form of the command and create it again with the desired mode.

Command Mode

Traffic Engineering RSVP Configuration

Command Syntax

tree TREE_NAME (explicit | dynamic)

no tree TREE_NAME

default tree TREE_NAME

Parameters

  • TREE_NAME - Specification name for the tree.

  • dynamic - Establishes a dynamic tree specification.

  • explicit - Establishes an explicit tree specification.

Example

The following command creates an explicit tree named tree1 and enters the configuration mode for that tree.
switch(config-te-rsvp)#tree tree1 explicit  
switch(config-te-rsvp-tree-expl-tree1)#
The following command creates a dynamic tree named tree2 and enters the configuration mode for that tree.
switch(config-te-rsvp)#tree tree2 dynamic  
switch(config-te-rsvp-tree-dyn-tree2)#

tree (RSVP tunnel)

The tree command in the Traffic Engineering RSVP P2MP Tunnel configuration mode specifies the tree specification that will be used for the P2MP tunnel.

The no and default forms of the command remove the specified tree from the tunnel configuration.

Command Mode

Traffic Engineering RSVP P2MP Tunnel Configuration

Command Syntax

tree TREE_NAME

no tree TREE_NAME

default tree TREE_NAME

Parameters

TREE_NAME - Specification name for the tree.

Example

The following command specifies that myTunnel should use the myTree specification:
switch(config-te-rsvp-tunnel-p2mp-myTunnel)#tree myTree 

tunnel (RSVP)

The tunnel command enters Traffic Engineering RSVP P2P Tunnel configuration mode for the named tunnel. If the named tunnel does not exist, the command creates it.

Note: The no and default forms of the command delete the named tunnel.

Entering the p2mp keyword after the name of the tunnel places the tunnel into Traffic Engineering RSVP P2MP Tunnel configuration mode for multicast tunnels.

Changes made in the tunnel mode only take effect when the mode is exited normally, using the exit command. The abort command can be used to exit the mode and also discard any changes made.

Command Mode

Traffic Engineering RSVP Configuration

Command Syntax

tunnel name [p2mp]

no tunnel name [p2mp]

default tunnel name [p2mp]

Parameters

name - Tunnel name.

p2mp - Places the tunnel into point-to-multipoint (p2mp) mode.

Example

The following example enters the configuration mode for the tunnel named MyTunnel:
switch(config-te-rsvp)# tunnel MyTunnel
switch(config-te-rsvp-tunnel-MyTunnel)#
The following example exits the tunnel mode and applies changes made since entering the mode.
switch(config-te-rsvp-tunnel-MyTunnel)# exit 
switch(config-te-rsvp)#
The following example exits the tunnel mode and discards changes made since entering the mode.
switch(config-te-rsvp-tunnel-MyTunnel)# abort 
switch(config-te-rsvp)#

tunneling ldp

The tunneling ldp command causes the RSVP tunnel to become eligible for LDP over RSVP.

To make the tunnel ineligible for LDP over RSVP, use the no tunneling or default tunneling command.

The ucmp keyword can be added to enable UCMP with LDP over RSVP. The bandwidth configured on the RSVP tunnel determines the weight that would be associated with this tunnel when traffic to the tunnel endpoint is UCMP load balanced.

Command Mode

Traffic Engineering RSVP Tunnel Configuration

Traffic Engineering RSVP Tunnel Profile Configuration

Command Syntax

tunneling ldp [ ucmp | disabled ]

no tunneling

default tunneling

Parameters

  • ucmp - Enables UCMP with LDP over RSVP.
  • disabled - Explicitly disables LDP tunneling irrespective of profile configuration.

Example

The following example configures LDP over RSVP.
switch(config-te-rsvp-tunnel-MyTunnel)# tunneling ldp
The following example configures UCMP with LDP over RSVP.
switch(config-te-rsvp-tunnel-tunnelABC)# tunneling ldp ucmp

tunnel profile

The tunnel profile command enters Traffic Engineering RSVP P2P Tunnel Profile configuration mode for the named tunnel profile. If the named tunnel profile does not exist, the command creates it. Tunnel profiles contain common sets of configurations that can be applied to different tunnel specifications

The no and default forms of the command delete the named tunnel profile.

Entering the p2mp keyword after the name of the tunnel profile places the tunnel profile into Traffic Engineering RSVP P2MP Tunnel Profile configuration mode for multicast tunnels.

Changes made in the tunnel profile mode only take effect when the mode is exited normally, using the exit command. The abort command can be used to exit the mode and also discard any changes made.

Command Mode

Traffic Engineering RSVP Configuration

Command Syntax

tunnel profile name [p2mp]

no tunnel profile name [p2mp]

default tunnel profile name [p2mp]

Parameters

  • name - Tunnel profile name.

  • p2mp - Places the tunnel profile into point-to-multipoint (p2mp) mode.

Example

The following example enters the configuration mode for the tunnel profile named MyProfile:
switch(config-te-rsvp)# tunnel profile MyProfile 
switch(config-te-rsvp-tunnel-profile-MyProfile)# 
The following example exits the tunnel profile mode and applies changes made since entering the mode.
switch(config-te-rsvp-tunnel-profile-MyProfile)# exit 
switch(config-te-rsvp)# 

The following example exits the tunnel profile mode and discards changes made since entering the mode.

switch(config-te-rsvp-tunnel-profile-MyProfile)# abort 
switch(config-te-rsvp)#