Beyond Linux® From Scratch - Version svn-20070421

Chapter 15. Other Connections

RP-PPPoE-3.8

Introduction to RP-PPPoE

The Roaring Penguin PPPoE package contains both a client and a server component that works with the client. The client allows you to connect to large networks that use the PPPoE protocol, common among ADSL providers. The server component runs alongside the client, allowing you to configure other clients that send out a configuration request.

Package Information

RP-PPPoE Dependencies

Required

PPP-2.4.4 and Net-tools-1.60 (you may omit Net-tools by using the following patch to utilize IPRoute2 instead: http://www.linuxfromscratch.org/patches/blfs/svn/rp-pppoe-3.8-iproute2-1.patch)

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/RP-PPPoE

Installation of RP-PPPoE

[Note]

Note

If you plan on using kernel-mode PPPoE, this package is no longer explicitly needed, however, it is recommended for ease of configuration. Additional information about kernel mode PPPoE can be found in rp-pppoe-3.8/doc/KERNEL-MODE-PPPOE.

Fix the location of the logger executable in several PPPoE scripts: 

sed -i s%/usr/bin/logger%/bin/logger% \
    scripts/pppoe-{connect,setup,stop}.in

Install RP-PPPoE by running the following commands: 

cd src &&
./configure &&
make

This package does not come with a test suite.

Now, as the root user: 

make install

Command Explanations

These are the standard installation commands that will install the package into the /usr prefix. You can optionally use the go script in the root of the source tree to run the same commands, which are then immediately followed by the pppoe-setup script.

Configuring RP-PPPoE

Config Files

/etc/ppp/pppoe.conf, /etc/ppp/firewall-standalone, /etc/ppp/firewall-masq, /etc/ppp/pppoe-server-options, /etc/resolv.conf, /etc/ppp/pap-secrets, /etc/ppp/chap-secrets

Configuration Information

To configure RP-PPPoE after installation, you should run the pppoe-setup script.

When configuring your connection, you will need to have your ISP's nameserver information available, as well as your username and password. You will also be asked whether to configure a dial-on-demand or a constant connection. If your service provider does not charge by the minute, it is usually good to have a bootscript handle the connection for you. You can, of course, choose not to install the following script, and start your connection manually with the pppoe-start script.

Optionally install the /etc/sysconfig/network-devices/services/pppoe service script included with the blfs-bootscripts-20060910 package (as user root). 

make install-service-pppoe

Now create the config file for use with the pppoe service script (as user root):

[Note]

Note

If you have previously configured the network interface that will now use PPPoE, you should remove the interface configuration files for that interface (as user root): 

rm -v /etc/sysconfig/network-devices/ifconfig.eth0/*

install -v -d /etc/sysconfig/network-devices/ifconfig.eth0 &&
cat > /etc/sysconfig/network-devices/ifconfig.eth0/pppoe << "EOF"
ONBOOT="yes"
SERVICE="pppoe"
EOF

Contents

Installed Programs: pppoe-connect, pppoe-setup, pppoe-start, pppoe-status, pppoe-stop, pppoe, pppoe-relay, pppoe-server and pppoe-sniff
Installed Libraries: None
Installed Directories: /etc/ppp/plugins and /usr/share/doc/rp-pppoe-3.8

Short Descriptions

pppoe-connect

is a shell script which manages an PPPoE connection using the user-space PPPoE client.

pppoe-setup

is a script for configuring the client. Configuration is then stored in /etc/ppp/pppoe.conf.

pppoe-start

starts the client using the options specified in /etc/ppp/pppoe.conf.

pppoe-status

displays the status of the PPPoE connection.

pppoe-stop

stops the client.

pppoe

is the client program. Generally it should not be started on its own.

pppoe-relay

starts the server relay agent.

pppoe-server

starts the server component.

pppoe-sniff

is a small network sniffer designed to assist in setting PPPOE_EXTRA settings.

Last updated on 2007-04-04 21:42:53 +0200