LRP PPPOE instructions

These instructions assume some familarility with LRP.

1. This image is 1680k in size. I recommend using either WinImage
(http://www.wimimage.com) or GRDUW (http://www.grsoftware.net/grduw.html)
under Windows 95/98 to create diskettes higher than 1440k, or use Linux, 
to create your boot diskette.
2. This image is Eiger-based (i.e., kernel v. 2.2.16).
3. This image is meant for use with PPPOE w/dhcp-client. It also includes
the dnscache and portsentry packages.
4. There are only 2 NIC drivers in this image - tulip and ne2000. If you use
a different NIC, you will need to add that module to this image. Instructions
for doing so are available on Charles Steinkeuhler's site.
5. Routing is pretty much standard LRP:

 - internal LAN is eth0 (which is defined as 192.168.1.254)
 - external NIC is eth1. When pppoe runs, it adds a ppp0 device (which is,
 in effect, actually an interface to eth1. Don't ask me; I just use it :-)
 - routing is eth0 - out thru - ppp0 (eth1).

The pppoe client is Roaring Penguin's pppoe software, with ppp v2.3.10. It
will load at bootup, as will dnscache and portsentry.

The syslinux config specifies a RAM disk size of 16384K. Make sure you have
enough RAM, or edit this figure.

6. There's a bug somewhere in forwarding rules; upon bootup, you'll get an
error from portfw about illegal local addresses. The image works, tho. If
you can fix this, please let me know.
7. The dnscache startup script has been modified from Charles's original to
read the EXTERNAL IP address from ppp0 each time the script runs, since
pppoe is a dhcp-client based interface, and the original script assumes a
a static IP for the external interface. Thanks go to Charles for this
modification.

ACTUAL CONFIGURATION:

Upon bootup (presuming that you've gotten the proper modules for your NIC),
the pppoe client will try to connect. Since you haven't configured it with
your particular userid and password, this will TIME OUT. This is normal.

Set up the pppoe client by entering: adsl-setup

-Enter your userid (in the form user@isp.com)
-Enter your external device (i.e., eth1)
-Enter your DNS settings (there are 2)
-Enter your userid

The pppoe client will save these settings. You can start the pppoe at any
time by entering adsl-start (conversely, adsl-stop will stop the pppoe client)

Edit the /etc/network.conf (by using the LRCFG menu, options 1, 1).
I prefer to explicitly set my DNS settings (i.e., use CONFIG_DNS=YES). Scroll
down to the DOMAIN SEARCH ORDER, and enter your DNS settings.

dnscache and portsentry shouldn't need any further configuration. If you
wish to do so, consult the documentation for these 2 packages.

That's pretty much it, really. If you prefer to use an IP address other than
192.168.1.254 for the eth0 interface, you will also need to enter it into
the dnscache startup script (LRCFG menu, option 3, 3, 2). Look for a line
that says IP=192.168.1.254, and modify accordingly.

Be sure to backup your configuration, especially root, etc and pppoe.

RESTARTING THE PPPOE CONNECTION:

One of the more annoying things about pppoe is that your connection may be
dropped by your ISP at any time. This will cause your dnscache to not work.
If your connection is dropped, you will need to manually stop and re-start
the dnscache (I haven't figured out how to do it automatically).

To stop dnscache:
  cd /etc/init.d
  ./dnscache stop
Then, restart the pppoe connection
  adsl-start
Then, restart the dnscache
  ./dnscache start