QoS Hierarchical Queueing for ATM DSLAMs

Last Updated: December 9, 2011

This feature module describes how to configure quality of service (QoS) hierarchical queueing policy maps on sessions and ATM VCs in ATM Digital Subscriber Line Access Multiplexer (A-DSLAM) applications on a Cisco ASR 1000 Series Aggregation Services Router.

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 Table at the end of this document.

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.

Prerequisites for QoS Hierarchical Queueing for ATM DSLAMs

You must configure traffic classes using the class-map command.

Restrictions for QoS Hierarchical Queueing for ATM DSLAMs

The QoS Hierarchical Queueing for ATM DSLAMs feature is not supported in combination with load balancing when a session service policy is routed to a Layer 2 Tunnel Protocol (L2TP) tunnel. This feature is supported only with shaped ATM VCs, which means ATM VCs that are defined as constant bit rate (CBR), Variable bit rate (VBR) or shaped unspecified bit rate (UBR), (that is, UBR with a peak cell rate).

Information About QoS Hierarchical Queueing for ATM DSLAMs

Different Levels of QoS Provisioning

Traffic downstream from a Broadband Router Access Server (BRAS) requires different levels of QoS provisioning (for example, traffic shaping) depending on the network architecture between the BRAS and the subscriber. The figure below illustrates an ATM DSL access network. The sample network includes multiple entities where QoS provisioning is required for different reasons.

Figure 1 ATM DSL Access Network


Integrated Queueing Hierarchy

Different traffic shaping requirements result in QoS provisioning at multiple levels at the same time. The QoS-Hierarchical Queueing for ATM DSLAMs feature provides the ability to form one integrated queueing hierarchy that provides QoS provisioning at multiple levels with support for features such as bandwidth distribution at any of these levels.

The integrated queueing hierarchy is formed on the physical interface. When a service policy is instantiated on a session, the Subscriber Service Switch (SSS) infrastructure invokes the Modular QoS CLI (MQC) and a common queueing control plane sets up and enables the queueing features.

Session-to-ATM associations are resolved to determine the ATM VC on which the session QoS queues are built. QoS policies consisting of a shaper may also be applied simultaneously at the VC level.

Configuration Guidelines for Hierarchical Queueing on ATM DSLAMs

When configuring the QoS Hierarchical Queueing for ATM DSLAMs feature, note the following guidelines:

  • When an ATM VC is used to aggregate a number of sessions with queueing policies, a queueing policy at an ATM VC level must be a one-level policy map that is configured as class-default with only the shape feature enabled.
  • Both ATM VCs and sessions can be oversubscribed and controlled by shapers.

How to Configure QoS Hierarchical Queueing for ATM DSLAMs

Configuring and Applying QoS Hierarchical Queueing Policy Maps to Sessions

SUMMARY STEPS

1.    enable

2.    configure terminal

3.    policy-map policy-map-name

4.    class class-map-name

5.    bandwidth {bandwidth-kbps | percentpercentage| remainingpercentpercentage}

6.    exit

7.    exit

8.    policy-map policy-map-name

9.    class class-default

10.    shape average {cir| percentpercentage}

11.    bandwidth remaining ratio ratio

12.    service-polic ypolicy-map-name

13.    exit

14.    exit

15.    interface virtual-template number

16.    service-policy output policy-map-name

17.    end


DETAILED STEPS
  Command or Action Purpose
Step 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
policy-map policy-map-name


Example:

Router(config)# policy-map session-a-child

 

Creates a child policy and enters policy-map configuration mode.

  • Enter the policy-map name.
 
Step 4
class class-map-name


Example:

Router(config-pmap)# class voip

 

Configures the traffic class that you specify and enters policy-map class configuration mode.

  • Enter the name of a previously configured class map .
 
Step 5
bandwidth {bandwidth-kbps | percentpercentage| remainingpercentpercentage}

Example:

Router(config-pmap-c)# bandwidth 10000



Example:

 

(Optional) Enables class-based weighted fair queueing based on the keywords and arguments specified.

  • bandwidth-kbps--Specifies the minimum bandwidth allocated for a class belonging to a policy map. Valid values are from 1 to 2,000,000.
  • percent percentage--Specifies the minimum percentage of the link bandwidth allocated for a class belonging to a policy map. Valid values are from 1 to 100.
  • remaining percent percentage--Specifies the minimum percentage of unused link bandwidth allocated for a class belonging to a policy map. Valid values are from 1 to 99.
 
Step 6
exit


Example:

Router(config-pmap-c)# exit

 

Exits policy-map class configuration mode.

 
Step 7
exit


Example:

Router(config-pmap)# exit

 

Exits policy-map configuration mode.

 
Step 8
policy-map policy-map-name


Example:

Router(config)# policy-map session_a_parent

 

Creates a parent policy and enters policy-map configuration mode.

  • Enter the policy-map name.
 
Step 9
class class-default


Example:

Router(config-pmap)# class class-default

 

Configures the traffic class as class-default and enters policy-map class configuration mode.

Note    Do not configure any other traffic class.
 
Step 10
shape average {cir| percentpercentage}


Example:

Router(config-pmap-c)# shape average 10000000

 

Specifies average-rate traffic shaping for all traffic that does not match any other traffic class.

  • Enter the average keyword followed by the committed information rate (CIR), in bits per second (bps), or enter the average keyword followed by percentage keyword to specify a percentage of the interface bandwidth for the CIR. Valid values are from 1 to 100.
 
Step 11
bandwidth remaining ratio ratio


Example:

Router(config-pmap-c)# bandwidth remaining ratio 10

 

Specifies the weight (ratio) for the ATM VC.

  • Enter the relative weight of this ATM VC (or class queue). This number (ratio) indicates the proportional relationship between the other ATM VCs or class queues.
 
Step 12
service-polic ypolicy-map-name


Example:

Router(config-pmap-c)# service-policy session-a-child

 

Applies the child policy map to the parent class-default class.

  • Enter the name of a previously configured child policy map.
 
Step 13
exit


Example:

Router(config-pmap-c)# exit

 

Exits policy-map class configuration mode.

 
Step 14
exit


Example:

Router(config-pmap)# exit

 

Exits policy-map configuration mode.

 
Step 15
interface virtual-template number


Example:

Router(config)# interface virtual-template 1

 

Creates a virtual template and enters interface configuration mode.

  • Enter the virtual template number. Valid range is from 1 to 4095.
 
Step 16
service-policy output policy-map-name


Example:

Router(config-if)# service-policy output session_a_parent

 

Applies the service policy to the virtual interface.

  • Enter the name of the previously configured parent policy map.
Note    You must specify the output keyword to apply the service policy to outbound traffic on the interface.
 
Step 17
end


Example:

Router(config-if)# end

 

(Optional) Returns to privileged EXEC mode.

 

Examples

The following is an example of how to configure and apply a QoS hierarchical queueing policy map to PPP/IP sessions by using a virtual template: 

Router> enable 
Router# configure terminal 
Router(config)# policy-map session-a-child 
Router(config-pmap)# class voip 
Router(config-pmap-c)# police 1000000 
Router(config-pmap-c)# priority level 1
Router(config-pmap-c)# exit
Router(config-pmap)# class video 
Router(config-pmap-c)# police 100000 
Router(config-pmap-c)# priority level 2 
Router(config-pmap-c)# exit
Router(config-pmap)# class precedence_0 
Router(config-pmap-c)# bandwidth remaining ratio 10 
Router(config-pmap-c)# exit
Router(config-pmap)# class precedence_1 
Router(config-pmap-c)# bandwidth remaining ratio 20 
Router(config-pmap-c)# exit 
Router(config-pmap)# exit 
Router(config)# policy-map session_a_parent 
Router(config-pmap-c)# exit
Router(config-pmap)# class class-default 
Router(config-pmap-c)# shape average 10000000 
Router(config-pmap-c)# bandwidth remaining ratio 10 
Router(config-pmap-c)# service-policy session-a-child 
Router(config-pmap-c)# exit 
Router(config-pmap)# exit 
Router(config)# interface virtual-template 20 
Router(config-if)# service-policy output session_a_parent 
Router(config-if)# end

Configuring and Applying QoS Hierarchical Queueing Policy Maps to ATM VCs

SUMMARY STEPS

1.    enable

2.    configure terminal

3.    policy-map policy-map-name

4.    class class-default

5.    shape average {cir| percentpercentage}

6.    exit

7.    exit

8.    interface type slot/subslot/port.subinterface

9.    pvc [name] vpi/vci [ces | ilmi | qsaal | smds| l2transport]

10.    vbr-nrt peak-cell-rate average-cell-rate

11.    service-policy output policy-map-name

12.    end


DETAILED STEPS
  Command or Action Purpose
Step 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
policy-map policy-map-name


Example:

Router(config)# policy-map subint-1

 

Creates a policy map and enters policy-map configuration mode.

  • policy-map-name--The name of the policy map.
 
Step 4
class class-default


Example:

Router(config-pmap)# class class-default

 

Configures the traffic class as class-default and enters policy-map class configuration mode.

  • Do not configure any other traffic class.
Note    When an ATM VC aggregates a number of sessions with queueing policies, a queueing policy at an ATM VC level must be a one-level policy map that is configured as class-default.
 
Step 5
shape average {cir| percentpercentage}


Example:

Router(config-pmap-c)# shape average 10000000

 

Specifies average-rate traffic shaping for all traffic that does not match any other traffic class.

  • Enter the average keyword followed by the CIR, in bps or enter the average keyword followed by percentage keyword to specify a percentage of the interface bandwidth for the CIR. Valid values are from 1 to 100.
Note    When an ATM VC aggregates a number of sessions with queueing policies, a queueing policy at an ATM VC level must be a one-level policy map with only the shape feature enabled.
 
Step 6
exit


Example:

Router(config-pmap-c)# exit

 

Exits policy-map class configuration mode.

 
Step 7
exit


Example:

Router(config-pmap)# exit

 

Exits policy-map configuration mode.

 
Step 8
interface type slot/subslot/port.subinterface

Example:

Router(config)# interface ATM 3/1/1.1

 

Specifies the ATM VC on which you are attaching the policy map and enters ATM VC configuration mode.

  • Enter the interface type and slot number, subslot number, port number, and ATM VC number.
 
Step 9
pvc [name] vpi/vci [ces | ilmi | qsaal | smds| l2transport]

Example:

Router(config-if-atm-vc)# pvc 2/100

 

Selects the ATM VC to which the service policy is to be applied.

 
Step 10
vbr-nrt peak-cell-rate average-cell-rate


Example:

Router(config-if-atm-vc)# vbr-nrt 800000 800000

 

Sets the VC type to VBR with a peak and average cell rate.

 
Step 11
service-policy output policy-map-name


Example:

Router(config-subif)# service-policy output subint-1

 

Attaches the service policy to the ATM VC.

  • policy-map-name--The name of the previously configured policy map.
Note    You must specify the output keyword to apply the service policy to outbound traffic on the ATM VC.
 
Step 12
end


Example:

Router(config-subif)# end

 

(Optional) Returns to privileged EXEC mode.

 

Examples

The following is an example of how to configure and apply a QoS hierarchical queueing policy map to an ATM VC (and provide aggregate shaping for a large number of subscribers): 

Router> enable 
Router# configure terminal
Router(config)# policy-map subint-1
Router(config-pmap)# class class-default
Router(config-pmap-c)# shape average 10000000
Router(config-pmap-c)# exit 
Router(config-pmap)# exit 
Router(config)# interface ATM 3/1/1.1
Router(config-if-atm-vc)# pvc 2/100
Router (config-if-atm-vc)# vbr-nrt 800000 800000
Router(config-subif)# service-policy output subint-1
Router(config-subif)# end

Displaying Policy-Map Information for Hierarchical Queueing

SUMMARY STEPS

1.    enable

2.    show policy-map

3.    show policy-map interface type number

4.    show policy-map session

5.    exit


DETAILED STEPS
  Command or Action Purpose
Step 1
enable


Example:

Router> enable

 

Enables privileged EXEC mode.

  • Enter your password if prompted.
 
Step 2
show policy-map


Example:

Router# show policy-map

 

(Optional) Displays all information for all class maps.

 
Step 3
show policy-map interface type number


Example:

Router# show policy-map interface ATM 4/0/0.1

 

(Optional) Displays the packet statistics of all classes that are configured for all service policies either on the specified interface or ATM VC or on a specific PVC on the interface.

  • Enter the interface type and number.
 
Step 4
show policy-map session


Example:

Router# show policy-map session

 

(Optional) Displays the QoS policy map in effect for the SSS session.

 
Step 5
exit


Example:

Router# exit

 

(Optional) Exits privileged EXEC mode.

 

Configuration Examples for QoS Hierarchical Queueing for ATM DSLAMs

Example Policy Maps on Sessions

The following example shows how to configure and apply QoS hierarchical queueing policy maps on sessions. A child queueing policy is applied to each parent subscriber line level policy.

Router> enable
Router# configure terminal
Router(config)# policy-map service-a-out
Router(config-pmap)# class voip
Router(config-pmap-c)# priority
Router(config-pmap-c)# set cos 1
Router(config-pmap-c)# exit
Router(config-pmap)# class video
Router(config-pmap-c)# set cos 2
Router(config-pmap-c)# exit
Router(config-pmap)# class gaming
Router(config-pmap-c)# bandwidth remaining percent 80
Router(config-pmap-c)# set cos 3
Router(config-pmap-c)# exit
Router(config-pmap)# class class-default
Router(config-pmap-c)# bandwidth remaining percent 20
Router(config-pmap-c)# set cos 4
Router(config-pmap-c)# exit
Router(config-pmap)# exit
!
Router(config)# policy-map rate-1-service-a-out
Router(config-pmap)# class class-default
Router(config-pmap-c)# bandwidth remaining ratio 10
Router(config-pmap-c)# shape average 100000
Router(config-pmap-c)# service-policy service-a-out
Router(config-pmap-c)# exit
Router(config-pmap)# exit
!
Router(config)# policy-map rate-1-service-a-in
Router(config-pmap)# class voip
Router(config-pmap-c)# police percent 25
Router(config-pmap-c)# exit
Router(config-pmap)# class gaming
Router(config-pmap-c)# police percent 50
Router(config-pmap-c)# exit
Router(config-pmap)# class class-default
Router(config-pmap-c)# police percent 20
Router(config-pmap-c)# exit
Router(config-pmap)# exit
!
Router(config)# interface virtual-template 20
Router(config-if)# service-policy output rate-1-service-a-out
Router(config-if)# service-policy input rate-1-service-a-in
Router(config-if)# end

Example Policy Maps on Sessions with Aggregate Shaping

The following example shows how to configure and apply QoS hierarchical queueing policy maps on sessions with multiple PPP/IP sessions per subscriber line. In this example, queueing is configured as in previous example. The VC is configured as follows:

Router(config)# policy-map isp_A_out
Router(config-pmap)# class class-default
Router(config-pmap-c)# shape average 500000
Router(config-pmap-c)# exit
Router(config-pmap)# exit
Router(config)# interface ATM 1/0/0.1
Router(config-subif)# pvc 10/100
Router(config-if-atm-vc)# vbr-nrt 800000 800000
Router(config-if-atm-vc)# service-policy output isp-A-out
Router(config-if-atm-vc)# exit
Router(config-subif)# exit

Additional References

Related Documents

Related Topic

Document Title

QoS commands: complete command syntax, command modes, command history, defaults, usage guidelines, and examples

Cisco IOS Quality of Service Solutions Command Reference

Traffic shaping

"Regulating Traffic Flow Using Traffic Shaping" module

MQC

"Applying QoS Features Using the MQC" module

Standards

Standard

Title

No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.

--

MIBs

MIB

MIBs Link

No new or modified MIBs are supported by this feature, and support for existing MIBs has not been modified by this feature.

To locate and download MIBs for selected platforms, Cisco IOS XE Software releases, and feature sets, use Cisco MIB Locator found at the following URL:

http://www.cisco.com/go/mibs

RFCs

RFC

Title

No new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.

--

Technical Assistance

Description

Link

The Cisco Support and Documentation website provides online resources to download documentation, software, and tools. Use these resources to install and configure the software and to troubleshoot and resolve technical issues with Cisco products and technologies. Access to most tools on the Cisco Support and Documentation website requires a Cisco.com user ID and password.

http://www.cisco.com/cisco/web/support/index.html

Feature Information for QoS Hierarchical Queueing for ATM DSLAMs

The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.

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.

Table 1 Feature Information for QoS Hierarchical Queueing for ATM DSLAMs

Feature Name

Releases

Feature Information

QoS Hierarchical Queueing for ATM DSLAMs

Cisco IOS XE Release 2.4 Cisco IOS XE Release 2.5

This feature module describes how to configure QoS hierarchical queueing policy maps on sessions and ATM VCs in ATM Digital Subscriber Line Access Multiplexer (A-DSLAM) applications.

This feature was implemented on Cisco ASR 1000 Series Aggregation Services Routers.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned 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. (1110R)

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

© 2011 Cisco Systems, Inc. All rights reserved.