%general-entities; ]> $LastChangedBy$ $Date$ RP-PPPoE-&pppoe-version; Introduction to <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application> 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 Download (HTTP): Download (FTP): Download size: &pppoe-size; Estimated disk space required: &pppoe-buildsize; Estimated build time: &pppoe-time; <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application> dependencies Required and Installation of <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application> 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-&pppoe-version;/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 <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application> 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. Optionally install the /etc/sysconfig/network-devices/services/pppoe service script included with the package. make install-service-pppoe Now create the config file for use with the pppoe service script: If you have previously configured the network interface that will now use PPPoE, you should remove the interface configuration files for that interface: 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 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.