To configure aggregate Weighted Random Early Detection (WRED) parameters for specific differentiated services code point
(DSCP) value, use the
random-detectdscpvalues(aggregate) command in QoS policy-map class configuration mode. To disable configuration of aggregate WRED DSCP values, use the
no form of this command.
random-detect dscp sub-class-val1 sub-class-val2 sub-class-val3 sub-class-val4 min-thresh max-thresh mark-prob
no random-detect dscp sub-class-val1 sub-class-val2 sub-class-val3 sub-class-val4 min-thresh max-thresh mark-prob
Cisco 10000 Series Router (PRE3)
random-detect dscp values sub-class-val1 [. . . [sub-class-val8]] minimum-thresh min-thresh-value maximum-thresh max-thresh-value mark-prob mark-prob-value
no random-detect dscp values sub-class-val1 [. . . [sub-class-val8]] minimum-thresh min-thresh-value maximum-thresh max-thresh-value mark-prob mark-prob
Syntax Description
sub-class-val1
sub-class-val2
sub-class-val3
sub-class-val4
|
DSCP value(s) to which the following WRED profile parameter specifications are to apply. A maximum of eight subclasses (DSCP
values) can be specified per command-line interface (CLI) entry. See the “Usage Guidelines” for a list of valid DSCP values.
|
min-thresh
|
The minimum number of packets allowed in the queue. When the average queue length reaches the minimum threshold, WRED randomly
drops some packets with the specified DSCP value. Valid minimum threshold values are 1 to 16384.
|
max-thresh
|
The maximum number of packets allowed in the queue. When the average queue length exceeds the maximum threshold, WRED drops
all packets with the specified DSCP value. Valid maximum threshold values are 1 to 16384.
|
mark-prob
|
The denominator for the fraction of packets dropped when the average queue depth is at the maximum threshold. For example,
if the denominator is 512, 1 out of every 512 packets is dropped when the average queue is at the maximum threshold. Valid
values are 1 to 65535.
|
Cisco
10000
Series
Router
|
values
sub-class-val1
[...[subclass-val8 ]]
|
DSCP value(s) to which the following WRED profile parameter specifications are to apply. A maximum of 8 subclasses (DSCP
values) can be specified per CLI entry. The DSCP value can be a number from 0 to 63, or it can be one of the following keywords:
ef ,
af11 ,
af12 ,
af13 ,
af21 ,
af22 ,
af23 ,
af31 ,
af32 ,
af33 ,
af41 ,
af42 ,
af43 ,
cs1 ,
cs2 ,
cs3 ,
cs4 ,
cs5 , or
cs7 .
|
minimum-thresh
min-thresh
|
Specifies the minimum number of packets allowed in the queue. When the average queue length reaches the minimum threshold,
WRED randomly drops some packets with the specified DSCP value. Valid minimum threshold values are 1 to 16384.
|
maximum-thresh
max-thresh
|
Specifies the maximum number of packets allowed in the queue. When the average queue length exceeds the maximum threshold,
WRED drops all packets with the specified DSCP value. Valid maximum threshold values are 1 to 16384.
|
mark-probability
mark-prob
|
Specifies the denominator for the fraction of packets dropped when the average queue depth is at the maximum threshold. For
example, if the denominator is 512, 1 out of every 512 packets is dropped when the average queue is at the maximum threshold.
Valid values are 1 to 65535.
|
Command Default
For all precedence levels, the mark-prob default value is 10 packets.
Command Modes
QoS policy-map class configuration
Command History
Release
|
Modification
|
12.2(18)SXE
|
This command was introduced.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(31)SB2
|
This command was integrated into Cisco IOS Release 12.2(31)SB2 and implemented on the Cisco 10000 series router.
|
Usage Guidelines
For ATM interfaces, the Aggregate WRED feature requires that the ATM SPA cards are installed in a Cisco 7600 SIP-200 carrier
card or a Cisco 7600 SIP-400 carrier card.
To configure WRED on an ATM interface, you must use therandom-detectaggregate commands; the standard random-detect commands are no longer supported on ATM interfaces.
Use this command with a
random-detectaggregate command within a policy map configuration.
Repeat this command for each set of DSCP values that share WRED parameters.
After the policy map is defined, the policy map must be attached at the virtual circuit (VC) level.
The set of subclass (DSCP precedence) values defined on a
random-detectdscp (aggregate) CLI will be aggregated into a single hardware WRED resource. The statistics for these subclasses will also be aggregated.
Use the
showpolicy-mapinterface command to display the statistics for aggregated subclasses.
Cisco 10000 Series Router
For the PRE2, the random-detect command specifies the default profile for the queue. For the PRE3, the aggregate random-detect
command is used instead to configure aggregate parameters for WRED. The PRE3 accepts the PRE2 random-detect command as a hidden
command.
On the PRE2, accounting for the default profile is per precedence. On the PRE3, accounting and configuration for the default
profile is per class map.
On the PRE2, the default threshold is per precedence for a DSCP or precedence value without an explicit threshold configuration.
On the PRE3, the default threshold is to have no WRED configured.
On the PRE2, the drop counter for each precedence belonging to the default profile only has a drop count that matches the
specific precedence value. Because the PRE2 has a default threshold for the default profile, the CBQOSMIB displays default
threshold values. On the PRE3, the drop counter for each precedence belonging to the default profile has the aggregate counter
of the default profile and not the individual counter for a specific precedence. The default profile on the PRE3 does not
display any default threshold values in the CBQOSMIB if you do not configure any threshold values for the default profile.
DSCP Values
You must enter one or more differentiated service code point (DSCP) values. The command may include any combination of the
following:
-
numbers (0 to 63) representing differentiated services code point values
-
af numbers (for example, af11) identifying specific AF DSCPs
-
cs numbers (for example, cs1) identifying specific CS DSCPs
-
default
--Matches packets with the default DSCP.
-
ef
--Matches packets with EF DSCP.
For example, if you wanted the DCSP values of 0, 1, 2, 3, 4, 5, 6, or 7 (note that only one of the IP DSCP values must be
a successful match criterion, not all of the specified DSCP values), enter the
matchdscp01234567 command.
Examples
The following example shows how to create a class map named map1 and associate it with the policy map named map2. The configuration
enables WRED to drop map1 packets based on DSCP 8 with a minimum threshold of 24 and a maximum threshold of 40. The map2 policy
map is attached to the outbound ATM interface 1/0/0.
Router(config-if)# class-map map1
Router(config-cmap)# match access-group 10
Router(config-cmap)# exit
Router(config)# policy-map map2
Router(config-pmap)# class map1
Router(config-pmap-c)# bandwidth 48
Router(config-pmap-c)# random-detect dscp-based
Router(config-pmap-c)# random-detect dscp 8 24 40
Router(config-pmap-c)# exit
Router(config-pmap)# exit
Router(config)# interface atm 1/0/0
Router(config-if)# service-policy output map2
The following example shows a DSCP-based aggregate WRED configuration for an ATM interface. Note that first a policy map
named dscp-aggr-wred is defined for the default class, then dscp-based aggregate WRED is enabled with the
random-detectdscp-basedaggregate command, then subclasses and WRED parameter values are assigned in a series of
random-detectdscp(aggregate) commands, and, finally, the policy map is attached at the ATM VC level using the
interface and
service-policy commands.
Router(config)# policy-map dscp-aggr-wred
Router(config-pmap)# class class-default
Router(config-pmap-c)# random-detect dscp-based aggregate minimum-thresh 1 maximum-thresh 10 mark-prob 10
!
! Define an aggregate subclass for packets with DSCP values of 0-7 and assign the WRED
! profile parameter values for this subclass
Router(config-pmap-c)# random-detect dscp 0 1 2 3 4 5 6 7 minimum-thresh 10 maximum-thresh 20 mark-prob 10
Router(config-pmap-c) random-detect dscp 8 9 10 11 minimum-thresh 10 maximum-thresh 40 mark-prob 10
Router(config)# interface ATM4/1/0.11 point-to-point
Router(config-subif)# ip address 10.0.0.2 255.255.255.0
Router(config-subif) pvc 11/101
Router(config-subif)# service-policy output dscp-aggr-wred
Examples
The following example shows how to create a class map named Gold and associate it with the policy map named Business. The
configuration enables WRED to drop Gold packets based on DSCP 8 with a minimum threshold of 24 and a maximum threshold of
40. The Business policy map is attached to the outbound ATM interface 1/0/0.
Router(config-if)# class-map Gold
Router(config-cmap)# match access-group 10
Router(config-cmap)# exit
Router(config)# policy-map Business
Router(config-pmap)# class Gold
Router(config-pmap-c)# bandwidth 48
Router(config-pmap-c)# random-detect dscp-based
Router(config-pmap-c)# random-detect dscp values 8 minimum-thresh 24 maximum-thresh 40
Router(config-pmap-c)# exit
Router(config-pmap)# exit
Router(config)# interface atm 1/0/0
Router(config-if)# service-policy output Business