VP/VC Shaping for PPPoEoA/PPPoA

The current Cisco ASR 1000 Series Aggregation Services Routers platform software supports virtual circuit (VC) shaping but not ATM virtual path (VP ) shaping for VCs with broadband sessions. This feature adds support for ATM VP shaping for VCs with underlying broadband sessions. Per VC and per VP traffic shaping controls or modifies the flow of traffic on an interface. Traffic shaping limits throughput by buffering excess traffic instead of dropping packets. It ensures that traffic from one VC does not adversely impact another VC, thus preventing loss of data. Providing traffic shaping on a per VC and per VP basis allows flexibility and control over every VC and VP configured.

The VP and VC Shaping for PPPoEoA and PPPoA feature is supported for the following ATM traffic service categories:
  • Variable bit rate Non-Real-Time (VBR-nRT)
  • Unspecified bit rate (UBR)

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.

Prerequisites for VP/VC Shaping for PPPoEoA/PPPoA

  • Dynamic changes to VP shaper rate should be enabled.

  • The ATM VC create-on-demand functionality (with the VP shaper configured) should be enabled.

  • PPP over Ethernet over ATM (PPPoEoA) sessions must be enabled.

Restrictions for VP/VC Shaping for PPPoEoA/PPPoA

  • All the VCs parented by a given VP with shaping applied must be of the same type. For example, if a VP shaper is applied to virtual path identifier (VPI) 10, all the virtual circuit identifiers (VCIs) with a VP of 10 must be vbr-nrt or all must be ubr+.

  • The atm pvp rate command cannot be added or removed if any of the VCs on that ATM interface that are in VP are in the active state. This is not supported in a nonbroadband configuration.

  • Configuration of Modular QoS CLI (MQC) policy maps on VPs is not supported. Only configuration of the VP rate using the atm pvp command is supported.

  • Quality of Service (QoS) on the VP and VC session is supported.

  • The sum of the VC shaper rates can oversubscribe the VP shaper rate configured.

  • The sum of all the VP shaper rates can oversubscribe the physical rate of the ATM interface.

  • VP shapers are supported for any combination of VCs with or without broadband sessions. They may or may not have queuing QoS policies attached.

  • On a given ATM interface, there may be mixed VPs with and without shapers.

  • When there are multiple VCs in a VP, class-of-service change is not allowed.

  • When there is only one VC in a VP, class-of-service change is allowed.

  • IP sessions and the existing Intelligent Services Gateway (ISG) on ATM functionality are supported.

Configuring VP/VC Shaping for PPPoEoA/PPPoA

Before You Begin

Before you configure VP/VC shaping for PPoEoA/PPPoA, ensure that you configure the ATM interface and define the attributes for each session. A broadband aggregation group (bba-group) configured on an ATM interface points to the virtual template the router will use to apply QoS policies to the sessions.

To configure VP/VC shaping for PPPoEoA/PPPoA on an ATM interface, perform the following configuration task.

SUMMARY STEPS

    1.    enable

    2.    configure terminal

    3.    interface atm slot/module/port

    4.    mac-address mac-address

    5.    no ip address

    6.    atm clock internal

    7.    atm oam flush

    8.    no atm ilmi-keepalive

    9.    exit

    10.    bba-group pppoe {group-name | global}

    11.    virtual-template template-number

    12.    sessions per-vc limit per-vc-limit [threshold threshold-value]

    13.    sessions per-mac limit per-mac-limit

    14.    sessions per-vlan limit per-vlan-limit

    15.    sessions per-vc throttle per-vc-throttle

    16.    exit

    17.    interface atm slot/subslot/port [subinterface][point-to-point | multipoint]

    18.    atm pvp vpi [peak-rate]

    19.    pvc vpi/vci

    20.    vbr-nrt output-pcr output-scr[output-maxburstsize]

    21.    dbs enable [aggregated | maximum]

    22.    encapsulation aal5snap

    23.    protocol pppoe group {group-name | global}

    24.    end


DETAILED STEPS
     Command or ActionPurpose
    Step 1 enable


    Example:
    Router> enable
     

    Enables the privileged EXEC mode.

    Enter your password if prompted.

     
    Step 2 configure terminal


    Example:
    Router# configure terminal
     

    Enters the global configuration mode.

     
    Step 3 interface atm slot/module/port


    Example:
    Router(config)# interface atm slot/module/port
     

    Creates or modifies an ATM interface. Enters the interface configuration mode. Here:

    slot/module/port is the interface number.

     
    Step 4 mac-address mac-address


    Example:
    Router(config-if)# mac-address mac-address
     

    Specifies the mac address for an interface.

     
    Step 5 no ip address


    Example:
    Router(config-if)# no ip address
     

    Disables IP processing on the interface by removing its IP address.

     
    Step 6 atm clock internal


    Example:
    Router(config-if)#atm clock internal
     

    Synchronizes the timer between two back-to-back ATM interfaces.

     
    Step 7 atm oam flush


    Example:
    Router(config-if)# atm oam flush
     

    Drops all the current and future Operation, Administration, and Maintenance (OAM) cells received on the ATM interface.

     
    Step 8 no atm ilmi-keepalive


    Example:
    Router(config-if)# no atm ilmi-keepalive
     

    Disables the Interim Local Management Interface (ILMI) keepalives.

     
    Step 9 exit


    Example:
    Router(config-if)# exit
     

    Exits the interface configuration mode.

     
    Step 10 bba-group pppoe {group-name | global}


    Example:
    Router(config)# bba-group pppoe group-name
     

    Defines a PPPoE profile, and enters the BBA group configuration mode.

    The global keyword creates a profile that serves as the default profile for any PPPoE port that is not assigned a specific profile.

     
    Step 11 virtual-template template-number


    Example:
    Router(config-bba-group)# virtual-template template-number
     

    Specifies which virtual template will be used to clone virtual access interfaces.

     
    Step 12 sessions per-vc limit per-vc-limit [threshold threshold-value]


    Example:
    Router(config-bba-group)# sessions per-vc limit per-vc-limit
     

    Specifies the maximum number of PPPoE sessions that can be established over an ATM permanent virtual circuit (PVC)

     
    Step 13 sessions per-mac limit per-mac-limit


    Example:
    Router(config-bba-group)# sessions per-mac limit per-mac limit
     

    Sets the maximum number of PPPoE sessions permitted per MAC address in a PPPoE profile.

     
    Step 14 sessions per-vlan limit per-vlan-limit


    Example:
    Router(config-bba-group)# sessions per-vlan limit per-vlan-limit
     

    Specifies the maximum number of PPPoE sessions permitted per VLAN in a PPPoE profile.

     
    Step 15 sessions per-vc throttle per-vc-throttle


    Example:
    Router(config-bba-group)# sessions per-vc throttle per-vc-throttle
     

    Configures PPPoE connection throttling, which limits the number of PPPoE session requests that can be made from a VC.

     
    Step 16 exit


    Example:
    Router(config-bba-group)# exit
     

    Exits the BBA group configuration mode and returns to the global configuration mode.

     
    Step 17 interface atm slot/subslot/port [subinterface][point-to-point | multipoint]


    Example:
    Router(config)# interface atm slot/subslot/port multipoint
     

    Configures the ATM interface and enters the subinterface configuration mode.

     
    Step 18 atm pvp vpi [peak-rate]


    Example:
    Router(config-subif)# atm pvp vpi[peak-rate]
     

    Creates a permanent virtual path (PVP) used to multiplex (or bundle) one or more VCs.

     
    Step 19 pvc vpi/vci


    Example:
    Router(config-subif)# atm pvp vpi[peak-rate]
     

    Creates or assigns a name to an ATM PVC and enters ATM virtual circuit configuration mode.

     
    Step 20 vbr-nrt output-pcr output-scr[output-maxburstsize]


    Example:
    Router(config-if-atm-vc)# vbr-nrt output-pcr output-scr [output-maxburstsize]
     

    Configures the VBR-nRT QoS and specifies output peak cell rate (PCR), output sustainable cell rate (SCR), and output maximum burst cell size for an ATM PVC, PVC range, switched virtual circuit (SVC), VC class, or VC bundle member.

     
    Step 21 dbs enable [aggregated | maximum]


    Example:
    Router(config-if-atm-vc)# dbs enable
     

    Applies the Dynamic Subscriber Bandwidth Selection QoS parameters.

     
    Step 22 encapsulation aal5snap


    Example:
    Router(config-if-atm-vc)# encapsulation aal5snap
     

    Configures the ATM adaptation layer (AAL) and encapsulation type for an ATM VC.

     
    Step 23 protocol pppoe group {group-name | global}

    Example:
    Router(config-if-atm-vc)# protocol pppoe group group-name
     

    Enables PPPoE sessions to be established on PVCs.

    group specifies a PPPoE profile (bba-group) to be used by the PPPoE sessions on the interface.

    group-name is the name of the PPPoE profile (bba-group) to be used by the PPPoE sessions on the interface.

    group group-name points to the bba-group to be used for applying a virtual template interface with QoS policies to sessions.

     
    Step 24 end


    Example:
    Router(config-if-atm-vc)# end
     

    Ends the session and returns to the privileged EXEC mode.

     

    Example

    The following example shows how to configure VP/VC shaping for PPPoEoA/PPPoA:

    Router(config)#interface ATM1/0/0
Router(config-if)#mac-address 0000.b001.0001
Router(config-if)#no ip address
Router(config-if)#atm clock INTERNAL
Router(config-if)#atm oam flush
Router(config-if)#no atm ilmi-keepalive
Router(config-if)#exit
Router(config)#bba-group pppoe group_basic
Router(config-bba-group)#virtual-template 2
Router(config-bba-group)#sessions per-vc limit 1
Router(config-bba-group)#sessions per-mac limit 1
Router(config-bba-group)#sessions per-vlan limit 1
Router(config-bba-group)#sessions per-vc throttle 1 2 3
Router(config-bba-group)#exit
Router(config)#interface ATM1/0/0.64001 multipoint
Router(config-subif)#atm pvp 1 50000
Router(config-subif)#pvc 1/32
Router(config-if-atm-vc)#vbr-nrt 40000 40000 1
Router(config-if-atm-vc)#dbs enable
Router(config-if-atm-vc)#encapsulation aal5snap
Router(config-if-atm-vc)#protocol pppoe group group_1
Router(config-if-atm-vc)#end

    Configuration Examples for VP/VC Shaping for PPPoEoA/PPPoA

    Example: Configuring VP/VC Shaping for PPPoEoA/PPPoA

    The following example shows how to configure VP/VC shaping for PPPoEoA/PPPoA:

    interface ATM1/0/0
mac-address 0000.b001.0001
no ip address
atm clock INTERNAL
atm oam flush
no atm ilmi-keepalive
!
bba-group pppoe group_basic
virtual-template 2
sessions per-vc limit 1
sessions per-mac limit 1
sessions per-vlan limit 1
sessions per-vc throttle 1 2 3
!
interface ATM1/0/0.1 multipoint
atm pvp 1 1000
pvc 1/10000
 vbr-nrt 500 500 1
 dbs enable
 encapsulation aal5snap
 protocol pppoe group group_basic

    Example: Verifying VP/VC Shaping for PPPoEoA/PPPoA

    The following example shows how to display configuration of a particular PVC.

    Router# Show ATM pvc
Keys:  A = ATM1/0/0, B = ATM1/0/1, C = ATM1/0/2, 
           VCD /                                            Peak Av/Min Burst
Interface  Name         VPI   VCI Type    Encaps     SC     Kbps   Kbps Cells St
A.64001    1              1     3 PVC     F4-OAM     UBR   50000              UP
A.64001    2              1     4 PVC     F4-OAM     UBR   50000              UP
A.64001    11             1    32 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    12             1    33 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    13             1    34 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    14             1    35 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    15             1    36 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    16             1    37 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    17             1    38 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    18             1    39 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    19             1    40 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    20             1    41 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    3              2     3 PVC     F4-OAM     UBR   50000              UP
A.64001    4              2     4 PVC     F4-OAM     UBR   50000              UP
A.64001    21             2    32 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    22             2    33 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    23             2    34 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    24             2    35 PVC     SNAP       VBR   40000  40000     1 UP

    The following example shows how to display configuration of the traffic parameters for a PVC.

    Router# Show ATM vc                      
Keys:  A = ATM1/0/0, B = ATM1/0/1, C = ATM1/0/2, 
Codes: DN - DOWN, IN - INACTIVE 

           VCD /                                            Peak Av/Min Burst
Interface  Name         VPI   VCI Type    Encaps     SC     Kbps   Kbps Cells St
A.64001    1              1     3 PVC     F4-OAM     UBR   50000              UP
A.64001    2              1     4 PVC     F4-OAM     UBR   50000              UP
A.64001    11             1    32 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    12             1    33 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    13             1    34 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    14             1    35 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    15             1    36 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    16             1    37 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    17             1    38 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    18             1    39 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    19             1    40 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    20             1    41 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    3              2     3 PVC     F4-OAM     UBR   50000              UP
A.64001    4              2     4 PVC     F4-OAM     UBR   50000              UP
A.64001    21             2    32 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    22             2    33 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    23             2    34 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    24             2    35 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    25             2    36 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    26             2    37 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    27             2    38 PVC     SNAP       VBR   40000  40000     1 UP
A.64001    28             2    39 PVC     SNAP       VBR   40000  40000     1 UP

    The following example shows how to display configuration for VP mode cell relay.

    Router# Show ATM vp
Keys:  A = ATM1/0/0, B = ATM1/0/1, C = ATM1/0/2, 
                             Data  CES    Peak     CES Avg/Min Burst     MCR
Interface     VPI SC          VCs  VCs    Kbps    Kbps    Kbps Cells    Kbps    CDVT  Status
A.64001         1 VBR-NRT      10    0   50000       0     N/A   N/A     N/A     N/A  ACTIVE  
A.64001         2 VBR-NRT      10    0   50000       0     N/A   N/A     N/A     N/A  ACTIVE  
A.64001         3 VBR-NRT      10    0   50000       0     N/A   N/A     N/A     N/A  ACTIVE  
A.64001         4 VBR-NRT      10    0   50000       0     N/A   N/A     N/A     N/A  ACTIVE  
A.64001         5 VBR-NRT      10    0   50000       0     N/A   N/A     N/A     N/A  ACTIVE  
B.64001         6 VBR-NRT      10    0   40000       0     N/A   N/A     N/A     N/A  ACTIVE  
B.64001         7 VBR-NRT      10    0   40000       0     N/A   N/A     N/A     N/A  ACTIVE  
B.64001         8 VBR-NRT      10    0   40000       0     N/A   N/A     N/A     N/A  ACTIVE  
B.64001         9 VBR-NRT      10    0   40000       0     N/A   N/A     N/A     N/A  ACTIVE  
B.64001        10 VBR-NRT      10    0   40000       0     N/A   N/A     N/A     N/A  ACTIVE  
C.64001        11 VBR-NRT      10    0   30000       0     N/A   N/A     N/A     N/A  ACTIVE  
C.64001        12 VBR-NRT      10    0   30000       0     N/A   N/A     N/A     N/A  ACTIVE  
C.64001        13 VBR-NRT      10    0   30000       0     N/A   N/A     N/A     N/A  ACTIVE  
C.64001        14 VBR-NRT      10    0   30000       0     N/A   N/A     N/A     N/A  ACTIVE  
C.64001        15 VBR-NRT      10    0   30000       0     N/A   N/A     N/A     N/A  ACTIVE

    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

    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 VP/VC Shaping for PPPoEoA/PPPoA

    Table 1 Feature Information for VP/VC Shaping for PPPoEoA/PPPoA

    Feature Name

    Releases

    Feature Information

    VP/VC Shaping for PPPoEoA/PPPoA

    Cisco IOS XE Release 3.10

    VP/VC Shaping for PPPoEoA/PPPoA enables ATM VP shaping for VCs with underlying broadband sessions.
    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)