Table Of Contents
MQC QoS on the Cisco CMTS Routers
Configuring QoS Policy Actions and Rules
Attaching Service Policies to an Interface
How to Configure MQC QoS on the Cisco CMTS Routers
Configuring Qos Features Using MQC
Configuring QoS Traffic Classes
Defining QoS Actions in a Policy Map
Configuration Examples for MQC QoS
Configuring the Traffic Class: Example
Configuring the Traffic Policy: Example
Attaching the Service Policy: Example
Feature Information for MQC QoS on the Cisco CMTS Routers
MQC QoS on the Cisco CMTS Routers
First Published: December 18, 2008
Last Updated: November 23, 2009
The Modular Quality of Service Command-Line Interface (MQC) is designed to simplify the configuration of Quality of Service (QoS) on the Cisco CMTS routers by defining a common command syntax and resulting set of QoS behaviors across platforms.
Finding Feature Information
Your software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the "Feature Information for MQC QoS on the Cisco CMTS Routers" section.
Use Cisco Feature Navigator to find information about platform support and Cisco IOS, Catalyst OS, and Cisco IOS XE software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Contents
•
How to Configure MQC QoS on the Cisco CMTS Routers
•
Configuration Examples for MQC QoS
•
Feature Information for MQC QoS on the Cisco CMTS Routers
Prerequisites for MQC QoS
Table 1 shows the Cisco Cable Modem Termination System (CMTS) hardware compatibility prerequisites for this feature.
.
Note
The combination of PRE4 and Cisco Half-Height Gigabit Ethernet (HHGE) is not supported in the same chassis.
Restrictions for MQC QoS
•
The sum of all priority traffic running on a given port must be less than or equal to 90 percent of the port bandwidth.
Information About MQC QoS
Quality of Service (QoS) is supported on WAN interfaces using the standard MQC. The MQC CLI structure allows you to create traffic policies and attach these policies to interfaces. A traffic policy contains a traffic class and QoS features. A traffic class is used to select traffic, while the QoS features in the traffic policy determine how to treat the classified traffic.
Classifying Traffic
The Cisco uBR10012 Universal Broadband Router must differentiate traffic before it can apply appropriate QoS actions to the traffic. You can use an MQC CLI element called a class map to define traffic classification rules or criteria.
Class maps organize data packets into specific categories called classes that can receive user-defined QoS policies. The traffic class defines the classification rules for packets received on an interface.
Configuring QoS Policy Actions and Rules
After classifying the traffic, the Cisco uBR10012 Universal Broadband Router must be configured to handle the traffic that meets the matching criteria. The MQC CLI element policy map is used to create QoS policies and configure QoS actions and rules to apply to packets that match a particular traffic class.
A policy map associates a traffic class with one or more QoS actions. While configuring a policy map, you can specify a class map name and configure the actions you want the router to take on the matching traffic. However, before creating class policies in a policy map, the class classification criteria must be configured in a class map.
Whenever you modify a class policy of a policy map, class-based weighted fair queuing (CBWFQ) is notified and new classes are installed as part of the policy map in the CBWFQ system.
Attaching Service Policies to an Interface
After creating and configuring a traffic policy, you should attach the policy to an interface. A policy can be applied to packets in either direction, inbound or outbound. An interface can have different service policies for incoming and outgoing packets.
How to Configure MQC QoS on the Cisco CMTS Routers
Note
MQC support is applicable only to WAN interfaces as DOCSIS has its own QoS mechanism. However, DOCSIS QoS extends limited MQC support for cable interfaces to limit peer-to-peer (P2P) traffic.
This section describes the following required and optional procedures:
•
Configuring Qos Features Using MQC (required)
•
Configuring QoS Traffic Classes (required)
•
Configuring Traffic Policies (required)
•
Defining QoS Actions in a Policy Map (required)
•
Attaching Service Policies (required)
•
Configuring Output Rate (optional)
Configuring Qos Features Using MQC
To configure QoS features using the Modular QoS CLI , complete the following basic steps:
Step 1
Define a traffic class using the class-map command.
Step 2
Create a traffic policy by associating the traffic class with QoS features using the policy-map command.
Step 3
Attach the traffic policy to the interface using the service-policy command and specify whether the policy has to be applied to inbound or outbound traffic.
Each of the above-mentioned steps is accomplished using a user interface command. Specifically, the three steps are accomplished through the use of three abstractions, class map, policy map, and service policy.
Note
Service policies are applied to Gigabit Ethernet, Ten Gigabit Ethernet, 802.1Q VLAN subinterfaces, and tunnel interfaces. Tunnel interfaces are virtual interfaces without queues, and service policies applied to tunnels cannot contain queuing actions. The Cisco uBR10012 Universal Broadband Router does not support per-subinterface queues for VLAN subinterfaces. However, the VLANs share the main interface queues.
For more information about MQC, refer to the "Configuring the Modular Quality of Service Command-Line Interface" chapter of the Cisco IOS Quality of Service Solutions Configuration Guide, Release 12.2 document.
Note
Though MQC is not broadly supported on cable interfaces as most subscriber queue configuration is controlled by parameters in the cable modem configuration file, a subset of MQC is supported on cable interfaces. This allows multiple service operators (MSOs) to classify P2P traffic based on type of service (ToS) bits and send it to a shaped queue. The P2P traffic control feature can configure shape and queue-limit actions on the P2P traffic control policy map. The type of service P2P is supported only on legacy cable interfaces and not on Wideband or modular cable (MC) interfaces.
Configuring QoS Traffic Classes
The class map command is used to create a traffic class. A traffic class contains three major elements: a name, a series of match commands, and, if more than one match command exists in the traffic class, an instruction on how to evaluate these match commands.
The match commands are used to specify various criteria for classifying packets. Packets are checked to determine whether they match the criteria specified in the match commands; if a packet matches the specified criteria, that packet is considered a member of the class and is forwarded according to the QoS specifications set in the traffic policy. Packets that fail to meet any of the matching criteria are classified as members of the default traffic class.
For more information about the default traffic class, refer to the "Configuring the Modular Quality of Service Command-Line Interface" chapter of the Cisco IOS Quality of Service Solutions Configuration Guide, Release 12.2 document.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
class-map [match-all | match-any] class-name
4.
match type
DETAILED STEPS
Command or Action PurposeStep 1
enable
Example:Router> enable
Enables privileged EXEC mode.
•
Enter your password if prompted.
Step 2
configure terminal
Example:Router# configure terminal
Enters global configuration mode.
Step 3
class-map [match-all | match-any] class-name
Example:Router(config)# class-map class1
Creates a class to be used with a class map, and enters class-map configuration mode. The class map is used for matching packets to the specified class.
•
match-all—(Optional) Specifies that all match criteria in the class map must be matched, using a logical AND of all matching statements defined under the class. This is the default.
•
match-any—(Optional) Specifies that one or more match criteria must match, using a logical OR of all matching statements defined under the class.
•
class-name—User-defined name of the class.
Step 4
match type
Example:Router(config-cmap)# match access-group 101
Specifies the matching criterion to be applied to the traffic, where type represents one of the forms of the match command.
Table 2 lists the match options supported on the class-map command.
Configuring Traffic Policies
After creating traffic classes, you can configure traffic policies to configure marking features to apply certain actions to the selected traffic in those classes.
The policy-map command is used to create a traffic policy. The purpose of a traffic policy is to configure the QoS features that should be associated with the traffic that has been classified in a user-specified traffic class.
Note
A packet can match only one traffic class within a traffic policy. If a packet matches more than one traffic class in the traffic policy, the first traffic class defined in the policy will be used.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
policy-map policy-map-name
4.
class {class-name | class-default}
DETAILED STEPS
Defining QoS Actions in a Policy Map
Action commands can be added from within class mode on a policy map. Action commands fall into three general categories as given below:
Set Actions
Set commands allow traffic to be marked such that other network devices along the forwarding path can quickly determine the proper class of service to apply to a traffic flow. Set commands can be applied to both input and output policy maps.
Table 3 lists the set options supported on the Cisco uBR10012 Universal Broadband Router.
Police Actions
Traffic policing is a traffic regulation mechanism that is used to limit the rate of traffic streams. Policing allows you to control the maximum rate of traffic sent or received on an interface. Policing propagates bursts of traffic and is applied to the inbound or outbound traffic on an interface. When the traffic rate exceeds the configured maximum rate, policing drops or remarks the excess traffic. Although policing does not buffer excess traffic, in the output direction, a configured queuing mechanism applies to conforming packets that might need to be queued while waiting to be serialized at the physical interface.
Traffic policing uses a token bucket algorithm to manage the maximum rate of traffic. This algorithm is used to define the maximum rate of traffic allowed on an interface at a given moment in time. The algorithm puts tokens into the bucket at a certain rate. Each token is permission for the source to send a specific number of bits into the network. With policing, the token bucket determines whether a packet exceeds or conforms to the applied rate. In either case, policing implements the action you configure such as setting the IP precedence or differentiated services code point (DSCP).
To configure traffic policing based on bits per second, use the police command in policy-map class configuration mode.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
policy-map [name]
4.
class [name]
5.
police [bps] [burst-normal ] [burst-excess] conform [conform-action] exceed [exceed-action]
DETAILED STEPS
Queuing Actions
When queuing actions are applied to a given class within a policy map, they either cause queues to be created for that particular class of traffic or control how the queues are managed. Queuing commands are valid only in the output direction.
The Cisco uBR10012 Universal Broadband Router supports the MQC policy maps for class queue creation on WAN interfaces.
The following two types of queues are supported through MQC:
•
Priority queues—Used mainly for voice traffic. They are policed at their individual committed information rate (CIR) to limit their bandwidth to the subscribed level. Only one priority queue is allowed per logical interface.
•
Class queues—Implemented as best effort queues. They are based on a specified bandwidth in Kbps and shaped using the "bandwidth" policy map action. Generally, the specified bandwidth is not guaranteed.
Weighted random early detection (WRED) is a mechanism for controlling congestion of queues. WRED combines the capabilities of the random early detection (RED) mechanism with IP precedence, DSCP, and discard class to provide preferential handling of higher priority packets. For additional information on WRED, refer to the Cisco IOS Quality of Service Solutions Configuration Guide, Release 12.2.
Note
Cisco IOS Release 12.2(33)SCB does not support random-detect for type of service (ToS) peer-to-peer (P2P) policy maps.
Table 4 lists the queuing actions supported on the Cisco uBR10012 Universal Broadband Router.
Attaching Service Policies
The service-policy command is used to attach the traffic policy, as specified with the policy-map command, to an interface. Because the elements of the traffic policy can be applied to packets entering and leaving the interface, it is essential to specify whether the traffic policy characteristics should be applied to incoming or outgoing packets.
To attach a policy map that the router can use to apply QoS policies to inbound and outbound packets, use the service-policy command in interface or map class configuration mode.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
interface interface-name
4.
service-policy {input | output} policy-map-name
DETAILED STEPS
Configuring Output Rate
To restrict the WAN interface bandwidth output rate to a smaller value than that of the physical link bandwidth, use the output-rate command in interface configuration mode.
Note
The output-rate command is valid only for Gigabit Ethernet interfaces. This command was introduced in Cisco IOS Release 12.2(33)SCC.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
interface interface-name
4.
output-rate rate
DETAILED STEPS
Configuration Examples for MQC QoS
This section provides the following configuration examples:
•
Configuring the Traffic Class: Example
•
Configuring the Traffic Policy: Example
•
Attaching the Service Policy: Example
•
Verifying QoS Policy: Example
Configuring the Traffic Class: Example
In the following example, two traffic classes are created and their match criteria are defined. For the first traffic class called class1, access control list (ACL) 101 is used as the match criterion. For the second traffic class called class2, ACL 102 is used as the match criterion. Packets are checked against the contents of these ACLs to determine if they belong to the class.
Router(config)# class-map class1Router(config-cmap)# match access-group 101Router(config-cmap)# exitRouter(config)# class-map class2Router(config-cmap)# match access-group 102Router(config-cmap)# exitConfiguring the Traffic Policy: Example
In the following example, a traffic policy called policy1 is defined to contain policy specifications for class1.
Router(config)# policy-map policy1Router(config-pmap)# class class1Router(config-pmap-c)# bandwidth 3000Router(config-pmap-c)# queue-limit 30Router(config-pmap)# exitAttaching the Service Policy: Example
The following example shows how to attach an existing traffic policy to an interface. After you define a traffic policy with the policy-map command, you can attach it to one or more interfaces by using the service-policy command in interface configuration mode. Although you can assign the same traffic policy to multiple interfaces, each interface can have only one traffic policy attached at the input and only one traffic policy attached at the output.
Router(config)# interface GigabitEthernet 3/0/0Router(config-if)# service-policy output policy1Router(config-if)# exitVerifying QoS Policy: Example
To verify a policy map configuration, enter any of the following commands in privileged EXEC mode:.
Router# show policy-map policy-map-name class class-nameClass foobarbandwidth percent 20packet-based wred, exponential weight 9random-detect aggregaterandom-detect precedence values 2 minimum-thresh 1024 maximum-thresh 20481Router# show policy-map interface [type number]{input | output} class class-nameAdditional References
The following sections provide references related to the MQC QoS feature.
Related Documents
Related Topic Document TitleCMTS cable commands
Modular Quality of Service Command-Line Interface
Cisco IOS Quality of Service Solutions Configuration Guide, Release 12.2
IP Differentiated Services Code Point Marking
Cisco IOS Quality of Service Solutions Configuration Guide, Release 12.2
Weighted Random Early Detection
Cisco IOS Quality of Service Solutions Configuration Guide, Release 12.2
Standards
Standard TitleNo new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.
—
MIBs
RFCs
RFC TitleNo new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.
—
Technical Assistance
Feature Information for MQC QoS on the Cisco CMTS Routers
Table 5 lists the features in this module and provides links to specific configuration information. Only features that were introduced or modified in Cisco IOS Release 12.2(33)SCB or a later release appear in the table.
Not all commands may be available in your Cisco IOS software release. For release information about a specific command, see the command reference documentation.
Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which Cisco IOS, Catalyst OS, and Cisco IOS XE software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Note
Table 5 lists only the Cisco IOS software release that introduced support for a given feature in a given Cisco IOS software release. Unless noted otherwise, subsequent releases of that Cisco IOS software release also support that feature.
CCDE, CCENT, CCSI, Cisco Eos, Cisco HealthPresence, Cisco IronPort, the Cisco logo, Cisco Nurse Connect, Cisco Pulse, Cisco SensorBase, Cisco StackPower, Cisco StadiumVision, Cisco TelePresence, Cisco Unified Computing System, Cisco WebEx, DCE, Flip Channels, Flip for Good, Flip Mino, Flipshare (Design), Flip Ultra, Flip Video, Flip Video (Design), Instant Broadband, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn, Cisco Capital, Cisco Capital (Design), Cisco:Financed (Stylized), Cisco Store, Flip Gift Card, and One Million Acts of Green are service marks; and Access Registrar, Aironet, AllTouch, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Lumin, Cisco Nexus, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, Continuum, EtherFast, EtherSwitch, Event Center, Explorer, Follow Me Browsing, GainMaker, iLYNX, IOS, iPhone, IronPort, the IronPort logo, Laser Link, LightStream, Linksys, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, PCNow, PIX, PowerKEY, PowerPanels, PowerTV, PowerTV (Design), PowerVu, Prisma, ProConnect, ROSA, SenderBase, SMARTnet, Spectrum Expert, StackWise, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0910R)
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
© 2009 Cisco Systems, Inc. All rights reserved.

