-
Cisco IOS XR MPLS Command Reference, Release 3.7
-
Preface
-
MPLS Label Distribution Protocol Commands on Cisco IOS XR Software
-
MPLS Forwarding Commands on Cisco IOS XR Software
-
MPLS Traffic Engineering Commands on Cisco IOS XR Software
-
RSVP Infrastructure Commands on Cisco IOS XR Software
-
MPLS Optical User Network Interface Commands on Cisco IOS XR Software
-
MPLS OAM Commands on Cisco IOS XR Software
-
Virtual Private Network Commands on Cisco IOS XR Software
-
Virtual Private LAN Services Commands on Cisco IOS XR Software
-
Index
-
Table Of Contents
RSVP Infrastructure Commands on
Cisco IOS XR Softwareclear rsvp counters authentication
clear rsvp counters prefix filtering
show rsvp counters prefix filtering
show rsvp hello instance interface-based
signalling graceful-restart restart-time
signalling hello graceful-restart interface-based
signalling hello graceful-restart refresh interval
signalling hello graceful-restart refresh misses
signalling prefix-filtering access-list
signalling prefix-filtering default-deny-action
signalling refresh reduction bundle-max-size
signalling refresh reduction disable
signalling refresh reduction reliable
signalling refresh reduction summary
RSVP Infrastructure Commands on
Cisco IOS XR Software
This chapter describes the commands that you will use to configure and use Resource Reservation Protocol (RSVP). RSVP is a signaling protocol used to set up, maintain, and control end-to-end quality-of-service (QoS) reservations over IP. RSVP is specified in Internet Engineering Task Force (IETF) RFC 2205 (ftp://ftp.isi.edu/in-notes/rfc2205.txt).
The protocol has been extended to signal Multiprotocol Label Switching traffic engineering (MPLS-TE) tunnels, as specified in the IETF RFC 3209, RSVP-TE: Extensions to RSVP for LSP Tunnels and Optical UNI tunnels, as specified in the Optical Internetworking Forum (OIF) document OIF2000.125.7, User Network Interface (UNI) 1.0, Signalling Specification. The RSVP implementation also supports fault handling as specified in IETF RFC 3473, Generalized Multiprotocol Label Switching (GMPLS) Signaling RSVP-TE extensions.
RFC2747, RSVP Cryptographic Authentication is also supported.
For detailed information about MPLS concepts, configuration tasks, and examples, refer to the
Cisco IOS XR MPLS Configuration Guide.authentication (RSVP)
To enter RSVP authentication submode, use the authentication command in global configuration mode, RSVP interface configuration mode, or RSVP neighbor configuration mode. To remove authentication parameters in the applicable submode, use the no form of this command.
authentication
no authentication
Syntax Description
This command has no arguments or keywords.
Defaults
The default value is no authentication, which means that the feature is disabled.
Command Modes
Global configuration
RSVP interface configuration
RSVP neighbor configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the authentication command to enter RSVP authentication configuration mode.
Task ID
Examples
The following example shows how to enter RSVP authentication configuration mode from global configuration mode:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# rsvp authenticationRP/0/RP0/CPU0:router(config-rsvp-auth)#The following example shows how to activate the RSVP on an interface and enter RSVP authentication configuration mode:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# rsvp interface pos 0/2/1/0RP/0/RP0/CPU0:router(config-rsvp-if)# authenticationRP/0/RP0/CPU0:router(config-rsvp-if-auth)#The following example shows how to configure the RSVP neighbor with IP address 1.1.1.1 and enter neighbor authentication configuration mode:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# rsvp neighbor 1.1.1.1RP/0/RP0/CPU0:router(config-rsvp-nbor)# authenticationRP/0/RP0/CPU0:router(config-rsvp-nbor-auth)#Related Commands
bandwidth (RSVP)
To configure RSVP bandwidth on an interface using prestandard DS-TE mode, use the bandwidth command in RSVP interface configuration mode. To reset the RSVP bandwidth on that interface to its default value, use the no form of this command.
bandwidth [total reservable bandwidth] [bc0 bandwidth] [global-pool bandwidth] [sub-pool reservable-bw]
no bandwidth [total reservable bandwidth] [bc0 bandwidth] [global-pool bandwidth] [sub-pool reservable-bw]
Syntax Description
Defaults
sub-pool-bw: 0
Note
If the command is entered without the optional arguments, the total bandwidth is set to 75 percent of the intrinsic bandwidth of the interface. (If the interface has zero intrinsic bandwidth, none are reserved.)
Command Modes
RSVP interface configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
RSVP is enabled either using the rsvp interface command or when MPLS is configured on the interface. In addition, there are other instances in which RSVP is enabled automatically; for example, when an RSVP message is received on an interface that is not configured under RSVP or MPLS (such as out-of-band signaling for an Optical User Network Interface application).
If RSVP reservation messages are received on an interface different from the one through which the corresponding Path message was sent out, the interfaces are adjusted such that all resource reservations, such as bandwidth, are done on the outgoing interface of the Path message.
Prestandard DS-TE uses the Cisco proprietary mechanisms for RSVP signaling and IGP advertisements. This DS-TE mode does not interoperate with third-party vendor equipment. Note that prestandard DS-TE is enabled only after configuring the sub-pool bandwidth values on MPLS-enabled interfaces.
Note
Task ID
Examples
The following example shows how to limit the total of all RSVP reservations on POS interface 0/3/0/0 to 5000 Kbps:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# rsvp interface pos 0/3/0/0RP/0/RP0/CPU0:router(config-rsvp)# bandwidth 5000Related Commands
bandwidth mam (RSVP)
To configure RSVP bandwidth on an interface using the Maximum Allocation Model (MAM) bandwidth constraints model, use the bandwidth mam command in RSVP interface configuration mode. To return to the default behavior, use the no form of this command.
bandwidth mam {total reservable bandwidth | max-reservable-bw maximum-reservable-bw} bc0 reservable bandwidth
no bandwidth mam {total reservable bandwidth | max-reservable-bw maximum-reservable-bw} bc0 reservable bandwidth
Syntax Description
Defaults
If the command is entered without the optional arguments, the RSVP total bandwidth is set to 75 percent of the intrinsic bandwidth of the interface. If the interface has no (0) intrinsic bandwidth, then no bandwidth is reserved for RSVP.
Command Modes
RSVP interface configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Both the MAM and RDM models can be configured on a single interface to allow switching between each model.
Note
Task ID
Examples
The following example shows how to limit the total of all RSVP reservations on POS interface 0/3/0/0 to 7500 kbps:
RP/0/RP0/CPU0:router# configRP/0/RP0/CPU0:router(config)# rsvp interface pos 0/3/0/0RP/0/RP0/CPU0:router(config-rsvp-if)# bandwidth mam 7500Related Commands
Configures RSVP bandwidth on an interface using prestandard DS-TE mode.
Configures RSVP bandwidth on an interface using the Russian Doll Model (RDM) bandwidth constraints model.
bandwidth rdm (RSVP)
To configure RSVP bandwidth on an interface using the Russian Doll Model (RDM) bandwidth constraints model, use the bandwidth rdm command in RSVP interface configuration mode. To return to the default behavior, use the no form of this command.
bandwidth rdm {total-reservable-bw | bc0 | global-pool} {sub-pool | bc1 reservable-bw}
no bandwidth rdm {total-reservable-bw | bc0 | global-pool} {sub-pool | bc1 reservable-bw}
Syntax Description
Defaults
sub-pool-bw: 0
global-pool and bc0: default value expressed in Kbps
Note
Command Modes
RSVP interface configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Both the MAM and RDM bandwidth constraint models support up two bandwidth pools.
Cisco IOS XR software provides global configuration when switching between bandwidth constraint models. Both models are configured on a single interface to allow switching between models.
Note
The global pool and sub-pool keywords are included in this command for backward compatibility with prestandard DS-TE. The global pool keyword is equivalent to the bc0 keyword. The sub-pool keyword is equivalent to the bc1 keyword.
RDM is the default bandwidth constraint model used in both pre-standard and IETF mode.
Task ID
Examples
The following example shows how to limit the total of all RSVP reservations on POS interface 0/3/0/0 to 7500 kbps, and allows each single flow to reserve no more than 1000 kbps:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# rsvp interface pos 0/3/0/0RP/0/RP0/CPU0:router(config-rsvp-if)# bandwidth rdm 7500 1000Related Commands
clear rsvp authentication
To eliminate RSVP security association (SA) before the lifetime expires, use the clear rsvp authentication command in EXEC mode.
clear rsvp authentication [type interface-id] [destination IP address] [source IP address]
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the clear rsvp authentication command for the following reasons:
•
•
•
You can delete all RSVP security associations if you do not enter an optional filter (interface, source, or destination IP address).
If you delete a security association, it is recreated as needed.
Task ID
Examples
The following example shows how to clear each SA:
RP/0/RP0/CPU0:router# clear rsvp authenticationThe following example shows how to clear each SA with the destination address 1.1.1.1:
RP/0/RP0/CPU0:router# clear rsvp authentication destination 1.1.1.1The following example shows how to clear each SA with the source address 2.2.2.2:
RP/0/RP0/CPU0:router# clear rsvp authentication source 2.2.2.2The following example shows how to clear each SA with the POS interface 0/2/1/0:
RP/0/RP0/CPU0:router# clear rsvp authentication POS 0/2/1/0The following example shows how to clear each SA on the POS interface 0/2/1/0, destination address 1.1.1.1, and source address 2.2.2.2:
RP/0/RP0/CPU0:router# clear rsvp authentication POS 0/2/1/0 destination 1.1.1.1 source 2.2.2.2Related Commands
Controls how long RSVP maintains idle security associations with other trusted RSVP neighbors.
clear rsvp counters authentication
To eliminate RSVP counters for each security association (SA), use the clear rsvp counters authentication command in EXEC mode.
clear rsvp counters authentication [type interface-id] [destination IP address] [source IP address]
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to clear authentication counters for each SA:
RP/0/RP0/CPU0:router# clear rsvp counters authenticationThe following example shows how to clear authentication counters for each SA with the destination address 1.1.1.1:
RP/0/RP0/CPU0:router# clear rsvp counters authentication destination 1.1.1.1The following example shows how to clear authentication counters for each SA with the source address 2.2.2.2:
RP/0/RP0/CPU0:router# clear rsvp counters authentication source 2.2.2.2The following example shows how to clear authentication counters for each SA with the POS interface 0/2/1/0:
RP/0/RP0/CPU0:router# clear rsvp counters authentication POS 0/2/1/0The following example shows how to clear authentication counters for each SA on the POS interface 0/2/1/0, destination address 1.1.1.1, and source address 2.2.2.2:
RP/0/RP0/CPU0:router# clear rsvp counters authentication POS 0/2/1/0 destination 1.1.1.1 source 2.2.2.2clear rsvp counters all
To clear (set to zero) all RSVP message and event counters that are being maintained by the router, use the clear rsvp counters all command in EXEC mode.
clear rsvp counters all type interface-id
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to clear all message and event counters:
RP/0/RP0/CPU0:router# clear rsvp counters allRelated Commands
clear rsvp counters chkpt
To clear RSVP checkpoint counters, use the clear rsvp counters chkpt command in EXEC mode.
clear rsvp counters chkpt
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to clear all message and event counters:
RP/0/RP0/CPU0:router# clear rsvp counters chkptRelated Commands
clear rsvp counters events
To clear (set to zero) all RSVP event counters that are being maintained by the router, use the clear rsvp counters events command in EXEC mode.
clear rsvp counters events [type interface-id]
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the clear rsvp counters events command to set all RSVP event counters to zero.
Task ID
Examples
The following example shows how to clear all event counters:
RP/0/RP0/CPU0:router# clear rsvp counters eventsRelated Commands
Clears all RSVP message counters that are being maintained by the router.
Shows RSVP event counters that are being maintained by the router when the events option is specified.
clear rsvp counters messages
To clear (set to zero) all RSVP message counters that are being maintained by the router, use the clear rsvp counters messages command in EXEC mode.
clear rsvp counters messages [type interface-id]
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the clear rsvp counters messages command to set all RSVP message counters to zero.
Task ID
Examples
The following example shows how to set all RSVP message counters for POS interface 0/3/0/2 to zero:
RP/0/RP0/CPU0:router# clear rsvp counters messages pos0/3/0/2Related Commands
clear rsvp counters oor
To clear internal RSVP counters on out of resources (OOR) events, use the clear rsvp counters oor command in EXEC mode.
clear rsvp counters oor [type interface-id]
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the clear rsvp counters oor command to set RSVP OOR counters to zero.
Task ID
Examples
The following example show how to clear all RSVP message counters for POS interface 0/3/0/2 to zero:
RP/0/RP0/CPU0:router# clear rsvp counters oor pos0/3/0/2Related Commands
clear rsvp counters prefix filtering
To clear internal prefix-filtering related RSVP counters, use the clear rsvp counters prefix-filtering command in EXEC mode.
clear rsvp counters prefix-filtering {interface [type interface-id] | access-list [aclname]}
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the clear rsvp counters prefix-filtering command to set RSVP prefix-filtering related RSVP counters to zero.
Task ID
Examples
The following example shows how to set all RSVP message counters for POS interface 0/3/0/2 to zero:
RP/0/RP0/CPU0:router# clear rsvp counters prefix-filtering interface pos0/3/0/2The following example shows how to set all RSVP prefix-filtering counters for access-list banks to zero:
RP/0/RP0/CPU0:router# clear rsvp counters prefix-filtering access-list banksRelated Commands
key-source key-chain (RSVP)
To specify the source of the key information to authenticate RSVP messages, use the key-source key-chain command in the appropriate RSVP authentication configuration mode. To remove the key source from the appropriate RSVP authentication configuration mode, use the no form of this command.
key-source key-chain key-chain-name
no key-source key-chain key-chain-name
Syntax Description
Defaults
The default value is none, which means that the key source is not specified.
Command Modes
RSVP authentication configuration
RSVP interface authentication configuration
RSVP neighbor authentication configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Note
•
•
•
Note
Task ID
Examples
The following example shows that the source of the key information is specified for the keychain mpls-keys in RSVP authentication configuration mode:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# rsvp authenticationRP/0/RP0/CPU0:router(config-rsvp-auth)# key-source key-chain mpls-keysThe following example shows that the source of the key information is specified for the keychain mpls-keys for a POS interface in RSVP authentication configuration mode:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# rsvp interface POS 0/2/1/0RP/0/RP0/CPU0:router(config-rsvp-if)# authenticationRP/0/RP0/CPU0:router(config-rsvp-if-auth)# key-source key-chain mpls-keysThe following example shows that the source of the key information is specified for the keychain mpls-keys in RSVP neighbor authentication configuration mode:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# rsvp neighbor 1.1.1.1 authenticationRP/0/RP0/CPU0:router(config-rsvp-nbor-auth)# key-source key-chain mpls-keysRelated Commands
