Update of /cvsroot/leaf/doc/guide/install-bering
In directory usw-pr-cvs1:/tmp/cvs-serv17919

Added Files:
        biabout.xml biaddrm.xml biall.xml bicontent.xml 
        bidowndistro.xml bidownmod.xml bikeybd.xml binetwork.xml 
        bipackages.xml bishorwall.xml bumodem.xml 
Log Message:
added current bering install xml source

--- NEW FILE: biabout.xml ---
<sect1 id="biabout"><title>About LEAF "Bering"</title>
<sect2><title>What is the LEAF "Bering" distribution ?</title>
<para>The LEAF "Bering" distribution is derived from <ulink 
url="http://lrp.steinkuehler.net";>Charles Steinkuehler's</ulink> Dachstein (rc2). It 
differs from it on two key elements:</para>
<itemizedlist>
<listitem><para>It is based on a 2.4.x linux kernel</para></listitem>
<listitem><para>It relies on <ulink url="http://www.shorewall.net";>Shorewall</ulink> 
for extended firewalling facilities. Check all the Shorewall features <ulink 
url="http://www.shorewall.net/shorewall_features.htm";>here</ulink>.</para></listitem>
</itemizedlist>
<para>The main objectives are:</para>
<itemizedlist>
<listitem><para>To benefit from the <ulink 
url="http://www.netfilter.org";>netfilter/iptables</ulink> facilities</para></listitem>
<listitem><para>To have access to the latest kernel device drivers & 
filesystems</para></listitem>
<listitem><para>To keep everything available on a single floppy for the largest 
possible user's base (including serial modem, cable modem or ADSL PPP/PPPOE 
users)</para></listitem>
<listitem><para>To keep the simplicity provided by Dachstein</para></listitem>
<listitem><para>To stick to a standard linux kernel as much as possible. This allows 
LEAF "Bering" usage and developement in a <ulink 
url="http://leaf.sourceforge.net/devel/jnilo/uml.html";>virtual 
environment</ulink></para></listitem>
<listitem><para>To stick as much as possible to the Debian distribution 
structure</para></listitem>
</itemizedlist>
<para>This work was made possible after having proposed a solution to get rid of the 
original kernel LRP patches which do not pass the change introduced in 
<filename>initrd</filename> in the 2.4.10 kernel. The interested reader can refer to 
the leaf-devel mailing list archives.</para>
</sect2>
<sect2><title>Why Bering ?</title>
<para>The name "Bering" was chosen from the Strait of the same name. A strait is a 
nice symbol for a firewall: a lot of traffic and strict navigation rules. Bering was 
chosen because it represents the shortest distance between Europe and America where 
most of the LEAF community is living. Those interested by the story of the Bering 
Island can check <ulink 
url="http://www.pbs.org/edens/kamchatka/bering.html";>here</ulink> (Thanks to Matt 
Schalit for the reference).</para>
</sect2>
<sect2><title>Feedback</title>
<para>Comment on this package can be sent to the authors:</para>
<para>Jacques Nilo <email>[EMAIL PROTECTED]</email> or Eric Wolzak 
<email>[EMAIL PROTECTED]</email>.</para>
</sect2>
<sect2><title>Acknowledgments and thanks</title>
<para>Thanks to everyone who help us on this work and especially the members of the 
<ulink url="http://lists.sourceforge.net/lists/listinfo/leaf-devel";>leaf-devel</ulink> 
and <ulink 
url="http://lists.sourceforge.net/lists/listinfo/leaf-user";>leaf-user</ulink> mailing 
list. Many thanks also to Tom Eastep <email>[EMAIL PROTECTED]</email> for his 
great shorewall package and his dedicated support.</para>
<para>The "Bering" distribution has benefited from many comments, help and suggestions 
from Lynn Avants, Chad Carr, Luis F. Correia, Allen Hillery, Christian Hostelet, Tom 
Eastep, Jeff Newmiller, Brock Nanson, Thor Nylander, Larry Platzek and Bob 
Pocius.</para>
</sect2>
<sect2><title>Changelog</title>
<para>Current version: 1.0-rc3 - June,16 2002</para>
<itemizedlist>
<listitem><para>Bering now supports apm and vlan as modules. New netfilter modules 
provided for H323, pptp, sftp and talk.Check available modules <ulink 
url="http://leaf.sourceforge.net/devel/jnilo/bering/latest/modules/net/ipv4/netfilter/";>here</ulink>.</para></listitem>
<listitem><para>Bering kernel now patched with <ulink 
url="http://www.grsecurity.net";>grsecurity</ulink> v1.9.4. Kernel compiled with 
"medium" level. Check all the details <ulink 
url="http://www.grsecurity.org/features.htm";>here</ulink>.</para></listitem>
<listitem><para><ulink url="http://www.shorewall.net";>Shorewall</ulink> updated to 
latest 1.3.1 version with the June 15, 2002 errata.</para></listitem>
<listitem><para>Busybox updated to 0.60.3: saves 10k and <emphasis>ls</emphasis> 
command output is now in colour :-)</para></listitem>
<listitem><para><filename>root.dev.mk</filename> updated to create mtd, nftla1->4, 
lp0, lp1 devices for DoC and parallel printer support</para></listitem>
<listitem><para>In <filename>/lib/POSIXness</filename>, 
<filename>POSIXness.text</filename> removed, <filename>POSIXness.mail</filename> 
corrected (thanks to K.P. Kirchd�rfer), <filename>POSIXness.system</filename> 
cleaned-up and <filename>POSIXness.linuxrouter</filename> modified so that 
<emphasis>lrpkg -i /anydir/package.lrp</emphasis> can work.</para></listitem>
<listitem><para><filename>/etc/passwd</filename> and <filename>/etc/group</filename> 
updated so that qmail.lrp can  now work out of the box</para></listitem>
<listitem><para>bridge scripts in bridge.lrp fixed</para></listitem>
<listitem><para>syslinux updated to version 1.75</para></listitem>
<listitem><para>weblet.lrp updated: sh-httpd has GID 10 (wheels) to be able to run 
with grsecurity patch. Correction for layout problems in viewsys and viewnet. Display 
of statistiscs improved using the "ip -s link show" command. Memory check changed: now 
only the memory in the tmpfs and dev/root are checked. Mounted floppies and cdroms are 
ignored.</para></listitem>
<listitem><para><ulink url="busers.html">User's guide</ulink> updated to revision 0.3. 
with some editing. Also now available as pdf file in the Bering <ulink 
url="http://sourceforge.net/project/showfiles.php?group_id=13751";>download 
area</ulink>.</para></listitem>
<listitem><para><ulink url="binstall.html">Installation guide</ulink> updated to 
revision 0.7. Also available as pdf file in the Bering <ulink 
url="http://sourceforge.net/project/showfiles.php?group_id=13751";>download 
area</ulink>.</para></listitem>
</itemizedlist>
<para>Version: 1.0-rc2 - April,22 2002</para>
<itemizedlist>
<listitem><para>Bering now support <ulink url="http://www.freeswan.org";>IPSEC</ulink> 
(Freeswan - version 1.97) as a module. ipsec.lrp & ipsec509.lrp packages available. 
Thanks to Chad Carr <email>[EMAIL PROTECTED]</email> for his great 
work!</para></listitem>
<listitem><para>Bering now support <ulink url="http://www.shorewall.net/PPTP.htm";>pptp 
tunnels</ulink>. Kernel was patched accordingly and pppd daemon as 
well</para></listitem>
<listitem><para>Bering can now boot from a CD-Rom. The result of a great team work 
involving Luis F. Correia <email>[EMAIL PROTECTED]</email>, Allen 
Hillery <email>[EMAIL PROTECTED]</email> and Chritian Hostelet 
<email>[EMAIL PROTECTED]</email>. Luis also wrote a <ulink url="bucdrom.html">new 
section</ulink> of the Bering user's guide explaining how to create the 
CD-Rom.</para></listitem>
<listitem><para>Shorewall updated to latest 1.2.12 version. Parameterized 
two-interfaces setup removed and replaced by the new two-interfaces sample from Tom. 
The Bering's installation manual about Shorewall has been completely 
rewritten.</para></listitem>
<listitem><para>PCMCIA kernel mode removed. We now go for pcmcia_cs package and 
modules. Seems more robust and also support PCI/PCMCIA bridge</para></listitem>
<listitem><para>Last version (2.21) of the <ulink 
url="http://leaf.sourceforge.net/devel/jnilo/manpages/e3.html";>e3 editor</ulink> now 
provided</para></listitem>
<listitem><para>Kernel now compiled with serial support (by popular demand 
:-))</para></listitem>
<listitem><para>Busybox mount command now works for NFS volumes</para></listitem>
<listitem><para>iptables updated with the last 1.2.6a version</para></listitem>
<listitem><para><ulink url="busers.html">User's guide</ulink> updated to revision 0.2. 
with five new chapters and many updates !</para></listitem>
<listitem><para><ulink url="binstall.html">Installation guide</ulink> updated to 
revision 0.5.</para></listitem>
</itemizedlist>
<para>Version: 1.0-rc1 - March,16 2002</para>
<itemizedlist>
<listitem><para>Updated with the 2.4.18 linux kernel which fixes the Netfilter/IRC 
bug. Support is now provided for Appletalk and IPX through appropriate 
modules</para></listitem>
<listitem><para>Shorewall updated version 1.2.9. Allows now MAC addresses 
filtering</para></listitem>
<listitem><para>iptables updated with the last 1.2.5 version</para></listitem>
<listitem><para><filename>lrcfg.back.script</filename> updated with the most recent 
version from Dachstein which allows partial backup and adatped to work without ctar. 
Backup problems experienced in beta-4 should be gone. Eric spent quite some time on 
this one :-).</para></listitem>
<listitem><para>New pcmcia.lrp packages (tested and more compact and with a more 
detailed documentation).</para></listitem>
<listitem><para>Documentation updated to revision 0.4.</para></listitem>
</itemizedlist>
<para>Version: beta4 - February 2002</para>
<itemizedlist>
<listitem><para>ifupdown program adapted to only use ip addr and ip route commands. 
ifconfig removed</para></listitem>
<listitem><para>Shorewall updated to latest 1.2.6 version</para></listitem>
<listitem><para>arp program added to /sbin to have proxy-arp working with Shorewall 
(thanks to Yvo Nelemans for noticing this)</para></listitem>
<listitem><para>Beta2 <filename>/usr/sbin/lrcfg.back.initrd</filename> script 
restored. Automatic computation of INITRD_SIZE in beta3 was buggy</para></listitem>
<listitem><para>Loading of modules stored in <filename>/boot/lib/modules</filename> 
right after initrd is mounted is now working properly</para></listitem>
<listitem><para>ctar removed following a suggestion by S. Caron</para></listitem>
<listitem><para>The pcmcia.lrp configuration list is no more broken</para></listitem>
<listitem><para>Some clean-up in weblet.lrp</para></listitem>
<listitem><para>Documentation updated to revision 0.3.</para></listitem>
</itemizedlist>
<para>Version: beta3 - February 2002</para>
<itemizedlist>
<listitem><para>The distribution has now a name: Bering !</para></listitem>
<listitem><para>Kernel 2.4.16 updated. Check the new <ulink 
url="http://leaf.sourceforge.net/devel/jnilo/bering/beta3/bering-b3.config";>config 
file</ulink>. Includes now support for Hard disks, DOC, ext2/ext3/reiserfs 
filesystems, PPPOA, IPV6</para></listitem>
<listitem><para>Shorewall updated to latest 1.2.5 version</para></listitem>
<listitem><para>Winimage floppy image now available for Windows users</para></listitem>
<listitem><para>INITRD_SIZE parameter removed: 
<filename>/usr/sbin/lrcfg.back.initrd</filename> now computes optimal size of INITRD 
filesystem</para></listitem>
<listitem><para><filename>/etc/init.d/netbase</filename> removed and replaced by 
<filename>/etc/init.d/inetd</filename>. Portmap will be provided as a separate 
package.</para></listitem>
<listitem><para>Some clean-up in the <filename>/etc/init.d</filename> RCDLINKS= 
parameters to comply with Debian/Woody</para></listitem>
<listitem><para>Supplemental packages available providing openssh, pcmcia, ppp (with 
active-filter enabled) and wireless support. Check the Bering packages <ulink 
url="http://leaf.sourceforge.net/devel/jnilo/bering/packages/";>directory</ulink>.</para></listitem>
<listitem><para>Pump.lrp recompiled with proper options and 
<filename>/etc/shorewall.pump</filename> script corrected. Also 
<filename>/etc/init.d/pump</filename> script removed: Pump fully controlled by 
ifup/down</para></listitem>
<listitem><para><filename>libnsl.so</filename> removed (and <filename>tcpd</filename> 
and <filename>sshd</filename> recompiled accordingly). Save about 10K 
(compressed).</para></listitem>
<listitem><para><filename>/usr/sbin/ticker</filename> replaced by a shell script 
(Thanks Ray !). Save 1,3K (compressed)</para></listitem>
<listitem><para>Documentation updated to revision 0.2. Thanks to L. Avants, T. Eastep 
& L. Platzek for their suggestions !</para></listitem>
</itemizedlist>
<para>Version: beta2 - January 2002</para>
<itemizedlist>
<listitem><para>Kernel 2.4.16 now used. New kernel <ulink 
url="http://leaf.sourceforge.net/devel/jnilo/kernel-2.4.16/leaf-mini-2416-b2.config";>config
 file</ulink>. Includes in particular support for PCMCIA, PPP, PPP/PPPOE, ISDN, USB 
and bridging</para></listitem>
<listitem><para>Use <ulink url="http://www.shorewall.net";>shorewall 1.2.2</ulink> 
allowing among <ulink url="http://www.shorewall.net/shorewall_features.htm";>many other 
things</ulink> traffic shapping & blacklisting</para></listitem>
<listitem><para>Pump (0.8.11-3) being used as default DHCP/BOOTP client to save disk 
space (dhclient.lrp still OK)</para></listitem>
<listitem><para>networking script now fully debian/sid compatible. Dachstein's 
<filename>/etc/network.conf</filename>, <filename>/etc/ipchains.conf</filename> and 
<filename>/etc/init.d/network</filename> files/scripts completely 
removed</para></listitem>
<listitem><para>ifconfig (1.4.2) and ifupdown (0.6.4) available</para></listitem>
<listitem><para>new applets in bbox library (0.60.2)</para></listitem>
<listitem><para>new version of iproute2 (010824). tc <ulink 
url="http://luxik.cdi.cz/~devik/qos/htb/v2/htb2_tc.diff";>patched</ulink> to allow for 
<ulink url="http://luxik.cdi.cz/~devik/qos/htb/";>HTB queuing 
discipline</ulink></para></listitem>
<listitem><para>bridge now available as a separate package. Provides brctl from <ulink 
url="http://bridge.sourceforge.net/";>bridge-utils</ulink> (0.9.4) </para></listitem>
<listitem><para>ppp.lrp and pppoe.lrp provided in the standard distro for serial/modem 
and adsl/pppoe connections. pppoe.lrp provides the PPPoE 2.4.16 kernel plugin. The ppp 
daemon is the 2.4.1 version patched for kernel mode PPPoE available <ulink 
url="http://www.shoshin.uwaterloo.ca/~mostrows/";>here</ulink>.</para></listitem>
<listitem><para>pon, poff and plog scripts provided in ppp.lrp for ppp on 
demand.</para></listitem>
<listitem><para>weblet.lrp modified to handle <filename>iptable</filename> output. Do 
not need <filename>netstat</filename> anymore</para></listitem>
<listitem><para>first draft of installation guide available (what your are reading 
now)</para></listitem>
</itemizedlist>
<para>version: <ulink 
url="http://www.geocrawler.com/archives/3/7232/2001/12/150/7221394/";>2.4.14-b1</ulink> 
- 12 December 2001</para>
<para>version: <ulink 
url="http://www.geocrawler.com/archives/3/7232/2001/11/50/7219319/";>2.4.14-alpha</ulink>
 - 20 November 2001</para>
</sect2>
<sect2><title>Bering download area</title>
<para>All Bering related files, including archives, are available in the LEAF <ulink 
url="http://sourceforge.net/project/showfiles.php?group_id=13751";>files 
area</ulink>.</para>
</sect2>
<sect2><title>Bering support</title>
<para>Bering is provided with an extensive documentation also available as pdf file in 
the LEAF <ulink 
url="http://sourceforge.net/project/showfiles.php?group_id=13751";>files 
area</ulink>.</para>
<para>Request for support should be directed only to the <ulink 
url="http://lists.sourceforge.net/lists/listinfo/leaf-user";>leaf-user mailing 
list</ulink>.</para>
</sect2>
</sect1>

--- NEW FILE: biaddrm.xml ---
<sect1 id="biaddrm"><title>Installation - step 3: Add/remove the (un)needed packages 
and modules</title>
<para>The LEAF "Bering" floppy disk is provided with package(s) and/or module(s) you 
won't necessary need. Get rid of  them to begin with.</para>
<para>Check the list of packages provided above to see if you need them. Some examples 
follow:</para>
<itemizedlist>
<listitem><para>A US user can remove the keyboard.lrp package</para></listitem>
<listitem><para>A cable modem user with dynamic IP can get rid of the ppp.lrp and 
pppoe.lrp packages</para></listitem>
<listitem><para>A user with a fixed external IP does not need 
pump.lrp</para></listitem>
<listitem><para>A DSL/PPPoE user will not necessarily need pump.lrp</para></listitem>
</itemizedlist>
<sect2><title>Removing unneeded packages</title>
<para>To remove a given package (say unneeded.lrp) from the LEAF disk, insert it in 
your floppy drive and boot it. When you will see the LEAF configuration menu, type q 
(quit) to get access to the linux shell. Then execute the following commands:</para>
<screen>
mount -t msdos /dev/fd0u1680 /mnt
cd /mnt
rm unneeded.lrp
cd /
umount /mnt
</screen>
</sect2>
<sect2><title>Edit the <filename>syslinux.cfg</filename> file</title>
<para>Make sure the list of packages that you want to load when the LEAF firewall 
floppy is booted correspond to those packages you want to load:</para>
<para>By default the syslinux.cfg file looks like:</para>
<screen>
display syslinux.dpy
timeout 0
default linux initrd=initrd.lrp init=/linuxrc root=/dev/ram0 boot=/dev/fd0u1680:msdos 
PKGPATH=/dev/fd0u1680 LRP=root,etc,local,modules,pump,keyboard,shorwall,dnscache,weblet
</screen>
<para>To edit this file:</para>
<screen>
mount -t msdos /dev/fd0u1680 /mnt
cd /mnt
ae syslinux.cfg
        (edit the LRP= list to fit your needs)
        (then save and exit)
cd /
umount /mnt
</screen>
<para>Other syslinux parameters:</para>
<itemizedlist>
<listitem><para><emphasis>log_size=</emphasis> Defines the size of the 
<filename>/var/log</filename> directory. Default= 2M</para></listitem>
<listitem><para><emphasis>syst_size=</emphasis> Defines the size of the TMPFS 
filesystem. Default= 6M.</para></listitem>
<listitem><para><emphasis>tmp_size=</emphasis> Defines the size of the 
<filename>/tmp</filename> directory. Default= remaining available 
memory</para></listitem>
<listitem><para><emphasis>PKGPATH=</emphasis> Defines location of packages defined in 
the <emphasis>LRP=</emphasis> list. I.E. if they are stored on two different floppies, 
one will have something like:</para></listitem>
</itemizedlist>
<screen>
display syslinux.dpy
timeout 0
default linux initrd=initrd.lrp log_size=4M init=/linuxrc root=/dev/ram0 
boot=/dev/fd0u1680:msdos PKGPATH=/dev/fd0u1680,/dev/fd1u1680 
LRP=root,etc,local,modules,pump,keyboard,libz,sshd,shorwall,dnscache,weblet
</screen>
<para>In the example above packages not available on the first floppy drive (e.g. 
libz.lrp and sshd.lrp) will be loaded from a 1680K formatted floppy inserted in the 
second drive. On the top of that 4M are allocated to <filename>/var/log</filename> 
files.</para>
<note>
<para>The LEAF editor is <ulink url="http://www.sax.de/~adlibit/";>e3</ulink>. The 
documentation is <ulink 
url="http://leaf.sourceforge.net/devel/jnilo/manpages/e3.html";>here</ulink>. Different 
emulations are available: vi, ae or e3ws are the most common one.</para>
</note>
</sect2>
<sect2><title>Removing unneeded modules</title>
<para>Once you have removed the unneeded packages, you can remove the unneeded.o 
module(s) as follow:</para>
<screen>
cd /lib/modules
rm unneeded.o
lrcfg
</screen>
<para>Once you are back with the LEAF configuration menu select the LEAF packages 
backup entry and backup the modules package.</para>
</sect2>
<sect2><title>Adding a new package</title>
<para>To add a new package just copy it to the LEAF floppy and declare the name in the 
<filename>syslinux.cfg</filename> LRP= list.</para>
</sect2>
<sect2><title>Adding extra modules in /lib/modules</title>
<para>You can add many features to your LEAF "Bering" distribution by adding extra 
kernel modules. Once you know which modules you need, download them from the LEAF 
Bering <ulink 
url="http://leaf.sourceforge.net/devel/jnilo/bering/latest/modules";>modules 
directory</ulink> to a standard (1,44M formatted) floppy disk. Boot the LEAF "Bering" 
floppy. Once you see the LEAF menu, remove the LEAF floppy and replace it with the 
modules floppy. Then issue the following commands:</para>
<screen>
mount -t msdos /dev/fd0 /mnt
cd /mnt
cp needed1.o needed2.o ... /lib/modules
cd /
umount /mnt
lrcfg
</screen>
<para>Through the LEAF Packages configuration menu select "modules" and declare those 
modules you need to load in <filename>/etc/modules</filename>.</para>
<para>Remember to save and backup modules.lrp !</para>
<important>
<para>The LEAF "Bering" <filename>/etc/modules</filename> file contains templates to 
setup a bridge, to access to an IDE Hard-disk or CD-ROM and to activate USB.</para>
</important>
</sect2>
<sect2><title>Adding extra modules in /boot/lib/modules</title>
<para>You can choose to load those extra kernel modules at the early stage of the boot 
process right after initrd filesystem is mounted. This is typically used to get access 
to a storage device where the remaining LEAF packages are stored. Once you know which 
modules you need, download them from the LEAF Bering <ulink 
url="http://leaf.sourceforge.net/devel/jnilo/bering/latest/modules";>modules 
directory</ulink> to a standard (1,44M formatted) floppy disk. Boot the LEAF "Bering" 
floppy. Once you see the LEAF menu, remove the LEAF floppy and replace it with the 
modules floppy. Then issue the following commands:</para>
<screen>
mount -t msdos /dev/fd0 /mnt
cd /mnt
cp needed1.o needed2.o ... /boot/lib/modules
cd /
umount /mnt
lrcfg
</screen>
<para>Through the LEAF Packages configuration menu select "initrd" and declare those 
modules you need to load in <filename>/boot/etc/modules</filename>.</para>
<para>Remember to save and backup initrd.lrp !</para>
</sect2>
</sect1>

--- NEW FILE: biall.xml ---
<?xml version="1.0" encoding='ISO-8859-1'?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" [
<!ENTITY biabout SYSTEM "biabout.xml">
<!ENTITY bicontent SYSTEM "bicontent.xml">
<!ENTITY bidowndistro SYSTEM "bidowndistro.xml">
<!ENTITY bidownmod SYSTEM "bidownmod.xml">
<!ENTITY biaddrm SYSTEM "biaddrm.xml">
<!ENTITY bikeybd SYSTEM "bikeybd.xml">
<!ENTITY binetwork SYSTEM "binetwork.xml">
<!ENTITY bishorwall SYSTEM "bishorwall.xml">
<!ENTITY bipackages SYSTEM "bipackages.xml">
]>
<book>
<article id="binstall"><title>LEAF "Bering" installation guide</title>
<articleinfo>
<author><firstname>Jacques</firstname> <surname>Nilo</surname></author>
<author><firstname>Eric</firstname> <surname>Wolzak</surname></author>
<revhistory>
     <revision>
        <revnumber>0.1</revnumber>
        <date>18 January 2002</date>
        <revremark>First draft for review</revremark>
     </revision>
     <revision>
        <revnumber>0.2</revnumber>
        <date>2 February 2002</date>
        <revremark>Second draft for review</revremark>
     </revision>
     <revision>
        <revnumber>0.3</revnumber>
        <date>21 February 2002</date>
        <revremark>Third draft for review</revremark>
     </revision>
     <revision>
        <revnumber>0.4</revnumber>
        <date>19 March 2002</date>
        <revremark>Fourth draft for review</revremark>
     </revision>
     <revision>
        <revnumber>0.5</revnumber>
        <date>22 April 2002</date>
        <revremark>Fifth draft for review</revremark>
     </revision>
     <revision>
        <revnumber>0.6</revnumber>
        <date>16 June 2002</date>
        <revremark>Sixth draft for review</revremark>
     </revision>
</revhistory>
</articleinfo>
&biabout;
&bicontent;
&bidowndistro;
&bidownmod;
&biaddrm;
&bikeybd;
&binetwork;
&bishorwall;
&bipackages;
</article>
</book>

--- NEW FILE: bicontent.xml ---
<sect1 id="bicontent"><title>Available packages on the LEAF "Bering" floppy</title>
<sect2><title>The LEAF "Bering" floppy disk content</title>
<para>The following files are available on the 1680K formatted LEAF "Bering" 
floppy:</para>
<screen>
[root@versa root]# ls -la /mnt/floppy/
total 1654
drwxr-xr-x    2 root     root         5632 jan  1  1970 ./
drwxr-xr-x    5 root     root         4096 mai 19 02:10 ../
-rwxr-xr-x    1 root     root         8795 jun 16 15:32 bridge.lrp*
-rwxr-xr-x    1 root     root        43768 jun 16 15:32 dhcpd.lrp*
-rwxr-xr-x    1 root     root        23821 jun 16 15:32 dnscache.lrp*
-rwxr-xr-x    1 root     root        23401 jun 16 15:31 etc.lrp*
-rwxr-xr-x    1 root     root       410442 jun 16 15:30 initrd.lrp*
-rwxr-xr-x    1 root     root        11855 jun 16 15:32 keyboard.lrp*
-r-xr-xr-x    1 root     root         7112 jun 16 12:11 ldlinux.sys*
-rwxr-xr-x    1 root     root       495127 jun  9 17:19 linux*
-rwxr-xr-x    1 root     root          494 jun 16 15:31 local.lrp*
-rwxr-xr-x    1 root     root          296 jun 16 15:37 log.lrp*
-rwxr-xr-x    1 root     root       104057 jun 16 15:31 modules.lrp*
-rwxr-xr-x    1 root     root        95752 jun 16 15:32 ppp.lrp*
-rwxr-xr-x    1 root     root        14125 jun 16 15:33 pppoe.lrp*
-rwxr-xr-x    1 root     root        24566 jun 16 15:31 pump.lrp*
-rwxr-xr-x    1 root     root          186 jun 16 15:34 readme*
-rwxr-xr-x    1 root     root       315097 jun 16 15:31 root.lrp*
-rwxr-xr-x    1 root     root        36597 jun 16 15:32 shorwall.lrp*
-rwxr-xr-x    1 root     root          205 jun 16 15:35 syslinux.cfg*
-rwxr-xr-x    1 root     root         1059 jun 16 15:36 syslinux.dpy*
-rwxr-xr-x    1 root     root        41798 jun 16 15:33 tc.lrp*
-rwxr-xr-x    1 root     root        19540 jun 16 15:32 weblet.lrp*
[root@versa root]#
</screen>
</sect2>
<sect2><title>Description</title>
<para>The different packages and files are described in the two following 
tables:</para>
<table frame='all'>
<title>Available LEAF packages</title>
<tgroup cols='4' align='left'>
<thead>
<row>
<entry>Package name</entry>
<entry>Purpose</entry>
<entry>Version</entry>
<entry>Status</entry>
</row>
</thead>
<tbody>
<row>
<entry>bridge.lrp</entry>
<entry>Provides brctl and bridging facilities</entry>
<entry>0.9.4</entry>
<entry>Optionnal</entry>
</row>
<row>
<entry>dhcpd.lrp</entry>
<entry>Provides a DHCP server to your local network</entry>
<entry></entry>
<entry>Optionnal</entry>
</row>
<row>
<entry>dnscache.lrp</entry>
<entry>Provides D.J. Bernstein fast caching resolver for DNS</entry>
<entry>1.05</entry>
<entry>Recommended</entry>
</row>
<row>
<entry>etc.lrp</entry>
<entry>Provides system /etc files</entry>
<entry>v1.0-rc3</entry>
<entry>Required</entry>
</row>
<row>
<entry>initrd.lrp</entry>
<entry>Provides LEAF bootstrap and core system files</entry>
<entry>v1.0-rc3</entry>
<entry>Required</entry>
</row>
<row>
<entry>keyboard.lrp</entry>
<entry>Provides 35 International keyboard layouts</entry>
<entry>0.3</entry>
<entry>Optionnal</entry>
</row>
<row>
<entry>local.lrp</entry>
<entry>Provides system files</entry>
<entry>v1.0-rc3</entry>
<entry>Required</entry>
</row>
<row>
<entry>log.lrp</entry>
<entry>Provides system /var/log files</entry>
<entry>v1.0-rc3</entry>
<entry>Required</entry>
</row>
<row>
<entry>modules.lrp</entry>
<entry>Provides 2.4.18 kernel modules files</entry>
<entry>v1.0-rc3</entry>
<entry>Required</entry>
</row>
<row>
<entry>ppp.lrp</entry>
<entry>Provides the ppp daemon patched for kernel mode PPPoE</entry>
<entry>2.4.1</entry>
<entry>Optionnal</entry>
</row>
<row>
<entry>pppoe.lrp</entry>
<entry>Provides the PPPoE kernel plugin</entry>
<entry>2.4.1</entry>
<entry>Optionnal</entry>
</row>
<row>
<entry>pump.lrp</entry>
<entry>Provides the Redhat DHCP/BOOTP client</entry>
<entry>0.8.11</entry>
<entry>Optionnal</entry>
</row>
<row>
<entry>root.lrp</entry>
<entry>Provides the LEAF system files</entry>
<entry>v1.0-rc3</entry>
<entry>Required</entry>
</row>
<row>
<entry>shorwall.lrp</entry>
<entry>Provides the shorewall firewall</entry>
<entry>1.3.1</entry>
<entry>Required</entry>
</row>
<row>
<entry>tc.lrp</entry>
<entry>Provides the IPROUTE2 tc program for traffic shapping</entry>
<entry>SS010824</entry>
<entry>Optionnal</entry>
</row>
<row>
<entry>weblet.lrp</entry>
<entry>Provides a Web based LEAF monitoring tool</entry>
<entry>1.2.0</entry>
<entry>Optionnal</entry>
</row>
</tbody>
</tgroup>
</table>
<table frame='all'>
<title>Other files</title>
<tgroup cols='4' align='left'>
<thead>
<row>
<entry>File name</entry>
<entry>Purpose</entry>
<entry>Version</entry>
<entry>Status</entry>
</row>
</thead>
<tbody>
<row>
<entry>ldlinux.sys</entry>
<entry>syslinux (boot loader) system file</entry>
<entry>1.75</entry>
<entry>Required</entry>
</row>
<row>
<entry>linux</entry>
<entry>Linux kernel</entry>
<entry>2.4.18</entry>
<entry>Required</entry>
</row>
<row>
<entry>syslinux.cfg</entry>
<entry>syslinux LEAF configuration file</entry>
<entry>1.75</entry>
<entry>Required</entry>
</row>
<row>
<entry>syslinux.dpy</entry>
<entry>syslinux screen logo file</entry>
<entry>1.75</entry>
<entry>Required</entry>
</row>
</tbody>
</tgroup>
</table>
</sect2>
</sect1>

--- NEW FILE: bidowndistro.xml ---
<sect1 id="bidowndistro"><title>Installation - step 1: download the 
distribution</title>
<sect2><title>Linux users</title>
<para>As root, download the <ulink 
url="http://prdownloads.sourceforge.net/leaf/Bering_1.0-rc3_img_bering_1680.bin";>1680K 
disk image</ulink> in your <filename>/tmp</filename> directory and copy it to a 1680K 
formatted floppy disk:</para>
<para>Format a blank floppy disk:</para>
<screen>
superformat /dev/fd0u1680
or
fdformat /dev/fd0u1680
</screen>
<para>Copy the disk image on the floppy:</para>
<screen>
dd if=/tmp/Bering_1.0-rc3_img_bering_1680.bin of=/dev/fd0u1680
</screen>
</sect2>
<sect2><title>Windows users</title>
<para>From your favorite browser, download the <ulink 
url="http://prdownloads.sourceforge.net/leaf/Bering_1.0-rc3_img_bering_1680.exe";>1680K 
Winimage</ulink> in any available directory. Have a blank formatted disk ready. Then 
click on the downloaded disk winimage and follow the instructions.</para>
</sect2>
</sect1>

--- NEW FILE: bidownmod.xml ---
<sect1 id="bidownmod"><title>Installation - step 2: download the modules</title>
<para>In order to use the LEAF firewall you will need to install the modules that will 
be loaded to complement your kernel. You will need one for your ethernet card(s) in 
particular.</para>
<para>Modules can be stored in two different places:</para>
<itemizedlist>
<listitem><para>In <filename>/boot/lib/modules</filename>: these modules will be 
loaded at the very begining of the booting process. This facility is used to load 
drivers which will be necessary in order to be able to load the remaining of the 
packages (CD-ROM or Hard-disk drivers for examples when you are booting off those 
media: cf. the <ulink 
url="http://leaf.sourceforge.net/devel/jnilo/bubooting.html";>"Booting Bering from 
different boot-media"</ulink> section of the Bering user's guide). These modules will 
be saved in the initrd.lrp package. None are provided by default in the LEAF 
distribution since most users won't need any. If you use this facility, you will also 
need to edit <filename>/boot/etc/modules</filename> in order to declare the sequence 
of modules you want to load at this stage.</para></listitem>
<listitem><para>In <filename>/lib/modules</filename>: these modules are provided by 
the modules.lrp package which is loaded as any other package. This package should 
provide most - if not all - of the modules required to have the LEAF firewall working 
on your specific hardware. You will also need to edit 
<filename>/etc/modules</filename> in order to declare the sequence of modules you want 
to load.</para></listitem>
</itemizedlist>
<para>By default, the modules.lrp package of the LEAF "Bering" firewall 
provides:</para>
<screen>
[root@versa modules]# ls -la
total 280
drwxr-x---    2 root     root         4096 jun 16 17:20 ./
drwxr-xr-x    3 root     root         4096 jun 16 19:46 ../
-rw-r--r--    1 root     root        36120 jun  9 11:02 3c59x.o
-rw-r--r--    1 root     root         8880 jun  9 11:02 8390.o
-rw-r--r--    1 root     root        26320 jun  9 11:02 eepro100.o
-rw-r--r--    1 root     root         5928 jun  9 11:03 ip_conntrack_ftp.o
-rw-r--r--    1 root     root         5720 jun  9 11:03 ip_conntrack_irc.o
-rw-r--r--    1 root     root         4748 jun  9 11:03 ip_nat_ftp.o
-rw-r--r--    1 root     root         4200 jun  9 11:03 ip_nat_irc.o
-rw-r--r--    1 root     root         8528 jun  9 11:02 ne2k-pci.o
-rw-r--r--    1 root     root         8144 jun  9 11:02 ne.o
-rw-r--r--    1 root     root         9816 jun  9 11:02 n_hdlc.o
-rw-r--r--    1 root     root         9968 jun  9 11:02 ppp_async.o
-rw-r--r--    1 root     root        39428 jun  9 11:02 ppp_deflate.o
-rw-r--r--    1 root     root        23736 jun  9 11:02 ppp_generic.o
-rw-r--r--    1 root     root        22536 jun  9 11:02 ppp_mppe.o
-rw-r--r--    1 root     root        11648 jun  9 11:02 pppoe.o
-rw-r--r--    1 root     root         3616 jun  9 11:02 pppox.o
-rw-r--r--    1 root     root         7920 jun  9 11:02 ppp_synctty.o
-rw-r--r--    1 root     root         6744 jun  9 11:02 slhc.o
[root@versa modules]#
</screen>
<para>3c59x, 8390, eepro100, ne and ne2k-pci are drivers for common network 
cards.</para>
<para>n_hdlc, ppp_generic, ppp_async, ppp_deflate, ppp_synctty, ppp_mppe, pppoe, 
pppox, slhc are ppp and ppp/pppoe related modules.</para>
<para>ip_conntrack_* and ip_nat_* modules are use for masquerading.</para>
<important>
<para>You will probably need to download other modules for your own network card or to 
get access to specific functionnalities (bridge.o for bridging, ...). The whole set of 
Bering linux kernel modules is available for download <ulink 
url="http://prdownloads.sourceforge.net/leaf/Bering_1.0-rc3_modules_2.4.18.tar.gz";>here</ulink>.
 If you just want to download a specific module go through the Bering modules <ulink 
url="http://leaf.sourceforge.net/devel/jnilo/bering/latest/modules/";>download 
area</ulink>.</para>
</important>
</sect1>

--- NEW FILE: bikeybd.xml ---
<sect1 id="bikeybd"><title>Installation - step 4: configure your keyboard</title>
<para>If you are a non US user you will probably need one of the 35 keyboard layouts 
provided in the keyboard.lrp package.</para>
<para>To configure keyboard go to the LEAF packages configuration menu and choose 
keyboard.</para>
<para>The following menu will appear:</para>
<screen>

                        keyboard configuration files

        1) change keyboard language maps

  q) quit
</screen>
<para>Type 1 to get access to the <filename>/etc/init.d/keyboard</filename> script 
where you will have to replace the KEYMAP variable (default="us.map") by the 
appropriate keyboard setting.</para>
<para>The KEYMAP variable must be chosen among the 35 following entries:</para>
<screen>
# azerty.map  cz.map         fi.map         jp.map  ro.map       trq.map
# be.map      de-latin1.map  fr-latin1.map  la.map  ru.map       ua.map
# bg.map      de.map         fr.map         lt.map  se.map       uk.map
# br-a.map    dk.map         gr.map         mk.map  sg.map       us.map
# br-l.map    dvorak.map     hu.map         nl.map  sk-y.map     wangbe.map
# by.map      es.map         il.map         no.map  sk-z.map
# cf.map      et.map         is.map         pl.map  slovene.map
# croat.map   fi-latin1.map  it.map         pt.map  trf.map
</screen>
<para>To activate the new keyboard map get access to the linux shell and type:</para>
<screen>
/etc/init.d/keyboard start
</screen>
<para>You can then remove the keymaps you do not need once you are happy with your 
choice. It will strip the keyboard.lrp package to 1k. From the LEAF console simply 
run:</para>
<screen>
/etc/init.d/keyboard remove
</screen>
<important>
<para>To save your modification(s) do not forget to backup 
<filename>keyboard.lrp</filename>!</para>
</important>
</sect1>

--- NEW FILE: binetwork.xml ---
<sect1 id="binetwork"><title>Installation - step 5: configure your network</title>
<para>You are now going to declare your network configuration through the Network 
configuration menu.</para>
<important>
<para>If you want to permanently change any of the following parameters, do not forget 
to backup etc.lrp !</para>
</important>
<para>Through the LEAF configuration menu type 1 to access to the Network 
configuration menu:</para>
<screen>

                        Network configuration menu

        1) interfaces
        2) hosts IP addresses
        3) hostname
        4) resolv.conf
        5) super server daemon configuration (inetd.conf)
        6) hosts.allow
        7) hosts.deny
        8) networks

  q) quit
  ----------------------------------------------------------------------------
        Selection:

</screen>
<sect2><title>interfaces</title>
<para>By default, the LEAF "Bering" firewall uses eth0 as the external interface with 
a dynamic IP provided by pump.lrp and eth1 as the internal interface at address 
192.168.1.254.</para>
<para>Edit 1) interfaces to modify those settings.</para>
<para>Typical LEAF configurations are provided in the <filename>interfaces</filename> 
file, simply uncomment what you need and comment (#) what you will not need!</para>
<para>Check the <ulink url="./manpages/interfaces_man.html">interfaces</ulink> man 
pages or the Debian network interfaces <ulink 
url="./manpages/interfaces_network.examples">examples</ulink> for more complicated 
setup.</para>
<para>The network configuration is activated in the 
<filename>/etc/init.d/networking</filename> script through the <ulink 
url="./manpages/ifup_man.html">ifupdown</ulink> functions.</para>
<para>Once your interfaces are configured, remember to save and backup the etc.lrp 
package !</para>
<important>
<para>Be sure that any interface change is reflected in your firewall configuration 
(step 6 below). Adjust Shorewall params file accordingly !</para>
</important>
</sect2>
<sect2><title>hosts IP addresses</title>
<para>The <filename>/etc/hosts</filename> file is where you put the name and IP 
address of local hosts. If you place a host in this file, then you do not need to 
query the domain name server to get its IP Address. The disadvantage of doing this is 
that if the IP address for that host changes, you must keep this file up to date 
yourself . In a well managed system, the only hostnames that usually appear in this 
file are an entry for the loopback interface, and also the local hosts name. By 
default:</para>
<screen>
127.0.0.1       localhost
192.168.1.254   firewall
</screen>
<important>
<para>Do not forget to declare the internal address(es) of a ssh client in this file 
if you want to connect quickly to your firewall machine!</para>
</important>
</sect2>
<sect2><title>hostname</title>
<para>By default, the name of your machine is:</para>
<screen>
firewall
</screen>
</sect2>
<sect2><title>resolv.conf</title>
<para>The <filename>/etc/resolv.conf</filename> file is the main configuration file 
for DNS resolution. Its format is quite simple. It is a text file that has one keyword 
per line. There are three keywords typically used by the file. These keywords 
are:</para>
<itemizedlist>
<listitem><para><emphasis>domain</emphasis>: This keyword specifies the local domain 
name</para></listitem>
<listitem><para><emphasis>search</emphasis>: This keyword specifies a list of 
alternate domain names to search for a hostname</para></listitem>
<listitem><para><emphasis>name server</emphasis>: This keyword, which may be used many 
times, specifies an IP address of a domain name server to query when resolving 
names</para></listitem>
</itemizedlist>
<para>By default this file is set to:</para>
<screen>
nameserver      127.0.0.1
nameserver      192.168.1.254
</screen>
<para>You should not need to change it. The file, by default, shows the address of the 
local DNS server (192.168.1.254) provided by dnscache. Pump won't override the address 
unless you implicitly allow it. Check the pump documentation below if you want to 
change that.</para>
</sect2>
<sect2><title>Super server daemon configuration (inetd.conf)</title>
<para>The <filename>/etc/inetd.conf</filename> file is the configuration file for the 
inetd server daemon. Its function is to tell inetd what to do when it receives a 
connection request for a particular service. For each service that you wish to accept 
connections, you must tell inetd what network server daemon to run (and how to run 
it).</para>
<para>Its format is also fairly simple. It is a text file with each line describing a 
service that you wish to provide. Any text in a line following a `#' is both ignored, 
and it is considered a comment. Each line contains seven fields separated by any 
number of whitespace (tab or space) characters.</para>
<para>By default the three following services are open through inetd:</para>
<screen>
ssh     stream  tcp     nowait  root            /usr/sbin/tcpd  /usr/sbin/sshd -i
www     stream  tcp     nowait  sh-httpd        /usr/sbin/tcpd  /usr/sbin/sh-httpd
stat    stream  tcp     nowait  root            /usr/sbin/tcpd  /usr/sbin/stat.sh
</screen>
</sect2>
<sect2><title>hosts.allow</title>
<para>The <filename>/etc/hosts.allow</filename> file is a configuration file for the 
<filename>/usr/sbin/tcpd</filename> program. The <filename>hosts.allow</filename> file 
contains rules describing which hosts are allowed access to a service on your 
machine.</para>
<para>The default for LEAF is:</para>
<screen>
# /etc/hosts.allow: list of hosts that are allowed to access the system.  See
#                   hosts_access(5) and /usr/doc/net/portmapper.txt
#
# Example:    ALL: LOCAL @some_netgroup
#             ALL: .foobar.edu EXCEPT terminalserver.foobar.edu
#
# Allow anything from the local net
ALL: 192.168.1.0/255.255.255.0
</screen>
<para>Any host from the internal network in the 192.168.1.0/24 IP range will be 
allowed to access to ssh, www and stat through inetd.</para>
<para>If you want that only 192.168.1.1 from your internal network can access to the 
firewall through ssh and weblet, you will have:</para>
<screen>
ssh: 192.168.1.1/255.255.255.255
www: 192.168.1.1/255.255.255.255
stat: 192.168.1.1/255.255.255.255
</screen>
</sect2>
<sect2><title>hosts.deny</title>
<para>The <filename>/etc/hosts.deny</filename> file is a configuration file for the 
<filename>/usr/sbin/tcpd</filename> program. The <filename>hosts.deny</filename> file 
contains entries for the rules defining which hosts will NOT be allowed access to a 
service on your machine.</para>
<para>The default in LEAF is:</para>
<screen>
# /etc/hosts.deny: list of hosts that are _not_ allowed to access the system.
#                  See hosts_access(5) and /usr/doc/net/portmapper.txt
#
# Example:    ALL: some.host.name, .some.domain
#             ALL EXCEPT in.fingerd: other.host.name, .other.domain
#
# The PARANOID wildcard matches any host whose name does not match its
# address.
ALL: PARANOID
# Prevent all access not explicitly allowed in hosts.allow
ALL: ALL
</screen>
</sect2>
<sect2><title>network</title>
<para>The <filename>/etc/networks</filename> file has a similar function to that of 
the <filename>/etc/hosts</filename> file.This file provides a simple database of 
network names against network addresses. Its format differs in that there may be only 
two fields per line, and that the fields are coded as:</para>
<para>The default in LEAF is:</para>
<screen>
localnet        127.0.0.0
</screen>
</sect2>
</sect1>

--- NEW FILE: bipackages.xml ---
<sect1 id="bipackages"><title>Information on specific packages</title>
<sect2><title>bridge.lrp</title>
<para>the bridge documentation is available <ulink 
url="bridge.html">here</ulink>.</para>
</sect2>
<sect2><title>dnscache.lrp</title>
<para>A full documentation is available <ulink 
url="http://leaf.sourceforge.net/devel/jnilo/dnscache.html";>here</ulink>.</para>
</sect2>
<sect2><title>pcmcia.lrp</title>
<para>This package is available in the LEAF "Bering" <ulink 
url="http://leaf.sourceforge.net/devel/jnilo/bering/latest/packages/";>packages 
section</ulink>. It is built from <ulink 
url="http://pcmcia-cs.sourceforge.net";>pcmcia-cs</ulink> 3.1.33. To configure pcmcia, 
go to the LEAF packages configuration menu and select pcmcia.</para>
<para>The functionnalities of this package are limited to network, wireless & serial 
setup. The following menu will appear:</para>
<screen>                        pcmcia configuration files

        1) pcmcia default parameters
        2) pcmcia configuration
        3) wireless configuration

  q) quit
  ----------------------------------------------------------------------------
        Selection:
</screen>
<para>Refer to the <ulink 
url="http://pcmcia-cs.sourceforge.net/ftp/doc/PCMCIA-HOWTO.html";>PCMCIA How-to</ulink> 
for a full explanation of the configuration parameters. The man pages are <ulink 
url="http://pcmcia-cs.sourceforge.net/man/index.html";>here</ulink>.</para>
<para>In order to have a working pcmcia package, you need to download in 
<filename>/lib/modules/pcmcia</filename> those modules which are necessary for your 
own PCMCIA card:</para>
<para>Starting with Bering v1.0-rc2, pcmcia modules come from the pcmcia-cs package 
and NOT from the kernel. Non kernel mode PCMCIA support through pcmcia-cs appears more 
stable.</para>
<para>The PCMCIA drivers are <ulink 
url="http://leaf.sourceforge.net/devel/jnilo/bering/latest/modules/drivers/pcmcia/";>here</ulink></para>
<para>Two "core" modules are mandatory: pcmcia_core.o and ds.o and are provided with 
the pcmcia.lrp package. You will then need a socket driver (tcic.o or i82365.o for 
example) and your network card drivers.</para>
<para>The interface provided by your pcmcia hardware (e.g. eth0 and ppp0) should NOT 
be put in the <emphasis>auto</emphasis> statement of the 
<filename>/etc/interface</filename> file. The <filename>/etc/pcmcia/network</filename> 
script will be launched by the cardmgr program which is launched by 
<filename>/etc/init.d/pcmcia</filename> script. The interface configuration will be 
then read from the interface file. See the Bering <ulink url="bupcmcia.html">user's 
guide</ulink> for practical examples.</para>
<para>On the top of the standard <ulink 
url="http://leaf.sourceforge.net/devel/jnilo/bering/latest/packages/pcmcia.lrp";>pcmcia.lrp</ulink>
 package provided without any pcmcia kernel modules, three other packages are provided 
in the Bering package area:</para>
<itemizedlist>
<listitem><para><ulink 
url="http://leaf.sourceforge.net/devel/jnilo/bering/latest/packages/pcmcia_full.lrp";>pcmcia_full.lrp</ulink>:
 provides all the packages of the original pcmcia_cs packages. Not really tested in a 
LEAF environnement and without any pcmcia modules. It is provided for those willing to 
adapt the original pcmcia.lrp package to support ide, scsi or 
parport.</para></listitem>
<listitem><para><ulink 
url="http://leaf.sourceforge.net/devel/jnilo/bering/latest/packages/pcmcia_xircom.lrp";>pcmcia_xircom.lrp</ulink>:
 provides a ready-to-go pcmcia package for XIRCOM 16 bits PCMCIA cards. The necessary 
pcmcia-cs (3.1.33) drivers are included. It has been tested successfully on a RealPort 
Ethernet 10/100 + Modem 56k (REM56G-100BTX). This file is stripped to a bare minimum 
to save space.</para></listitem>
<listitem><para><ulink 
url="http://leaf.sourceforge.net/devel/jnilo/bering/latest/packages/pcmcia_orinoco.lrp";>pcmcia_orinoco.lrp</ulink>:
 provides a ready-to-go pcmcia package for orinoco cards. The necessary pcmcia-cs 
(3.1.33) drivers are included.</para></listitem>
</itemizedlist>
<important>
<para>The previous three packages should be renamed pcmcia.lrp after downloading. Also 
make sure that the modules provided with pcmcia_xircom.lrp and pcmcia_orinoco.lrp 
correspond to the modules provided with your Bering release !</para>
</important>
</sect2>
<sect2><title>ppp.lrp</title>
<para>ppp.lrp provides the ppp daemon patched to allow for PPPoE connection. It will 
also be needed for a standard serial modem connection. To configure ppp go to the LEAF 
Packages configuration menu and choose ppp.</para>
<para>The following menu will appear:</para>
<screen>

                        ppp configuration files

        1) ISP pppd options
        2) ISP login script
        3) System wide pppd options
        4) chap secret
        5) pap secret
        6) pppd daemon script

  q) quit
</screen>
<itemizedlist>
<listitem><para>Option 1 give you access to the 
<filename>/etc/ppp/peer/provider</filename> file. The sample file is ready to use for 
a Compuserve modem dial-up connection. Adjust it to you needs.</para></listitem>
<listitem><para>Option 2 gives you access to the 
<filename>/etc/chatscripts/provider</filename>. The sample file is a sample script 
file for Compuserve. Adjust it to your needs.</para></listitem>
<listitem><para>Option 3 gives you access to the <filename>/etc/ppp/options</filename> 
system wide file</para></listitem>
<listitem><para>Option 4 gives you access to the 
<filename>/etc/ppp/chap-secrets</filename> file</para></listitem>
<listitem><para>Option 5 gives you access to the 
<filename>/etc/ppp/pap-secrets</filename> file</para></listitem>
<listitem><para>Option 6 gives you access to the <filename>/etc/init.d/ppp</filename> 
script file</para></listitem>
</itemizedlist>
<para>The man page for the ppp daemon is available <ulink 
url="./manpages/pppd_man.html">here</ulink>.</para>
<important>
<para>The <filename>peer/provider</filename> and 
<filename>chatscript/provider</filename> files are the one used by default for a modem 
connection. You can ignore those two files if you run ppp.lrp togther with the 
pppoe.lrp package. In this case you will edit the two adsl-provider files available 
through the pppoe configuration menu.</para>
</important>
<para>The Bering pppd daemon comes from the <ulink 
url="ftp://ftp.samba.org/pub/ppp/ppp-2.4.1.tar.gz";>ppp-2.4.1.tar.gz</ulink> package. 
This program is patched for <ulink 
url="http://www.shoshin.uwaterloo.ca/~mostrows/";>pppoe support</ulink> with the <ulink 
url="http://www.shoshin.uwaterloo.ca/~mostrows/ppp-2.4.1-pppoe.patch4";>ppp-2.4.1-pppoe.patch4</ulink>
 patch. The result of the compilation gives the "Bering" pppd daemon provided in 
ppp.lrp.</para>
<para>If you want support for MSCHAP (pptp tunnels) or for the active-filter pppd 
option you will have to replace the pppd daemon provided on the Bering ppp.lrp package 
by the appropriate version available <ulink 
url="http://leaf.sourceforge.net/devel/jnilo/bering/latest/packages/pppd/";>here</ulink>.</para>
<para>The following patched pppd daemons are available:</para>
<screen>
pppd-pptp
        "Bering" pppd daemon + the two following patches:
        ppp-2.4.1-openssl-0.9.6-mppe-patch.gz
        ppp-2.4.1-MSCHAPv2-fix.patch.gz

pppd-pptp-reqmppe
        pppd-pptp + the following patch:
        require-mppe.diff

pppd-pptp-reqmppe-filter
        pppd-pptp-reqmppe compiled with the FILTER flag enabled and
        statiscally compiled against libpcap.

pppd-filter
        "Bering" pppd daemon compiled with the FILTER flag enabled and
        statically compiled against libpcap. No pptp support.
</screen>
</sect2>
<sect2><title>pppoe.lrp</title>
<para>pppoe.lrp provides the PPPoE 2.4.16 kernel plugin to allow for a kernel based 
PPPoE connection. To configure PPPoE, go to the LEAF packages configuration menu and 
select pppoe.</para>
<para>The following menu will appear:</para>
<screen>

                        pppoe configuration files

        1) DSL pppd options
        2) pap secret

  q) quit
</screen>
<itemizedlist>
<listitem><para>Option 1 give you access to the 
<filename>/etc/ppp/peer/dsl-provider</filename> file. The sample file is ready to use 
for T-DSL. Adjust it to you needs.</para><para>IMPORTANT: be sure to change the user 
<emphasis>papname</emphasis> with your valid login name. Usually you need the 
@provider.com suffix. This name must be the same as the one in the 
<filename>/etc/ppp/pap-secrets</filename> below.</para></listitem>
<listitem><para>Option 2 gives you access to the 
<filename>/etc/ppp/pap-secrets</filename> file. The format is 
<emphasis>username</emphasis> (the same as above) * 
<emphasis>yoursecret</emphasis></para></listitem>
</itemizedlist>
<warning>
<para>The LEAF "Bering" distribution uses the PPPoE kernel mode plugin. Do not use the 
instructions for Roaring Penguin pppoe!</para>
</warning>
</sect2>
<sect2><title>pump.lrp</title>
<para>Pump is the DHCP/BOOTP client from Redhat. To configure it go to the LEAF 
packages configuration menu and choose pump.</para>
<para>The following menu will appear:</para>
<screen>
                        pump configuration files

        1) pump configuration file
        2) pump default config file
        3) pump init script

  q) quit
</screen>
<itemizedlist>
<listitem><para>Option 1 give you access to the pump configuration file 
(<filename>/etc/pump.conf</filename>). Man pages are available <ulink 
url="./manpages/pump_man.html">here</ulink>.</para></listitem>
<listitem><para>Option 2 defines default parameters</para></listitem>
<listitem><para>Option 3 gives you access to the <filename>/etc/init.d/pump</filename> 
script (experienced users only!)</para></listitem>
</itemizedlist>
</sect2>
<sect2><title>vlan.lrp</title>
<para>This package is available in the LEAF "Bering" <ulink 
url="http://leaf.sourceforge.net/devel/jnilo/bering/latest/packages/";>packages 
section</ulink>. It provides the <ulink url="./manpages/vconfig.html">vconfig</ulink> 
program and the necessary scripts. The vconfig program comes from the <ulink 
url="http://www.candelatech.com/~greear/vlan.html";>vlan linux</ulink> web site where 
you will find useful information.</para>
</sect2>
<sect2><title>tc.lrp</title>
<para>The tc.lrp package provides the tc program from the iproute2 utilities used with 
LEAF "Bering". There is no configuration file for this program, which is only used if 
you want for traffic-shapping through Shorewall. Refer to the <ulink 
url="http://www.shorewall.net/traffic_shaping.htm";>shorewall documentation</ulink> if 
you are planning to use traffic-shapping.</para>
</sect2>
<sect2><title>wireless.lrp and wireutil.lrp</title>
<para>These packages are available in the LEAF "Bering" <ulink 
url="http://leaf.sourceforge.net/devel/jnilo/bering/latest/packages/";>packages 
section</ulink>. They provide the wireless utilities <ulink 
url="./manpages/iwconfig.html">iwconfig</ulink>, <ulink 
url="./manpages/iwgetid.html">iwgetid</ulink>, <ulink 
url="./manpages/iwlist.html">iwlist</ulink>, <ulink url="iwpriv.html">iwpriv</ulink> 
and <ulink url="./manpages/iwspy.html">iwspy</ulink>. You need to download the <ulink 
url="http://leaf.sourceforge.net/devel/jnilo/bering/latest/packages/libm.lrp";>libm.lrp</ulink>
 package to have a working wireless.lrp and wireutil.ltrp package. There is no 
configuration file for those packages which are typically used in cunjunction with 
pcmcia.lrp. In most cases only wireless.lrp will be necessary.</para>
</sect2>
</sect1>

--- NEW FILE: bishorwall.xml ---
<sect1 id="bishorwall"><title>Installation - step 6: configure Shorewall</title>
<para>One of the distintive feature of Bering is that it relies on <ulink 
url="http://www.shorewall.net/";>Shorewall</ulink> to provide it's firewall 
facility.</para>
<para>The reasons behind this choice are numerous:</para>
<itemizedlist>
<listitem><para><ulink url="http://www.shorewall.net/";>Shorewall</ulink> is an <ulink 
url="http://www.netfilter.org/";>iptables</ulink> based firewall which offers many 
features (Masquerading/SNAT, Port forwarding, Static NAT, Proxy ARP, VPN support, 
Traffic Control/Shaping) which are described in greater detail <ulink 
url="http://www.shorewall.net/shorewall_features.htm";>here.</ulink></para></listitem>
<listitem><para>It is a very powerfull tool with which it is "simple to do simple 
things" but which also offers a great flexibility.</para></listitem>
<listitem><para>It is very well documented. I strongly recommend that you print out 
the full documentation available in pdf format in the Shorewall <ulink 
url="http://www.shorewall.net/pub/shorewall";>download area</ulink> and that you spend 
the time to understand the concept behind it. A worthwhile effort !</para></listitem>
<listitem><para>It has a nice <ulink 
url="http://www.shorewall.net/shorewall_quickstart_guide.htm";>QuickStart Guide</ulink> 
which will allow the reader to quickly grasp the basics. A prerequisite reading 
!</para></listitem>
<listitem><para>It has a tremendous support from it's developper, Tom Eastep, who 
replies very quickly to requests addressed to the <ulink 
url="http://www.shorewall.net/mailing_list.htm";>shorewall user's mailing list</ulink>. 
Mail archives are also available and searchable.</para></listitem>
</itemizedlist>
<para>The shorwall.lrp package provided on the Bering distro (starting with v1.0-rc2) 
is built as follow:</para>
<itemizedlist>
<listitem><para>Download the <ulink 
url="http://www.shorewall.net/pub/shorewall/LATEST.lrp";>LATEST.lrp</ulink> package 
from Tom's site and rename it shorwall.lrp.</para></listitem>
<listitem><para>Download either the <ulink 
url="http://www.shorewall.net/pub/shorewall/LATEST.samples/two-interfaces.tgz";>Two-interfaces</ulink>
 Masquerading Firewall or the  <ulink 
url="http://www.shorewall.net/pub/shorewall/LATEST.samples/three-interfaces.tgz";>Three-interfaces</ulink>
 Masquerading Firewall with DMZ depending on your own situation. They will provide you 
with default setup for the  interfaces, masq, policy, rules and zones files that will 
be used in replacement of those provided in Tom's original package.</para></listitem>
<listitem><para>Add two statements in the "rules" file in order to allow query to 
dnscache and weblet servers from the internal network. See below.</para></listitem>
<listitem><para>Create an OUTPUT file in <filename>/etc/shorewall</filename>with a 
unique statement that will take care of the icmp-dnat netfilter bug 
workaround:</para></listitem>
</itemizedlist>
<screen>
# Take care of icmp-dnat netfilter bug workaround
# http://www.netfilter.org/security/2002-04-02-icmp-dnat.html
# JN June 2002. Suggestion by Tom Eastep (Thks Tom !)
run_iptables -I OUTPUT 3 -m state -p icmp --state INVALID -j DROP
</screen>
<para>The four previous steps will allow you to update shorwall.lrp on your own Bering 
distro whenever a more recent Shorewall version is released.</para>
<important>
<para>Bering shorwall.lrp package is provided by default with the Two-interfaces 
Masquerading Firewall and the two extra rules mentionned earlier. This setup assumes 
that eth0 is connected to the Internet via a dynamic IP and that your local network is 
interfaced through eth1.</para>
</important>
<para>To configure Shorewall, start the LEAF packages configuration menu and choose 
shorwall. The following menu will appear:</para>
<screen>

                        shorwall configuration files

        1) <ulink 
url="http://www.shorewall.net/Documentation.htm#Variables";>Params</ulink>    Assign 
parameter values
        2) <ulink url="http://www.shorewall.net/Documentation.htm#Zones";>Zones</ulink> 
    Partition the network into Zones
        3) <ulink 
url="http://www.shorewall.net/Documentation.htm#Interfaces";>Ifaces</ulink>    
Shorewall Networking Interfaces
        4) <ulink url="http://www.shorewall.net/Documentation.htm#Hosts";>Hosts</ulink> 
    Define specific zones
        5) <ulink 
url="http://www.shorewall.net/Documentation.htm#Policy";>Policy</ulink>    Firewall 
high-level policy
        6) <ulink url="http://www.shorewall.net/Documentation.htm#Rules";>Rules</ulink> 
    Exceptions to policy
        7) <ulink url="http://www.shorewall.net/Documentation.htm#Masq";>Masq</ulink>   
   Internal MASQ Server Configuration
        8) <ulink 
url="http://www.shorewall.net/Documentation.htm#ProxyArp";>ProxyArp</ulink>  Proxy ARP 
Configuration
        9) <ulink url="http://www.shorewall.net/Documentation.htm#Nat";>Nat</ulink>     
  Static NAT Configuration
        10) <ulink 
url="http://www.shorewall.net/Documentation.htm#Tunnels";>Tunnels</ulink>   Tunnel 
Definition (ipsec)
        11) <ulink 
url="http://www.shorewall.net/traffic_shaping.htm#tcrules";>TCRules</ulink>   FWMark 
Rules
        12) <ulink 
url="http://www.shorewall.net/Documentation.htm#Conf";>Config</ulink>    Shorewall 
Initialization Configuration
        13) <ulink 
url="http://www.shorewall.net/Documentation.htm#Modules";>Modules</ulink>   Netfilter 
modules to load
        14) <ulink url="http://www.shorewall.net/Documentation.htm#TOS";>TOS</ulink>    
   Type of Service policy
        15) <ulink 
url="http://www.shorewall.net/Documentation.htm#Blacklist";>Blacklist</ulink> 
Blacklisted hosts
        16) <ulink 
url="http://www.shorewall.net/Documentation.htm#rfc1918";>RFC1918</ulink>   Defines 
'norfc1918' interface option

  q) quit
  ----------------------------------------------------------------------------
        Selection:
</screen>
<para>Check the hyperlinks above, the <ulink 
url="http://www.shorewall.net/shorewall_quickstart_guide.htm";>Quickstart Guide</ulink> 
or the Shorewall <ulink 
url="http://www.shorewall.net/Documentation_Index.htm";>documentation</ulink> to have a 
full explanation on those configuration files.</para>
<para>Four files must be checked absolutely to make sure they fit your needs:</para>
<para>A/ The <filename>zone</filename> file (entry 2). For a two interfaces setting - 
Bering's default - it looks like:</para>
<screen>
#ZONE   DISPLAY         COMMENTS
net     Net             Internet
loc     Local           Local networks
#LAST LINE - ADD YOUR ENTRIES ABOVE THIS ONE - DO NOT REMOVE  a>
</screen>
<para>B/ The <filename>interfaces</filename> file (entry 3) defines your interfaces. 
Default in Bering is:</para>
<screen>
(...)
#ZONE   INTERFACE       BROADCAST       OPTIONS
net     eth0            detect          dhcp,routefilter,norfc1918
loc     eth1            detect          routestopped
#LAST LINE -- ADD YOUR ENTRIES BEFORE THIS ONE -- DO NOT REMOVE
</screen>
<para>C/ The <filename>rules</filename> file (entry 6) is one of the most important 
files in Shorewall. Here is the one from Bering: </para>
<screen>
(...)
#                       Your entries for this setup would look like:
#
ACCEPT          fw        net           tcp     53
ACCEPT          fw        net           udp     53
#
# Accept SSH connections from the local network for administration
#
ACCEPT          loc       fw            tcp     22

# Bering specific rules:
# allow loc to fw udp/53 for dnscache to work
# allow loc to fw tcp/80 for weblet to work
#
ACCEPT          loc       fw            udp     53
ACCEPT          loc       fw            tcp     80
#LAST LINE -- ADD YOUR ENTRIES BEFORE THIS ONE -- DO NOT REMOVE
</screen>
<para>As you can notice from above, two rules have been added to the two-interfaces 
file. They allow:</para>
<itemizedlist>
<listitem><para>UDP requests from the local network (loc) to the firewall (fw) on port 
53. This is the port used by dnscache to listen at dns requests coming from the 
internal network.</para></listitem>
<listitem><para>TCP requests from the local network (loc) to the firewall (fw) on port 
80. This is the port used by weblet for its web server.</para></listitem>
</itemizedlist>
<para>D/ Finally the <filename>masq</filename> file (entry 7). In Bering it looks 
like:</para>
<screen>
(...)
#INTERFACE              SUBNET
eth0                    eth1
#LAST LINE -- ADD YOUR ENTRIES ABOVE THIS LINE -- DO NOT REMOVE
</screen>
<important>
<para>If you change any of the shorewall parameters, remember to backup shorwall.lrp 
!</para>
</important>
</sect1>

--- NEW FILE: bumodem.xml ---
<sect1 id="bumodem"><title>Serial Modem configuration</title>
<sect2><title>Objectives</title>
<para>We assume here that you can only get connected to internet through a serial 
modem connection and that you want to share that connection with other (internal) 
computers in your home or office.  What follows describe the configuration of this 
dial-up modem router. Your external interface (to the internet) will be ppp0, your 
internal interface (to your internal network) is supposed to be done through an 
ethernet network card (eth0).</para>
<para>What follows has been tested with Bering v1.0-rc1 on a Pentium 133 machine and a 
US Robotics external modem connected to com1 (ttyS0). Lee provided useful additions to 
this section</para>
<para>The <ulink 
url="http://www.linuxdoc.org/HOWTO/PPP-HOWTO/index.html";>PPP-Howto</ulink> is a useful 
reference for this section.</para>
<para>Comments on this section should be addressed to its maintainer: Jacques Nilo 
<email>[EMAIL PROTECTED]</email>.</para>
</sect2>
<sect2><title>Step 1: declare the ppp package</title>
<para>Boot a Bering floppy image. Once the LEAF menu appears get access to the linux 
shell by (q)uitting the menu. Edit the <filename>syslinux.cfg</filename> file and 
replace the pump entry by ppp in the LRP= list of packages to be loaded at boot. Check 
the Bering <ulink url="leaffw04.html">installation guide</ulink> to learn how to do 
that.</para>
<para>Your <filename>syslinux.cfg</filename> file could look like (adjust to your 
tastes):</para>
<screen>display syslinux.dpy
timeout 0
default linux initrd=initrd.lrp init=/linuxrc root=/dev/ram0 boot=/dev/fd0u1680:msdos
        PKGPATH=/dev/fd0u1680 
LRP=root,etc,local,modules,ppp,keyboard,shorwall,dnscache,weblet
</screen>
</sect2>
<sect2><title>Step 2: declare the serial and ppp modules</title>
<para>In order to have a modem dialup connection working, you need to have serial and 
ppp support enabled through the appropriate kernel modules. You also need to declare 
the driver module of the network card assigned to your internal network. In the 
following example, this card is supposed to be a standard ne 2000 PCI card.</para>
<para>To configure your modules, go to the LEAF Packages configuration menu and choose 
modules. Enter 1) to edit the <filename>/etc/modules</filename> file and enter the 
following information:</para>
<screen>
# 8390 based ethernet cards
8390
ne2k-pci

# Modules needed for PPP connection
serial
slhc
ppp_generic
ppp_async
ppp_deflate

# Masquerading 'helper' modules
ip_conntrack_ftp
ip_conntrack_irc
ip_nat_ftp
ip_nat_irc
</screen>
<important>
<para>The sample file above might be different in your own case: you might need 
another network module or some extra functionnalities. Adjust to your needs !</para>
</important>
<para>Backup the modules.lrp package.</para>
</sect2>
<sect2><title>Step 3: configure ppp</title>
<para>Connection with your ISP will be handled by PPP. The PPP How-to document will 
give you very detailed information about this protocol and how to set-up the numerous 
parameters.</para>
<para>Through the LEAF packages configuration get access to ppp configuration. The 
following menu will show-up</para>
<screen>
                        ppp configuration files

        1) ISP pppd options
        2) ISP login script
        3) System wide pppd options
        4) chap secret
        5) pap secret
        6) pppd daemon script

  q) quit
  ----------------------------------------------------------------------------
        Selection:
</screen>
<para>Entry 1) allows you to adjust the parameter of your ppp connection through the 
<filename>/etc/ppp/peers/provider</filename> file. The most important argument is the 
<emphasis>ttySx</emphasis> parameter which defines the serial port to which your modem 
is connected.</para>
<tip>
<para>Look at your <filename>/var/log/syslog</filename> file after booting Bering. It 
will give you the list of the serial ports recognized by your linux kernel.</para>
</tip>
<para>A working <filename>/etc/ppp/peers/provider</filename> file for a Compuserve 
connection could look like:</para>
<screen>
# ISP pppd options file
# What follows is OK for Compuserve
#
noauth
debug           # log transaction to /var/log/messages
/dev/ttyS0      # (ttyS0=com1, ttyS1=com2, ...)
115200          # baud  rate
modem
crtscts         # use hardware flow control
asyncmap 0
defaultroute    # ppp becomes default route to the internet
noipdefault
lock            # don't let other processes besides PPP use the device
connect "/usr/sbin/chat -v -f /etc/chatscripts/provider"
</screen>
<para>If you plan to dial into a Windows RAS server or a server that uses PAP or CHAP 
authentication, you need to add a line to this file. Just above the "connect" command, 
on a line of its own, add "name &lt;ISPUserID>" where &lt;ISPUserID> is the login name 
your ISP gave you. You need this because ppp has to masquerade the firewall as you 
when using PAP or CHAP authentication.</para>
<para>Entry 2) allows you to adjust the communication script which will handle the 
connection with your ISP. This script is stored in the 
<filename>/etc/chatscripts/provider</filename></para>
<para> If you are not using Compuserve you should also delete all of the lines below 
the "comment" line. A few - very few - ISPs require the final "PPP" line these 
days.</para>
<para>A working script for a Compuserve connection could look like:</para>
<screen># ISP login script
# What follows is OK for Compuserve
# Adjust to your taste
ABORT "BUSY"
ABORT "NO CARRIER"
ABORT "VOICE"
ABORT "NO DIALTONE"
ABORT "NO ANSWER"
"" ATZ
# ISP telephone number: 124567890
OK ATDT1234567890#
CONNECT ''
Name: CIS
# With compuserve your_login_account=12345,6789
ID: your_login_account/go:pppconnect
Password: your_password
PPP
</screen>
<para>Edit Entry 3) - /etc/ppp/options "System-wide pppd options" if you want the 
system to demand dial and to drop the line if idle for a preset time. To do this, 
change "persist" to "demand" and add another line below "demand" that says "idle 600", 
where 600 is the number of seconds the system should wait before dropping hanging up 
if there is no network traffic.</para>
<para>Edit either the PAP (Entry 4) or CHAP (Entry 5) option to set up how your system 
authenticates. For PAP authentication, choose the PAP option and add a line saying 
"&lt;ISPUserID> * &lt;ISPUserPassword> to the bottom of the file. &lt;ISPUserID> is 
the same entry that you made in Entry 1) - the "ISP pppd ptions" file. The 
&lt;ISPUserPassword> entry is self-explanatory. The "*" can be replaced with the IP 
address or name of the server you are dialling into if you know it. Usually, an 
asterisk is sufficient. If you want to authenticate using CHAP, add the same entry to 
the CHAP item instead.</para>
<para>Backup the ppp.lrp package.</para>
</sect2>
<sect2><title>Step 4: configure your interface file</title>
<para>Trough the LEAF configuration menu type 1 to access to the network configuration 
menu and 1 again to edit your <filename>/etc/network/interfaces</filename> file. Enter 
the following information:</para>
<screen>
auto lo ppp0 eth0

iface lo inet loopback

iface ppp0 inet ppp
        provider provider

iface eth0 inet static
        address 192.168.1.254
        masklen 24
        broadcast 192.168.1.255
</screen>
<para>The "auto" statement declares all the interfaces that will be automatically set 
up at boot time. This job will be carried out by the "ifup -a" statement in the 
<filename>/etc/init.d/networking</filename> script.</para>
<para>The syntax if "iface" statements is explained in the Bering's installation 
guide.</para>
<para>Backup the etc.lrp package.</para>
</sect2>
<sect2><title>Step 5: configure Shorewall</title>
<para>Through the LEAF packages configuration menu, choose shorwall and check the two 
following files:</para>
<para>A/ The <filename>interfaces</filename> file (entry 3) defines your interfaces. 
Here connection to the net goes through ppp0. So we must set:</para>
<screen>
(...)
#ZONE   INTERFACE       BROADCAST       OPTIONS
net     ppp0            -               dhcp,routefilter,norfc1918
loc     eth1            detect          routestopped
#LAST LINE -- ADD YOUR ENTRIES BEFORE THIS ONE -- DO NOT REMOVE
</screen>
<warning><para>Do not forget the "-" under the BROADCAST heading for the net/ppp0 
entry.</para></warning>
<para>B/ The <filename>masq</filename> file (entry 7). With a dial-up modem setup it 
should look like:</para>
<screen>
(...)
#INTERFACE              SUBNET
ppp0                    eth0
#LAST LINE -- ADD YOUR ENTRIES ABOVE THIS LINE -- DO NOT REMOVE
</screen>
<para>Backup the shorwall.lrp package.</para>
</sect2>
<sect2><title>Step 6: reboot...</title>
<para>Your modem connection should be established automatically. Type 
<emphasis>plog</emphasis> to check the login sequence with your ISP. If there is no 
output check <filename>/var/log/syslog</filename> to get a clue on potential 
problems.</para>
<tip>
<para>If you want to be sure that your modem and/or script parameters are OK before 
backing up ppp.lrp, you can launch the connection manually just by typing 
<emphasis>pon</emphasis>. Use the <emphasis>plog</emphasis> command to see how the 
connection is going and <emphasis>poff</emphasis> to close down your ppp 
connection.</para>
</tip>
</sect2>
</sect1>




-------------------------------------------------------
This sf.net email is sponsored by: OSDN - Tired of that same old
cell phone?  Get a new here for FREE!
https://www.inphonic.com/r.asp?r=sourceforge1&refcode1=vs3390
_______________________________________________
Leaf-cvs-commits mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/leaf-cvs-commits

Reply via email to