Table Of Contents
ip nbar port-map
ip nbar protocol-discovery
ip rsvp atm-peak-rate-limit
ip rsvp bandwidth
ip rsvp burst policing
ip rsvp dsbm candidate
ip rsvp dsbm non-resv-send-limit
ip rsvp flow-assist
ip rsvp neighbor
ip rsvp policy cops minimal
ip rsvp policy cops report-all
ip rsvp policy cops servers
ip rsvp policy cops timeout
ip rsvp policy default-reject
ip rsvp pq-profile
ip rsvp precedence
ip rsvp reservation
ip nbar port-map
To configure Network-Based Application Recognition (NBAR) to search for a protocol or protocol name using a port number other than the well-known port, use the ip nbar port-map global configuration command. To look for the protocol name using only the well-known port number, use the no form of this command.
ip nbar port-map protocol-name [tcp | udp] port-number
no ip nbar port-map protocol-name [tcp | udp] port-number
Syntax Description
protocol-name
|
Name of protocol known to NBAR.
|
tcp
|
(Optional) Specifies that a TCP port will be searched for the specified protocol-name argument.
|
udp
|
(Optional) Specifies that a UDP port will be searched for the specified protocol-name argument.
|
port-number
|
Assigned port for named protocol. The port-number argument is either a UDP or a TCP port number, depending on which protocol is specified in this command line. Up to 16 port-number arguments can be specified in one command line. Port number values can range from 0 to 65535.
|
Defaults
This command has no default behavior or values.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.0(5)XE2
|
This command was introduced.
|
12.1(1)E
|
This command was integrated into Cisco IOS Release 12.1(1)E.
|
12.1(5)T
|
This command was integrated into Cisco IOS Release 12.1(5)T.
|
Usage Guidelines
This command is used in global configuration mode to tell NBAR to look for the protocol or protocol name, using a port number or numbers other than the well-known Internet Assigned Numbers Authority (IANA)-assigned) port number. For example, use this command to configure NBAR to look for Telnet on a port other than 23. Up to 16 ports can be specified with this command. Port number values can range from 0 to 65535.
Examples
The following example configures NBAR to look for the protocol SQL*NET on port numbers 63000 and 63001 instead of on the well-known port number:
ip nbar port-map sqlnet tcp 63000 63001
Related Commands
Command
|
Description
|
show ip nbar port-map
|
Displays the current protocol-to-port mappings in use by NBAR.
|
ip nbar protocol-discovery
To configure Networked-Based Application Recognition (NBAR) to discover traffic for all protocols known to NBAR on a particular interface, use the ip nbar protocol-discovery interface configuration command. To disable traffic discovery, use the no form of this command.
ip nbar protocol-discovery
no ip nbar protocol-discovery
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default behavior or values.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.0(5)XE2
|
This command was introduced.
|
12.1(1)E
|
This command was integrated into Cisco IOS Release 12.1(1)E.
|
12.1(5)T
|
This command was integrated into Cisco IOS Release 12.1(5)T.
|
Usage Guidelines
Use the ip nbar protocol-discovery command to configure NBAR to keep traffic statistics for all protocols known to NBAR. Protocol discovery provides an easy way to discover application protocols transiting an interface so that QoS policies can be developed and applied. The Protocol Discovery feature discovers any protocol traffic supported by NBAR. Protocol discovery can be used to monitor both input and output traffic and may be applied with or without a service policy enabled.
Examples
The following example configures protocol discovery on an Ethernet interface:
ip nbar protocol-discovery
Related Commands
Command
|
Description
|
show ip nbar protocol-discovery
|
Displays the statistics gathered by the NBAR Protocol Discovery feature.
|
ip rsvp atm-peak-rate-limit
To set a limit on the peak cell rate (PCR) of reservations for all newly created Resource Reservation Protocol (RSVP) switched virtual circuits (SVCs) established on the current interface or any of its subinterfaces, use the ip rsvp atm-peak-rate-limit interface configuration command. To remove the current peak rate limit, in which case the reservation peak rate is limited by the line rate, use the no form of this command.
ip rsvp atm-peak-rate-limit limit
no ip rsvp atm-peak-rate-limit
Syntax Description
limit
|
The peak rate limit of the reservation specified, in KB. The minimum value allowed is 1 KB; the maximum value allowed is 2 GB.
|
Defaults
The peak rate of a reservation defaults to the line rate.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.0(3)T
|
This command was introduced.
|
Usage Guidelines
Each RSVP reservation corresponds to an ATM SVC with a certain PCR, sustainable cell rate (SCR), and maximum burst size. The PCR, also referred to as the peak rate, can be configured by the user or allowed to default to the line rate.
RSVP controlled-load reservations do not define any peak rate for the data. By convention, the allowable peak rate in such reservations is taken to be infinity, which is usually represented by a very large number. Under these circumstances, when a controlled-load reservation is converted to an ATM SVC, the PCR for the SVC becomes correspondingly large and may be out of range for the switch. You can use the ip rsvp atm-peak-rate-limit command to limit the peak rate.
The following conditions determine the peak rate limit on the RSVP SVC:
•
The peak rate defaults to the line rate.
•
If the peak rate is greater than the configured peak rate limiter, the peak rate is lowered to the peak rate limiter.
•
The peak rate cannot be less than the reservation bandwidth. If this is the case, the peak rate is raised to the reservation bandwidth.
Note
Bandwidth conversions applied to the ATM space from the RSVP space are also applied to the peak rate.
The peak rate limit is local to the router; it does not affect the normal messaging of RSVP. Only the SVC setup is affected. Large peak rates are sent to the next host without modification.
For RSVP SVCs established on subinterfaces, the peak rate limit applied to the subinterface takes effect on all SVCs created on that subinterface. If a peak rate limit is applied to the main interface, the rate limit has no effect on SVCs created on a subinterface of the main interface even if the limit value on the main interface is lower than the limit applied to the subinterface.
For a given interface or subinterface, a peak rate limit applied to that interface affects only new SVCs created on the interface, not existing SVCs.
Note
This command is available only on interfaces that support the ip rsvp svc-required command.
Use the show ip rsvp atm-peak-rate-limit command to determine the peak rate limit set for an interface or subinterface, if one is configured.
Examples
The following example sets the peak rate limit for interface atm2/0/0.1 to 100 KB:
ip rsvp atm-peak-rate-limit 100
Related Commands
Command
|
Description
|
ip rsvp svc-required
|
Enables creation of an SVC to service any new RSVP reservation made on the interface or subinterface.
|
show ip rsvp atm-peak- rate-limit
|
Displays the current peak rate limit set for an interface.
|
show ip rsvp interface
|
Displays RSVP-related interface information.
|
ip rsvp bandwidth
To enable Resource Reservation Protocol (RSVP) for IP on an interface, use the ip rsvp bandwidth interface configuration command. To disable RSVP, use the no form of this command.
ip rsvp bandwidth [interface-kbps [single-flow-kbps]]
no ip rsvp bandwidth [interface-kbps [single-flow-kbps]]
Syntax Description
interface-kbps
|
(Optional) Maximum amount of bandwidth, in kbps, that may be allocated by RSVP flows. The range is from 1 to 10,000,000.
|
single-flow-kbps
|
(Optional) Maximum amount of bandwidth, in kbps, that may be allocated to a single flow. The range is from 1 to 10,000,000.
|
Defaults
RSVP is disabled by default. If the ip rsvp bandwidth command is entered but no bandwidth values are supplied (for example, ip rsvp bandwidth is entered followed by a carriage return, or pressing the Return or Enter key), a default bandwidth value is assumed for both the interface-kbps and single-flow-kbps arguments.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
Usage Guidelines
RSVP cannot be configured with VIP-distributed Cisco Express Forwarding (dCEF).
RSVP is disabled by default to allow backward compatibility with systems that do not implement RSVP. Weighted Random Early Detection (WRED) or fair queueing must be enabled first.
Examples
The following example shows a T1 (1536 kbps) link configured to permit RSVP reservation of up to 1158 kbps, but no more than 100 kbps for any given flow on serial interface 0. Fair queueing is configured with 15 reservable queues to support those reserved flows, should they be required.
ip rsvp bandwidth 1158 100
Related Commands
Command
|
Description
|
fair-queue (WFQ)
|
Enables WFQ for an interface.
|
ip rsvp neighbor
|
Enables neighbors to request a reservation.
|
ip rsvp reservation
|
Enables a router to simulate receiving and forwarding RSVP RESV messages.
|
ip rsvp sender
|
Enables a router to simulate receiving and forwarding RSVP PATH messages.
|
ip rsvp udp-multicasts
|
Instructs the router to generate UDP-encapsulated RSVP multicasts whenever it generates an IP-encapsulated multicast packet.
|
random-detect (interface)
|
Enables WRED or DWRED.
|
show ip rsvp installed
|
Displays RSVP-related installed filters and corresponding bandwidth information.
|
show ip rsvp interface
|
Displays RSVP-related interface information.
|
show ip rsvp neighbor
|
Displays current RSVP neighbors.
|
show ip rsvp reservation
|
Displays RSVP-related receiver information currently in the database.
|
show ip rsvp sender
|
Displays RSVP PATH-related sender information currently in the database.
|
ip rsvp burst policing
To configure a burst factor within the Resource Reservation Protocol (RSVP) token bucket policer on a per-interface basis, use the ip rsvp burst policing interface configuration command. To return to the default value, enter the no form of this command.
ip rsvp burst policing [factor]
no ip rsvp burst policing
Syntax Description
factor
|
(Optional) Indicates a burst factor value as a percentage of the requested burst of the receiver.
|
Defaults
The default value is 200; the minimum value is 100, and the maximum value is 700.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.1(3)T
|
This command was introduced.
|
Usage Guidelines
You configure the burst police factor per interface, not per flow. The burst factor controls how strictly or loosely the traffic of the sender is policed with respect to burst.
The burst factor applies to all RSVP flows installed on a specific interface. You can configure each interface independently for burst policing.
Examples
Here is an example of the ip rsvp burst policing command with a burst factor of 200:
ip rsvp burst policing 200
ip rsvp dsbm candidate
To configure an interface as a Designated Subnetwork Bandwidth Manager (DSBM) candidate, use the ip rsvp dsbm candidate interface configuration command. To disable DSBM on an interface, which exempts the interface as a DSBM candidate, use the no form of this command.
ip rsvp dsbm candidate [priority]
no ip rsvp dsbm candidate
Syntax Description
priority
|
(Optional) A value in the range from 64 to 128. Among contenders for the DSBM, the interface with the highest priority number wins the DSBM election process.
|
Defaults
An interface is not configured as a DSBM contender by default. If you use this command to enable the interface as a DSBM candidate and you do not specify a priority, the default priority of 64 is assumed.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.0(5)T
|
This command was introduced.
|
12.1(1)T
|
This command was integrated into Cisco IOS Release 12.1(1)T.
|
Usage Guidelines
SBM protocol entities, any one of which can manage resources on a segment, can reside in Layer 2 or Layer 3 devices. Many SBM-capable devices may be attached to a shared Layer 2 segment. When more than one SBM exists on a given segment, one of the SBMs is elected to be the DSBM. The elected DSBM is responsible for exercising admission control over requests for resource reservations on a segment, which, in the process, becomes a managed segment. A managed segment includes those interconnected parts of a shared LAN that are not separated by DSBMs. In all circumstances, only one, if any, DSBM exists for each Layer 2 segment.
You can configure an interface to have a DSBM priority in the range from 64 to 128. You can exempt an interface from participation in the DSBM election on a segment but still allow the system to interact with the DSBM if a DSBM is present on the segment. In other words, you can allow a Resource Reservation Protocol (RSVP)-enabled interface on a router connected to a managed segment to be managed by the DSBM even if you do not configure that interface to participate as a candidate in the DSBM election process. To exempt an interface from DSBM candidacy, do not issue the ip rsvp dsbm candidate command on that interface.
RSVP cannot be configured with VIP-distributed Cisco Express Forwarding (dCEF).
Examples
The following example configures Ethernet interface 2 as a DSBM candidate with a priority of 100:
ip rsvp dsbm candidate 100
Related Commands
Command
|
Description
|
debug ip rsvp
|
Displays information about SBM message processing, the DSBM election process, and standard RSVP enabled message processing information
|
debug ip rsvp detail
|
Displays detailed information about RSVP and SBM.
|
debug ip rsvp detail sbm
|
Display detailed information about SBM messages only, and SBM and DSBM state transitions
|
ip rsvp dsbm non-resv-send-limit
|
Configures the NonResvSendLimit object parameters.
|
show ip rsvp sbm
|
Displays information about an SBM configured for a specific RSVP-enabled interface or for all RSVP-enabled interfaces on the router.
|
ip rsvp dsbm non-resv-send-limit
To configure the NonResvSendLimit object parameters, use the ip rsvp dsbm non-resv-send-limit interface configuration command. To use the default NonResvSendLimit object parameters, use the no form of this command.
ip rsvp dsbm non-resv-send-limit {rate kbps | burst kilobytes | peak kbps | min-unit bytes |
max-unit bytes}
no ip rsvp dsbm non-resv-send-limit {rate kbps | burst kilobytes | peak kbps | min-unit bytes |
max-unit bytes}
Syntax Description
rate kbps
|
The average rate, in kBps, for the Designated Subnetwork Bandwidth Manager (DSBM) candidate.
|
burst kilobytes
|
The maximum burst size, in KB, for the DSBM candidate.
|
peak kbps
|
The peak rate, in kBps, for the DSBM candidate.
|
min-unit bytes
|
The minimum policed unit, in bytes, for the DSBM candidate.
|
max-unit bytes
|
The maximum packet size, in bytes, for the DSBM candidate.
|
Defaults
The default for the rate, burst, peak, min-unit, and max-unit keywords is unlimited; all traffic can be sent without a valid Resource Reservation Protocol (RSVP) reservation.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.1(1)
|
This command was introduced.
|
Usage Guidelines
To configure the per-flow limit on the amount of traffic that can be sent without a valid RSVP reservation, configure the rate, burst, peak, min-unit, and max-unit values for finite values greater than 0.
To allow all traffic to be sent without a valid RSVP reservation, configure the rate, burst, peak, min-unit, and max-unit values for unlimited traffic. To configure the parameters for unlimited traffic, you can either omit the command, or enter the no form of the command (for example, no ip rsvp dsbm non-resv-send-limit rate). Unlimited is the default value.
The absence of the NonResvSendLimit object allows any amount of traffic to be sent without a valid RSVP reservation.
RSVP cannot be configured with VIP-distributed Cisco Express Forwarding (dCEF).
Examples
The following example configures Ethernet interface 2 as a DSBM candidate with a priority of 100, an average rate of 500 kBps, a maximum burst size of 1000 KB, a peak rate of 500 kBps, and unlimited minimum and maximum packet sizes:
ip rsvp dsbm candidate 100
ip rsvp dsbm non-resv-send-limit rate 500
ip rsvp dsbm non-resv-send-limit burst 1000
ip rsvp dsbm non-resv-send-limit peak 500
Related Commands
Command
|
Description
|
ip rsvp dsbm candidate
|
Configures an interface as a DSBM candidate.
|
show ip rsvp sbm
|
Displays information about an SBM configured for a specific RSVP-enabled interface or for all RSVP-enabled interfaces on the router.
|
ip rsvp flow-assist
To enable Resource Reservation Protocol (RSVP) to attach itself to NetFlow so that it can leverage NetFlow services to obtain flow classification information about packets in order to update its token bucket and set IP Precedence as required, use the ip rsvp flow-assist interface configuration command. To detach RSVP from NetFlow, use the no form of this command.
ip rsvp flow-assist
no ip rsvp flow-assist
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default behavior or values. (RSVP does not use NetFlow as a packet filtering mechanism.)
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.0(3)T
|
This command was introduced.
|
Usage Guidelines
For RSVP to maintain token buckets and set IP Precedence on packets traversing the flow, it must interact with the underlying packet forwarding mechanism in order to obtain the information it needs. RSVP uses NetFlow for this purpose.
If RSVP is used on non-ATM links and RSVP must set IP Precedence without relying on traffic policing, weighted fair queueing (WFQ) cannot be used. In this case, a method of attaching RSVP to the underlying forwarding mechanism is required. The ip rsvp flow-assist command satisfies this requirement. It allows RSVP to attach itself to NetFlow so that it can use NetFlow to obtain information about packets, which it can then use to update its token bucket and set IP Precedence. NetFlow does not police packets or flows. For this reason, when RSVP is configured in this mode, it can only set IP Precedence and not otherwise police traffic.
In summary, you should use this command only when all of the following conditions exist:
•
You want to set IP Precedence and type of service (ToS) bits using the ip rsvp precedence command or the ip rsvp tos command.
•
You are not running WFQ on the interface.
•
You are not running ATM or you have not specified the ip rsvp svc-required command.
When all of these conditions prevail, RSVP is completely detached from the data flow path and, thus, has no way to detect packets. Use of this command enables RSVP to detect packets so that it can mark them.
RSVP cannot be configured with VIP-distributed Cisco Express Forwarding (dCEF).
Use the show ip rsvp interface command to determine whether this command is in effect for an interface or subinterface.
Examples
The following example enables RSVP on the ATM interface 2/0/0 to attach itself to NetFlow:
Related Commands
Command
|
Description
|
ip rsvp precedence
|
Allows you to set the IP Precedence values to be applied to packets that either conform to or exceed the RSVP flowspec.
|
ip rsvp tos
|
Allows you to set the ToS values to be applied to packets that either conform to or exceed the RSVP flowspec.
|
ip rsvp svc-required
|
Enables creation of an SVC to service any new RSVP reservation made on the interface or subinterface.
|
show ip rsvp interface
|
Displays RSVP-related interface information.
|
ip rsvp neighbor
To enable neighbors to request a reservation, use the ip rsvp neighbor interface configuration command. To disable this feature, use the no form of this command.
ip rsvp neighbor access-list-number
no ip rsvp neighbor access-list-number
Syntax Description
access-list-number
|
Number of a standard or extended access list. It can be any number in the range from 1 to 199.
|
Defaults
The router accepts messages from any neighbor.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
Usage Guidelines
Use this command to allow only specific Resource Reservation Protocol (RSVP) neighbors to make a reservation. If no limits are specified, any neighbor can request a reservation. If an access list is specified, only neighbors meeting the specified access list requirements can make a reservation.
RSVP cannot be configured with VIP-distributed Cisco Express Forwarding (dCEF).
Examples
The following example allows neighbors meeting access list 1 requirements to request a reservation:
Related Commands
Command
|
Description
|
fair-queue (WFQ)
|
Enables WFQ for an interface.
|
ip rsvp bandwidth
|
Enables RSVP for IP on an interface.
|
ip rsvp reservation
|
Enables a router to simulate receiving and forwarding RSVP RESV messages.
|
ip rsvp sender
|
Enables a router to simulate receiving and forwarding RSVP PATH messages.
|
ip rsvp udp-multicasts
|
Instructs the router to generate UDP-encapsulated RSVP multicasts whenever it generates an IP-encapsulated multicast packet.
|
random-detect (interface)
|
Enables WRED or DWRED.
|
show ip rsvp installed
|
Displays RSVP-related installed filters and corresponding bandwidth information.
|
show ip rsvp interface
|
Displays RSVP-related interface information.
|
show ip rsvp neighbor
|
Displays current RSVP neighbors.
|
show ip rsvp reservation
|
Displays RSVP-related receiver information currently in the database.
|
show ip rsvp sender
|
Displays RSVP PATH-related sender information currently in the database.
|
ip rsvp policy cops minimal
To lower the load of the COPS server and to improve latency times for messages on the governed router, use the ip rsvp policy cops minimal global configuration command to restrict the COPS RSVP policy to adjudicate only PATH and RESV messages. To turn off the restriction, use the no form of this command.
ip rsvp policy cops minimal
no ip rsvp policy cops minimal
Syntax Description
This command has no arguments or keywords.
Defaults
The default state is OFF, causing all adjudicable RSVP messages to be processed by the configured COPS policy.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.1(1)T
|
This command was introduced.
|
Usage Guidelines
When this command is used, COPS does not attempt to adjudicate PATHERROR and RESVERROR messages. Instead, those messages are all accepted and forwarded.
Examples
In the following example, COPS authentication is restricted to PATH and RESV messages:
ip rsvp policy cops minimal
In the following example, that restriction is removed:
no ip rsvp policy cops minimal
ip rsvp policy cops report-all
To enable a router to report on its success and failure with outsourcing decisions, use the ip rsvp policy cops report-all global configuration command. To return the router to its default, use the no form of this command.
ip rsvp policy cops report-all
no ip rsvp policy cops report-all
Syntax Description
This command has no arguments or keywords.
Defaults
The default state of this command is to send reports to the PDP about configuration decisions only.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.1(1)T
|
This command was introduced.
|
Usage Guidelines
In the default state, the router reports to the Policy Decision Point (PDP) when the router has succeeded or failed to implement Resource Reservation Protocol (RSVP) configuration decisions.
A configuration decision contains at least one of the following:
•
A RESV ALLOC context (with or without additional contexts)
•
A stateless or named decision object
A decision that does not contain at least one of those elements is an outsourcing decision.
Some brands of policy server might expect reports about RSVP messaging, which the default state of the Cisco Common Open Policy Service (COPS) for RSVP does not issue. In such cases, use the ip rsvp policy cops report-all command to ensure interoperability between the router and the policy server. Doing so does not adversely affect policy processing on the router.
Unicast FF reservation requests always stimulate a report from the router to the PDP, because those requests contain a RESV ALLOC context (combined with an IN CONTEXT and an OUT CONTEXT).
Examples
In order to show the Policy Enforcement Point (PEP)-to-PDP reporting process, the debug cops command in the following example already is enabled when a new PATH message arrives at the router:
router-1(config)# ip rsvp policy cops report-all
router-1(config)# 00:02:48:COPS:** SENDING MESSAGE **
Contents of router's request to PDP:
COPS HEADER:Version 1, Flags 0, Opcode 1 (REQ), Client-type:1, Length:216
HANDLE (1/1) object. Length:8. 00 00 02 01
CONTEXT (2/1) object. Length:8. R-type:5. M-type:1
IN_IF (3/1) object. Length:12. Address:10.1.2.1. If_index:4
OUT_IF (4/1) object. Length:12. Address:10.33.0.1. If_index:3
CLIENT SI (9/1) object. Length:168. CSI data:
[A 27-line Path message omitted here]
00:02:48:COPS:Sent 216 bytes on socket,
00:02:48:COPS:Message event!
00:02:48:COPS:State of TCP is 4
00:02:48:In read function
00:02:48:COPS:Read block of 96 bytes, num=104 (len=104)
00:02:48:COPS:** RECEIVED MESSAGE **
Contents of PDP's decision received by router:
COPS HEADER:Version 1, Flags 1, Opcode 2 (DEC), Client-type:1, Length:104
HANDLE (1/1) object. Length:8. 00 00 02 01
CONTEXT (2/1) object. Length:8. R-type:1. M-type:1
DECISION (6/1) object. Length:8. COMMAND cmd:1, flags:0
DECISION (6/3) object. Length:56. REPLACEMENT
[A 52-byte replacement object omitted here]
CONTEXT (2/1) object. Length:8. R-type:4. M-type:1
DECISION (6/1) object. Length:8. COMMAND cmd:1, flags:0
00:02:48:Notifying client (callback code 2)
00:02:48:COPS:** SENDING MESSAGE **
Contents of router's report to PDP:
COPS HEADER:Version 1, Flags 1, Opcode 3 (RPT), Client-type:1, Length:24
HANDLE (1/1) object. Length:8. 00 00 02 01
REPORT (12/1) object. Length:8. REPORT type COMMIT (1)
00:02:48:COPS:Sent 24 bytes on socket,
ip rsvp policy cops servers
To specify that Resource Reservation Protocol (RSVP) should use Common Open Policy Service (COPS) policy for remote adjudication, use the ip rsvp policy cops servers global configuration command. To turn off the use of COPS for RSVP, use the no form of this command.
ip rsvp policy cops [acl] servers server-ip [server-ip]
no ip rsvp policy cops [acl] servers
Syntax Description
acl
|
(Optional) Specifies the access control list (ACL) whose sessions will be governed by the COPS policy.
|
server-ip
|
Specifies the IP addresses of the servers governing the COPS policy. As many as eight servers can be specified, with the first being treated as the primary server.
|
Defaults
If no ACL is specified, the default behavior is for all reservations to be governed by the specified policy servers.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.1(1)T
|
This command was introduced.
|
Usage Guidelines
If more than one server is specified, the first server is treated by RSVP as the primary serer, and functions as such for all ACLs specified.
All servers in the list must have the same policy configuration.
If the connection of the router to the server breaks, the router tries to reconnect to that same server. If the reconnection attempt fails, the router then obeys the following algorithm:
If the connection to the Policy Decision Point (PDP) is closed (either because the PDP closed the connection, a TCP/IP error occurred, or the keepalives failed), the Policy Enforcement Point (PEP) issues a CLIENT-CLOSE message and then attempts to reconnect to the same PDP. If the PEP receives a CLIENT-CLOSE message containing a PDP redirect address, the PEP attempts to connect to the redirected PDP. Note the following points:
•
If either attempt fails, the PEP attempts to connect to the PDPs previously specified in the ip rsvp policy cops servers configuration command, obeying the sequence of servers given in that command, always starting with the first server in that list.
•
If the PEP reaches the end of the list of servers without connecting, it waits a certain time (called the reconnect delay) before trying again to connect to the first server in the list. This reconnect delay is initially 30 seconds, and doubles each time the PEP reaches the end of the list without having connected, until the reconnect delay becomes its maximum of 30 minutes. As soon as a connection is made, the delay is reset to 30 seconds.
The no form of this command need not contain any server IP addresses, but it must contain all the previously specified access lists (see the last example in the following section).
Examples
This first example applies the COPS policy residing on server 172.27.224.117 to all reservations passing through router-9. It also identifies the backup COPS server for this router as the one at address 172.27.229.130:
router-9(config)# ip rsvp policy cops servers 172.27.224.117 172.27.229.130
The next example applies the COPS policy residing on server 172.27.224.117 to reservations passing through router-9 only if they match access lists 40 and 160. Other reservations passing through that router will not be governed by this server. The command statement also identifies the backup COPS server for that router to be the one at address 172.27.229.130:
router-9(config)# ip rsvp policy cops 40 160 servers 172.27.224.117 172.27.229.130
The following example turns off COPS for the previously specified access lists 40 and 160 (you cannot turn off just one of the previously specified lists):
router-9(config)# no ip rsvp policy cops 40 160 servers
ip rsvp policy cops timeout
To configure the amount of time the Policy Enforcement Point (PEP) router will retain policy information after losing connection with the Common Open Policy Service (COPS) server, use the ip rsvp policy cops timeout global configuration command. To restore the router to the default value (5 minutes), use the no form of this command.
ip rsvp policy cops timeout policy-timeout
no ip rsvp policy cops timeout
Syntax Description
policy-timeout
|
Duration of timeout, from 1 to 10,000 seconds.
|
Defaults
Timeout default is 300 seconds (5 minutes).
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.1(1)T
|
This command was introduced.
|
Examples
The following example configures the router to time out all policy information relating to a lost server in 10 minutes:
ip rsvp policy cops timeout 600
The following example resets the timeout to the default value:
no ip rsvp policy cops timeout
ip rsvp policy default-reject
To reject all messages that do not match the policy access control lists (ACLs), use the ip rsvp policy default-reject global configuration command. To restore the default behavior, which passes along all messages that do not match the ACLs, use the no form of this command.
ip rsvp policy default-reject
no ip rsvp policy default-reject
Syntax Description
This command has no arguments or keywords.
Defaults
Without this command, the default behavior of Resource Reservation Protocol (RSVP) is to accept, install, or forward all unmatched RSVP messages. Once this command is invoked, all unmatched RSVP messages are rejected.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.1(1)T
|
This command was introduced.
|
Usage Guidelines
If COPS is configured without an ACL, or if any policy ACL is configured to use the permit ip any any command, the behavior of that ACL will take precedence, and no session will go unmatched.
Note
This command makes one exception to its blocking of unmatched messages. It forwards RESVERROR and PATHERROR messages that were generated by its own rejection of RESV and PATH messages. That is done to ensure that the default-reject operation does not remain totally hidden from network managers.
Caution 
Be extremely careful with this command. It will shut down all RSVP processing on the router if access lists are too narrow or if no Common Open Policy Service (COPS) server has been specified. (Use the
ip rsvp policy cops servers command to specify a COPS server.)
Examples
The following example configures RSVP to reject all unmatched reservations:
ip rsvp policy default-reject
The following example configures RSVP to accept all unmatched reservations:
no ip rsvp policy default-reject
ip rsvp pq-profile
To specify the criteria for Resource Reservation Protocol (RSVP) to use to determine which flows to direct into the priority queue (PQ) within weighted fair queueing (WFQ), use the ip rsvp pq-profile global configuration command. To disable the specified criteria, use the no form of this command.
ip rsvp pq-profile [voice-like | r' [b'[p-to-r' | ignore-peak-value]]
no ip rsvp pq-profile
Syntax Description
voice-like
|
(Optional) Indicates pq-profile parameters sufficient for most voice flows. The default values for r', b', and p-to-r' are used. These values should cause all voice flows generated from Cisco IOS applications and most voice flows from other RSVP applications, such as Microsoft NetMeeting, to be directed into the PQ.
|
r'
|
(Optional) Indicates maximum rate of a flow in bytes per second. Valid range is from 1 to 1048576 bytes per second.
|
b'
|
(Optional) Indicates maximum burst of a flow in bytes. Valid range is from 1 to 8192 bytes.
|
p-to-r'
|
(Optional) Indicates maximum ratio of peak rate to average rate as a percentage. Valid range is from 100 to 4000 percent.
|
ignore-peak-value
|
(Optional) Indicates that the peak rate to average rate ratio of the flow is not evaluated when RSVP identifies flows.
|
Defaults
The default value for r' is 12288 bytes per second.
The default value for b' is 592 bytes.
The default value for p-to-r' is 110 percent.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.1(3)T
|
This command was introduced.
|
Usage Guidelines
Use this command to define the profile of RSVP flows to be placed in the PQ within the WFQ system. You can have only one profile in effect at a time. Changes to this configuration affect only new flows, not existing flows.
This command applies only on interfaces that are running RSVP and WFQ.
RSVP recognizes voice flows based upon the r, b, and p values within the flowspec of a receiver. A reserved flow is granted the PQ as long as the flowspec parameters of a receiver meet the following default criteria:
(r <= r') AND (b <= b') AND (p/r <= p-to-r')
Examples
In the following example, voice-like flows (with the default criteria for voice) are put into the PQ:
Router(config)# ip rsvp pq-profile
Router(config)# ip rsvp pq-profile voice-like
Router(config)# ip rsvp pq-profile 12288 592 110
Router(config)# default ip rsvp pq-profile
Router# show run | include pq-profile
In the following example, all flows matching the voice criteria are put into the PQ:
Router(config)# ip rsvp pq-profile 10240 512 100
Router# show run | include pq-profile
ip rsvp pq-profile 10240 512 100
In the following example, no flows are put into the PQ:
Router(config)# no ip rsvp pq-profile
Router# show run | include pq-profile
In the following example, flows with the criteria given for r' and b' and the default value for p-to-r' are put into the PQ:
Router(config)# ip rsvp pq-profile 9000 300
Router# show run | include pq-profile
ip rsvp pq-profile 9000 300 110
In the following example, flows with the criteria given for r' and b' and ignoring the peak value of the flow are put into the PQ:
Router(config)# ip rsvp pq-profile 9000 300 ignore-peak-value
Router# show run | include pq-profile
ip rsvp pq-profile 9000 300 ignore-peak-value
In the following example, Microsoft NetMeeting voice flows with G.711 or adaptive differential pulse code modulation (ADPCM) codecs are put into the PQ:
Router(config)# ip rsvp pq-profile 10200 1200
ip rsvp precedence
To enable the router to mark the IP Precedence value of the type of service (ToS) byte for packets in a Resource Reservation Protocol (RSVP) reserved path using the specified values for packets that either conform to or exceed the RSVP flowspec, use the ip rsvp precedence interface configuration command. To remove existing IP Precedence settings, use the no form of this command; if neither the conform nor exceed keyword is specified, all IP Precedence settings are removed.
ip rsvp precedence {[conform precedence-value] [exceed precedence-value]}
no ip rsvp precedence [conform] [exceed]
Syntax Description
conform precedence-value
|
(Optional) Specifies an IP Precedence value in the range from 0 to 7 for traffic that conforms to the RSVP flowspec. The IP Precedence value is written to the three high-order bits (bits 5 to 7) of the ToS byte in the IP header of a packet. Either the conform or exceed keyword is required; both keywords may be specified.
When used with the no form of the command, the conform keyword is optional.
|
exceed precedence-value
|
(Optional) Specifies an IP Precedence value in the range from 0 to 7 for traffic that exceeds the RSVP flowspec. The IP Precedence value is written to the three high-order bits (bits 5 to 7) of the ToS byte in the IP header of a packet. Either the conform or exceed keyword is required; both keywords may be specified.
When used with the no form of the command, the exceed keyword is optional.
|
Defaults
The IP Precedence bits of the ToS byte are left unmodified when this command is not used. The default state is equivalent to execution of the no ip rsvp precedence command.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.0(3)T
|
This command was introduced.
|
Usage Guidelines
Packets in an RSVP reserved path are divided into two classes: those that conform to the reservation flowspec and those that correspond to a reservation but that exceed, or are outside, the reservation flowspec.
The ip rsvp precedence command allows you to set the IP Precedence values to be applied to packets belonging to these two classes. You must specify the IP Precedence value for at least one class of traffic when you use this command. You can use a single instance of the command to specify values for both classes, in which case you can specify the conform and exceed keywords in either order.
As part of its input processing, RSVP uses the ip rsvp precedence command to set the IP Precedence bits on conforming and nonconforming packets. If per-VC DWRED is configured, the system uses the IP Precedence and ToS bit settings on the output interface in its packet drop process. The IP Precedence setting of a packet can also be used by interfaces on downstream routers.
Execution of the ip rsvp precedence command causes IP Precedence values for all preexisting reservations on the interface to be modified.
Note
RSVP must be enabled on an interface before you can use this command; that is, use of the ip rsvp bandwidth command must precede use of the ip rsvp precedence command. RSVP cannot be configured with VIP-distributed Cisco Express Forwarding (dCEF).
RSVP receives packets from the underlying forwarding mechanism. Therefore, before you use the ip rsvp precedence command to set IP Precedence, one of the following features is required:
•
Weighted fair queueing (WFQ) must be enabled on the interface.
•
RSVP switched virtual circuits (SVCs) must be used.
•
NetFlow must be configured to assist RSVP.
Note
Use of the no form of this command is not equivalent to giving the ip rsvp precedence 0 command, which sets all precedence on the packets to 0, regardless of previous precedence setting.
Examples
The following example sets the IP Precedence value to 3 for all traffic on the ATM interface 0 that conforms to the RSVP flowspec and to 2 for all traffic that exceeds the flowspec:
ip rsvp precedence conform 3 exceed 2
The following example sets the IP Precedence value to 2 for all traffic on ATM interface 1 that conforms to the RSVP flowspec. The IP Precedence values of those packets that exceed the flowspec are not altered in any way.
ip rsvp precedence conform 2
Related Commands
Command
|
Description
|
ip rsvp bandwidth
|
Enables RSVP for IP on an interface.
|
ip rsvp policy cops minimal
|
Lowers the COPS server's load and improves latency times for messages on the governed router.
|
ip rsvp tos
|
Allows you to set the ToS values to be applied to packets that either conform to or exceed the RSVP flowspec.
|
show ip rsvp
|
Displays the IP Precedence and ToS bit values to be applied to packets that either conform to or exceed the RSVP flowspec for a given interface.
|
ip rsvp reservation
To enable a router to simulate receiving and forwarding Resource Reservation Protocol (RSVP) RESV messages, use the ip rsvp reservation global configuration command. To disable this feature, use the no form of this command.
ip rsvp reservation session-ip-address sender-ip-address {tcp | udp | ip-protocol} session-dport
sender-sport next-hop-ip-address next-hop-interface {ff | se | wf} {rate | load} bandwidth
burst-size
no ip rsvp reservation session-ip-address sender-ip-address {tcp | udp | ip-protocol}
session-dport sender-sport next-hop-ip-address next-hop-interface {ff | se | wf} {rate | load}
bandwidth burst-size
Syntax Description
session-ip-address
|
For unicast sessions, this is the address of the intended receiver; for multicast sessions, this is the IP multicast address of the session.
|
sender-ip-address
|
The IP address of the sender.
|
tcp | udp | ip-protocol
|
TCP, User Datagram Protocol (UDP), or IP protocol in the range from 0 to 255.
|
session-dport sender-sport
|
session-dport is the destination port. sender-sport is the source port. Port numbers are specified in all cases, because the use of 16-bit ports following the IP header is not limited to UDP or TCP. If destination is zero, source must be zero, and the implication is that ports are not checked. If destination is nonzero, source must be nonzero (except for wf reservations, for which the source port is always ignored and can therefore be zero).
|
next-hop-ip-address
|
Host name or address of the receiver or the router closest to the receiver.
|
next-hop-interface
|
Next hop interface or subinterface type and number. Interface type can be ethernet, loopback, null, or serial.
|
ff | se | wf
|
Reservation style:
• Fixed Filter (ff) is single reservation.
• Shared Explicit (se) is shared reservation, limited scope.
• Wild Card Filter (wf) is shared reservation, unlimited scope.
|
rate | load
|
QoS guaranteed bit rate service or controlled load service.
|
bandwidth
|
Average bit rate, in kbps, to reserve up to 75 percent of the total on the interface. The range is from 1 to 10000000.
|
burst-size
|
Maximum burst size (KB of data in queue). The range is from 1 to 65535.
|
Defaults
The router does not simulate receiving and processing RSVP RESV messages by default.
Command Modes
Global configuration
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
Usage Guidelines
Use this command to make the router simulate receiving RSVP RESV messages from a downstream host. This command can be used to proxy RSVP RESV messages for non-RSVP-capable receivers. By giving a local (loopback) next hop address and next hop interface, you can also use this command to proxy RSVP for the router you are configuring.
Note
RSVP cannot be configured with VIP-distributed Cisco Express Forwarding (dCEF).
Examples
The following example specifies the use of a Shared Explicit style of reservation and the controlled load service, with token buckets of 100 or 150 kbps and 60 or 65 kbps maximum queue depth:
ip rsvp reservation 224.250.0.2 172.16.1.1 UDP 20 30 172.16.4.1 Et1 se load 100 60
ip rsvp reservation 224.250.0.2 172.16.2.1 TCP 20 30 172.16.4.1 Et1 se load 150 65
The following example specifies the use of a Wild Card Filter style of reservation and the guaranteed bit rate service, with token buckets of 300 or 350 kbps and 60 or 65 kbps maximum queue depth:
ip rsvp reservation 224.250.0.3 0.0.0.0 UDP 20 0 172.16.4.1 Et1 wf rate 300 60
ip rsvp reservation 226.0.0.1 0.0.0.0 UDP 20 0 172.16.4.1 Et1 wf rate 350 65
Note that the Wild Card Filter does not admit the specification of the sender; it accepts all senders. This action is denoted by setting the source address and port to zero. If, in any filter style, the destination port is specified to be zero, RSVP does not permit the source port to be anything else; it understands that such protocols do not use ports or that the specification applies to all ports.
Related Commands
Command
|
Description
|
fair-queue (WFQ)
|
Enables WFQ for an interface.
|
ip rsvp bandwidth
|
Enables RSVP for IP on an interface.
|
ip rsvp neighbor
|
Enables neighbors to request a reservation.
|
ip rsvp reservation-host
|
Enables a router to simulate a host generating RSVP RESV messages.
|
ip rsvp sender
|
Enables a router to simulate receiving and forwarding RSVP PATH messages.
|
ip rsvp sender-host
|
Enables a router to simulate a host generating RSVP PATH messages.
|
ip rsvp udp-multicasts
|
Instructs the router to generate UDP-encapsulated RSVP multicasts whenever it generates an IP-encapsulated multicast packet.
|
random-detect (interface)
|
Enables WRED or DWRED.
|
show ip rsvp installed
|
Displays RSVP-related installed filters and corresponding bandwidth information.
|
show ip rsvp interface
|
Displays RSVP-related interface information.
|
show ip rsvp neighbor
|
Displays current RSVP neighbors.
|
show ip rsvp reservation
|
Displays RSVP-related receiver information currently in the database.
|
show ip rsvp sender
|
Displays RSVP PATH-related sender information currently in the database.
|