Differences between revisions 4 and 14 (spanning 10 versions)
Revision 4 as of 2007-02-25 22:10:53
Size: 1740
Editor: EddyPetrisor
Comment: PPPoE out of the box
Revision 14 as of 2019-10-18 16:31:41
Size: 3177
Editor: ?ReinerHerrmann
Comment: fix link to install guide
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= What is PPPoE? = #language en
Line 3: Line 3:
["PPPoE"] is short for ["PPP"] over ["Ethernet"]. ##TRANSLATION-HEADER-START
||<tablestyle="width: 100%;" style="border: 0px hidden">~-[[DebianWiki/EditorGuide#translation|Translation(s)]] : English - [[it/PPPoE|Italiano]] - [[fr/PPPoE|Français]] - [[ru/PPPoE|Русский]] -~||<style="text-align: right;border: 0px hidden"> (!) [[/Discussion|Discussion]]||
##TRANSLATION-HEADER-END
----
Line 5: Line 8:
It was put in use by internet providers and is amazingly annoying because of how it caught PPP implementations off guard (which were usually restricted to serial ports and subsequentially modems). PPPoE, Point-to-Point Protocol over Ethernet, is a network protocol for encapsulating Point-to-Point Protocol ([[PPP]]) frames inside Ethernet frames. It is used mainly with ADSL services where individual users connect to the ADSL transceiver (modem) over Ethernet and in plain Metro Ethernet networks. (more on [[WikiPedia:Point-to-Point_Protocol_over_Ethernet|Wikipedia]]).
Line 7: Line 10:
= Installing from the start a PPPoE enabled system = == Installing Debian from the start a PPPoE enabled system ==
Line 9: Line 12:
Debian Installer, starting with February 2007 supports installing a system via PPPoE and will configure the system accordingly. At the regular Debian Installer boot line just append ''modules=ppp-udeb'' (e.g.: type "installgui modules=ppp-udeb" to start a graphical installation via PPPoE). Debian Installer, starting with February 2007 supports installing a system via PPPoE and will configure the system accordingly. At the regular Debian Installer boot line just append {{{modules=ppp-udeb}}} (e.g.: type {{{installgui modules=ppp-udeb}}} to start a graphical installation via PPPoE).
Line 11: Line 14:
More information in the [http://d-i.alioth.debian.org/manual/en.i386/apds05.html corresponding chapter in the Installation Guide]. More information in the ''Installation Guide'', chapter ''[[http://www.debian.org/releases/stable/i386/apds05.en.html|Installing Debian GNU/Linux using PPP over Ethernet (PPPoE)]]''.
Line 13: Line 16:
= How to make it work = == How to enable PPPoE for an already installed system ==
Line 15: Line 18:
In order to make PPPoE run on a Debian station you must follow the following steps: In order to make PPPoE run on a Debian station you should follow the following steps:
Line 17: Line 20:
  * ppp and pppoe support enabled (module or built-in)
  * ethernet driver for the interface on which you expect to connect using PPPoE
 * install pppoeconf (it will pull pppoe and ppp)
 * run pppoeconf and read the instructions given and follow them ('''note: the password will be shown in plain text''')
  * ppp and pppoe support enabled (module or built-in). Kernels compiled by Debian have them.
  * Ethernet driver for the interface on which you expect to connect using PPPoE
 * install DebPkg:pppoeconf (it will pull DebPkg:ppp and optionally DebPkg:pppoe )
 * Run {{{pppoeconf}}} to generate and/or modify {{{/etc/ppp/peers/dsl-provider}}}, {{{/etc/ppp/*ap-secrets}}} files and {{{/etc/network/interfaces}}}. <<BR>> It is best, in most cases, to keep the suggested answers
Line 22: Line 25:
If everything went fine, now you should be able to browse.  {{{
auto eth0
iface eth0 inet manual
Line 24: Line 29:
auto dsl-provider
iface dsl-provider inet ppp
pre-up /sbin/ifconfig eth0 up
provider dsl-provider
}}}
Line 25: Line 35:
= Notes = ==== PPPoE with kernelspace pppoe driver ====
Line 27: Line 37:
 * If the name server information is not taken from the pppoe data, you will have to insert yourself that data in /etc/resolv.conf
 * It is best, in most cases, to keep the suggested answers
 * PPPoE has seen working for Debian GNU/Linux Sarge and later. It appears that it runs fine on Debian GNU/Linux Woody, too.
 * Documentation on how to use the kernel module without rp-pppoe can be found at /usr/share/doc/ppp/examples/peers-pppoe
pppoeconf try to load pppoe kernel module ({{{modprobe -q pppoe}}}). If there is a file {{{/proc/net/pppoe}}}, configuration will be in "kernel_mode". It's the case for a large majority of users because standard Debian installation have a kernel with pppoe compiled in module.
 {{{
plugin rp-pppoe.so eth0
}}}

 * Documentation on how to use the kernel module without rp-pppoe can be found at [[http://sysinf0.klabs.be/usr/share/doc/ppp/examples/peers-pppoe?dist=etch|/usr/share/doc/ppp/examples/peers-pppoe]].

''I have found it necessary to add the --clamp-mss-to-pmtu option in my firewall to avoid problems accessing certain websites.<<BR>>-- MichaelSoulier <<DateTime(2010-10-15T13:50:24Z)>>''

==== PPPoE with userspace pppoe driver ====
Alternatively, user-space agent DebPkg:pppoe can be used.
 {{{
pty "pppoe -I eth0 -T 80 -m 1452"
}}}

== Notes ==
 * If the name server information is not taken from the pppoe data, you will have to insert yourself that data in {{{/etc/resolv.conf}}}

Translation(s) : English - Italiano - Français - Русский

(!) ?Discussion


PPPoE, Point-to-Point Protocol over Ethernet, is a network protocol for encapsulating Point-to-Point Protocol (PPP) frames inside Ethernet frames. It is used mainly with ADSL services where individual users connect to the ADSL transceiver (modem) over Ethernet and in plain Metro Ethernet networks. (more on Wikipedia).

Installing Debian from the start a PPPoE enabled system

Debian Installer, starting with February 2007 supports installing a system via PPPoE and will configure the system accordingly. At the regular Debian Installer boot line just append modules=ppp-udeb (e.g.: type installgui modules=ppp-udeb to start a graphical installation via PPPoE).

More information in the Installation Guide, chapter Installing Debian GNU/Linux using PPP over Ethernet (PPPoE).

How to enable PPPoE for an already installed system

In order to make PPPoE run on a Debian station you should follow the following steps:

  • install a Linux kernel which has:
    • ppp and pppoe support enabled (module or built-in). Kernels compiled by Debian have them.
    • Ethernet driver for the interface on which you expect to connect using PPPoE
  • install pppoeconf (it will pull ppp and optionally pppoe )

  • Run pppoeconf to generate and/or modify /etc/ppp/peers/dsl-provider, /etc/ppp/*ap-secrets files and /etc/network/interfaces.
    It is best, in most cases, to keep the suggested answers

    auto eth0
    iface eth0 inet manual
    
    auto dsl-provider
    iface dsl-provider inet ppp
    pre-up    /sbin/ifconfig eth0 up
    provider dsl-provider

PPPoE with kernelspace pppoe driver

pppoeconf try to load pppoe kernel module (modprobe -q pppoe). If there is a file /proc/net/pppoe, configuration will be in "kernel_mode". It's the case for a large majority of users because standard Debian installation have a kernel with pppoe compiled in module.

I have found it necessary to add the --clamp-mss-to-pmtu option in my firewall to avoid problems accessing certain websites.
-- ?MichaelSoulier 2010-10-15 13:50:24

PPPoE with userspace pppoe driver

Alternatively, user-space agent pppoe can be used.

  • pty "pppoe -I eth0 -T 80 -m 1452"

Notes

  • If the name server information is not taken from the pppoe data, you will have to insert yourself that data in /etc/resolv.conf