Table Of Contents
Quality of Service: Policies Aggregation
Prerequisites for QoS: Policies Aggregation
Restrictions for QoS: Policies Aggregation
Information About QoS: Policies Aggregation
Understanding Fragments in Class Definition Statements
Understanding Fragments for Gigabit Etherchannel Bundles
How to Configure QoS: Policies Aggregation
How to Configure QoS: Policies Aggregation for an Interface
Configuring a Fragment Traffic Class in a Policy Map
Configuring a Service Fragment Traffic Class
How to Configure QoS: Policies Aggregation on Gigabit Etherchannels
Configuring Fragments on Gigabit Etherchannel Member Link Subinterfaces
Configuring Service Fragments on Physical Interface Supporting a Gigabit Etherchannel Bundle
Configuration Examples for QoS: Policies Aggregation
QoS: Policies Aggregation: Example
Gigabit Etherchannel QoS: Policies Aggregation: Example
Feature Information for QoS: Policies Aggregation
Quality of Service: Policies Aggregation
First Published: May 5th, 2008Last Updated: May 5th, 2008The Quality of Service: Policies Aggregation (QoS: Policies Aggregation) feature allows the default traffic classes of different policy maps on the same physical interface to be configured as a single traffic class within the Modular QoS CLI.
Finding Feature Information in This Module
Your Cisco IOS software release may not support all of the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To reach links to specific feature documentation in this module and to see a list of the releases in which each feature is supported, use the "Feature Information for QoS: Policies Aggregation" section.
Finding Support Information for Platforms and Cisco IOS and Catalyst OS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS and Catalyst OS 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
•
Prerequisites for QoS: Policies Aggregation
•
Restrictions for QoS: Policies Aggregation
•
Information About QoS: Policies Aggregation
•
How to Configure QoS: Policies Aggregation
•
Configuration Examples for QoS: Policies Aggregation
•
Feature Information for QoS: Policies Aggregation
Prerequisites for QoS: Policies Aggregation
This feature is configured using the Modular Quality of Service (QoS) Command-Line Interface (CLI) (MQC). It is most useful in QoS configurations where several policy maps attached to the same physical interface want identical treatment of multiple default traffic classes in different policy maps.
Restrictions for QoS: Policies Aggregation
This feature only works when multiple policy maps are attached to the same physical interface. This feature cannot be used to collectively classify default traffic classes of policy maps on different physical interfaces.
Information About QoS: Policies Aggregation
This section covers the following topics:
•
Understanding Fragments in Class Definition Statements
•
Understanding Fragments for Gigabit Etherchannel Bundles
Understanding Fragments in Class Definition Statements
QoS: Policies Aggregation introduces the idea of fragments in class definition statements. A default traffic class definition statement can be marked as a fragment within a policy map. Other policy maps on the same interface can also define their default traffic class statements as fragments, if desired. A separate policy map can then be created with a service fragment class definition statement that will be used to apply QoS to all of the fragments as a single group.
Figure 1 provides an example of one physical interface with three attached policy maps that is not using fragments. Note that each policy map has a default traffic class that can only classify traffic for the default traffic within its own policy map.
Figure 1
Three Policy Maps Configured Without Fragments
Figure 2 shows the same configuration configured with fragments, and adds a fourth policy map with a class definition statement that classifies the fragments collectively. The default traffic classes are now classified as one service fragment group rather than three separate default traffic classes within the individual policy maps.
Figure 2
Three Policy Maps Configured Using Fragments
Understanding Fragments for Gigabit Etherchannel Bundles
Fragments can be configured for Gigabit Etherchannels when all of the member links of the Gigabit Etherchannel (GEC) bundle are on the same physical interface. Notably, if VLANs on the same physical interface are bundled, fragments can be used to define the collective treatment of all default traffic for the GEC bundle of VLAN subinterface member links.
When fragments are configured for Gigabit Etherchannel bundles, the policy maps that have a default traffic class configured using the fragment keyword are attached to the member subinterface links, and the policy maps that have a traffic class configured with the service-fragment keyword to collectively classify the fragments is attached to the physical interface.
How to Configure QoS: Policies Aggregation
This section contains the following procedures:
•
How to Configure QoS: Policies Aggregation for an Interface
•
How to Configure QoS: Policies Aggregation on Gigabit Etherchannels
How to Configure QoS: Policies Aggregation for an Interface
This section contains the following procedures:
•
Configuring a Fragment Traffic Class in a Policy Map
•
Configuring a Service Fragment Traffic Class
Configuring a Fragment Traffic Class in a Policy Map
This task describes how to configure a class statement as a fragment within a policy map.
Prerequisites
This procedure only shows how to configure the default traffic class as a fragment within a policy map. It does not include steps on configuring other classes within the policy map, or other policy maps on the router.
Like any policy map, the configuration is not managing network traffic until it has been attached to an interface. This procedure does not cover the process of attaching a policy map to an interface.
Note the following points about attaching and removing a policy map:
•
To configure QoS: Policies Aggregation, you must attach the policy map that contains the service-fragment keyword to the main interface first, and then you must attach the policy map that contains the fragment keyword to the main interface.
•
To disable QoS: Policies Aggregation, you must remove the policy map that contains the fragment keyword from the subinterface first, and then you must remove the policy map that contains the service-fragment keyword from the subinterface.
Restrictions
Only the default class statement in a policy map can be configured as a fragment.
Fragments only work when multiple policy maps are attached to the same physical interface. This process cannot be used to classify default traffic classes as fragments on policy maps on different physical interfaces.
Only queueing features are allowed in classes where the fragment keyword is entered, and at least one queueing feature must be entered in classes where the fragment keyword is used.
A policy map with a class using the fragment keyword can only be applied to traffic leaving the interface (policy maps attached to interfaces using the service-policy output command).
The fragment keyword cannot be entered in a child policy map.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
policy-map policy-map-name
4.
class class-default fragment fragment-class-name
5.
qos-queueing-feature
DETAILED STEPS
Examples
In the following example, a fragment named BestEffort is created in policy map subscriber1 and policy map subscriber 2.
policy-map subscriber1 class voice set cos 5 priority level 1 class video set cos 4 priority level 2 class class-default fragment BestEffort shape average 200000000 bandwidth remaining ratio 10 policy-map subscriber 2 class voice set cos 5 priority level 1 class video set cos 4 priority level 2 class class-default fragment BestEffort shape average 200000000 bandwidth remaining ratio 10What to Do Next
After configuring multiple default class statements as fragments in a policy map, a separate policy map with a class statement using the service-fragment keyword must be configured to apply QoS to the class statements configured as fragments.
This process is documented in the "Configuring a Service Fragment Traffic Class" section.
Configuring a Service Fragment Traffic Class
This task describes how to configure a service fragment traffic class statement within a policy map. A service fragment traffic class is used to apply QoS to a collection of default class statements that have been configured previously in other policy maps as fragments.
PrerequisitesThis procedure assumes that fragment default traffic classes were already created. The procedure for creating fragment default traffic classes is documented in the "Configuring a Fragment Traffic Class in a Policy Map" section.
Like any policy map, the configuration is not managing network traffic until it has been attached to an interface. This procedure does not cover the process of attaching a policy map to an interface.
Restrictions
A service fragment can only be used to collectively classify fragments from the same physical interface. Fragments from different interfaces cannot be classified using the same service fragment.
Only queueing features are allowed in classes where the service-fragment keyword is entered, and at least one queueing feature must be entered in classes when the service-fragment keyword is used.
A policy map with a class using the service-fragment keyword can only be applied to traffic leaving the interface (policy maps attached to interfaces using the service-policy output command).
A class configured using the service-fragment keyword cannot be removed when it is being used to collectively apply QoS to fragments that are still configured on the interface. If you wish to remove a class configured using the service-fragment keyword, remove the fragment traffic classes before removing the service fragment.
The fragment keyword cannot be entered in a child policy map.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
policy-map policy-map-name
4.
class class-name service-fragment fragment-class-name
5.
qos-queueing-feature
DETAILED STEPS
Examples
In the following example, a policy map is created to apply QoS to all fragments named BestEffort.
policy-map main-interfaceclass data service-fragment BestEffortshape average 400000000In the following example, two fragments are created and then classified collectively using a service fragment.
policy-map subscriber1 class voice set cos 5 priority level 1 class video set cos 4 priority level 2 class class-default fragment BestEffort shape average 200000000 bandwidth remaining ratio 10 policy-map subscriber 2 class voice set cos 5 priority level 1 class video set cos 4 priority level 2 class class-default fragment BestEffort shape average 200000000 bandwidth remaining ratio 10policy-map main-interfaceclass data service-fragment BestEffortshape average 200000000shape average 200000000 bandwidth remaining ratio 10Troubleshooting Tips
Ensure all class statements that are supposed to be part of the same service fragment share the same fragment-class-name.
What to Do Next
The policy map must be attached to an interface.
How to Configure QoS: Policies Aggregation on Gigabit Etherchannels
To properly configure QoS: Policies Aggregation on a Gigabit Etherchannel bundle, the following actions must be executed:
•
fragment traffic classes have to be configured and attached to the member link subinterfaces
•
service fragment traffic classes have to be configured and attached to the main physical interfaces
This section details these steps and contains the following procedures:
•
Configuring Fragments on Gigabit Etherchannel Member Link Subinterfaces
•
Configuring Service Fragments on Physical Interface Supporting a Gigabit Etherchannel Bundle
Configuring Fragments on Gigabit Etherchannel Member Link Subinterfaces
This task describes how to configure the default traffic classes of the policy maps attached to member link subinterfaces of a Gigabit Etherchannel bundle as fragments.
Prerequisites
This procedure assumes that a service fragment traffic class has already been created. A service fragment traffic class cannot be configured without configuring a fragment class. The procedure for creating a fragment class is documented in the "Configuring a Fragment Traffic Class in a Policy Map" section. The procedure for creating a service fragment traffic classes is documented in the "Configuring a Service Fragment Traffic Class" section.
These instructions do not provide any details about the options that can be configured for Gigabit Etherchannel member link subinterfaces. These instructions only document the procedure for attaching a policy map that already has a fragment traffic class to a member link subinterface.
Restrictions
Fragments cannot be used for traffic on two or more physical interfaces. The GEC must all be on the same physical interface for this configuration to work properly.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
interface port-channel port-channel-interface-number.port-channel-subinterface-number
4.
service-policy output fragment-class-name
DETAILED STEPS
Examples
In the following example, the service policy named subscriber has a fragment default traffic class and is attached to the member link subinterface of a Gigabit Etherchannel bundle.
Note
This example only shows how to attach a fragment default traffic class to the member link subinterface of a Gigabit Etherchannel bundle. This configuration is incomplete and would not classify default traffic appropriately until the physical interface was configured to support a service fragment traffic class.
policy-map subscriberclass voicepriority level 1class videopriority level 2class class-default fragment BEshape average 100000000bandwidth remaining ratios 80policy-map aggregate-member-linkclass BestEffort service-fragment BEshape average 100000000!interface Port-channel1ip address 172.1.2.3 255.255.0.0!interface Port-channel1.100encapsulation dot1Q 100ip address 173.1.2.100 255.255.255.0service-policy output subscriber!Troubleshooting Tips
This configuration will not work until a service fragment default traffic class is created to classify the default traffic classes marked as fragments. This service fragment traffic class must be configured for this configuration to have any affect on network traffic.
What to Do Next
This configuration will not work until a service fragment default traffic class is created to classify the default traffic classes marked as fragments.
Follow the instructions in the "Configuring Service Fragments on Physical Interface Supporting a Gigabit Etherchannel Bundle" section to complete this configuration.
Configuring Service Fragments on Physical Interface Supporting a Gigabit Etherchannel Bundle
This task describes how to configure a policy maps with a service fragment default traffic class on the physical interface of a Gigabit Etherchannel bundle.
Prerequisites
This procedure assumes that a service fragment traffic class has already been created. A service fragment traffic class cannot be configured without configuring a fragment class. The procedure for creating a fragment class is documented in the "Configuring a Fragment Traffic Class in a Policy Map" section. The procedure for creating a service fragment traffic classes is documented in the "Configuring a Service Fragment Traffic Class" section.
These instructions do not provide any details about the options that can be configured for Gigabit Etherchannel member link subinterfaces. These instructions only document the procedure for attaching a policy map that already has a fragment traffic class to a member link subinterface.
Restrictions
This process only works if all of the links of the GEC bundle are on the same physical interface.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
interface gigabitethernet interface-number
4.
service-policy output fragment-class-name
DETAILED STEPS
Examples
In the following example, policy map subscriber is configured with a fragment class named BE. The fragment is then configured as part of a policy map named aggregate-member-link. Policy map subscriber is then attached to the bundle subinterfaces while policy map aggregate-member-link is attached to the physical interface.
port-channel load-balancing vlan-manualclass-map match-all BestEffort!class-map match-all video!class-map match-all voice!policy-map subscriberclass voicepriority level 1class videopriority level 2class class-default fragment BEshape average 100000000bandwidth remaining ratios 80policy-map aggregate-member-linkclass BestEffort service-fragment BEshape average 100000000!interface Port-channel1ip address 172.1.2.3 255.255.0.0!interface Port-channel1.100encapsulation dot1Q 100ip address 173.1.2.100 255.255.255.0service-policy output subscriber!interface Port-channel1.200encapsulation dot1Q 200ip address 173.1.2.200 255.255.255.0service-policy output subscriber!interface Port-channel1.300encapsulation dot1Q 300ip address 173.1.2.300 255.255.255.0service-policy output subscriber!interface GigabitEthernet1/1/1no ip addresschannel-group 1 mode onservice-policy output aggregate-member-link!interface GigabitEthernet1/1/2no ip addresschannel-group 1 mode onservice-policy output aggregate-member-linkTroubleshooting Tips
Ensure the fragment-class-name is consistent across service-fragment and fragment class definitions.
What to Do Next
This is the final configuration step for configuring the QoS: Policies Aggregation feature on a Gigabit Etherchannel (GEC) bundle.
Configuration Examples for QoS: Policies Aggregation
This section contains the following examples:
•
QoS: Policies Aggregation: Example
•
Gigabit Etherchannel QoS: Policies Aggregation: Example
QoS: Policies Aggregation: Example
In the following example, QoS: Policies Aggregation is used to define a fragment class of traffic to classify default traffic using the default traffic class named BestEffort. All default traffic from the policy maps named subscriber1 and subscriber2 is part of the fragment default traffic class named BestEffort. This default traffic is then shaped collectively by creating a class called data that uses the service-fragment keyword and the shape command.
Note the following about this example:
•
The class-name for each fragment default traffic class is "BestEffort."
•
The class-name of "BestEffort" is also used to define the class where the service-fragment keyword is entered. This class applies a shaping policy to all traffic forwarded using the fragment default traffic classes named "BestEffort."
policy-map subscriber1 class voice set cos 5 priority level 1 class video set cos 4 priority level 2 class class-default fragment BestEffort shape average 200000000 bandwidth remaining ratio 10 policy-map subscriber 2 class voice set cos 5 priority level 1 class video set cos 4 priority level 2 class class-default fragment BestEffort shape average 200000000 bandwidth remaining ratio 10policy-map input_policyclass class-defaultset dscp defaultpolicy-map main-interfaceclass data service-fragment BestEffortshape average 400000000interface portchannel1.1001encapsulation dot1q 1001service-policy output subscriber1service-policy input input_policyinterface portchannel1.1002encapsulation dot1q 1002service-policy output subscriber2service-policy input input_policyinterface gigabitethernet 0/1 description member-link1port channel 1service-policy output main-interfaceinterface gigabitethernet 0/2description member-link2port channel 1service-policy output main-interface
Gigabit Etherchannel QoS: Policies Aggregation: Example
In the following example, policy map subscriber is configured with a fragment class named BE. The fragment is then configured as part of a policy map named aggregate-member-link. Policy map subscriber is then attached to the bundle subinterfaces while policy map aggregate-member-link is attached to the physical interface.
port-channel load-balancing vlan-manualclass-map match-all BestEffort!class-map match-all video!class-map match-all voice!policy-map subscriberclass voicepriority level 1class videopriority level 2class class-default fragment BEshape average 100000000bandwidth remaining ratios 80policy-map aggregate-member-linkclass BestEffort service-fragment BEshape average 100000000!interface Port-channel1ip address 172.1.2.3 255.255.0.0!interface Port-channel1.100encapsulation dot1Q 100ip address 173.1.2.100 255.255.255.0service-policy output subscriber!interface Port-channel1.200encapsulation dot1Q 200ip address 173.1.2.200 255.255.255.0service-policy output subscriber!interface Port-channel1.300encapsulation dot1Q 300ip address 173.1.2.300 255.255.255.0service-policy output subscriber!interface GigabitEthernet1/1/1no ip addresschannel-group 1 mode onservice-policy output aggregate-member-link!interface GigabitEthernet1/1/2no ip addresschannel-group 1 mode onservice-policy output aggregate-member-linkAdditional References
The following sections provide references related to the QoS: Policies Aggregation feature.
Related Documents
Related Topic Document TitleModular Quality of Service Command-Line Interface
Distribution of Remaining Bandwidth Using Ratio
Class-Based Shaping
Regulating Packet Flow on a Per-Class Basis — Using Class-Based Traffic Shaping
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
Command Reference
The following command is modified in the feature documented in this module. For information about these commands, see the Cisco IOS Quality of Service Command Reference at http://www.cisco.com/en/US/docs/ios/qos/command/reference/qos_book.html. For information about all Cisco IOS commands, use the Command Lookup Tool at http://tools.cisco.com/Support/CLILookup or the Cisco IOS Master Command List, All Releases, at http://www.cisco.com/en/US/docs/ios/mcl/allreleasemcl/all_book.html.
•
class (policy-map)
Feature Information for QoS: Policies Aggregation
Table 1 lists the release history for this feature.
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 and Catalyst OS 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 1 lists only the Cisco IOS software release that introduced support for a given feature in a given Cisco IOS software release train. Unless noted otherwise, subsequent releases of that Cisco IOS software release train also support that feature.
Glossary
fragment—A fragment is configuration option for default traffic classes within a policy map. A default traffic class configured as a fragment will later become part of a service fragment. Fragments allow multiple default traffic classes for multiple policy maps on the same interface to be classified collectively. Without fragments, each policy map has a single default traffic class that is only part of that policy map.
service fragment—A class definition statement within a policy map that specifies a class of traffic made up entirely of fragments.
CCDE, CCENT, Cisco Eos, Cisco Lumin, Cisco StadiumVision, the Cisco logo, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn is a service mark; and Access Registrar, Aironet, 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 Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, 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. (0804R)
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.
© 2008 Cisco Systems, Inc. All rights reserved.



