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

 
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 

interface type slot/port

Example:

Router(config)# interface gigabitethernet 9/5

Configures an interface type and enters interface configuration mode.

Step 4 

policy-map policy-map-name

Example:

Router(config-if)# policy-map abc

Creates a policy map and enters policy-map configuration mode

Step 5 

class class-default

Example: 
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]

Example:

Router(config-pmap-c)# shape average cir 256000

Specifies average or peak rate traffic shaping.

Step 7 

interface type slot/port

Example:

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

Example: 
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  

end
Example: 
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

 
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  

service-group service-group-identifier
Example: 
Router(config)# service-group 1

Creates a service group

Step 4 

service-policy {input | output} policy-map-name

Example: 
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

Example:

Router(config-service-group)# interface gigabitethernet 9/5

Configures an interface type and enters interface configuration mode.

Step 6  

group service-group-identifier
Example:

Router(config-if)# group 1

Adds a member to a service group.

Step 7  

end
Example: 
Router(config)# end

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

 
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 

show policy-map interface type number service group service-group-identifier

Example: 
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
Example:

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 

group 1 

 

 interface gigabitethernet 1/1/1 

  group 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 

ip subscriber routed 

initiator unclassified ip-address

Examples: Configuring Minimum Bandwidth Guarantee 

policy-map group-policy 

class class-default 

bandwidth 256000 kbps 

service group 1 

service-policy output group-policy 

 

interface gigabitethernet 1/1/1

group 1

 

interface gigabitethernet 1/1

service instance 1 ethernet

group 1

or 

Router# show policy-map parent 


  policy Map parent

    class class-default

      bandwidth 256000 (kbps)

      service-policy child

 

Router# show policy-map child 


  Policy Map child

          class prec1

          band r r x


    class class-default

      bandwidth remaining ratio  y 

 

service group 1 

service-policy output parent

 

interface gigabitethernet 1/1/1

group 1

 

interface gigabitethernet 1/1

service instance 1 ethernet

group 1

Additional References

Related Documents

Related Topic
Document Title

Cisco IOS commands

Cisco IOS Master Commands List, All Releases

QoS commands

Cisco IOS QoS Command Reference


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 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 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 

Feature Name
Releases
Feature Information

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.