Beyond Linux From Scratch - Version 6.0

Part IV. Connecting to a Network

Other Connections

Other methods to connect to large networks are through ISDN and PPPoE interfaces, among others. PPPoE is discussed here. Pages written for ISDN (or others as the need arises) are always welcome and will be included in future books, if available.

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

RP-PPPoE dependencies

Required

PPP-2.4.3 and Net-tools-1.60 (you may omit Net-tools by using the following patch to utilize IPRoute2: http://www.linuxfromscratch.org/blfs/downloads/6.0/rp-pppoe-3.5-iproute2-1.patch)

Installation of RP-PPPoE

[Note]

Note

If you plan on using kernel-mode PPPoE, this package is no longer explicitly needed, however, it is recomended for ease of configuration. 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

Now, as the root user: 

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-secrets, /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.

Optionally install the /etc/sysconfig/network-devices/services/pppoe service script included with the blfs-bootscripts-6.0 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 /etc/sysconfig/network-devices/ifconfig.eth0/* 

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

Contents

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

Short Descriptions

adsl-connect

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

adsl-setup

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

adsl-start

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

adsl-status

displays the status of the ADSL connection.

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