Contents

Port-Level Shaping and Minimum Bandwidth Guarantee

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

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

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

Configure port-level shaping to limit per-port bandwidth on service groups, EVCs, subinterfaces, and ISG sessions.


Note

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

        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

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

        Port-Level Shaping and Minimum Bandwidth Guarantee

        Contents

        Port-Level Shaping and Minimum Bandwidth Guarantee

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

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

        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

        Configure port-level shaping to limit per-port bandwidth on service groups, EVCs, subinterfaces, and ISG sessions.


        Note

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

              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

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