PPPoE Configuration

From GLUG-BOM

You are here : Main Page > Howtos > PPPoE Configuration

Contents 1 Introduction 2 LAN Cards 3 Configuration 3.1 Using pppoe 4 GUI Tools

Introduction

PPPoE (Point-to-Point Protocol over Ethernet) is a protocol used by many ADSL Internet Service Providers. This guide will help you to setup PPPoE access to Exatt / Worldnet / Zone.net on Debian based distros (including Ubuntu). If you use the RASPPPOE driver to get connected in Windows then this guide should work for you.

LAN Cards

The following Ethernet cards are known to work with linux:

• D-Link DFE-520TX
• D-Link DFE-530TX
• D-Link DFE-538TX
• If you are aware of any other cards then please add them to this list

Configuration

The first step is to setup your LAN interface (typically eth0). For this you can either use the command-line utility ifconfig or the GUI utility System > Administration > Network.

Next, we need to setup the PPPoE connection as follows:

Using pppoe

1. Install the Roaring Penguin package:

Debian users can install this package from the DVD using:

sudo apt-get install pppoe

Ubuntu doesn't include the package on the installation CD (as of 7.10). It can be downloaded from the universe repositories. Install the package using the command:

sudo dpkg -i pppoe_3.8-3_i386.deb

2. Search for Service Provider(s) by running:

sudo pppoe-discovery

If there are multiple service providers then make a note of the desired Access-Concentrator and Service-Name.

3. Run the pppoe configuration utility:

sudo pppoe-setup

1. Enter the username
2. Enter the ethernet interface (typically eth0)
3. Type "no" to set the link to stay up continuously. (Unless if you are using a limited-hours scheme)
4. If you know your DNS addresses enter them here.
5. Enter the password
6. Enter 0 for no firewall
7. Enter y to accept the settings

Note: You may get the error:
"Oh, dear, I don't see the file '/etc/ppp/pppoe.conf' anywhere"
As a workaround, create the file using the values from the sample pppoe.conf file

4. If you had discovered multiple service providers on your network, then you need to manually edit the pppoe configuration file to specify the desired service provider.

sudo vi /etc/ppp/pppoe.conf

Look for the lines containing the text "SERVICENAME=" and "ACNAME=". If these lines do not exist then append them to the file. For example, if your Access-Concentrator is "worldnet001" and Service-Name is "worldnet001" then the lines should look like:

ACNAME='worldnet001'
SERVICENAME='worldnet001'

You can also compare the other values with the ones from the sample pppoe.conf file

5. Start your pppoe connection using:

sudo pppoe-start

6. If you need to check the status of the connection you can use:

sudo pppoe-status

7. If you need to stop the connection you can use:

sudo pppoe-stop

8. To set the connection to be started every time the system is booted, add a line to the file rc.local:

sudo vi /etc/rc.local

Add the line 'pppoe-start' just before the line 'exit 0'

GUI Tools

PPPoE GUI Config (Downloads section)