- Read Me First
- Applying QoS Features Using the MQC
- 3-Level User-Defined Queuing Policy Support
- Configuring IP to ATM Class of Service
- Complex Hierarchical Scheduling: Fragmented Policies (i.e, Policies Aggregation)
- Legacy QoS Command Deprecation
- QoS Packet Marking
- QoS Packet-Matching Statistics Configuration
- Set ATM CLP Bit Using Policer
- EVC Quality of Service
- Quality of Service for Etherchannel Interfaces
- Aggregate EtherChannel Quality of Service
- PPPoGEC Per Session QoS
- IPv6 Selective Packet Discard
- Per ACE QoS Statistics
- Finding Feature Information
- IP to ATM CoS on a Single ATM VC Configuration Task List
- IP to ATM CoS on an ATM Bundle Configuration Task List
- Per-VC WFQ and CBWFQ Configuration Task List
- IP to ATM CoS Configuration Examples
Configuring IP to ATM Class of Service
This module describes the tasks for configuring the IP to ATM Class of Service (CoS), a feature suite that maps QoS characteristics between IP and ATM.
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.
- Finding Feature Information
- IP to ATM CoS on a Single ATM VC Configuration Task List
- IP to ATM CoS on an ATM Bundle Configuration Task List
- Per-VC WFQ and CBWFQ Configuration Task List
- IP to ATM CoS Configuration Examples
Finding Feature Information
Your software release may not support all the features documented in this module. For the latest caveats and feature information, see Bug Search Tool and 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 table.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.
IP to ATM CoS on a Single ATM VC Configuration Task List
To configure IP to ATM CoS for a single ATM virtual circuit (VC), perform the tasks described in the following sections. The tasks in the first two sections are required; the tasks in the remaining sections are optional.
The IP to ATM CoS feature requires ATM permanent virtual circuit (PVC) management.
- Defining the WRED Parameter Group
- Configuring the WRED Parameter Group
- Displaying the WRED Parameters
- Displaying the Queueing Statistics
Defining the WRED Parameter Group
Command |
Purpose |
---|---|
Router(config)# random-detect-group group-name |
Defines the WRED or VIP-distributed WRED (DWRED) parameter group. |
Configuring the WRED Parameter Group
1. Device(config)# random-detect-group group-name
2. Device(config)# exponential-weighting-constant exponent
3. Device(config)# precedence precedence min-threshold max-threshold mark-probability-denominator
DETAILED STEPS
Displaying the WRED Parameters
Command |
Purpose |
---|---|
Router# show queueing random-detect [interface atm_subinterface [vc [[vpi/] vci]]] |
Displays the parameters of every VC with WRED or DWRED enabled on the specified ATM subinterface. |
Displaying the Queueing Statistics
Command |
Purpose |
---|---|
Router# show queueing interface interface-number [vc [[vpi/] vci]] |
Displays the queueing statistics of a specific VC on an interface. |
IP to ATM CoS on an ATM Bundle Configuration Task List
To configure IP to ATM CoS on an ATM bundle, perform the tasks in the following sections.
The IP to ATM CoS feature requires ATM PVC management.
- Creating a VC Bundle
- Applying Bundle-Level Parameters
- Committing a VC to a Bundle
- Applying Parameters to Individual VCs
- Configuring a VC Not to Accept Bumped Traffic
- Monitoring and Maintaining VC Bundles and Their VC Members
Creating a VC Bundle
Command |
Purpose |
---|---|
Router(config-subif)# bundle bundle-name |
Creates the specified bundle and enters bundle configuration mode. |
Applying Bundle-Level Parameters
- Configuring Bundle-Level Parameters
- Configuring VC Class Parameters to Apply to a Bundle
- Attaching a Class to a Bundle
Configuring Bundle-Level Parameters
Configuring VC Class Parameters to Apply to a Bundle
Command |
Purpose |
||
---|---|---|---|
Router(config-vc-class)# oam-bundle [manage] [frequency] |
Enables end-to-end F5 OAM loopback cell generation and OAM management for all VCs in the bundle.
|
Attaching a Class to a Bundle
Command |
Purpose |
||
---|---|---|---|
(config-atm-bundle)# class-bundle vc-class-name |
Configures a bundle with the bundle-level commands contained in the specified VC class.
|
Committing a VC to a Bundle
Command |
Purpose |
---|---|
Device(config-atm-bundle)# pvc-bundle pvc-name [vpi/] [vci] |
Adds the specified VC to the bundle and enters bundle-vc configuration mode in order to configure the specified VC bundle member. |
Applying Parameters to Individual VCs
- Configuring a VC Bundle Member Directly
- Configuring VC Class Parameters to Apply to a VC Bundle Member
- Applying a VC Class to a Discrete VC Bundle Member
Configuring a VC Bundle Member Directly
Command |
Purpose |
---|---|
Device(config-if-atm-member)# ubr output-pcr [input-pcr] |
Configures the VC for unspecified bit rate (UBR) QoS and specifies the output peak cell rate (PCR) for it. |
Device(config-if-atm-member)# ubr+ output-pcr output-mcr [input-pcr] [input-mcr] |
Configures the VC for UBR QoS and specifies the output PCR and output minimum guaranteed cell rate for it. |
Device(config-if-atm-member)# vbr-nrt output-pcr output-scr output-mbs [input-pcr] [input-scr] [input-mbs] |
Configures the VC for variable bit rate nonreal-time (VBR-nrt) QoS and specifies the output PCR, output sustainable cell rate, and output maximum burst cell size for it. |
Device(config-if-atm-member)# precedence [other | range] |
Configures the precedence levels for the VC. |
Device(config-if-atm-member)# bump {implicit | explicit precedence-level | traffic} |
Configures the bumping rules for the VC. |
Device(config-if-atm-member)# protect {group | vc} |
Configures the VC to belong to the protected group of the bundle or to be an individually protected VC bundle member. |
Configuring VC Class Parameters to Apply to a VC Bundle Member
Command |
Purpose |
||
---|---|---|---|
Device(config-vc-class)# bump {implicit | explicit precedence-level | traffic} |
Specifies the bumping rules for the VC member to which the class is applied. These rules determine to which VC in the bundle traffic is directed when the carrier VC bundle member goes down.
|
||
Device(config-vc-class)# precedence precedence min-threshold max-threshold mark-probability-denominator |
Defines precedence levels for the VC member to which the class is applied. |
||
Device(config-vc-class)# protect {group | vc} |
Configures the VC as a member of the protected group of the bundle or as an individually protected VC. |
Applying a VC Class to a Discrete VC Bundle Member
Command |
Purpose |
---|---|
Device(config-if-atm-member)# class-vc vc-class -name |
Assigns a VC class to a VC bundle member. |
Configuring a VC Not to Accept Bumped Traffic
Command |
Purpose |
---|---|
Device(config-if-atm-member)# no bump traffic
|
Configures the VC not to accept any bumped traffic that would otherwise be redirected to it. |
Monitoring and Maintaining VC Bundles and Their VC Members
Command |
Purpose |
---|---|
Device# show atm bundle bundle-name |
Displays the bundle attributes assigned to each bundle VC member and the current working status of the VC members. |
Device# show atm bundle bundle-name statistics [detail] |
Displays statistics or detailed statistics on the specified bundle. |
Device# show atm map
|
Displays a list of all configured ATM static maps to remote hosts on an ATM network and on ATM bundle maps. |
Device# debug atm bundle errors
|
Displays information on bundle errors. |
Device# debug atm bundle events
|
Displays a record of bundle events. |
Per-VC WFQ and CBWFQ Configuration Task List
To configure IP to ATM CoS for per-VC WFQ and CBWFQ, perform the tasks described in the following sections.
The IP to ATM CoS feature requires ATM PVC management.
- Configuring Class-Based Weighted Fair Queueing
- Attaching a Service Policy and Enabling CBWFQ for a VC
- Configuring a VC to Use Flow-Based WFQ
- Monitoring per-VC WFQ and CBWFQ
- Enabling Logging of Error Messages to the Console
Configuring Class-Based Weighted Fair Queueing
Before configuring CBWFQ for a VC, you must perform the following tasks using standard CBWFQ commands:
Create one or more classes to be used to classify traffic sent across the VC
Define a policy-map containing the classes to be used as the service policy
Note | You can configure class policies for as many classes as are defined on the router, up to the maximum of 64. However, the total amount of bandwidth allocated for all classes included in a policy-map to be attached to a VC must not exceed 75 percent of the available bandwidth of the VC. The remaining 25 percent of available bandwidth is used for encapsulation, such as the ATM cell overhead (also referred to as ATM cell tax), routing and best-effort traffic, and other functions that assume overhead. For more information on bandwidth allocation, see the "Congestion Management Overview" module. |
Because CBWFQ gives you minimum bandwidth guarantee, you can only apply CBWFQ to VCs having these classes of service: available bit rate (ABR) and variable bit rate (VBR). You cannot apply per-VC WFQ and CBWFQ to UBR and unspecified bit rate plus (UBR+) VCs because both of these service classes are best-effort classes that do not guarantee minimum bandwidth. When CBWFQ is enabled for a VC, all classes configured as part of the service policy are installed in the fair queueing system.
In addition to configuring CBWFQ at the VC level, the IP to ATM CoS feature allows you to configure flow-based WFQ at the VC level. Because flow-based WFQ gives you best-effort class of service--that is, it does not guarantee minimum bandwidth--you can configure per-VC WFQ for all types of CoS VCs: ABR, VBR, UBR, and UBR+.
Per-VC WFQ uses the class-default class. Therefore, to configure per-VC WFQ, you must first create a policy-map and configure the class-default class. (You need not create the class-default class, which is predefined, but you must configure it.) For per-VC WFQ, the class-default class must be configured with the fair-queue policy-map class configuration command.
In addition to configuring the fair-queue policy-map class configuration command, you can configure the default class with either the queue-limit command or the random-detectcommand, but not both. Moreover, if you want the default class to use flow-based WFQ, you cannot configure the default class with the bandwidth policy-map class configuration command--to do so would disqualify the default class as flow-based WFQ, and therefore limit application of the service policy containing the class to ABR and VBR VCs.
Attaching a Service Policy and Enabling CBWFQ for a VC
- Attaching a Policy-Map to a Standalone VC and Enabling CBWFQ
- Attaching a Policy-Map to an Individual VC and Enabling CBWFQ
Attaching a Policy-Map to a Standalone VC and Enabling CBWFQ
Command |
Purpose |
---|---|
Router(config-if-atm-vc)# service-policy output policy-map |
Enables CBWFQ and attaches the specified service policy-map to the VC being created or modified. |
Attaching a Policy-Map to an Individual VC and Enabling CBWFQ
Command |
Purpose |
---|---|
Router(config-if-atm-member)# service-policy output policy-map |
Enables CBWFQ and attaches the specified service policy-map to the VC being created or modified. |
Note | The service-policy output and random-detect-group commands are mutually exclusive; you cannot apply a WRED group to a VC for which you have enabled CBWFQ through application of a service policy. Moreover, before you can configure one command, you must disable the other if it is configured. |
Configuring a VC to Use Flow-Based WFQ
1. Device(config)# policy-map policy-map
2. Device(config-pmap)# class class-default default-class-name
3. Device(config-pmap-c)# fair-queue number-of-dynamic-queues
DETAILED STEPS
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 | Device(config)# policy-map policy-map |
Specifies the name of the policy-map to be created or modified. | ||
Step 2 | Device(config-pmap)# class class-default default-class-name |
Specifies the default class so that you can configure or modify its policy.
| ||
Step 3 | Device(config-pmap-c)# fair-queue number-of-dynamic-queues |
Specifies the number of dynamic queues to be reserved for use by flow-based WFQ running on the default class.
| ||
Step 4 | Do one of the following: |
Specifies the maximum number of packets that can be queued for the class. Enables WRED. The class policy will drop packets using WRED instead of tail drop. |
Attaching a Policy-Map to a Standalone VC and Enabling WFQ
Command |
Purpose |
---|---|
Device(config-if-atm-vc)# service-policy output policy-map |
Enables WFQ for the VC by attaching the specified policy-map containing the class-default class to the VC being created or modified. |
Attaching a Policy-Map to an Individual VC and Enabling WFQ
Command |
Purpose |
---|---|
Device(config-if-atm-member)# service-policy output policy-map |
Enables WFQ for the VC bundle member by attaching the specified policy-map containing the class-default class to the VC bundle member. |
Monitoring per-VC WFQ and CBWFQ
Command |
Purpose |
---|---|
Device# show policy-map interface interface-number [vc [vpi/] vci]] |
Displays the contents of packets inside a queue for a particular interface or VC. |
Enabling Logging of Error Messages to the Console
Command |
Purpose |
---|---|
Router(config)# logging console level |
Limits messages logged to the console based on severity. |
IP to ATM CoS Configuration Examples
- Example Single ATM VC with WRED Group and IP Precedence
- Example VC Bundle Configuration Using a VC Class
- Example Per-VC WFQ and CBWFQ on a Standalone VC
- Example Per-VC WFQ and CBWFQ on Bundle-Member VCs
Example Single ATM VC with WRED Group and IP Precedence
The following example creates a PVC on an ATM interface and applies the WRED parameter group called sanjose to that PVC. Next, the IP Precedence values are configured for the WRED parameter group sanjose.
interface ATM1/1/0.46 multipoint ip address 200.126.186.2 255.255.255.0 no ip mroute-cache shutdown pvc 46 encapsulation aal5nlpid random-detect attach sanjose ! random-detect-group sanjose precedence 0 200 1000 10 precedence 1 300 1000 10 precedence 2 400 1000 10 precedence 3 500 1000 10 precedence 4 600 1000 10 precedence 5 700 1000 10 precedence 6 800 1000 10 precedence 7 900 1000 10
Example VC Bundle Configuration Using a VC Class
This example configures VC bundle management on a router that uses Intermediate System-to-Intermediate System (IS-IS) as its IP routing protocol.
- Bundle-Class Class
- Control-Class Class
- Premium-Class Class
- Priority-Class Class
- Basic-Class Class
- new-york Bundle
- san-francisco Bundle
- los-angeles Bundle
Bundle-Class Class
At the outset, this configuration defines a VC class called bundle-class that includes commands that set VC parameters. When the class bundle-class is applied at the bundle level, these parameters are applied to all VCs that belong to the bundle. Note that any commands applied directly to an individual VC of a bundle in bundle-vc mode take precedence over commands applied globally at the bundle level. Taking into account hierarchy precedence rules, VCs belonging to any bundle to which the class bundle-class is applied will be characterized by these parameters: aal5snap encapsulation, broadcast on, use of Inverse Address Resolution Protocol (ARP) to resolve IP addresses, and operation, administration, and maintenance (OAM) enabled.
router isis net 49.0000.0000.0000.1111.00 vc-class atm bundle-class encapsulation aal5snap broadcast protocol ip inarp oam-bundle manage 3 oam retry 4 3 10
The following sections of the configuration define VC classes that contain commands specifying parameters that can be applied to individual VCs in a bundle by assigning the class to that VC.
Control-Class Class
When the class called control-class is applied to a VC, the VC carries traffic whose IP Precedence level is 7. When the VC to which this class is assigned goes down, it takes the bundle down with it because this class makes the VC a protected one. The QoS type of a VC using this class is vbr-nrt.
vc-class atm control-class precedence 7 protect vc vbr-nrt 10000 5000 32
Premium-Class Class
When the class called premium-class is applied to a VC, the VC carries traffic whose IP Precedence levels are 6 and 5. The VC does not allow other traffic to be bumped onto it. When the VC to which this class is applied goes down, its bumped traffic will be redirected to a VC whose IP Precedence level is 7. This class makes a VC a member of the protected group of the bundle. When all members of a protected group go down, the bundle goes down. The QoS type of a VC using this class is vbr-nrt.
vc-class atm premium-class precedence 6-5 no bump traffic protect group bump explicitly 7 vbr-nrt 20000 10000 32
Priority-Class Class
When the class called priority-class is applied to a VC, the VC is configured to carry traffic with IP Precedence in the 4-2 range. The VC uses the implicit bumping rule, it allows traffic to be bumped, and it belongs to the protected group of the bundle. The QoS type of a VC using this class is ubr+.
vc-class atm priority-class precedence 4-2 protect group ubr+ 10000 3000
Basic-Class Class
When the class called basic-class is applied to a VC, the VC is configured through the precedence other command to carry traffic with IP Precedence levels not specified in the profile. The VC using this class belongs to the protected group of the bundle. The QoS type of a VC using this class is ubr.
vc-class atm basic-class precedence other protect group ubr 10000
The following sets of commands configure three bundles that the router subinterface uses to connect to three of its neighbors. These bundles are called new-york, san-francisco, and los-angeles. Bundle new-york has four VC members, bundle san-francisco has four VC members, and bundle los-angeles has three VC members.
new-york Bundle
The first part of this example specifies the IP address of the subinterface, the router protocol--the router uses IS-IS as an IP routing protocol--and it creates the first bundle called new-york and enters bundle configuration mode:
interface atm 1/0.1 multipoint ip address 10.0.0.1 255.255.255.0 ip router isis bundle new-york
From within bundle configuration mode, the next portion of the configuration uses two protocol commands to enable IP and Open Systems Interconnect (OSI) traffic flows in the bundle. The OSI routing packets will use the highest precedence VC in the bundle. The OSI data packets, if any, will use the lowest precedence VC in the bundle. If configured, other protocols, such as IPX or AppleTalk, will always use the lowest precedence VC in the bundle.
As the indentation levels of the preceding and following commands suggest, subordinate to bundle new-york is a command that configures its protocol and a command that applies the class called bundle-class to it.
protocol ip 1.1.1.2 broadcast protocol clns 49.0000.0000.2222.00 broadcast class-bundle bundle-class
The class called bundle-class, which is applied to the bundle new-york, includes a protocol ip inarp command. According to inheritance rules, protocol ip, configured at the bundle level, takes precedence over protocol ip inarp specified in the class bundle-class.
The next set of commands beginning with pvc-bundle ny-control 207, which are further subordinate, add four VCs (called ny-control, ny-premium, ny-priority, and ny-basic) to the bundle new-york. A particular class--that is, one of the classes predefined in this configuration example--is applied to each VC to configure it with parameters specified by commands included in the class.
As is the case for this configuration, to configure individual VCs belonging to a bundle, the router must be in bundle mode for the mother bundle. For each VC belonging to the bundle, the subordinate mode is pvc-mode for the specific VC.
The following commands configure the individual VCs for the bundle new-york:
pvc-bundle ny-control 207 class-vc control-class pvc-bundle ny-premium 206 class-vc premium-class pvc-bundle ny-priority 204 class-vc priority-class pvc-bundle ny-basic 201 class-vc basic-class
san-francisco Bundle
The following set of commands create and configure a bundle called san-francisco. At the bundle configuration level, the configuration commands included in the class bundle-class are ascribed to the bundle san-francisco and to the individual VCs that belong to the bundle. Then, the pvc-bundle command is executed for each individual VC to add it to the bundle. After a VC is added and bundle-vc configuration mode is entered, a particular, preconfigured class is assigned to the VC. The configuration commands comprising that class are used to configure the VC. Rules of hierarchy apply at this point. Command parameters contained in the applied class are superseded by the same parameters applied at the bundle configuration level, which are superseded by the same parameters applied directly to a VC.
bundle san-francisco protocol clns 49.0000.0000.0000.333.00 broadcast inarp 1 class-bundle bundle-class pvc-bundle sf-control 307 class-vc control-class pvc-bundle sf-premium 306 class-vc premium-class pvc-bundle sf-priority 304 class-vc priority-class pvc-bundle sf-basic 301 class-vc basic-class
los-angeles Bundle
The following set of commands create and configure a bundle called los-angeles. At the bundle configuration level, the configuration commands included in the class bundle-class are ascribed to the bundle los-angeles and to the individual VCs that belong to the bundle. Then, the pvc-bundle command is executed for each individual VC to add it to the bundle. After a VC is added and bundle-vc configuration mode is entered, precedence is set for the VC and the VC is either configured as a member of a protected group (protect group) or as an individually protected VC. A particular class is then assigned to each VC to further characterize it. Rules of hierarchy apply. Parameters of commands applied directly and discretely to a VC take precedence over the same parameters applied within a class to the VC at the bundle-vc configuration level, which take precedence over the same parameters applied to the entire bundle at the bundle configuration level.
bundle los-angeles protocol ip 1.1.1.4 broadcast protocol clns 49.0000.0000.4444.00 broadcast inarp 1 class-bundle bundle-class pvc-bundle la-high 407 precedence 7-5 protect vc class-vc premium-class pvc-bundle la-mid 404 precedence 4-2 protect group class-vc priority-class pvc-bundle la-low 401 precedence other protect group class-vc basic-class
Example Per-VC WFQ and CBWFQ on a Standalone VC
The following example creates two class maps and defines their match criteria. For the first map class, called class1, the numbered access control list (ACL) 101 is used as the match criterion. For the second map class called class2, the numbered ACL 102 is used as the match criterion.
Next, the example includes these classes in a policy-map called policy1. For class1, the policy includes a minimum bandwidth allocation request of 500 kbps and maximum packet count limit of 30 for the queue reserved for the class. For class2, the policy specifies only the minimum bandwidth allocation request of 1000 kbps, so the default queue limit of 64 packets is assumed. Note that the sum of the bandwidth requests for the two classes comprising policy1 is 75 percent of the total amount of bandwidth (2000 kbps) for the PVC called cisco to which the policy-map is attached.
The example attaches the policy-map called policy1 to a PVC. Once the policy-map policy1 is attached to the PVC, its classes constitute the CBWFQ service policy for that PVC. Packets sent on this PVC will be checked for matching criteria against ACLs 101 and 102 and classified accordingly.
Because the class-default command is not explicitly configured for this policy-map, all traffic that does not meet the match criteria of the two classes comprising the service policy is handled by the predefined class-default class, which provides best-effort flow-based WFQ.
class-map class1 match access-group 101 class-map class2 match access-group 102 policy-map policy1 class class1 bandwidth 500 queue-limit 30 class class2 bandwidth 1000 interface ATM1/1/0.46 multipoint ip address 200.126.186.2 255.255.255.0 pvc 46 vbr-nrt 2000 2000 encap aal5snap service policy output policy1
Example Per-VC WFQ and CBWFQ on Bundle-Member VCs
The following example shows a PVC bundle called san-francisco with members for which per-VC WFQ and CBWFQ are enabled and service policies configured. The example assumes that the classes included in the following policy-maps have been defined and that the policy-maps have been created: policy1, policy2, and policy4. For each PVC, the IP to ATM CoS pvc-bundle command is used to specify the PVC to which the specified policy-map is to be attached.
Note that PVC 0/34 and 0/31 have the same policy-map attached to them, policy2. Although you can assign the same policy-map to multiple VCs, each VC can have only one policy-map attached at an output PVC.
bundle san-francisco protocol ip 1.0.2.20 broadcast encapsulation aal5snap pvc-bundle 0/35 service policy output policy1 vbr-nrt 5000 3000 500 precedence 4-7 pvc-bundle 0/34 service policy output policy2 vbr-nrt 5000 3000 500 precedence 2-3 pvc-bundle 0/33 vbr-nrt 4000 3000 500 precedence 2-3 service policy output policy4 pvc-bundle 0/31 service policy output policy2