%general-entities; ]> $LastChangedBy$ $Date$ rp-pppoe-&pppoe-version;.tar rp-pppoe 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 instead: ) 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-&pppoe-version;/doc/KERNEL-MODE-PPPOE. 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 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. /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 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 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 -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 Installed Programs Installed Libraries Installed Directories pppoe-connect, pppoe-setup, pppoe-start, pppoe-status, pppoe-stop, pppoe, pppoe-relay, pppoe-server and pppoe-sniff None /etc/ppp/plugins and /usr/share/doc/rp-pppoe-&pppoe-version; Short Descriptions pppoe-connect is a shell script which manages an PPPoE connection using the user-space PPPoE client. pppoe-connect pppoe-setup is a script for configuring the client. Configuration is then stored in /etc/ppp/pppoe.conf. pppoe-setup pppoe-start starts the client using the options specified in /etc/ppp/pppoe.conf. pppoe-start pppoe-status displays the status of the PPPoE connection. pppoe-status pppoe-stop stops the client. pppoe-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