This module describes the commands used 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. The RSVP implementation supports fault handling as specified in IETF RFC 3473, Generalized Multiprotocol Label Switching (GMPLS) Signaling RSVP-TE extensions. The RSVP implementation also supports cryptographic authentication and refresh overhead reduction as specified in the RFC2747, RSVP Cryptographic Authentication and RFC2961, RSVP Refresh Overhead Reduction Extensions respectively.
For detailed information about MPLS concepts, configuration tasks, and examples, see MPLS Configuration Guide for Cisco NCS 5000 Series Routers.
RSVP computes and sets the checksum field on all outgoing RSVP messages, by default. RSVP also verifies the received checksum on all RSVP received messages to ensure its integrity.
RP/0/RP0/CPU0:router(config)#rsvp signalling checksum disable
![]() Note | When the rsvp signalling checksum disable command is configured, RSVP sets a zero checksum on all outgoing RSVP messages and ignores the checksum on all received RSVP incoming messages. |
To enter RSVP authentication mode, use the authentication command in global configuration mode, RSVP interface configuration mode, or RSVP neighbor XR Config mode. To remove authentication parameters in the applicable mode, use the no form of this command.
authentication
no authentication
This command has no arguments or keywords.
The default value is no authentication, which means that the feature is disabled.
RSVP interface configuration
RSVP neighbor configuration
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
No specific guidelines impact the use of this command.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to enter RSVP authentication configuration mode from global configuration mode:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp authentication RP/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# configure RP/0/RP0/CPU0:router(config)# rsvp interface HundredGigE 0/0/0/3 RP/0/RP0/CPU0:router(config-rsvp-if)# authentication RP/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# configure RP/0/RP0/CPU0:router(config)# rsvp neighbor 1.1.1.1 authentication RP/0/RP0/CPU0:router(config-rsvp-nbor-auth)#
To eliminate RSVP security association (SA) before the lifetime expires, use the clear rsvp authentication command in XR EXEC mode.
clear rsvp authentication [ type interface-path-id ] [ destination IP address ] [ source IP address ]
type |
(Optional) Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or a virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
||
destination IP address |
(Optional) Eliminates the RSVP security associations (SA) before their lifetimes expire. All SAs with this destination IP address are cleared. |
||
source IP address |
(Optional) Eliminates the RSVP security associations (SA) before their lifetimes expire. All SAs with this source IP address are cleared. |
No default behavior or values
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
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 |
Operations |
---|---|
mpls-te |
execute |
The following example shows how to clear each SA:
RP/0/RP0/CPU0:router# clear rsvp authentication
The following example shows how to clear each SA with the destination address1.1.1.1:
RP/0/RP0/CPU0:router# clear rsvp authentication destination 1.1.1.1
The 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.2
The following example shows how to clear each SA with the interface:
RP/0/RP0/CPU0:router# clear rsvp authentication HundredGigE 0/0/0/3
The following example shows how to clear each SA on the interface, destination address 1.1.1.1, and source address 2.2.2.2:
RP/0/RP0/CPU0:router# clear rsvp authentication HundredGigE 0/0/0/3 destination 1.1.1.1 source 2.2.2.2
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 XR EXEC mode.
clear rsvp counters all [ type interface-path-id ]
type |
(Optional) Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or a virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
No specific guidelines impact the use of this command.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to clear all message and event counters:
RP/0/RP0/CPU0:router# clear rsvp counters all
To eliminate RSVP counters for each security association (SA), use the clear rsvp counters authentication command in XR EXEC mode.
clear rsvp counters authentication [ type interface-path-id ] [ destination IP address ] [ source IP address ]
type |
(Optional) Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or a virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
||
destination IP address |
(Optional) Eliminates authentication-related statistics for each security association (SA) with this destination IP address. |
||
source IP address |
(Optional) Eliminates authentication-related statistics for each security association (SA) with this source IP address. |
No default behavior or values
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
No specific guidelines impact the use of this command.
Task ID |
Operations |
---|---|
mpls-te |
execute |
The following example shows how to clear authentication counters for each SA:
RP/0/RP0/CPU0:router# clear rsvp counters authentication
The 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.1
The 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.2
The following example shows how to clear authentication counters for each SA with an interface.
RP/0/RP0/CPU0:router# clear rsvp counters authentication HundredGigE 0/0/0/3
The following example shows how to clear authentication counters for each SA on an interface, destination address 1.1.1.1, and source address 2.2.2.2:
RP/0/RP0/CPU0:router# clear rsvp counters authentication HundredGigE 0/0/0/3 destination 1.1.1.1 source 2.2.2.2
To clear RSVP checkpoint counters, use the clear rsvp counters chkpt command in XR EXEC mode.
clear rsvp counters chkpt
This command has no arguments or keywords.
No default behavior or values
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
No specific guidelines impact the use of this command.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to clear all message and event counters:
RP/0/RP0/CPU0:router# clear rsvp counters chkpt
To clear (set to zero) all RSVP event counters that are being maintained by the router, use the clear rsvp counters events command in XR EXEC mode.
clear rsvp counters events [ type interface-path-id ]
type |
(Optional) Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or a virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
No default behavior or values
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
Use the clear rsvp counters events command to set all RSVP event counters to zero.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to clear all event counters:
RP/0/RP0/CPU0:router# clear rsvp counters events
To clear (set to zero) all RSVP message counters that are being maintained by the router, use the clear rsvp counters messages command in XR EXEC mode.
clear rsvp counters messages [ type interface-path-id ]
type |
(Optional) Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or a virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
No default behavior or values
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
Use the clear rsvp counters messages command to set all RSVP message counters to zero.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to set all RSVP message counters for an interface to zero:
RP/0/RP0/CPU0:router# clear rsvp counters messages HundredGigE0/0/0/3
To clear internal RSVP counters on out of resources (OOR) events, use the clear rsvp counters oor command in XR EXEC mode.
clear rsvp counters oor [ type interface-path-id ]
type |
(Optional) Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or a virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
No default behavior or values
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
Use the clear rsvp counters oor command to set RSVP OOR counters to zero.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example show how to clear all RSVP message counters for HundredGigE interface 0/0/0/3 to zero:
RP/0/RP0/CPU0:router# clear rsvp counters oor HundredGigE0/0/0/3
To clear internal prefix-filtering related RSVP counters, use the clear rsvp counters prefix-filtering command in XR EXEC mode.
clear rsvp counters prefix-filtering { interface [ type interface-path-id ] | access-list [aclname] }
interface |
Clears RSVP prefix-filtering counters for all interfaces. |
||
type |
(Optional) Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or a virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
||
access-list |
Clears RSVP prefix-filtering counters for access control list. |
||
aclname |
(Optional) Name of the access list. |
No default behavior or values
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
Use the clear rsvp counters prefix-filtering command to set RSVP prefix-filtering related RSVP counters to zero.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to set all RSVP message counters for HundredGigE interface 0/0/0/3 to zero:
RP/0/RP0/CPU0:router# clear rsvp counters prefix-filtering interface HundredGigE0/0/0/3
The 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 banks
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
key-chain-name |
Name of the keychain. The maximum number of characters is 32. |
The default value is none, which means that the key source is not specified.
RSVP authentication configuration
RSVP interface authentication configuration
RSVP neighbor authentication configuration
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
RSVP authentication is enabled regardless of whether or not the specified keychain exists or has no available keys to use. If the specified keychain does not exist or there are no available keys in the keychain, RSVP authentication processing fails.
The key-source key-chain command does not create a keychain but just specifies which keychain to use. You must configure a keychain first.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
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# configure RP/0/RP0/CPU0:router(config)# rsvp authentication RP/0/RP0/CPU0:router(config-rsvp-auth)# key-source key-chain mpls-keys
The following example shows that the source of the key information is specified for the keychain mpls-keys for a HundredGigE interface in RSVP authentication configuration mode:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface HundredGigE 0/0/0/3 RP/0/RP0/CPU0:router(config-rsvp-if)# authentication RP/0/RP0/CPU0:router(config-rsvp-if-auth)# key-source key-chain mpls-keys
The 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# configure RP/0/RP0/CPU0:router(config)# rsvp neighbor 1.1.1.1 authentication RP/0/RP0/CPU0:router(config-rsvp-nbor-auth)# key-source key-chain mpls-keys
To control how long RSVP maintains idle security associations with other trusted RSVP neighbors, use the life-time command in the appropriate RSVP authentication configuration mode. To disable the lifetime setting, use the no form of this command.
life-time seconds
no life-time seconds
seconds |
Length of time, in seconds, that RSVP maintains security associations with other trusted RSVP neighbors. Range is 30 to 86400. |
seconds: 1800 (30 minutes)
RSVP authentication configuration
RSVP interface authentication configuration
RSVP neighbor authentication configuration
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
Use the life-time (RSVP) command to indicate when to end idle security associations with RSVP trusted neighbors.
By setting a larger lifetime, the router remembers the state for a long period time which provides better protection against a replay attack.
Use the clear rsvp authentication command to free security associations before their lifetimes expire.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure a lifetime of 2000 seconds for each SA in RSVP authentication configuration mode:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp authentication RP/0/RP0/CPU0:router(config-rsvp-auth)# life-time 2000
The following example shows how to configure a lifetime of 2000 seconds for each SA in RSVP neighbor authentication configuration mode:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp neighbor 1.1.1.1 authentication RP/0/RP0/CPU0:router(config-rsvp-nbor-auth)# life-time 2000
The following example shows how to configure a lifetime of 2000 seconds for each SA in RSVP interface authentication configuration mode:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface HundredGigE 0/0/0/3 RP/0/RP0/CPU0:router(config-rsvp-if)# authentication RP/0/RP0/CPU0:router(config-rsvp-if-auth)# life-time 2000
To enable functionality for Resource Reservation Protocol (RSVP) and enter RSVP configuration commands, use the rsvp command in XR Config mode. To return to the default behavior, use the no form of this command.
rsvp
no rsvp
This command has no keywords or arguments.
No default behavior or values
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
No specific guidelines impact the use of this command.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to enable RSVP functionality and enter the sub-mode for RSVP configuration commands:
RP/0/RP0/CPU0:router(config)# rsvp RP/0/RP0/CPU0:router(config-rsvp)#
To configure RSVP on an interface, use the rsvp interface command in XR Config mode. To disable RSVP on that interface, use the no form of this command.
rsvp interface type interface-path-id
no rsvp interface type interface-path-id
type |
Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or a virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
RSVP is enabled by default on an interface under the following conditions. (Enabling RSVP on an interface means that interface can be used by RSVP to send and receive RSVP messages).
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
When RSVP is enabled on an interface by any of the three methods mentioned in the above section, the default bandwidth is 0. Use the bandwidth command in RSVP interface configuration mode to configure the bandwidth on an interface.
If the interface bandwidth is 0, RSVP can be used only to signal flows that do not require bandwidth on this interface.
The rsvp interface command enables the RSVP interface configuration mode.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to enable the RSVP interface configuration mode and to enable RSVP on this interface with 0 bandwidth:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface HundredGigE 0/0/0/3
To specify an RSVP neighbor, use the rsvp neighbor command in XR Config mode. To deactivate authentication for a neighbor, use the no form of this command.
rsvp neighbor IP-address authentication
no rsvp neighbor IP-address authentication
IP-address |
IP address of the neighbor. A single IP address of a specific neighbor; usually one of the neighbor's physical or logical (loopback) interfaces. |
authentication |
Configures RSVP authentication parameters. |
No default values or behaviors
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
RSVP neighbor configuration mode can be used only if you want to configure authentication for a particular neighbor.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to enter RSVP neighbor authentication configuration mode for IP address 1.1.1.1:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp neighbor 1.1.1.1 authentication RP/0/RP0/CPU0:router(config-rsvp-nbor-auth)#
To list all the requests that RSVP knows about on a router, use the show rsvp request command in XR EXEC mode.
show rsvp request [ destination IP-address ] [detail] [ dst-port port-num ] [ session-type { lsp-p2p } ] [ source IP-address ] [ src-port port-num ]
detail |
(Optional) Displays multiline status for each path. If this keyword is not specified, only a single-line table entry is displayed. |
destination IP-address |
(Optional) Displays the entries that match the specified address. |
dst-port port-num |
(Optional) Displays destination port and tunnel information. |
session-type |
(Optional) Displays the entries that match the specified session type. |
lsp-p2p |
Displays the entries that are used for P2P sessions. |
source IP-address |
(Optional) Displays source address information. |
src-port port-num |
(Optional) Displays port and LSP ID information. |
No default behavior or values
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
This command displays information about upstream reservations only; that is, reservations being sent to upstream hops. Information about downstream reservations (that is, incoming or locally created reservations) is available using the show rsvp reservation command.
Reservations are displayed in ascending order of destination IP address, destination port, source IP address, and source port.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following is sample output from the show rsvp request command:
RP/0/RP0/CPU0:router# show rsvp request
Dest Addr DPort Source Addr SPort Pro OutputIF Sty Serv Rate Burst
---------------- ----- ---------------- ----- --- ---------- --- ---- ---- -----
192.168.40.40 2001 192.168.67.68 2 0 HundredGigE 0/0/0/3 SE LOAD 0 1K
The following is sample output from the show rsvp request detail command, which displays detailed information about all requests in the router. Requests are reservation states for the reservation messages sent upstream:
RP/0/RP0/CPU0:router# show rsvp request detail
REQ: IPv4-LSP Session addr: 192.168.40.40. TunID: 2001. LSPId: 2.
Source addr: 192.168.67.68. ExtID: 192.168.67.68.
Output interface: HundredGigE 0/0/0/3. Next hop: 192.168.67.68 (lih: 0x19700001).
Flags: Local Receiver.
Style: Shared-Explicit. Service: Controlled-Load.
Rate: 0 bits/sec. Burst: 1K bytes. Peak: 0 bits/sec.
MTU min: 0, max: 500 bytes.
Policy: Forwarding. Policy source(s): MPLS/TE.
Number of supporting PSBs: 1
Destination Add DPort Source Add SPort Pro Input IF Rate Burst Prot
192.168.40.40 2001 192.168.67.68 2 0 HundredGigE 0/0/0/3 0 1K Off
Number of supporting RSBs: 1
Destination Add DPort Source Add SPort Pro Input IF Sty Serv Rate Burst
192.168.40.40 2001 10.66.67.68 2 0 None SE LOAD 0 1K
Field |
Description |
---|---|
Number of supporting PSBs |
Number of senders for this session (typically, 1). |
Number of supporting RSBs |
Number of reservations per session (typically, 1). |
Policy |
Admission control status. |
Policy source |
Entity performing the admission control. |
To display the database for the security association that RSVP has established with other RSVP neighbors, use the show rsvp authentication command in XR EXEC mode.
show rsvp authentication [ type interface-path-id ] [ destination IP-address ] [detail] [ mode { receive | send } ] [ neighbor IP-address ] [ source IP-address ]
type |
(Optional) Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or a virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
||
destination IP-address |
(Optional) Displays the database for the security association (SA) for the destination IP address. The IP address argument is the IP address of the destination address. |
||
detail |
(Optional) Displays additional information about RSVP security SAs. |
||
mode |
(Optional) Specifies the SA type. An SA is used to authenticate either incoming (receive) or outgoing (send) messages. |
||
receive |
Displays SAs for incoming messages. |
||
send |
Displays SAs for outgoing messages. |
||
neighbor IP-address |
(Optional) Displays the RSVP authentication information for the neighbor IP address. The IP-address argument is the IP address of the neighbor. For the send SA, the neighbor address is the destination address. For receive, the neighbor address is the source address. |
||
source IP-address |
(Optional) Displays the database for the SA for the source IP address. The IP-address argument is the IP address of the source address. |
No default behavior or values
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
No specific guidelines impact the use of this command.
Task ID |
Operations |
---|---|
mpls-te |
read |
The following sample output displays information for RSVP authentication:
RP/0/RP0/CPU0:router# show rsvp authentication
Codes: S - static, G - global, N - neighbor, I -interface, C - chain
Source Address Dest Address Interface Mode Key-Source Key-ID Code
10.0.0.1 10.0.0.2 HundredGigE 0/0/0/3 Send mpls-keys 1 SGC
10.0.0.2 10.0.0.1 HundredGigE 0/0/0/3 Recv mpls-keys 1 SGC
Field |
Description |
---|---|
Source Address |
IP address of the sender. For Send mode, this is the local address (either the address of the Interface field or the local router ID). For Recv mode, this is the address of the RSVP neighbor. |
Dest Address |
IP address of the receiver. For Send mode, this is the address of the RSVP neighbor. For Recv mode, this is the local address (either the address of the Interface field or the local router ID). |
Interface |
Name of the interface over which the security association is being maintained. |
Mode |
|
Key-Source |
Key source identification string that is currently set to the configured keychain name. |
Key-ID |
The last successful key ID that is used for authentication and maps to the keychain ID configuration. If the value is too large to fit into the column, it is truncated and a (..) suffix is appended. Use the detail mode to see the non-truncated key ID. |
Code |
|
The following sample output shows detailed information about a Send mode SA that is followed by a Receive mode SA:
RP/0/RP0/CPU0:router# show rsvp authentication detail
RSVP Authentication Information:
Source Address: 10.0.0.1
Destination Address: 10.0.0.2
Neighbour Address: 10.0.0.2
Interface: HundredGigE 0/0/0/3
Direction: Send
LifeTime: 1800 (sec)
LifeTime left: 1305 (sec)
KeyType: Static Global KeyChain
Key Source: name1
Key Status: No error
KeyID: 1
Digest: HMAC MD5 (16)
Challenge: Not supported
TX Sequence: 5023969459702858020 (0x45b8b99b00000124)
Messages successfully authenticated: 245
Messages failed authentication: 0
Receive Errors:
Incomplete security association: 0
Missing INTEGRITY object: 0
Incorrect digest: 0
Digest type mismatch: 0
Duplicate sequence number: 0
Out-of-range sequence number: 0
Invalid message format: 0
Field |
Description |
---|---|
Source Address |
IP address of the sender. For Send mode, this is the local address (either the address of the Interface field or the local router ID). For Recv mode, this is the address of the RSVP neighbor. |
Destination Address |
IP address of the receiver. For Send mode, this is the address of the RSVP neighbor. For Recv mode, this is the local address (either the address of the Interface field or the local router ID). |
Neighbor Address |
IP address of the RSVP neighbor with which the security association is being maintained. |
Interface |
Name of the interface over which the security association is being maintained. |
Direction |
|
LifeTime |
Configured expiration timer value. |
LifeTime left |
Number of seconds until the expiration timer expires. |
KeyType |
|
Key-Source |
Key source identification string that is currently set to the configured keychain name. |
Key Status |
Last status reported from the key source. |
Key-ID |
Last successful key ID that is used for authentication and that maps to the keychain ID configuration. If the value is too large to fit into the column, it is truncated and a (..) suffix is appended. (Use the detail mode to see the non-truncated key ID.) |
Digest |
Digest algorithm that is used. The algorithms are either HMAC-MD5 or HMAC-SHA1. |
Challenge |
Current challenge status reported. |
Tx Sequence |
Last sequence number that was sent. |
Messages successfully authenticated |
Number of messages authenticated by using this SA. |
Messages failed authentication |
Number of messages that failed authentication using this SA. |
Sequence Window Size |
Maximum configured RX sequence number window. |
Sequence Window Count |
Currently used size of the RX sequence number window. |
Incomplete security association |
Number of messages that are dropped due to a key failure. |
Incorrect digest |
Number of messages that are dropped due to an incorrect digest. |
Digest type mismatch |
Number of messages that are dropped due to an incorrect digest length, which implies an algorithm mismatch. |
Duplicate sequence number |
Number of messages that are dropped due to a duplicate sequence number. |
Out-of-range sequence number |
Number of messages that are dropped due to a sequence number range (window-size) checking. |
Invalid message format |
Number of messages that are dropped due to formatting errors, such as incorrect objects. |
To display internal RSVP counters, use the show rsvp counters command in XR EXEC mode mode.
show rsvp counters { messages [ type interface-path-id | summary ] | events | database }
messages |
Displays a historical count of the number of messages RSVP has received and sent on each interface along with a summation. |
||
type |
(Optional) Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or a virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
||
summary |
(Optional) Displays the aggregate counts of all interfaces. |
||
events |
Displays the number of states expired for lack of refresh and a count of received No Acknowledgements (NACKs). |
||
database |
Displays counters on RSVP database, including number of paths, session, and so on. |
No default behavior or values
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
In message counters, bundle messages are counted as single bundle messages. The component messages are not counted separately.
The messages keyword shows the counters for all the interfaces. In addition, the aggregate summary is shown by using both the messages and summary keywords.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following is sample output from the show rsvp counters messages command for HundredGigE 0/0/0/3:
RP/0/RP0/CPU0:router# show rsvp counters messages HundredGigE 0/0/0/3
HundredGigE0/0/0/3 Recv Xmit Recv Xmit
Path 24 1 Resv 0 0
PathError 0 0 ResvError 0 0
PathTear 5 1 ResvTear 0 0
ResvConfirm 0 0 Ack 34 0
Bundle 0 Hello 0 0
SRefresh 10118 0 OutOfOrder 0
Retransmit 0 Rate Limited 0
Field |
Description |
---|---|
Path |
Number of Path messages sent downstream or received from an upstream node. |
PathError |
Number of PathError messages received from a downstream neighbor or sent to an upstream neighbor. |
PathTear |
Number of PathTear messages sent downstream, or messages received, from upstream neighbors. |
ResvConfirm |
Number of ResvConfirm messages received from an upstream neighbor or sent to a downstream neighbor. |
Bundle |
Number of Bundle messages containing RSVP messages sent and received by the neighbor. |
SRefresh |
Number of Summary Refresh messages sent to and received by a neighbor to refresh the path and reservation states. |
Retransmit |
Number of messages retransmitted to ensure reliable messaging (related to refresh reduction). |
Resv |
Number of Reservation messages received from a downstream neighbor or sent to an upstream neighbor to reserve resources. |
ResvError |
Number of Reservation Error messages received from a upstream neighbor or sent to a downstream neighbor. |
ResvTear |
Number of Reservation Tear messages received from a downstream neighbor or sent to an upstream neighbor to tear down RSVP flows. |
Ack |
Number of Acknowledgement messages sent and received by a neighbor acknowledging receipt of a message. |
Hello |
Number of Hello messages sent to and received by a neighbor. |
OutOfOrder |
Number of messages received that are out of order. |
Rate Limited |
Number of RSVP packets affected by rate limiting. |
The following is sample output from the show rsvp counters database command:
RP/0/RP0/CPU0:router# show rsvp counters database
Sessions: 0
Locally created and incoming paths: 0
Outgoing paths: 0
Locally created and incoming Reservations: 0
Outgoing Reservations: 0
Interfaces: 4
To display internal RSVP counters on out of resources (OOR) events, use the show rsvp counters oor command in XR EXEC mode.
show rsvp counters oor [ type interface-path-id | summary ]
type |
(Optional) Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or a virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
||
summary |
(Optional) Displays a summary of OOR events. |
No default behavior or values
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
No specific guidelines impact the use of this command.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following is sample output from the show rsvp counters oor command:
RP/0/RP0/CPU0:router# show rsvp counters oor
HundredGigE 0/0/0/3 Rejected
Path 24
HundredGigE 0/0/0/4 Rejected
Path 31
All RSVP Interfaces Rejected
Path 55
Field |
Description |
---|---|
Path |
Number of Path messages received on the interface that were rejected due to oor conditions. |
To display internal prefix-filtering related RSVP counters, use the show rsvp counters prefix-filtering command in XR EXEC mode.
show rsvp counters prefix-filtering interface [ type interface-path-id | summary ] access-list [aclname]
interface |
Displays RSVP prefix-filtering counters for all interfaces. |
||
type |
(Optional) Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or a virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
||
summary |
(Optional) Displays a summary of RSVP prefix-filtering counters on all interfaces. |
||
access-list |
Displays RSVP prefix-filtering counters for the access control list. |
||
aclname |
(Optional) Name of the access control list. |
No default behavior or values
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
Counters do not increment if you have not configured an access control list for prefix-filtering.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following is sample output from the show rsvp counters prefix-filtering command:
RP/0/RP0/CPU0:router# show rsvp counters prefix-filtering interface
Routed Fwd Local Drop Def-Drop Def-Proc Total
Path 4 4
PathTear 0 0
ResvConfirm 0 0
Total 4 4
HundredGigE0/0/0/3 Fwd Local Drop Def-Drop Def-Proc Total
Path 1 0 219 2 222
PathTear 0 0 31 0 31
ResvConfirm 0 0 0 0 0
Total 1 0 219 2 253
HundredGigE0/0/0/3 Fwd Local Drop Def-Drop Def-Proc Total
Path 0 0 0 1 1
PathTear 0 0 0 0 0
ResvConfirm 0 0 0 0 0
Total 0 0 0 1 1
ALL RSVP
Interfaces Fwd Local Drop Def-Drop Def-Proc Total
Path 4 1 0 219 3 227
PathTear 0 0 0 31 0 31
ResvConfirm 0 0 0 0 0 0
Total 4 1 0 250 3 258
The following is sample output from the show rsvp counters prefix-filtering interface type interface-path-idcommand:
RP/0/RP0/CPU0:router# show rsvp counters prefix-filtering interface HundredGigE 0/0/0/3
HundredGigE0/0/0/3 Fwd Local Drop Def-Drop Def-Proc Total
Path 1 0 219 2 222
PathTear 0 0 31 0 31
ResvConfirm 0 0 0 0 0
Total 1 0 250 2 253
The following is sample output from the show rsvp counters prefix-filtering interface summary command:
RP/0/RP0/CPU0:router# show rsvp counters prefix-filtering interface summary
ALL RSVP
Interfaces Fwd Local Drop Def-Drop Def-Proc Total
Path 4 1 0 219 3 227
PathTear 0 0 0 31 0 31
ResvConfirm 0 0 0 0 0 0
Total 4 1 0 250 3 258
The following is sample output from the show rsvp counters prefix-filtering access-list bankscommand:
RP/0/RP0/CPU0:router# show rsvp counters prefix-filtering access-list banks
ACL: banks Forward Local Drop Total
Path 0 0 0 0
PathTear 0 0 0 0
ResvConfirm 0 0 0 0
Total 0 0 0 0
Field |
Description |
||
---|---|---|---|
Fwd |
Number of messages forwarded to the next router.
|
||
Local |
Number of messages not forwarded (because they are locally destined). |
||
Drop |
Number of messages dropped. |
||
Def-Drop |
Number of messages dropped when an access control list match returns an implicit deny. (Results when RSVP is configured to drop implicit deny messages.) |
||
Def-Proc |
Number of messages processed by RSVP when an access control list match returns an implicit deny. |
||
Path |
Number of Path messages. |
||
PathTear |
Number of Path Tear messages. |
||
ResvConfirm |
Number of ResvConfirm messages. |
To display RSVP Fast-Reroute (FRR) information, use the show rsvp fast-reroute command in EXEC mode.
show rsvp fast-reroute [ destination IP -address ] [ dst-port port ] [ session-type { lsp-p2p } ] [ source IP-address ] [ src-port source-port ] [summary]
destination IP-address |
(Optional) Displays the entries that match the specified address. |
dst-port port |
(Optional) Displays the port address of the destination router. |
session-type |
(Optional) Displays the entries that match the specified session type. |
lsp-p2p |
Displays the entries that are used for P2P sessions. |
source IP-address |
(Optional) Displays the IP address of the source network. |
src-port source-port |
(Optional) Displays the port number of the source router. |
summary |
(Optional) Displays summarized information about the FRR database. |
None
EXEC
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
No specific guidelines impact the use of this command.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
This is sample output from the show rsvp fast-reroute command:
RP/0/RP0/CPU0:router# show rsvp fast-reroute
Type Destination TunID Source PSBs RSBs
-------- --------------- ----------- ------------ --------- -------
LSP4 10.10.10.10 1 10.20.20.20 Ready Ready
Field |
Description |
---|---|
Type |
Type of session. |
Destination |
Destination address of session. |
TunID |
Tunnel ID number. |
Source |
Source address of session. |
PSBs |
PSB FRR1 state. |
RSBs |
RSB FRR state. |
This is sample output from the show rsvp fast-reroute summary command:
RP/0/RP0/CPU0:router# show rsvp fast-reroute summary
States Total Ready Act-Wait Active
PSBs 1 1 0 0
RSBs 1 1 0 0
Field |
Description |
---|---|
States |
FRR2 state. |
Total |
Total number of path and reservation states. |
Ready |
Number of states in FRR ready state. No FRR processing has been done on these states. |
Act-Wait |
Number of states in “Active Wait” FRR state. |
Active |
Number of states in “Active” FRR state. |
To display the local graceful-restart information for RSVP, use the show rsvp graceful-restart command in XR EXEC mode.
show rsvp graceful-restart [neighbors] [IP-address] [detail]
neighbors |
(Optional) Displays single-line status for each neighbor. If this keyword is not specified, only a multiline table entry is displayed showing local graceful-restart information. |
IP-address |
(Optional) Address of the neighbor you are displaying. Displays a specific neighbor with that destination address only. If this keyword is not specified, all neighbors are displayed. |
detail |
(Optional) Displays multiline status for each neighbor. If this keyword is not specified, only a single-line table entry is displayed. |
No default behavior or values
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
Graceful-restart neighbors are displayed in ascending order of neighbor IP address.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following is sample output from the show rsvp graceful-restart command:
RP/0/RP0/CPU0:router# show rsvp graceful-restart
Graceful restart: enabled Number of global neighbors: 1
Local MPLS router id: 192.168.55.55
Restart time: 60 seconds Recovery time: 120 seconds
Recovery timer: Not running
Hello interval: 5000 milliseconds Maximum Hello miss-count: 4
Field |
Description |
---|---|
Graceful restart |
Indicates whether graceful restart is configured locally. |
Number of global neighbors |
Number of neighbors identified by a unique router ID. |
Local MPLS router id |
Local router ID used for the MPLS applications. |
Restart time |
Amount of time after a loss in hello messages within which RSVP hello session is reestablished. This setting is manually configurable. |
Recovery time |
Local recovery time advertised to neighbors. This is dynamically computed based on the number of LSPs established and is the time used by neighbors to refresh states in the event of a failure. |
Recovery timer |
Countdown timer which, upon expiry, causes un-refreshed data forwarding states to be deleted (usually beginning with a value that is equivalent to the sum of the restart and recovery times). |
Hello interval |
Interval at which hello messages are sent to neighbors. |
Maximum hello miss-count |
Number of hellos from a neighbor that can be missed before declaring hellos down. |
The following is sample output from the show rsvp graceful-restart neighbors command, which displays information about graceful restart neighbors in the router:
RP/0/RP0/CPU0:router# show rsvp graceful-restart neighbors
Neighbor App State Recovery Reason Since LostCnt
--------------- ----- ------ -------- ------------ -------------------- --------
192.168.77.77 MPLS UP DONE N/A 19/12/2016 17:02:25 0
Field |
Description |
---|---|
Neighbor |
Router ID of a global neighbor. |
App |
Application type of a global neighbor (MPLS ). |
State |
State of the hello session to a global neighbor (up, down, INIT). |
Recovery |
State at which the local node is recovering a global neighbor. |
Reason |
Last reason for which communication has been lost for a global neighbor. If none has occurred, this field is marked as N/A. |
Since |
Time at which the current hello state for a global neighbor has been established. |
LostCnt |
Number of times hello communication has been lost with a global neighbor. |
The following is sample output from the show rsvp graceful-restart neighbors detail command, which displays detailed information about all graceful restart neighbors:
RP/0/RP0/CPU0:router# show rsvp graceful-restart neighbors detail
Neighbor: 192.168.77.77 Source: 192.168.55.55 (MPLS)
Hello instance for application MPLS
Hello State: UP (for 00:20:52)
Number of times communications with neighbor lost: 0
Reason: N/A
Recovery State: DONE
Number of Interface neighbors: 1
address: 192.168.55.0
Restart time: 120 seconds Recovery time: 120 seconds
Restart timer: Not running
Recovery timer: Not running
Hello interval: 5000 milliseconds Maximum allowed missed Hello messages: 4
Field |
Description |
---|---|
Neighbor |
Router ID of a global neighbor. |
Source |
Local router ID and application type. |
Hello State |
State of the hello instance for the global neighbor (up, down, or init) and duration of the current state. |
Number of times communications with neighbor lost |
Number of times hello communication has been lost with a global neighbor. |
Reason |
Last reason indicating why communication was lost for a global neighbor. If none has occurred, this field is marked as N/A. |
Recovery State |
State at which the local node is recovering a global neighbor. |
Number of Interface neighbors |
Number of interfaces belonging to a global neighbor. |
Address |
IP address of the interface neighbor. |
Recovery timer |
Remote recovery time for a global neighbor. |
Hello interval |
Interval at which hello messages are sent by the remote global neighbor. |
Maximum allowed missed Hello messages |
Number of hellos that can be missed by the remote global neighbor before declaring hellos down. |
To display the RSVP hello instances, use the show rsvp hello instance command in XR EXEC mode.
show rsvp hello instance [ Hostname or IP-address ] [detail]
Hostname or IP-address |
(Optional) Address of the neighbor you are displaying. If this argument is not specified, all neighbors are displayed. |
detail |
(Optional) Displays multiline status for each hello instance. If this keyword is not specified, only a single-line table entry is displayed. |
No default behavior or values
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
Hello instances are displayed in ascending order of neighbor IP address.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following is sample output from the show rsvp hello instance command, which displays brief information about all hello instances in the router:
RP/0/RP0/CPU0:router# show rsvp hello instance
Neighbor Type State Interface LostCnt
---------------- ------ -------- ------------ --------
192.168.77.77 ACTIVE UP None 0
Field |
Description |
---|---|
Neighbor |
Router ID of a global neighbor hosting the hello instance. |
Type |
Hello instance type (active or passive). Active type indicates that a node is sending hello requests and passive indicates that a node is sending hello acknowledgements. |
State |
State of the hello session to a global neighbor (up, down, or init). |
Interface |
Interface for interface bound hello's used for FRR3. Hello instances bound to a global neighbor show Interface as None. Hellos used for FRR are currently not supported. |
LostCnt |
Number of times hello communication has been lost with a global neighbor. |
The following is sample output from the show rsvp hello instance command, which displays detailed information about all hello instances in the router:
RP/0/RP0/CPU0:router# show rsvp hello instance detail
Neighbor: 192.168.77.77 Source: 192.168.55.55 (MPLS)
State: UP (for 00:07:14)
Type: ACTIVE (sending requests)
I/F: None
Hello interval (msec) (used when ACTIVE)
Configured: 5000
Src_instance 0x484b01, Dst_instance 0x4d4247
Counters:
Communication with neighbor lost:
Num of times: 0 Reasons:
Missed acks: 0
New Src_Inst received: 0
New Dst_Inst received: 0
I/f went down: 0
Neighbor disabled Hello: 0
Msgs Received: 93
Sent: 92
Suppressed: 87
Field |
Description |
---|---|
Neighbor |
Router ID of a global neighbor. |
Source |
Local router ID and application type. |
State |
State of the hello instance for the global neighbor (up, down or init) and duration of the current state. |
Type |
Hello instance type (active or passive). Active type indicates that a node is sending hello requests and passive indicates that a node is sending hello acks. |
I/F |
Interface for interface bound hellos. Hello instances for Graceful restart show interface as None. |
To display the RSVP hello instances on a specific interface, use the show rsvp hello instance interface-based command in XR EXEC mode.
show rsvp hello instance interface-based [IP-address] [detail]
IP-address |
(Optional) Address of the neighboring interface. you are displaying. If this argument is not specified, all neighbors are displayed. |
detail |
(Optional) Displays detailed information for the specified interface. |
No default behavior or values
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
Hello instances are displayed in ascending order of neighbor IP address.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following is sample output from the show rsvp hello instance interface-based command, which displays detailed information about hello instances on a specific interface:
RP/0/RP0/CPU0:router# show rsvp hello instance interface-based 10.10.10.10
Neighbor Type State Interface LostCnt
---------------- ------ -------- ------------ --------
10.10.10.10 ACTIVE UP None 0
Field |
Description |
---|---|
Neighbor |
Router ID of a global neighbor hosting the hello instance. |
Type |
Hello instance type (active or passive). Active type indicates that a node is sending hello requests and passive indicates that a node is sending hello acknowledgements. |
State |
State of the hello session to a global neighbor (up, down, or init). |
Interface |
Interface for interface bound hellos used for FRR4. For hello instances bound to a global neighbor, interface will be displayed as none. |
LostCnt |
Number of times hello communication has been lost with a global neighbor. |
To display information about all interfaces with RSVP enabled, use the show rsvp interface command in System Admin EXEC mode.
show rsvp interface [ type interface-path-id ] [detail]
type |
(Optional) Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or a virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
||
detail |
(Optional) Displays multiline status for each interface. If this keyword is not specified, only a single-line table entry is displayed. |
No default behavior or values
Use the show rsvp interface command to display various configuration settings such as the list of neighbors and their refresh reduction capabilities.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following is sample output from the show rsvp interface command, which displays brief information about the RSVP-configured interfaces for the GigabitEthernet interface type:
RP/0/RP0/CPU0:router# show rsvp interface HundredGigE 0/0/0/3
Thu Oct 22 20:35:42.323 UTC
Interface MaxBW (bps) MaxFlow (bps) Allocated (bps) MaxSub (bps)
----------- ----------- ------------- -------------------- ------------
HundredGigE 0/0/0/3 750M 750M 0 ( 0%) 0
To display information about RSVP neighbors, use the show rsvp neighbor command in XR EXEC mode.
show rsvp neighbor [detail]
detail |
(Optional) Displays detailed information about RSVP neighbors. |
No default behavior or values
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
Use the show rsvp interface command to display various configuration settings such as the list of neighbors and their refresh reduction capabilities.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following is sample output from the show rsvp neighbor command using the detail keyword:
RP/0/RP0/CPU0:router# show rsvp neighbor detail
Global Neighbor: 10.10.10.10
Interface Neighbor: 1.1.1.1
Interface: HundredGigE0/0/0/3
Refresh Reduction: "Enabled" or "Disabled".
Remote epoch: 0xXXXXXXXX
Out of order messages: 0
Retransmitted messages: 0
Interface Neighbor: 2.2.2.2
Interface: HundredGigE0/0/0/3
Refresh Reduction: "Enabled" or "Disabled".
Remote epoch: 0xXXXXXXXX
Out of order messages: 0
Retransmitted messages: 0
To display all reservations that RSVP knows about on a router, use the show rsvp reservation command in XR EXEC mode.
show rsvp reservation [ destination IP address ] [detail] [ dst-port port-num ] [ session-type { lsp-p2p } ] [ source IP-address ] [ src-port port-num ]
detail |
(Optional) Displays multiline status for each reservation. If the detail keyword is not specified, only a single-line table entry is displayed. |
destination IP-address |
(Optional) Displays the entries that match the specified address. |
dst-port port-num |
(Optional) Displays destination port and tunnel ID information. |
session-type |
(Optional) Displays the entries that match the specified session type. |
lsp-p2p |
Displays the entries that are used for P2P sessions. |
source IP-address |
(Optional) Displays source address information. |
src-port port-num |
(Optional) Displays source port and LSP ID information. |
No default behavior or values
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
The show rsvp reservation command displays information about downstream reservations only (that is, reservations received on this device or created by application program interface (API) calls). Upstream reservations or requests are displayed using the show rsvp request command.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following is sample output from the show rsvp reservation command:
RP/0/RP0/CPU0:router# show rsvp reservation
Dest Addr DPort Source Addr SPort Pro Input IF Sty Serv Rate Burst
---------------- ----- ---------------- ----- --- ---------- --- ---- ---- -----
192.168.40.40 2001 192.168.67.68 2 0 None SE LOAD 0 1K
192.168.67.68 2000 10.40.40.40 15 0 HundredGigE 0/0/0/3 SE LOAD 0 1K
The following example displays detailed information about all reservations in the router:
RP/0/RP0/CPU0:router# show rsvp reservation detail
RESV: IPv4-LSP Session addr: 192.168.40.40. TunID: 2001. LSPId: 2.
Source addr: 192.168.67.68. ExtID: 192.168.67.68.
Input adjusted interface: None. Input physical interface: None.
Next hop: 0.0.0.0 (lih: 0x0).
Style: Shared-Explicit. Service: Controlled-Load.
Rate: 0 bits/sec. Burst: 1K bytes. Peak: 0 bits/sec.
MTU min: 40, max: 500 bytes.
Flags: Local Receiver.
State expires in 0.000 sec.
Policy: Accepted. Policy source(s): MPLS/TE.
Header info: RSVP TTL=255. IP TTL=255. Flags: 0x0. TOS=0xff.
Resource:
Labels: Local downstream: 3.
RESV: IPv4-LSP Session addr: 192.168.67.68. TunID: 2000. LSPId: 15.
Source addr: 192.168.40.40. ExtID: 10.10.40.40.
Input adjusted interface: HundredGigE 0/0/0/3. Input physical interface: HundredGigE 0/0/0/3.
Next hop: 10.66.67.68 (lih: 0x8DE00002).
Style: Shared-Explicit. Service: Controlled-Load.
Rate: 0 bits/sec. Burst: 1K bytes. Peak: 0 bits/sec.
MTU min: 0, max: 500 bytes.
Flags: None.
State expires in 361.184 sec.
Policy: Accepted. Policy source(s): MPLS/TE.
Header info: RSVP TTL=254. IP TTL=254. Flags: 0x1. TOS=0xff.
Resource:
Labels: Outgoing downstream: 3.
Field |
Description |
---|---|
Input adjusted interface |
Interface to reflect the path’s outgoing interface. |
Input physical interface |
Interface where the reservation was received. |
Next hop |
Address of the downstream node that sent the reservation to this node. |
Lih |
Logical interface handle sent in the hop object of path returned to us in the reservation to figure out what interface the path was sent on. |
Flags |
Indicates path state, including as Local Repair, Local Sender (LSP5 ingress node), and others. |
Policy |
Admission control status. |
Policy source |
Entity performing the admission control on the LSP. |
Header info |
RSVP header information as described in RFC 2205. |
To display all path states that RSVP knows about on this router, use the show rsvp sender command in XR EXEC mode mode.
show rsvp sender [ destination IP-address ] [detail] [ dst-port port-num ] [ session-type { lsp-p2p } ] [ source IP-address ] [ src-port port-num ]
detail |
(Optional) Displays multiline status for each path. If the detail keyword is not specified, only a single-line table entry is displayed. |
destination IP-address |
(Optional) Displays the entries that match the specified address. |
dst-port port-num |
(Optional) Displays destination port and tunnel ID information. |
session-type |
(Optional) Displays the entries that match the specified session type. |
lsp-p2p |
Displays the entries that are used for P2P sessions. |
source IP-address |
(Optional) Displays source address information. |
src-port port-num |
(Optional) Displays source port and LSP ID information. |
No default behavior or values
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
The show rsvp sender command displays information about path states.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following is sample output from the show rsvp sendercommand:
RP/0/RP0/CPU0:router# show rsvp sender
Dest Addr DPort Source Addr SPort Pro Input IF Rate Burst Prot
---------------- ----- ---------------- ----- --- ------------ ---- ----- ----
10.40.40.40 2001 10.66.67.68 2 0 HundredGigE0/0/0/3 0 1K Off
10.66.67.68 2000 10.40.40.40 15 0 None 0 1K Off
Field |
Description |
---|---|
DProt |
Destination port number and tunnel-id. |
Dest Address |
Destination and session address of LSP6. |
SPort |
Source port and LSP ID. |
Source Addr |
Address of the ingress node of the LSP. |
Input IF |
Interface on which the Path message was received. |
The following example displays detailed information about all paths in the system:
RP/0/RP0/CPU0:router# show rsvp sender detail
PATH: IPv4-LSP Session addr: 10.66.67.68. TunID: 1. LSPId: 25.
Source addr: 10.40.40.40. ExtID: 10.40.40.40.
Prot: Off. Backup tunnel: None.
Setup Priority: 7, Reservation Priority: 0
Rate: 0 bits/sec. Burst: 1K bytes. Peak: 0 bits/sec.
Min unit: 40 bytes, Max unit: 500 bytes
Flags: Bidirectional.
State expires in 370.154 sec.
Policy: Accepted. Policy source(s): Default.
Header info: RSVP TTL=254. IP TTL=254. Flags: 0x1. TOS=0xc0.
Input interface: HundredGigE 0/0/0/3. Previous hop: 10.40.40.40 (lih: 0x40600001).
Resource:
Labels: Outgoing upstream: 3.
Class-Type: None.
Explicit Route (Incoming):
Strict, 10.66.67.68(interface-path-id 5)
Strict, 10.66.67.68/32
Field |
Description |
---|---|
Prot |
LSP configured as a protected tunnel. |
Backup tunnel |
Name of the backup tunnel assigned to protect this LSP7. |
Flags |
Path state, including as local repair, local sender (LSP ingress node), and others. |
Policy |
Admission control status for Path message in the incoming direction. |
Policy source |
Entity doing the admission control, such as COPS or MPLS-TE8. |
Header info |
RSVP header information as described in RFC 2205. |
Input interface |
Interface on which the path was received. At ingress mode, it is None. |
Previous hop |
Address of the upstream peer who sent us the Path message. May be the interface address or node-id depending on LSP (packet or optical). |
Lih |
Logical interface handle received in the hop object of the path. |
Output interface |
Interface on which the path was forwarded to the downstream neighbor |
Policy |
Admission control status for the path in the outgoing direction. |
Explicit route |
Explicit route specified in the explicit-route object of the Path message. |
To list all sessions that RSVP knows about on this router, use the show rsvp session command in XR EXEC mode.
show rsvp session [ destination IP-address ] [detail] [ dst-port port-num ] [ session-type { lsp-p2p } ] [ tunnel-name tunnel-name ]
detail |
(Optional) Displays multiline status for each path. If the detail keyword is not specified, only a single-line table entry is displayed. |
destination IP-address |
(Optional) Displays the entries that match the specified address. |
dst-port port-num |
(Optional) Displays destination port and tunnel ID information. |
session-type |
(Optional) Displays the entries that match the specified session type. |
lsp-p2p |
Displays the entries that are used for P2P sessions. |
tunnel-name tunnel-name |
(Optional) Displays status for the session matching the specified tunnel-name. |
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
Sessions are displayed in ascending order of destination IP address, destination port, and source IP address.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following is sample output from the show rsvp session command:
RP/0/RP0/CPU0:router# show rsvp session
Type Session Addr Port Proto/ExtTunID PSBs RSBs Reqs
---- --------------- ----- --------------- ----- ----- -----
LSP4 10.40.40.40 2001 10.66.67.68 1 1 1
LSP4 10.66.67.68 2000 10.40.40.40 1 1 0
Field |
Description |
---|---|
Type |
Type of data flow (Traffic-Engineering LSP (LSP4 or IPV4 session). |
Session Addr |
Destination address of the data packets and also tail of the LSP. |
Port |
Destination port or tunnel ID in case of TE tunnels. |
Proto/ExtTunID |
Source address of TE tunnels or protocol as in the case of IPV4 sessions. |
PSBs |
Number of path state blocks for this session. |
RSBs |
Number of reservation state blocks pertaining to incoming or local reservations for this session. |
Reqs |
Number of requests. State data structure representing reservations sent up-stream. |
The following is sample output for the show rsvp session detail command:
RP/0/RP0/CPU0:router# show rsvp session detail
SESSION: IPv4-LSP Addr: 10.66.67.68, TunID: 1, ExtID: 10.40.40.40
PSBs: 1, RSBs: 1, Requests: 0
LSPId: 1
Tunnel Name: newhead_t1
RSVP Path Info:
InLabel: No intf, No label
Incoming Address: Unknown
Explicit Route:
Strict, 10.66.67.68(interface-path-id 5)
Strict, 10.66.67.68/32
Record Route: None
Tspec: avg rate=0, burst=1K, peak rate=0
RSVP Resv Info:
OutLabel: HundredGigE0/0/0/3, 5
FRR OutLabel: No intf, No label
Record Route:
Node-id 10.66.67.68, interface index 5
Fspec: avg rate=0, burst=1K, peak rate=0
Field |
Description |
---|---|
TunID |
Tunnel identifier and the destination port of the LSP9. |
ExtID |
Ingress node address of LSP. |
Tunnel Instance |
Source port of the LSP (with the ExtId forming the source parameters). |
Tunnel Name |
Name of the tunnel and LSP. |
InLabel |
Incoming interface and label info for the LSP in the upstream direction. At the egress node, using penultimate hop popping at the egress node, (implicit-null) appears as No Label. |
Incoming Address |
Address of the ingress interface. |
Explicit Route |
Explicit route specified in the explicit-route object of the Path message. |
Record Route |
Record route object in either the path or reservation message. |
Tspec |
Traffic parameters. |
OutLabel |
Outgoing interface and label sent downstream. |
FRR OutLabel |
For FRR10, displays the backup tunnel and Merge-point label. |
Fspec |
Flow spec parameters for specified QoS. |
To give all RSVP signaling packets sent out on a specific interface higher priority in the network by marking them with a particular Differentiated Service Code Point (DSCP), use the signalling dscp command in RSVP interface configuration submode. To return to the default behavior, use the no form of this command.
signalling dscp dscp
no signalling dscp
dscp |
DSCP priority number. Range is 0 to 63. |
No default behavior or values
RSVP interface configuration
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
DSCP marking improves signaling setup and teardown times.
Usually, when a router receives Path messages for a particular state marked with a DSCP value, it sends out Path messages for that state marked with the same DSCP value. This command overrides that DSCP persistence and ensures that all messages sent out a particular interface are marked with a specified DSCP.
Though this command controls RSVP signaling packets, it has no effect on ordinary IP or MPLS data packets traveling along the path created or reserved by this RSVP session.
DSCP persistence operates on a per-state basis, but this command operates on a per-interface basis. So, if some incoming message (for example, multicast Path) with DSCP 10 causes two outgoing messages on interfaces A and B, usually both are sent with DSCP 10. If signalling dscp 5 is configured for RSVP on interface A, the Path messages being sent out interface A is marked with DSCP 5, but the Path messages being sent out of interface B are marked with DSCP 10.
There is a difference between signalling dscp 0 and no signalling dscp commands. The first command instructs RSVP to explicitly set the DSCP value to 0 on all packets sent out of this interface. The second command removes any override on the packets being sent out of this interface, and allows the DSCP of received packets that created this state to persist on packets forwarded out of this interface.
The RFC specifies a standard mapping from the eight IP precedence values to eight values in the 64-value DSCP space. You can use those special DSCP values to specify IP precedence bits only.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to mark all RSVP packets going out on a HundredGigE interface with DSCP value 20.
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface HundredGigE 0/0/0/3 RP/0/RP0/CPU0:router(config-rsvp-if)# signalling dscp 20
The following example shows how to disable DSCP marking of signaling packets going out on a HundredGigE interface.
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface HundredGigE 0/0/0/3 RP/0/RP0/CPU0:router(config-rsvp-if)# no signalling dscp
To enable or disable RSVP signaling graceful restart, use the signalling graceful-restart command in RSVP configuration mode. To return to the default behavior, use the no form of this command.
signalling graceful-restart [ recovery-time time | restart-time time ]
no signalling graceful-restart
recovery-time |
(Optional) Configures the recovery time that is advertised in the Restart Cap object in the Hello messages. |
time |
Time, in seconds, for the neighbor to wait for the node to recover (replay) existing states after the Hello session is reestablished before initiating TEARs. Range is 0 to 3600. |
restart-time |
(Optional) Configures the restart time that is advertised in the Restart Cap object in hello messages. |
time |
Time, in seconds, after a control-plane restart that RSVP can start exchanging hello messages. Range is 60 to 3600. Default is 120. |
RSVP signaling graceful restart is disabled.
RSVP configuration
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
The signalling graceful-restart command provides a mechanism that helps minimize the negative effects on MPLS and Optical User Network Interface (O-UNI) traffic for the following types of faults. This is an implementation of the fault handling section of the IETF standard RFC 3473:
Disruption of communication channels between 2 nodes when the communication channels are separated from the data channels.
Control plane of a node fails, but the node preserves its data forwarding states.
The signalling graceful-restart command instigates the exchange of RSVP hello messages between the router and its neighbor nodes. After the hello messages are established with a given neighbor, RSVP can detect these types of faults when they occur.
If no hello messages are received from a neighbor within a certain number of hello intervals, a node assumes that communication with the neighbor has been lost. The node waits the amount of time advertised by the last restart time communicated by the neighbor, before invoking procedures for recovery from communication loss.
The configured restart time is important in case of recovery from failure. The configured value should accurately reflect the amount of time within which, after a control-plane restart, RSVP can start exchanging hello messages.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to enable RSVP signalling graceful restart:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp RP/0/RP0/CPU0:router(config-rsvp)# signalling graceful-restart
The following example shows how to set the restart time:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp RP/0/RP0/CPU0:router(config-rsvp)# signalling graceful-restart restart-time 200
The following example shows how to reset the restart time to the default of 120 seconds:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp RP/0/RP0/CPU0:router(config-rsvp)# no signalling graceful-restart restart-time
To enable RSVP to accept interface-based hello requests from the neighbor on an interface and send a Hello Acknowledgment to it, use the signalling hello graceful-restart interface-based command in RSVP configuration mode. To return to the default behavior, use the no form of this command.
signalling hello graceful-restart interface-based
no signalling hello graceful-restart interface-based
This command has no arguments or keywords.
No default behavior or values
RSVP interface configuration
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
No specific guidelines impact the use of this command.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to enable interface-based graceful restart:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface tunnel-te 66 RP/0/RP0/CPU0:router(config-rsvp-if)# signalling hello graceful-restart interface based
To configure the interval at which RSVP graceful-restart hello messages are sent to each neighbor, use the signalling hello graceful-restart refresh interval command in RSVP configuration mode. To return to the default behavior, use the no form of this command.
signalling hello graceful-restart refresh interval refresh-interval
no signalling hello graceful-restart refresh interval
refresh-interval |
Interval, in milliseconds, at which RSVP graceful-restart hello messages are sent to each neighbor. Range is 3000 to 30000. |
refresh interval: 5000
RSVP configuration
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
The signalling hello graceful-restart refresh interval command determines how often hello messages are sent to each neighbor. If the interval is made short, the hello messages are sent more frequently. Although a short interval may help detect failures quickly, it also results in increased network traffic. Optimizations in the RSVP hello mechanism exist to reduce the number of hello messages traveling over the network.
When an RSVP hello message is received, the receiving node acknowledges the hello and restarts its hello timer to the neighbor. By doing this, a hello is transmitted to the neighbor only if a hello is not received before the hello refresh interval has expired.
If two neighboring nodes do not have the same hello interval, the node with the larger hello interval has to acknowledge its neighbor’s (more frequent) hellos. For instance, if node A has a hello interval of 5 seconds, and node B has a hello interval of 10 seconds, node B still has to send hello messages every 5 seconds.
The hello backoff mechanism is an optimization that is tailored to minimize the number of hello messages from a neighbor that either does not have graceful restart enabled, or that fails to come back up during the restart interval. The restart interval is provided by the neighbor in the restart cap object.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example sets the hello graceful-restart refresh interval to 4000 msecs:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp RP/0/RP0/CPU0:router(config-rsvp)# signalling hello graceful-restart refresh interval 4000
To specify the extended access control list to use for prefix filtering of RSVP Router Alert messages, use the signalling prefix-filtering access-list command in RSVP configuration mode. To return to the default behavior, use the no form of this command.
signalling prefix-filtering access-list access list name
no signalling prefix-filtering access-list access list name
access list name |
Extended access-list name as a string (maximum 32 characters). |
No default behavior or values
RSVP configuration
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
The extended access control list containing the source and destination prefixes used for packet filtering is configured separately.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure the access control list name banks for prefix-filtering of RSVP Router Alert messages:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp RP/0/RP0/CPU0:router(config-rsvp)# signalling prefix-filtering access-list banks
The following example shows how to disable RSVP prefix-filtering of RSVP Router Alert messages:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp RP/0/RP0/CPU0:router(config-rsvp)# no signalling prefix-filtering access-list banks
To configure RSVP to drop RSVP Router Alert messages when an access control list match returns an implicit deny, use the signalling prefix-filtering default-deny-action command in RSVP configuration mode. To return to the default behavior, use the no form of this command.
signalling prefix-filtering default-deny-action drop
no signalling prefix-filtering default-deny-action drop
drop |
Specifies when RSVP router alert messages are dropped. |
Performs normal RSVP processing of Path, Path Tear, and ResvConfirm message packets.
RSVP configuration
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
No specific guidelines impact the use of this command.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure RSVP Router Alert messages when an access control list match returns an implicit deny:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp RP/0/RP0/CPU0:router(config-rsvp)# signalling prefix-filtering default-deny-action drop
To limit the rate of RSVP signaling messages being sent out a particular interface, use the signalling rate-limit command in RSVP interface configuration mode. To return to the default behavior, use the no form of this command.
signalling rate-limit [ rate messages ] [ interval interval-length ]
no signalling rate-limit [ rate messages ] [ interval interval-length ]
rate messages |
(Optional) Configures the number of messages sent per scheduling interval. Range is 1 to 500 messages. |
interval interval-length |
(Optional) Specifies the length, in milliseconds, between scheduling intervals. Range is 250 to 2000. |
messages: 100
interval-length: 1,000 (1 second)
RSVP interface configuration
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
Use the rate-limiting feature with caution. Limiting the rate of RSVP signaling has the advantage of avoiding an overload of the next hop router’s input queue, because such overloads would cause the next hop router to drop RSVP messages. However, reliable messaging and rapid retransmit usually enable the router to recover very rapidly from message drops; so rate limiting might not be necessary.
If the rate is set too low, it causes slower convergence times. This command limits all RSVP messages except acknowledgments (ACK) and SRefresh messages. The command does not let you make a router generate messages faster than its inherent limit. (That limit differs among router models.)
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to enable rate-limiting:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface HundredGigE 0/0/0/3 RP/0/RP0/CPU0:router(config-rsvp-if)# signalling rate-limit
The following example shows how to limit the rate to 50 messages per second:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface HundredGigE 0/0/0/3 RP/0/RP0/CPU0:router(config-rsvp-if)# signalling rate-limit rate 50
The following example shows how to set a limit at 40 messages for every 250 milliseconds:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface HundredGigE 0/0/0/3 RP/0/RP0/CPU0:router(config-rsvp-if)# signalling rate-limit rate 40 interval 250
The following example shows how to restore the rate to the default of 100 messages per second:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface HundredGigE 0/0/0/3 RP/0/RP0/CPU0:router(config-rsvp-if)# no signalling rate-limit rate
The following example shows how to disable rate-limiting:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface HundredGigE 0/0/0/3 RP/0/RP0/CPU0:router(config-rsvp-if)# no signalling rate-limit
To change the frequency with which a router updates the network about the RSVP state of a particular interface, use the signalling refresh interval command in RSVP interface configuration mode. To return to the default behavior, use the no form of this command.
signalling refresh interval seconds
no signalling refresh interval
seconds |
Number of seconds the router waits to update the network about the RSVP state of an interface, in seconds. Range is 10 to 180. Default is 45. |
seconds: 45
RSVP interface configuration
Release | Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
RSVP relies on a soft-state mechanism to maintain state consistency in the face of network losses. That mechanism is based on continuous refresh messages to keep a state current. Each RSVP router is responsible for sending periodic refresh messages to its neighbors.
The router attempts to randomize network traffic and reduce metronomic burstiness by jittering the actual interval between refreshes by as much as 50 percent. As a result, refreshes may not be sent at exactly the interval specified. However, the average rate of refreshes are within the specified refresh interval.
Lengthening the interval reduces the refresh load of RSVP on the network but causes downstream nodes to hold state longer. This reduces the responsiveness of the network to failure scenarios. Shortening the interval improves network responsiveness but expands the messaging load on the network.
The reliable messaging extension, implemented through the signalling refresh reduction reliable command, may cause new or changed messages to be temporarily refreshed at a more rapid rate than specified to improve network responsiveness.
The use of reliable messaging with rapid retransmit substantially improves network responsiveness in case of transient message loss; if the refresh interval is changed when using the reliable messaging feature, it is more useful to lengthen the interval than to shorten it.
The summary refresh extension, implemented through the signalling refresh reduction summary command, provides a lower-cost mechanism to refresh RSVP state. The router uses the same refresh interval between successive refreshes of a single state when using summary refresh and when using ordinary message-based refresh.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to specify a refresh interval of 30 seconds:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface tunnel-te 2 RP/0/RP0/CPU0:router(config-rsvp-if)# signalling refresh interval 30
The following example shows how to restore the refresh interval to the default value of 45 seconds:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface tunnel-te 2 RP/0/RP0/CPU0:router(config-rsvp-if)# no signalling refresh interval
To specify the number of successive refresh messages that can be missed before the RSVP deems a state to be expired (resulting in the state to be torn down), use the signalling refresh missed command in RSVP interface configuration mode. To return to the default behavior, use the no form of this command.
signalling refresh missed number
no signalling refresh missed
number |
Number of successive missed refresh messages. Range is 1 to 8. Default is 4. |
number: 4
RSVP interface configuration
Release |
Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
Decreasing the missed-message number improves RSVP responsiveness to major failures like router failure or link faults, but decreases the resilience of RSVP resulting in packet drops or temporary network congestion. The latter condition makes RSVP too sensitive.
Increasing the missed-message number increases the resilience of RSVP to such transient packet loss, but decreases the RSVP responsiveness to more intransient network failures such as router failure or link fault.
The default value of 4 provides a balance of resilience and responsiveness factors.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to specify a missed refresh limit of six (6) messages:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface tunnel-te 2 RP/0/RP0/CPU0:router(config-rsvp-if)# signalling refresh missed 6
The following example shows how to return the missed refresh limit to the default value of four (4):
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface tunnel-te 2 RP/0/RP0/CPU0:router(config-rsvp-if)# no signalling refresh missed
To specify the maximum number of RSVP authenticated messages that can be received out of sequence, use the window-size command in RSVP authentication configuration mode, RSVP interface authentication configuration mode, or RSVP neighbor authentication configuration mode. To disable the window size, use the no form of this command.
window-size N
no window-size
N |
Size of the window to restrict out-of-sequence messages. Range is 1 to 64. Default is 1. All out-of-sequence messages are dropped. |
N: 1
RSVP authentication configuration
RSVP interface authentication configuration
RSVP neighbor authentication configuration
Release |
Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
Use the window-size command to specify the maximum number of authenticated messages that are received out of sequence. All RSVP authenticated messages include a sequence number that is used to prevent replays of RSVP messages.
With a default window size of one message, RSVP rejects any out-of-order or out-of-sequence authenticated messages because they are assumed to be replay attacks. However, sometimes bursts of RSVP messages become reordered between RSVP neighbors. If this occurs on a regular basis, and you can verify that the node sending the burst of messages is trusted, you can use the window-size option to adjust the burst size such that RSVP does not discard such reordered bursts. RSVP checks for duplicate messages within these bursts.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to configure the size of the window to 33 in RSVP neighbor authentication configuration mode:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp neighbor 1.1.1.1 authentication RP/0/RP0/CPU0:router(config-rsvp-nbor-auth)# window-size 33
The following example shows how to configure the size of the window to 33 in RSVP authentication configuration mode:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp authentication RP/0/RP0/CPU0:router(config-rsvp-auth)# window-size 33
The following example shows how to configure the size of the window to 33 in RSVP interface authentication configuration mode by using the rsvp interface command:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface HundredGigE 0/0/0/3 RP/0/RP0/CPU0:router(config-rsvp-if)# authentication RP/0/RP0/CPU0:router(config-rsvp-if-auth)# window-size 33
To configure RSVP summary refresh message size on an interface, use the signalling refresh reduction summary command in RSVP interface configuration mode. To return to the default behavior, use the no form of this command.
signalling refresh reduction summary max-size bytes
no signalling refresh reduction summary max-size bytes
max-size bytes |
Specifies the maximum size, in bytes, of a single RSVP summary refresh message. Range is 20 to 65000. |
bytes: 4096
RSVP interface configuration
Release |
Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
Use the signalling refresh reduction summary command to specify the maximum size of the summary refresh messages sent. Message size is verified using the show rsvp interface detail command.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to change the summary message maximum size on an interface:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface tunnel-te 2 RP/0/RP0/CPU0:router(config-rsvp-if)# signalling refresh reduction summary max-size 6000
The following example shows how to return the summary message maximum size to the default value on an interface:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface tunnel-te 2 RP/0/RP0/CPU0:router(config-rsvp-if)# no signalling refresh reduction summary max-size 6000
To configure the parameters of reliable messaging, use the signalling refresh reduction reliable command in RSVP interface configuration mode. To return to the default behavior, use the no form of this command.
signalling refresh reduction reliable { ack-max-size bytes | ack-hold-time milliseconds | retransmit-time milliseconds | summary-refresh }
no signalling refresh reduction reliable { ack-max-size bytes | ack-hold-time milliseconds | retransmit-time milliseconds | summary-refresh }
ack-max-size |
Specifies the maximum size of the RSVP component within a single acknowledgment message. |
bytes |
Number of bytes that define the maximum size of an RSVP component. Range is 20 to 65000. |
ack-hold-time |
Specifies the maximum amount of time a router holds an acknowledgment before sending it, in an attempt to bundle several acknowledgments into a single acknowledgment message. |
milliseconds |
Number of milliseconds that define the acknowledgment hold time. Range is 100 to 5000. |
retransmit-time |
Specifies the amount of time the router initially waits for an acknowledgment message before resending the RSVP message. |
milliseconds |
Number of milliseconds that define the retransmit time. Range is 100 to 10000. |
summary-refresh |
Enables the use of reliable transmission for RSVP summary refresh messages. |
ack-max-size bytes: 4096
ack-hold-time milliseconds: 400 (0.4 seconds)
retransmit-time milliseconds: 900 (0.9 seconds)
RSVP interface configuration
Release |
Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
For reliable messaging to work properly, configure the retransmit time on the send router (A) and acknowledgment hold time on the peer router (B). (Vice versa for messages in reverse direction.)
The retransmit time must be greater than the acknowledgment hold time, so that the acknowledgment message has time to get back to the sender before the message retransmits. We recommend that the retransmit-time interval be at least twice the acknowledgment hold-time interval. If the retransmit-time value is smaller than the acknowledgment hold-time value, then router A retransmits the message even though router B may have received the message and is waiting for an acknowledgment hold time to time out to send the acknowledgment. This causes unnecessary network traffic.
Reducing the value of ack-max-size causes more acknowledgment messages to be issued, with fewer acknowledgments contained within each acknowledgment message. However, reducing the acknowledgment-max-size does not speed up the rate at which acknowledgment messages are issued because their frequency is still controlled by the time values (acknowledgment hold time and retransmit time).
To use reliable messaging for summary refresh messages, use the rsvp interface interface-name and signalling refresh reduction summary commands.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to set the maximum acknowledgment message size to 4096 bytes on a HundredGigE interface.
RP/0/RP0/CPU0:router(config)# rsvp interface HundredGigE 0/0/0/3 RP/0/RP0/CPU0:router(config-rsvp-if)# signalling refresh reduction reliable ack-max-size 4096
The following example shows how to return the maximum acknowledgment message size to the default of 1000 bytes on a HundredGigE interface.
RP/0/RP0/CPU0:router(config)# rsvp interface HundredGigE 0/0/0/3 RP/0/RP0/CPU0:router(config-rsvp-if)# no rsvp signalling refresh reduction reliable
The following example shows how to set the acknowledgment hold time to 1 second.
RP/0/RP0/CPU0:router(config)# rsvp interface HundredGigE 0/0/0/3 RP/0/RP0/CPU0:router(config-rsvp-if)# signalling refresh reduction reliable ack-hold-time 1000
The following example shows how to return the acknowledgment hold time to the default of 0.4 second.
RP/0/RP0/CPU0:router(config)# rsvp interface HundredGigE 0/0/0/3 RP/0/RP0/CPU0:router(config-rsvp-if)# no signalling refresh reduction reliable ack-hold-time
The following example shows how to set the retransmit timer to 2 seconds.
RP/0/RP0/CPU0:router(config)# rsvp interface HundredGigE 0/0/0/3 RP/0/RP0/CPU0:router(config-rsvp-if)# signalling refresh reduction reliable retransmit-time 2000
The following example shows how to return the retransmit timer to the default of 0.9 seconds.
RP/0/RP0/CPU0:router(config)# rsvp interface HundredGigE 0/0/0/3 RP/0/RP0/CPU0:router(config-rsvp-if)# no signalling refresh reduction reliable
The following example shows how to enable the use of reliable transmission for RSVP summary refresh messages.
RP/0/RP0/CPU0:router(config-rsvp-if)# signalling refresh reduction reliable summary-refresh
To disable RSVP refresh reduction on an interface, use the signalling refresh reduction disable command in RSVP interface configuration mode. To return to the default behavior, use the no form of this command.
signalling refresh reduction disable
no signalling refresh reduction disable
This command has no arguments or keywords.
No default behavior or values
RSVP interface configuration
Release |
Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
The following features of the IETF refresh reduction standard RFC 2961 are enabled with this command:
Because refresh reduction relies on cooperation of the neighbor, the neighbor must also support the standard. If the router detects that a neighbor is not supporting the refresh reduction standard (either through observing the refresh-reduction-enabled bit in messages received from the next hop, or by sending a Message-ID object to the next hop and receiving an error), refresh reduction is not used on this link. That information is obtained through use of the show rsvp interface detail command.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to disable RSVP refresh reduction on an interface:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface tunnel-te 2 RP/0/RP0/CPU0:router(config-rsvp-if)# signalling refresh reduction disable
The following example shows how to enable RSVP refresh reduction on the interface:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface tunnel-te 2 RP/0/RP0/CPU0:router(config-rsvp-if)# no signalling refresh reduction disable
To configure the maximum size of a single RSVP bundle message, use the signalling refresh reduction bundle-max-size command in RSVP interface configuration mode.
signalling refresh reduction bundle-max-size size
size |
Maximum size, in bytes, of a single RSVP bundle message. Range is 512 to 65000. |
size: 4096
RSVP interface configuration
Release |
Modification |
---|---|
Release 6.2.1 |
This command was introduced. |
No specific guidelines impact the use of this command.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
The following example shows how to set the maximum bundle size of a single RSVP bundle message to 4000:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# rsvp interface tunnel-te 2 RP/0/RP0/CPU0:router(config-rsvp-if)# signalling refresh reduction bundle-max-size 4000