Port-Level Shaping and Minimum Bandwidth Guarantee
First Published: November 17, 2010
Last Updated: March 21, 2011
This document explains the Port-Level Shaping and Minimum Bandwidth Guarantee feature. The port-level shaping part of this feature allows you to configure a port-level shaper with policies on the following:
•Service groups
•Ethernet Virtual Connections (EVCs)
•Subinterfaces
•Intelligent Services Gateway (ISG) sessions
The minimum bandwidth guarantee part of this feature allows you to configure bandwidth guarantees in (Quality of Service) QoS policies on service groups.
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 Port-Level Shaping and Minimum Bandwidth Guarantee" section.
Use Cisco Feature Navigator to find information about platform support and Cisco 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 Port-Level Shaping and Minimum Bandwidth Guarantee
•Restrictions for Port-Level Shaping and Minimum Bandwidth Guarantee
•Information About Port-Level Shaping and Minimum Bandwidth Guarantee
•How to Configure Port-Level Shaping and Minimum Bandwidth Guarantee
•Configuration Examples for Port-Level Shaping and Minimum Bandwidth Guarantee
•Additional References
•Feature Information for Port-Level Shaping and Minimum Bandwidth Guarantee
Prerequisites for Port-Level Shaping and Minimum Bandwidth Guarantee
The Port-Level Shaping and Minimum Bandwidth Guarantee feature requires simultaneous policies on the main interface, service groups, EVCs, and subinterfaces.
Restrictions for Port-Level Shaping and Minimum Bandwidth Guarantee
Port-level policies are restricted to a "class-default with shaper only" policy if there are service group or EVC policies on the same port.
The minimum bandwidth guarantee configuration cannot be allowed at the same layer where service groups are configured using bandwidth remaining ratio (BRR).
The Port-Level Shaping and Minimum Bandwidth Guarantee feature indirectly sets the bandwidth for the default node; it works only in hierarchical queueing framework (HQF) two-parameter scheduling. It does not work with three-parameter scheduling.
Minimum bandwidth guarantee is not supported on the following:
•Subinterfaces
•Access subinterfaces
•ISG sessions
Information About Port-Level Shaping and Minimum Bandwidth Guarantee
•Hierarchical QoS
•Port-Level Shaping
•Minimum Bandwidth Guarantee
Hierarchical QoS
Hierarchical QoS (HQoS) redirects traffic from the service-group layer to another queue where shaping is applied. Port-level shaping occurs when traffic is directed to the default queue of the CLASS_LAYER. This CLASS_LAYER is built on top of the port.
When HQoS queueing policies are applied to service groups, an HQoS SG default queueing node is created at the service-group level for all traffic going through the HQoS service groups.
The port default node is used for:
•All traffic from EVCs and subinterfaces that are not part of a service group
•EVCs and subinterfaces that are part of service groups but do not have QoS
Port-Level Shaping
Port-level shaping shapes at the port level in the egress direction. You can limit per-port bandwidth in coexistence with four-level scheduling on the following:
•Service groups
•EVCs
•Subinterfaces
•ISG sessions
Port-level policy is attached to a port before service group or EVC policies are attached on that port.
Minimum Bandwidth Guarantee
You can configure the minimum bandwidth guarantee at the service-group level. This does the following:
•Allows bandwidth guarantees during times of traffic congestion
•Sets the remaining bandwidth for classes without a scheduler at the top level; this bandwidth is used as a parent scheduler reference for lower-level schedulers
•Allows you to implicitly configure default service group node bandwidth
How to Configure Port-Level Shaping and Minimum Bandwidth Guarantee
This section shows you how to use the Port-Level Shaping and Minimum Bandwidth Guarantee feature.:
•Configuring Port-Level Shaping (Required)
•Configuring Minimum Bandwidth Guarantees (Required)
•Verifying Port-Level Shaping and Minimum Bandwidth Guarantee (Required)
Configuring Port-Level Shaping
Configure port-level shaping to limit per-port bandwidth on service groups, EVCs, subinterfaces, and ISG sessions.
Restrictions
When configuring, apply the port-level shaper first, then apply QoS on the other end of the following:
•Service groups
•EVCs
•Subinterfaces
•ISG sessions
When removing, remove QoS on the other end first (service groups, EVCs, subinterfaces, ISG sessions), then remove the port-level shaper.
SUMMARY STEPS
1. enable
2. configure terminal
3. interface type slot/port
4. policy-map policy-map-name
5. class class-default
6. shape {average | peak} cir [bc] [be]
7. interface type slot/port
8. service-policy {input | output} policy-map-name
9. end
DETAILED STEPS
|
|
|
Step 1 |
enable
Router> enable |
Enables privileged EXEC mode. •Enter your password if prompted. |
Step 2 |
configure terminal
Router# configure terminal |
Enters global configuration mode. |
Step 3 |
interface type slot/port
Router(config)# interface gigabitethernet 9/5 |
Configures an interface type and enters interface configuration mode. |
Step 4 |
policy-map policy-map-name
Router(config-if)# policy-map abc |
Creates a policy map and enters policy-map configuration mode |
Step 5 |
class class-default
Router(config-pmap)# class class-default
|
Creates a traffic class nd enters policy-map class configuration mode. |
Step 6 |
shape {average | peak} cir [bc] [be]
Router(config-pmap-c)# shape average cir 256000 |
Specifies average or peak rate traffic shaping. |
Step 7 |
interface type slot/port
Router(config-pmap-c)# interface gigabitethernet 9/5 |
Configures an interface type and enters interface configuration mode. |
Step 8 |
service-policy {input | output} policy-map-name
Router(config-pmap-c)# service-policy output
abc
|
Attaches a policy map to a control plane for aggregate or distributed control plane services. |
Step 9 |
Router(config-pmap-c)# end
|
Exits policy-map class configuration mode and returns to privileged EXEC mode. |
Configuring Minimum Bandwidth Guarantees
Configure minimum bandwidth guarantee to set bandwidth guarantees in QoS policies on service groups.
SUMMARY STEPS
1. enable
2. configure terminal
3. service-group service-group-identifier
4. service-policy {input | output} policy-map-name
5. interface type slot/port
6. group service-group-identifier
7. end
DETAILED STEPS
|
|
|
Step 1 |
enable
Router> enable |
Enables privileged EXEC mode. •Enter your password if prompted. |
Step 2 |
configure terminal
Router# configure terminal |
Enters global configuration mode. |
Step 3 |
service-group service-group-identifier
Router(config)# service-group 1
|
Creates a service group |
Step 4 |
service-policy {input | output} policy-map-name
Router(config-service-group)# service-policy
output abc
|
Attaches a policy map to a control plane for aggregate or distributed control plane services. |
Step 5 |
interface type slot/port
Router(config-service-group)# interface gigabitethernet 9/5 |
Configures an interface type and enters interface configuration mode. |
Step 6 |
group service-group-identifier
Router(config-if)# group 1 |
Adds a member to a service group. |
Step 7 |
|
Exits interface configuration mode and returns to privileged EXEC mode. |
Verifying Port-Level Shaping and Minimum Bandwidth Guarantee
To ensure that you have properly configured port-level shaping and minimum bandwidth guarantee, do the following steps. You can enter the show commands in any order.
SUMMARY STEPS
1. enable
2. configure terminal
3. show policy-map interface type number service group service-group-identifier
4. show policy-map interface number service instance number
DETAILED STEPS
|
|
|
Step 1 |
enable
Router> enable |
Enables privileged EXEC mode. •Enter your password if prompted. |
Step 2 |
configure terminal
Router# configure terminal |
Enters global configuration mode. |
Step 3 |
show policy-map interface type number service group service-group-identifier
Router# show policy-map interface
gigabitEthernet 9/5 service group 1
|
Displays the policy-map information for service groups that have members attached to an interface. |
Step 4 |
show policy-map interface number service
instance number
Router# show policy-map interface port-channel 1 service instance 1 |
Displays the policy-map information for a given service instance under a port channel. |
Configuration Examples for Port-Level Shaping and Minimum Bandwidth Guarantee
The following examples show how to configure the Port-Level Shaping and Minimum Bandwidth Guarantee feature:
•Example: Configuring Port-Level Shaping for Service Groups
•Example: Configuring Port-Level Shaping for Subinterfaces
•Example: Configuring Port-Level Shaping for Subinterfaces
•Example: Configuring Port-Level Shaping for EVCs
•Example: Configuring Port-Level Shaping for ISG Sessions
•Examples: Configuring Minimum Bandwidth Guarantee
Example: Configuring Port-Level Shaping for Service Groups
interface gigabitethernet 1/1
service-policy output port-policy
service instance 1 ethernet
service-policy output member-policy
interface gigabitethernet 1/1/1
Example: Configuring Port-Level Shaping for Subinterfaces
interface gigabitethernet 1/1
service-policy output port-policy
interface gigabitethernet 1/1/1
service-policy output member-policy
Example: Configuring Port-Level Shaping for EVCs
interface gigabitethernet 1/1
service-policy output port-policy
service instance 1 ethernet
service-policy output member-policy
Example: Configuring Port-Level Shaping for ISG Sessions
policy-map type service hqos_dynamic
service-policy output member-policy
service-policy input member-policy
policy-map type control hqos-dynamic-control
class type control always event session-start
1 service-policy type service name hqos-dynamic
interface gigabitethernet 1/1
service-policy output port-policy
interface gigabitethernet 1/1/2 access
service-policy type control hqos-dynamic-control
initiator unclassified ip-address
Examples: Configuring Minimum Bandwidth Guarantee
service-policy output group-policy
interface gigabitethernet 1/1/1
interface gigabitethernet 1/1
service instance 1 ethernet
or
Router# show policy-map parent
Router# show policy-map child
bandwidth remaining ratio y
service-policy output parent
interface gigabitethernet 1/1/1
interface gigabitethernet 1/1
service instance 1 ethernet
Additional References
Related Documents
Standards
|
|
No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature. |
— |
MIBs
|
|
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 software releases, and feature sets, use Cisco MIB Locator found at the following URL: http://www.cisco.com/go/mibs |
RFCs
|
|
No new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature. |
|
Technical Assistance
|
|
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 Port-Level Shaping and Minimum Bandwidth Guarantee
Table 1 lists the features in this module and provides links to specific configuration information.
Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which 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 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.
Table 1 Feature Information for Port-Level Shaping and Minimum Bandwidth Guarantee
|
|
|
Port-Level Shaping and Minimum Bandwidth Guarantee |
15.1(1)S |
The port-level shaping part of this feature allows you to configure a port-level shaper with policies on the following: •Service groups •Ethernet Virtual Connections (EVCs) •Subinterfaces •Intelligent Services Gateway (ISG) sessions The minimum bandwidth guarantee part of this feature allows you to configure bandwidth guarantees in QoS policies on service groups. In Cisco IOS Release15.1(1)S, this feature was introduced on the Cisco 7600 Series Routers. The following sections provide information about this feature: •Information About Port-Level Shaping and Minimum Bandwidth Guarantee •How to Configure Port-Level Shaping and Minimum Bandwidth Guarantee |
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other countries. A listing of Cisco's trademarks can be found at 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. (1005R)
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.