Install notes for SmoothWall Version 0.9 (29/08/00)
By Lawrence Manning (lawrence@aslak.demon.co.uk)
and Jon Fautley (jon@filbert-da-frog.co.uk)

Remember to check our sourceforge site for updates!
(sourceforge.net/projects/smoothwall/)

UPDATE UPDATE UPDATE UPDATE UPDATE UPDATE UPDATE UPDATE UPDATE UPDATE UPDATE 

1st Sept 2000

CDROM support is known not to work :-( I forgot to add joilet support in
the kernel, hence it couldn't read the long filenames.

BETA BETA BETA BETA BETA BETA BETA BETA BETA BETA BETA BETA BETA BETA BETA 

This is a temporary document, giving people who are interested in looking at
SmoothWall a taster for how to install it.  Be especially aware that CDROM
installing is not tested!  But the network install works nicely.

WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING

This is a complete (if very small) linux distribution and if you install it, it
will reformat your harddisk!!!!!  Do not under any circumstances run the
installer on a machine you have data you wish to keep on!

This file describes how to install v0.9 of SmoothWall.

Requirements
------------

386 with 8meg.  Lowest spec so far tested is a 486DX4 with 32meg.  Should
easily run on a DX2 with 8meg. Any 2.2.16 suppored network card.  Modem on
ttyS0 or ttyS1.  80meg of IDE harddisk.  An IDE CDROM.  Alternativly, the common
"old style" CDROM interfaces are supported, such as the SoundBlaster ones.  Only
the SB16 driver has been tested, but the others should all work.  You will
probably need to supply IO/IRQ information!

Files
-----

smoothwall-disk1-0.9.gz is a compressed image of the boot disk.  gzip -d it, and
dd it to a formatted floppy: dd if=smoothwall-disk1-0.9 of=/dev/fd0 bs=1k 
count=1440.

smoothwall-disk2-0.9.gz is required if you are installing across a network. 
Copy to a formatted floppy, as above.

smoothwall-cdrom-0.9.gz is a ISO image of the installation CDROM.  It is not
currently bootable.

smoothwall-install-0.9.tar.gz is the source code to the install program. It uses
a simple Makefile.  smoothwall-cgi.0.9.tar.gz is the basic SmoothWall cgi files.
They are tarred up relative to root.

Installing
----------

CDROM installing hasn't yet been tested, as I don't currently have a CD burner.
Sorry. :(

Boot the disk1 floppy. Choose whether you are installing from CDROM or network.
If installing from CDROM, put the CD in the drive, and continue. If installing 
from the network, see below.

The harddisk will be repartitioned and filesystems created.

Next you will have to setup the network.  Give the driver name, such as ne,
ne2k-pci etc.  This is lame :( I will add auto-detecting later.  Give  the
IP address information.

Next, the files should be installed (untarred).  For network installs, give a
URL to the smoothwall.tgz file.  Then you will have to give a root and 
SmoothWall admin password.  Then you can reboot the SmoothWall, and point your
webbrowser at:

http://machine/cgi-bin/index.cgi

And configure.... Good Luck!  Remember: To IP masquarade through SmoothWall, you
should set each desktop's default gateway to the SmoothWall machine, and set
the DNS to the IPS's DNS servers.

Yes, there is alot to do!

Installing over the network:
----------------------------

For this to work, you will need loopback-fs support in your kernel. For help
with recompiling your kernel, see the Kernel-HOWTO.

A. Setup the loopback FS and point it at the ISO image on your harddrive:

root# losetup /dev/loop0 smoothwall-cdrom-0.9
mount /dev/loop0 /cdrom

B. Copy the file to your webserver: 
cp /cdrom/smoothwall.tgz /home/httpd/html

Then your all set for a network install! Good Luck...

Bugs
----

Currently, insufficient checking for shell backticking etc. characters in 
fields before pppd is called. Will be fixed in next release.
