%general-entities; ]> $LastChangedBy$ $Date$ 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 Download (HTTP): Download (FTP): Download MD5 sum: &pppoe-md5sum; Download size: &pppoe-size; Estimated disk space required: &pppoe-buildsize; Estimated build time: &pppoe-time; RP-PPPoE Dependencies Required and (you may omit Net-tools by using the following patch to utilize IPRoute2: ) 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. Kernel-mode PPPoE Fix the location of the logger executable in several ADSL scripts: sed -i s%/usr/bin/logger%/bin/logger% scripts/adsl-{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 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. /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 /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 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 (as user root). pppoe (service script) make install-service-pppoe Now create the config file for use with the pppoe service script (as user root): /etc/sysconfig/.../pppoe 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 Installed Programs Installed Libraries Installed Directories adsl-connect, adsl-setup, adsl-start, adsl-status, adsl-stop, pppoe, pppoe-relay, pppoe-server and pppoe-sniff None /etc/ppp/plugins and /usr/share/doc/rp-pppoe-&pppoe-version; Short Descriptions adsl-connect is a shell script which manages an ADSL connection using the user-space PPPoE client. adsl-connect adsl-setup is a script for configuring the client. Configuration is then stored in /etc/ppp/pppoe.conf. adsl-setup adsl-start starts the client using the options specified in /etc/ppp/pppoe.conf. adsl-start adsl-status displays the status of the ADSL connection. adsl-status adsl-stop stops the client. adsl-stop pppoe is the client program. Generally it should not be started on its own. pppoe pppoe-relay starts the server relay agent. pppoe-relay pppoe-server starts the server component. pppoe-server pppoe-sniff is a small network sniffer designed to assist in setting PPPOE_EXTRA settings. pppoe-sniff