RP-PPPoE-3.5

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

Installation of RP-PPPoE

If you plan on using demand dialing, or kernel mode PPPoE, confirm that you have applied the patch during installation of PPP-2.4.1. Additional information about kernel mode PPPoE can be found in rp-pppoe-3.5/doc/KERNEL-MODE-PPPOE.

Install RP-PPPoE by running the following commands:

cd src &&
./configure &&
make &&
make install

Command explanations

These are the standard installation commands that will install 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 adsl-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-seecrets, /etc/ppp/chap-secrets

Configuration Information

To configure RP-PPPoE after installation, you should run the adsl-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 adsl-start script.

Use the following commands to create the optional adsl bootscript:

cat > /etc/rc.d/init.d/adsl << "EOF"
#!/bin/bash
# Begin $rc_base/init.d/adsl

# Based on sysklogd script from LFS-3.1 and earlier.
# Rewritten by Gerard Beekmans  - gerard@linuxfromscratch.org
# adsl script written by DJ Lucas  - dj@lucasit.com

source /etc/sysconfig/rc
source $rc_functions

case "$1" in
        start)
                echo "Bringing up the ADSL interface..."
                /usr/sbin/adsl-start
                evaluate_retval
                ;;

        stop)
                echo "Bringing down the ADSL interface..."
                /usr/sbin/adsl-stop
                evaluate_retval
                ;;

        restart)
                $0 stop
                sleep 1
                $0 start
                ;;

        status)
                /usr/sbin/adsl-status
                ;;

        *)
                echo "Usage: $0 {start|stop|restart|status}"
                exit 1
                ;;
esac

# End $rc_base/init.d/adsl
EOF
chmod 755 /etc/rc.d/init.d/adsl

Now create the necessary symlinks:

ln -sf ../init.d/adsl /etc/rc.d/rc0.d/K49adsl &&
ln -sf ../init.d/adsl /etc/rc.d/rc1.d/K49adsl &&
ln -sf ../init.d/adsl /etc/rc.d/rc2.d/K49adsl &&
ln -sf ../init.d/adsl /etc/rc.d/rc3.d/S24adsl &&
ln -sf ../init.d/adsl /etc/rc.d/rc4.d/S24adsl &&
ln -sf ../init.d/adsl /etc/rc.d/rc5.d/S24adsl &&
ln -sf ../init.d/adsl /etc/rc.d/rc6.d/K49adsl

Contents

The RP-PPPoE package contains adsl-setup, adsl-start, adsl-status, adsl-stop, pppoe, pppoe-relay, pppoe-server and pppoe-sniff.

Description

adsl-setup

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

adsl-start

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

adsl-status

adsl-status displays the status of the ADSL connection.

adsl-stop

adsl-stop stops the client.

pppoe

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

pppoe-relay

pppoe-relay starts the server relay agent.

pppoe-server

pppoe-server starts the server component.

pppoe-sniff

A small network sniffer designed to assist in setting PPPOE_EXTRA settings.