Home | Skip to Content | Skip to Search | Skip to Navigation | Skip to Footer |
Worldwide [change] |Register |About Cisco
Guest

Hierarchical Navigation

Cisco IOS Software Releases 12.2 T

PPPoE Profiles

Downloads

Table Of Contents

PPPoE Profiles

Contents

Restrictions for PPPoE Profiles

Information About PPPoE Profiles

PPPoE Profiles

Benefits of PPPoE Profiles

PPPoE Circuit-ID Tag Processing

How to Configure PPPoE Profiles

Defining a PPPoE Profile

Assigning a PPPoE Profile to an Ethernet Interface

Assigning a PPPoE Profile to an ATM PVC

Assigning a PPPoE Profile to an ATM PVC Range and PVC-in-Range

Assigning a PPPoE Profile to an ATM VC Class

Configuring PPPoE Circuit-ID Tag Processing

Monitoring and Maintaining PPPoE Profiles

Configuration Examples for PPPoE Profiles

PPPoE Profiles Configuration Example

Additional References

Related Documents

Standards

MIBs

RFCs

Technical Assistance

Command Reference

ac name

bba-group pppoe

debug pppoe

encapsulation (ATM)

encapsulation dot1q

pppoe enable

protocol pppoe (ATM VC)

sessions max limit

sessions per-mac limit

sessions per-vc limit

sessions per-vlan limit

vendor-tag circuit-id service

vendor-tag circuit-id strip

virtual-template (BBA group)

Glossary


PPPoE Profiles

First Published: 12.2(15)T
Last Updated: February 28, 2006

The PPPoE Profiles feature introduces PPP over Ethernet (PPPoE) profiles, which contain configuration information for a group of PPPoE sessions. Multiple PPPoE profiles can be defined on a device, allowing different virtual templates and other PPPoE configuration parameters to be assigned to different Ethernet interfaces, VLANs, and ATM permanent virtual circuits (PVCs).

History for the PPPoE Profiles Feature

Release
Modification

12.2(15)T

This feature was introduced.

12.3(7)XI3

The PPPoE Circuit-ID Tag Processing feature was integrated into Cisco IOS Release 12.3(7)XI3.

12.2(28)SB

This feature was integrated into Cisco IOS Release 12.2(28)SB.


Finding Support Information for Platforms and Cisco IOS Software Images

Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at the login dialog box and follow the instructions that appear.

Contents

•Restrictions for PPPoE Profiles

•Information About PPPoE Profiles

•How to Configure PPPoE Profiles

•Configuration Examples for PPPoE Profiles

•Additional References

•Command Reference

•Glossary

Restrictions for PPPoE Profiles

The PPPoE Profiles feature separates the configuration of PPPoE from virtual private dial-up network (VPDN). The legacy method of configuring PPPoE in VPDN groups is still permitted, but you cannot configure PPPoE profiles and PPPoE in VPDN groups simultaneously.

If a PPPoE profile is assigned to a PPPoE port (Ethernet interface, VLAN, or PVC), virtual circuit (VC) class, or ATM PVC range and the profile has not yet been defined, the port, VC class, or range will not have any PPPoE parameters configured and will not use parameters from the global group.

PPPoE session limits cannot be configured both in PPPoE profiles and directly on PPPoE ports simultaneously.

Information About PPPoE Profiles

To configure the PPPoE Profiles feature, you should understand the following concepts:

•PPPoE Profiles

•Benefits of PPPoE Profiles

•PPPoE Circuit-ID Tag Processing

PPPoE Profiles

PPPoE profiles contain configuration information for PPPoE sessions. Once a profile has been defined, it can be assigned to a PPPoE port (Ethernet interface, VLAN, or PVC), a VC class, or an ATM PVC range. PPPoE profiles can also be used for PPPoE sessions established by PPPoA/PPPoE autosense. Multiple PPPoE profiles can be created and assigned to different ports. A global PPPoE profile can also be created; it serves as the default profile for any port that has not been assigned a specific PPPoE profile.

Benefits of PPPoE Profiles

Before the introduction of this feature, PPPoE parameters were configured within a VPDN group. Configuring PPPoE in a VPDN group limited PPPoE configuration options because only one PPPoE VPDN group with one virtual template is permitted on a device. The PPPoE Profiles feature provides simplicity and flexibility in PPPoE configuration by separating PPPoE from VPDN configuration. The PPPoE Profiles feature allows multiple PPPoE profiles, each with a different configuration, to be used on a single device.

PPPoE Circuit-ID Tag Processing

The PPPoE Circuit-ID Tag Processing feature enables Ethernet-based access network services by providing a mechanism for a PPPoE Broadband Remote Access Server (BRAS) to map a subscriber's circuit ID (that is, the line ID) to a specific Ethernet interface.

A Digital Subscriber Line Multiplexer (DSLAM) can be configured to insert a unique circuit-ID tag into a PPPoE Active Discovery Initiation/PPPoE Active Discovery Request (PADI/PADR) frame. You can create a PPPoE profile to enable the PPPoE BRAS to process the vendor tag to send the circuit-ID portion of the tag (as NAS-Port-ID attribute 87) to the RADIUS server in all authentication, authorization, and accounting (AAA) access and accounting requests. You can also create a PPPoE profile to strip the vendor tag from outgoing PPPoE Active Discovery Offer (PADO) and PPPoE Active Discovery Session (PADS) frames.

How to Configure PPPoE Profiles

This section contains the following procedures. The first is required, and any one of the next four is required.

•Defining a PPPoE Profile (required)

•Assigning a PPPoE Profile to an Ethernet Interface (optional)

•Assigning a PPPoE Profile to an ATM PVC (optional)

•Assigning a PPPoE Profile to an ATM PVC Range and PVC-in-Range (optional)

•Assigning a PPPoE Profile to an ATM VC Class (optional)

•Configuring PPPoE Circuit-ID Tag Processing (optional)

•Monitoring and Maintaining PPPoE Profiles (optional)

Defining a PPPoE Profile

Perform this task to define a PPPoE profile.

SUMMARY STEPS

1. enable

2. configure terminal

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

4. virtual-template template-number

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

6. sessions per-mac limit per-mac-limit

7. sessions per-vlan limit per-vlan-limit

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

9. ac name name

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

bba-group pppoe {group-name | global}

Example:

Router(config)# bba-group pppoe global

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

•The global keyword will create a profile that will serve as the default profile for any PPPoE port that is not assigned a specific 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 max limit number-of-sessions [threshold threshold-value]

Example:

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

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 an SNMP trap will be generated.

Note This command applies only to the global profile.

Step 6 

sessions per-mac limit per-mac-limit

Example:

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

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

Step 7 

sessions per-vlan limit per-vlan-limit

Example:

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

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

Step 8 

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

Example:

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

Sets the maximum number of PPPoE sessions permitted on a VC in a PPPoE profile, and sets the PPPoE session-count threshold at which an SNMP trap will be generated.

Step 9 

ac name name

Example:

Router(config-bba-group)# ac name user1

(Optional) Specifies the name of the access concentrator to be used in PPPoE Active Discovery Offers (PADO).

Step 10 

end

Example:

Router(config-bba-group)# end

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

Assigning a PPPoE Profile to an Ethernet Interface

Perform this task to assign a PPPoE profile to an Ethernet interface.

SUMMARY STEPS

1. enable

2. configure terminal

3. interface ethernet number

4. pppoe enable [group group-name]

5. 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 ethernet number

Example:

Router(config)# interface ethernet 0

Specifies an 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 an Ethernet interface or subinterface.

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

Step 5 

end

Example:

Router(config-if)# end

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

Assigning a PPPoE Profile to an ATM PVC

Perform this task to assign a PPPoE profile to an ATM PVC.

SUMMARY STEPS

1. enable

2. configure terminal

3. interface ATM number [point-to-point | multipoint]

4. pvc vpi/vci

5. protocol pppoe [group group-name]

or

encapsulation aal5autoppp virtual-template number [group group-name]

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 ATM number [point-to-point | multipoint]

Example:

Router(config)# interface atm 5/0.1 multipoint

Specifies an ATM interfaceor subinterface and enters interface configuration mode.

Step 4 

pvc vpi/vci

Example:

Router(config-if)# pvc 2/101

Creates an ATM PVC and enters ATM virtual circuit configuration mode.

Step 5 

protocol pppoe [group group-name]


or

encapsulation aal5autoppp virtual-template number [group group-name]

Example:

Router(config-if-atm-vc)# protocol pppoe group one


or

Example:

Router(config-if-atm-vc)# encapsulation aal5autoppp virtual-template 1 group one

Enables PPPoE sessions to be established on ATM PVCs.

or

Configures PPPoA/PPPoE autosense on the PVC.

Note If a PPPoE profile is not assigned to the PVC by using the group group-name option, the PVC will use the global PPPoE profile.

Step 6 

end

Example:

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

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

Assigning a PPPoE Profile to an ATM PVC Range and PVC-in-Range

Perform this task to assign a PPPoE profile to an ATM PVC range and PVC within a range.

SUMMARY STEPS

1. enable

2. configure terminal

3. interface atm number [point-to-point | multipoint]

4. range [range-name] pvc start-vpi/start-vci end-vpi/end-vci

5. protocol pppoe [group group-name]

or

encapsulation aal5autoppp virtual-template number [group group-name]

6. pvc-in-range [pvc-name] [[vpi/]vci]

7. protocol pppoe [group group-name]

or

encapsulation aal5autoppp virtual-template number [group group-name]

8. 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 atm number [point-to-point | multipoint]

Example:

Router(config)# interface atm 5/0.1 multipoint

Specifies an ATM interface or subinterface and enters interface configuration mode.

Step 4 

range [range-name] pvc start-vpi/start-vci end-vpi/end-vci

Example:

Router(config-if)# range range-one pvc 100 4/199

Defines a range of PVCs and enables PVC range configuration mode.

Step 5 

protocol pppoe [group group-name]


or

encapsulation aal5autoppp virtual-template number [group group-name]


Example:

Router(config-if-atm-range)# protocol pppoe group one


or

Example:

Router(config-if-atm-range)# encapsulation aal5autoppp virtual-template 1 group one

Enables PPPoE sessions to be established on a range of ATM PVCs.

or

Configures PPPoA/PPPoE autosense.

Note If a PPPoE profile is not assigned to the PVC range by using the group group-name option, the PVCs in the range will use the global PPPoE profile.

Step 6 

pvc-in-range [pvc-name] [[vpi/]vci]

Example:

Router(config-if-atm-range)# pvc-in-range pvc1 3/104

Defines an individual PVC within a PVC range and enters PVC-in-range configuration mode.

Step 7 

protocol pppoe [group group-name]


or

encapsulation aal5autoppp virtual-template number [group group-name]

Example:

Router(cfg-if-atm-range-pvc)# protocol pppoe group two


or

Example:

Router(cfg-if-atm-range-pvc)# encapsulation aal5autoppp virtual-template 1 group one

Enables PPPoE sessions to be established on a PVC within a range.

or

Configures PPPoA/PPPoE autosense.

Note If a PPPoE profile is not assigned to the PVC by using the group group-name option, the PVC will use the global PPPoE profile.

Step 8 

end

Example:

Router(cfg-if-atm-range-pvc)# end

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

Assigning a PPPoE Profile to an ATM VC Class

Perform this task to assign a PPPoE profile to an ATM VC class.

SUMMARY STEPS

1. enable

2. configure terminal

3. vc-class atm vc-class-name

4. protocol pppoe [group group-name]

or

encapsulation aal5autoppp virtual-template number [group group-name]

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

vc-class atm vc-class-name

Example:

Router(config)# vc-class atm class1

Creates an ATM VC class and enters ATM VC class configuration mode.

•A VC class can be applied to an ATM interface, subinterface, or VC.

Step 4 

protocol pppoe [group group-name]


or

encapsulation aal5autoppp virtual-template number [group group-name]

Example:

Router(config-vc-class)# protocol pppoe group two


or

Example:

Router(config-vc-class)# encapsulation aal5autoppp virtual-template 1 group one

Enables PPPoE sessions to be established.

or

Configures PPPoA/PPPoE autosense.

Note If a PPPoE profile is not assigned by using the group group-name option, the PPPoE sessions will be established with the global PPPoE profile.

Step 5 

end

Example:

Router(config-vc-class)# end

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

Configuring PPPoE Circuit-ID Tag Processing

Perform this task to configure a PPPoE server to process the vendor tag in an incoming PADI/PADR frame. This configuration enables the PPPoE server to send the circuit-ID part of the tag to a remote RADIUS server in AAA access and accounting requests. Optionally, you can configure the PPPoE server to remove the vendor tag in outgoing PPPoE Active Discovery Offer (PADO) and PPPoE Active Discovery Session (PADS) frames by using the vendor-tag circuit-id strip command.

SUMMARY STEPS

1. enable

2. configure terminal

3. bba-group pppoe [group-name]

4. vendor-tag circuit-id service

5. vendor-tag circuit-id strip

6. interface type number

7. encapsulation dot1Q vlan-id

8. pppoe-enable [group group-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 

bba-group pppoe [group-name]

Example:

Router(config)# bba-group pppoe pppoe-tag

Defines a PPPoE profile called "pppoe-tags" and enters BBA group configuration mode.

Step 4 

vendor-tag circuit-id service

Example:

Router(config-bba-group)# vendor-tag circuit-id service

Enables the PPPoE server to process the vendor tag in incoming frames and send the circuit-ID part of the tag to a remote RADIUS server in AAA access and accounting requests.

Step 5 

vendor-tag circuit-id strip

Example:

Router(config-bba-group)# vendor-tag circuit-id strip

(Optional) Enables the PPPoE server to remove the circuit-ID part of the vendor tag in outgoing PADO and PADS frames.

Step 6 

interface type number

Example:

Router(config-bba-group)# interface FastEthernet 0/0.1

Specifies a FastEthernet interface and enters subinterface configuration mode.

Step 7 

encapsulation dot1Q vlan-id

Example:

Router(config-subif)# encapsulation dot1Q 120

Enables IEEE 802.1Q encapsulation of traffic on the specified subinterface in a virtual LAN (VLAN), and defines the outer VLAN ID.

Step 8 

pppoe-enable [group group-name]

Example:

Router(config-subif)# pppoe enable group pppoe-tag

Enables PPPoE sessions on the Fast Ethernet interface or subinterface and assigns the "pppoe-tags" PPPoE profile.

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

Step 9 

end

Example:

Router(config-subif)# end

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

Monitoring and Maintaining PPPoE Profiles

Perform this task to monitor and maintain PPPoE profiles.

SUMMARY STEPS

1. enable

2. show pppoe session [all | packets]

3. clear pppoe {interface type number [vc {[vpi/]vci | vc-name}] | rmac mac-addr [sid session-id ] | all}

4. debug pppoe {data | errors | events | packets} [rmac remote-mac-address | interface type number [vc {[vpi/]vci | vc-name}]]

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Example:

Router> enable

Enables privileged EXEC mode.

•Enter your password if prompted.

Step 2 

show pppoe session [all | packets]

Example:

Router# show pppoe session all

Displays information about active PPPoE sessions.

Step 3 

clear pppoe {interface type number [vc {[vpi/]vci | vc-name}] | rmac mac-addr [sid session-id ] | all}

Example:

Router# clear pppoe interface atm0/1.0

Terminates PPPoE sessions.

Step 4 

debug pppoe {data | errors | events | packets} [rmac remote-mac-address | interface type number [vc {[vpi/]vci | vc-name}]]

Example:

Router# debug pppoe events

Displays debugging information for PPPoE sessions.

Configuration Examples for PPPoE Profiles

This section provides the following configuration example:

•PPPoE Profiles Configuration Example

PPPoE Profiles Configuration Example

The following example shows the configuration of three PPPoE profiles: "vpn1", "vpn2", and a global PPPoE profile. The profiles "vpn1" and "vpn2" are assigned to PVCs, VC classes, VLANs, and PVC ranges. Any Ethernet interface, VLAN, PVC, PVC range, or VC class that is configured for PPPoE but is not assigned either profile "vpn1" or "vpn2" (such as VC class "class-pppoe-global") will use the global profile. 

vpdn enable 

! 

vpdn-group 1 

 request-dialin 

  protocol l2tp 

  domain vpn1 

 initiate-to ip 10.12.1.64  priority 1 

 local name NAS1-1 

! 

vpdn-group 2 

 request-dialin 

  protocol l2tp 

  domain vpn2 

 initiate-to ip 10.12.2.64  priority 1 

 local name NAS1-2 

! 

virtual-template 1 pre-clone 20 

virtual-template 2 pre-clone 20 

! 

bba-group pppoe global 

 virtual-template 1 

 sessions max limit 8000 

 sessions per-vc limit 8 

 sessions per-mac limit 2 

! 

bba-group pppoe vpn1 

 virtual-template 1 

 sessions per-vc limit 2 

 sessions per-mac limit 1 

! 

bba-group pppoe vpn2 

 virtual-template 2 

 sessions per-vc limit 2 

 sessions per-mac limit 1 

! 

vc-class atm class-pppoe-global 

 protocol pppoe 

! 

vc-class atm class-pppox-auto 

 encapsulation aal5autoppp virtual-template 1 group vpn1 

! 

vc-class atm class-pppoe-1 

 protocol pppoe group vpn1 

! 

vc-class atm class-pppoe-2 

 protocol pppoe group vpn2 

! 

interface Loopback1 

 ip address 10.1.1.1 255.255.255.0 

! 

interface ATM1/0.10 multipoint 

 range range-pppoe-1 pvc 100 109 

  protocol pppoe group vpn1 

 ! 

interface ATM1/0.20 multipoint 

 class-int class-pppox-auto 

 pvc 0/200 

  encapsulation aal5autoppp Virtual-Template1 

 ! 

 pvc 0/201 

 ! 

 pvc 0/202 

  encapsulation aal5autoppp Virtual-Template1 group vpn2 

 ! 

 pvc 0/203 

  class-vc class-pppoe-global 

 ! 

! 

interface Ethernet2/3.1 

 encapsulation dot1Q 1 

 pppoe enable group vpn1 

! 

interface Ethernet2/3.2 

 encapsulation dot1Q 2 

 pppoe enable group vpn2 

! 

interface ATM6/0.101 point-to-point 

 ip address 10.12.1.63 255.255.255.0 

 pvc 0/101 

 ! 

interface ATM6/0.102 point-to-point 

 ip address 10.12.2.63 255.255.255.0 

 pvc 0/102 

 ! 

interface Virtual-Template1 

 ip unnumbered loopback 1 

 no logging event link-status 

 no keepalive 

 peer default ip address pool pool-1 

 ppp authentication chap 

! 

interface Virtual-Template2 

 ip unnumbered loopback 1 

 no logging event link-status 

 no keepalive 

 peer default ip address pool pool-2 

 ppp authentication chap 

! 

ip local pool pool-1 10.10.1.1 255.255.255.255 

ip local pool pool-2 10.10.2.1 255.255.255.255 

!

Additional References

The following sections provide references related to PPPoE Profiles:

Related Documents

Related Topic
Document Title

PPPoA/PPPoE configuration tasks

"Configuring Broadband Access: PPP and Routed Bridge Encapsulation" chapter in Cisco IOS Wide-Area Networking Configuration Guide, Release 12.2

PPPoA/PPPoE commands

"Broadband Access: PPP and Routed Bridge Encapsulation Commands" chapter in Cisco IOS Wide-Area Networking Command Reference, Release 12.2

PPPoA/PPPoE autosense configuration

"PPPoA/PPPoE Autosense for ATM PVCs" Cisco IOS Release 12.2(4)T feature module

ATM PVC range configuration tasks

"Configuring ATM" chapter in Cisco IOS Wide-Area Networking Configuration Guide, Release 12.2

ATM PVC range commands

"ATM Commands" chapter in Cisco IOS Wide-Area Networking Command Reference, Release 12.2


Standards

Standards
Title

RFC 2516

A Method for Transmitting PPP over Ethernet


MIBs

MIBs
MIBs Link

None

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

None

 

Technical Assistance

Description
Link

The Cisco Technical Support & Documentation website contains thousands of pages of searchable technical content, including links to products, technologies, solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access even more content.

http://www.cisco.com/techsupport


Command Reference

This section documents modified commands.

•ac name

•bba-group pppoe

•debug pppoe

•encapsulation (ATM)

•encapsulation dot1q

•pppoe enable

•protocol pppoe (ATM VC)

•sessions max limit

•sessions per-mac limit

•sessions per-vc limit

•sessions per-vlan limit

•vendor-tag circuit-id service

•vendor-tag circuit-id strip

•virtual-template (BBA group)

ac name

To specify the name of the access concentrator to be used in PPPoE Active Discovery Offers (PADO), use the ac name command in BBA group configuration mode. To remove this specification, use the no form of this command.

ac name name

no ac name name

Syntax Description

name

Name of the access concentrator to be used in PADOs.


Defaults

If the name of the access concentrator is not specified, the name of the router is used as the access concentrator name.

Command Modes

BBA group configuration

Command History

Release
Modification

12.2(15)T

This command was introduced.

12.3(7)XI3

This command was integrated into Cisco IOS Release 12.3(7)XI3.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Usage Guidelines

The ac name command allows you to advertise a unique access concentrator name other than the router name to PPPoE clients.

Examples

The following example shows the configuration of the name "region1" as the access concentrator name to be used in PADOs: 

bba-group pppoe global

 virtual-template 1

 ac name region1

Related Commands

Command
Description

bba-group pppoe

Creates a PPPoE profile.


bba-group pppoe

To create a PPP over Ethernet (PPPoE) profile, use the bba-group pppoe command in global configuration mode. To delete a PPPoE profile, use the no form of this command.

bba-group pppoe {group-name | global}

no bba-group pppoe {group-name | global}

Syntax Description

group-name

Name of the PPPoE profile.

global

PPPoE profile that serves as the default profile for any PPPoE port—Ethernet interface, VLAN, or permanent virtual circuit (PVC)—that has not been assigned a specific PPPoE profile.


Defaults

A PPPoE profile is not configured.

Command Modes

Global configuration

Command History

Release
Modification

12.2(15)T

This command was introduced.

12.3(7)XI3

This command was integrated into Cisco IOS Release 12.3(7)XI3.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Usage Guidelines

PPPoE profiles contain the configuration for a group of PPPoE sessions. Once a profile has been defined, it can be assigned to a PPPoE port (Ethernet interface, VLAN, or PVC), a virtual circuit (VC) class, or an ATM PVC range. PPPoE profiles can also be used with PPP over ATM (PPPoA)/PPPoE autosense. Multiple PPPoE profiles can be created and assigned to different ports.

The global PPPoE profile serves as the default profile for any port that has not been assigned a specific PPPoE profile.

Examples

The following example shows the configuration of a global PPPoE profile and a profile called "vpn1". PPPoE sessions established on PVCs that use the VC class "class-pppoe-global" will use the global profile. PVCs in the range "range-pppoe-1" will use the "vpn1" profile. 

bba-group pppoe global 

 virtual-template 1 

 sessions max limit 8000 

 sessions per-vc limit 8 

 sessions per-mac limit 2 

! 

bba-group pppoe vpn1 

 virtual-template 1 

 sessions per-vc limit 2 

 sessions per-mac limit 1 

! 

vc-class atm class-pppoe-global 

 protocol pppoe 

! 

interface ATM1/0.10 multipoint 

 range range-pppoe-1 pvc 100 109 

  protocol pppoe group vpn1 

!

interface ATM1/0.20 multipoint

 class-int class-pppoe-global

 pvc 0/200

Related Commands

Command
Description

encapsulation aal5autoppp virtual-template

Enables PPPoA/PPPoE autosense.

pppoe enable

Enables PPPoE sessions on an Ethernet interface or subinterface.

protocol pppoe (ATM VC)

Enables PPPoE sessions to be established on PVCs.

sessions max limit

Configures a PPPoE global profile with the maximum number of PPPoE sessions permitted on a router and sets the PPPoE session-count threshold.

sessions per-mac limit

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

sessions per-vc limit

Sets the maximum number of PPPoE sessions to be established over a VC and sets the PPPoE session-count threshold.

sessions per-vlan limit

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


debug pppoe

To display debugging information for PPP over Ethernet (PPPoE) sessions, use the debug pppoe command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug pppoe {data | errors | events | packets} [rmac remote-mac-address | interface type number [vc {[vpi/]vci | vc-name}] [vlan vlan-id]]

no debug pppoe {data | errors | events | packets} [rmac remote-mac-address | interface type number [vc {[vpi/]vci | vc-name}] [vlan vlan-id]]

Syntax Description

data

Displays data packets of PPPoE sessions.

errors

Displays PPPoE protocol errors that prevent a session from being established, or displays errors that cause an established session to be closed.

events

Displays PPPoE protocol messages about events that are part of normal session establishment or shutdown.

packets

Displays each PPPoE protocol packet that is exchanged.