Providing Session Limit Support

First Published: May 4, 2005
Last Updated: November 20, 2009

The PPP over Ethernet Session Limit feature enables you to limit the number of PPP over Ethernet (PPPoE) sessions that can be created on a router or on a Gigabit Ethernet interface for configuration.

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 Providing Session Limit Support" section.

Use Cisco Feature Navigator to find information about platform support and Cisco IOS and Catalyst OS 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

•Information About Providing Session Limit Support

•How to Provide Session Limit Support

•Configuration Examples for Providing Session Limit Support

•Additional References

•Feature Information for Providing Session Limit Support

Information About Providing Session Limit Support

To configure session limit support, you should understand the following concept:

•Benefits of Providing Session Limit Support

Benefits of Providing Session Limit Support

The PPPoE Session Limit feature prevents the router from using too much memory for virtual access by limiting the number of PPPoE sessions that can be created on a router or on all Ethernet interfaces and sub-interfaces as well as ATM interfaces and sub-interfaces.

How to Provide Session Limit Support

To configure PPPoE session limits, complete one or more of the following tasks:

•Specifying the Maximum Number of PPPoE Sessions on the Router (optional)

•Specifying the Maximum Number of PPPoE Sessions on a Gigabit Ethernet Interface (optional)

Specifying the Maximum Number of PPPoE Sessions on the Router

Perform this task to specify the maximum number of PPPoE sessions that can be created on a router.

SUMMARY STEPS

1. enable

2. configure terminal

3. bba-group pppoe {word | global}

4. virtual-template template-number

5. sessions per-mac limit per-mac-limit

6. sessions per-vlan limit per-vlan-limit [inner vlan-id]

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

8. sessions max limit number-of-sessions [threshold threshold-value]

9. exit

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 

bba-group pppoe {name | global}

Example:

Router(config)# bba-group pppoe global

Configures a BBA group to be used to establish PPPoE sessions and enters BBA group configuration mode.

•name—Identifies the broadband aggregation (BBA) group. You can have multiple BBA groups.

•global—PPPoE profile that serves as the default profile for any PPPoE port (Gigabit Ethernet interface or VLAN) that has not been assigned a specific PPPoE profile.

Step 4 

virtual-template template-number

Example:

Router(config-bba-group)# virtual-template 1

Specifies which virtual template will be used to clone virtual access interfaces for all PPPoE ports that use this PPPoE profile.

Step 5 

sessions per-mac limit per-mac-limit

Example:

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

(Optional) Sets the maximum number of PPPoE sessions allowed per MAC session limit in a PPPoE profile. The default is 100.

Step 6 

sessions per-vlan limit per-vlan-limit [inner vlan-id]

Example:

Router(config-bba-group)# session per-vlan limit 4000 inner 3500

(Optional) Sets the session limit for the inner VLAN on QinQ sub-interface. The default is 100.

Note The per-VLAN limit is only applicable to Gigabit Ethernet subinterfaces (802.1q VLANs).

Step 7 

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

Example:

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

(Optional) Sets the maximum number of PPPoE sessions allowed per VC session limit in a PPPoE profile. The default is 100.

Note The per-vc limit is applicable only to ATM interfaces and sub-interfaces.

Step 8 

sessions max limit number-of-sessions [threshold threshold-value]

Example:

Router(config-bba-group)# sessions max limit 32000

Configures the PPPoE global profile with the maximum number of PPPoE sessions that will be permitted on a router, and sets the PPPoE session-count threshold at which a Simple Network Management Protocol (SNMP) trap will be generated.

Note This command applies only to the global profile.

Step 9 

exit

Example:

Router(config-bba-group)# exit

Returns to global configuration mode.

Specifying the Maximum Number of PPPoE Sessions on a Gigabit Ethernet Interface

Perform this task to specify the maximum number of PPPoE sessions that can be created on a Gigabit Ethernet interface.

SUMMARY STEPS

1. enable

2. configure terminal

3. interface {GigabitEthernet | tenGigabitEthernet} slot/subslot/port[.subinterface]

4. pppoe enable [group group-name]

5. pppoe max-sessions number

6. 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 {GigabitEthernet | tenGigabitEthernet} slot/subslot/port[.subinterface]

Example:

Router(config)# interface GigabitEthernet0/0/1

Specifies a Gigabit Ethernet interface and enters interface configuration mode.

Step 4 

pppoe enable [group group-name]

Example:

Router(config-if)# pppoe enable group one

Enables PPPoE sessions on a Gigabit Ethernet interface or subinterface.

Note If a PPPoE profile is not assigned to the interface through use of the group group-name option, the interface will use the global PPPoE profile.

Step 5 

pppoe max-sessions number

Example:

Router(config-if)# pppoe max-sessions 10

Specifies the maximum number of PPPoE sessions permitted on the interface or subinterface. The default value is 100.

Step 6 

end

Example:

Router(config-if)# end

(Optional) Exits the configuration mode and returns to privileged EXEC mode.

Configuration Examples for Providing Session Limit Support

This section provides the following configuration examples:

•Specifying the Maximum Number of PPPoE Sessions on a Router: Example

•Specifying the Maximum Number of PPPoE Sessions on a Gigabit Ethernet Interface: Example

Specifying the Maximum Number of PPPoE Sessions on a Router: Example

The following example shows a limit of 32,000 PPPoE sessions configured for the router: 

bba-group pppoe global

  virtual-template 1

  sessions per-mac limit 1000

  sessions per-vlan limit 4000 inner 3500

  sessions per-vc limit 2000

Specifying the Maximum Number of PPPoE Sessions on a Gigabit Ethernet Interface: Example

The following example shows a limit of ten PPPoE sessions on the Gigabit Ethernet interface: 

interface GigabitEthernet1/0/0

  pppoe enable

  pppoe max-sessions 10

The following example shows a limit of ten PPPoE sessions on the Gigabit Ethernet subinterface using the encapsulation command: 

interface GigabitEthernet0/0/0.1

  encapsulation dot1q 2 

  pppoe enable

  pppoe max-sessions 10

Additional References

The following sections provide references related to supporting session limits.

Related Documents

Related Topic
Document Title

Broadband access aggregation of PPPoE sessions

Understanding Broadband Access Aggregation

Task for preparing for broadband access aggregation

Preparing for broadband access aggregation

Broadband access commands: complete command syntax, command mode, command history, defaults, usage guidelines, and examples

Cisco IOS Broadband Access Aggregation and DSL Command Reference

Additional information about commands used in this document

Cisco IOS Master Command List, All Releases


Standards

Standards
Title

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

—


MIBs

MIBs
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 releases, and feature sets, use Cisco MIB Locator found at the following URL:

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


RFCs

RFCs
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 website provides extensive online resources, including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies.

To receive security and technical information about your products, you can subscribe to various services, such as the Product Alert Tool (accessed from Field Notices), the Cisco Technical Services Newsletter, and Really Simple Syndication (RSS) Feeds.

Access to most tools on the Cisco Support website requires a Cisco.com user ID and password.

http://www.cisco.com/techsupport


Feature Information for Providing Session Limit Support

Table 1 lists the features in this module and provides links to specific configuration information. Only features that were introduced or modified in Cisco IOS Releases 12.2(1) or 12.0(3)S or a later release appear in the table.

Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which Cisco IOS and Catalyst OS 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 Cisco IOS software release that introduced support for a given feature in a given Cisco IOS software release train. Unless noted otherwise, subsequent releases of that Cisco IOS software release train also support that feature.

Table 1 Feature Information for Providing Session Limit Support 

Feature Name
Releases
Feature Information

PPP over Ethernet (PPPoE) Session Limit

12.2(1)DX
12.2(2)DD
12.2(4)B
12.2(4)T
15.0(1)M
12.2(33)SRE

The PPP over Ethernet (PPPoE) Session Limit feature enables you to limit the number of PPPoE sessions that can be created on a router or on a Gigabit Ethernet interface for configuration.

The following sections provide information about this feature:

•Information About Providing Session Limit Support

•How to Provide Session Limit Support

The following commands were introduced or modified:

sessions per-mac limit, sessions per-vlan limit, sessions per-vc limit, sessions max limit, pppoe max-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)

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
© 2005-2009 Cisco Systems, Inc. All rights reserved.