SmoothWall Install Guide

By Jon Fautley (filbert@webbedmail.com) and Tom Ellis (trellis@webbedmail.com)
Edited by Richard Morrell (rmorrell@valinux.com) and Lawrence Manning
(guru@smoothwall.org)

Version: 1.2 - Date: 20/09/00

This is the SmoothWall installation guide. It will tell you how to install
SmoothWall onto your computer.  For post-install configuration, please see
the configuration guide.

1. The SmoothWall CD

There are two ways to get at the files contained within the ISO image
file.  The first is to burn it to a writeable CD.  The second is to mount
it via loopback from a Linux workstation.

The Smoothwall ISO image can be found at:
sourceforge.net/projects/smoothwall

Our example filename smoothwall-cdrom-X.Y.Z.iso, where X, Y and Z are the
version numbers.

1.1. Burning the ISO file under Linux

    cdrecord dev=0,SCSI_ID,0 smoothwall-cdrom-X.Y.Z.iso 

1.2. Burning the ISO file under Windows

Under Windows there are many CD recording programs, each of which works
slightly differently.  We have chosen to use the application CDRWin, which
you should be able to adapt to your particular choice of burning software.

In CDRWin use the file backup utilities, this is represented by the
'Screwdriver and Spanner' from the menu.

When the window loads change the combo box to 'Record ISO9660' and then
point the image location to the location of the SmoothWall ISO file.  
Stick in a CDR or CDRW recordable media and proceed.

The default settings are fine as long as CDRwin is already working you
should be all right.  We have certainly not experienced any difficulties.

We have tested our ISO images with:

Adaptec DirectCD which immediately created an ISO image by double clicking
on the file we had previously FTP'd from our Linux test download server as
the registry in Windows 9x had picked up the association and within
minutes we had a bootable ISO CD to work with.

Nero v 5.0 which also produced in around the same time a perfect working
CD image

1.3. Mounting under Loopback

If you do not have a CD burner, you can still install SmoothWall via your
network.  To do this, you will need to access the files from the ISO image
file, and then create two floppy disks.

To mount the ISO file under Linux, do the following:

    losetup /dev/loop0 smoothwall-X.Y.Z.iso
    mount /dev/loop0 /mnt/cdrom

You will now see the contents of the SmoothWall CDROM under /mnt/cdrom.  
Now you can create the floppy disks.

When you have finished, make sure you unmount and remove loop0, before you
do anything to the iso file:

    umount /mnt/cdrom
    losetup -d /dev/loop0

2. Preparing to Install

There are two ways to install SmoothWall.  You can either install directly
from the CDROM, using a bootdisk or by booting directly off the CDROM, or
you can install across a network.

2.1. CDROM Installation from a Bootable CDROM Drive

Before you start make sure that you have set your computer to boot from
the CDROM in the BIOS.  Also if you have downloaded the iso image from the
SmoothWall site or a mirror please ensure that you have copied it
correctly.  Instructions on coping are included in this guide.

1. Insert the SmoothWall CD into your CDROM drive.

2. Turn on machine and wait till you are greeted with the LILO: prompt.  

3. Now hit return and your screen should fill with text, this will be the
SmoothWall install kernel booting.  Soon after this you will forced into
the install program.

4. Now follow the prompts, select Ok.  Then choose your installation
media. There are two options: CDROM and FTP or HTTP

5. After you have selected the media type you will be prompted to insert
the CDROM into the drive.  In this case you should have the SmoothWall
disk still in the drive as you booted it.  At this point, it will attempt
to automatically find an ATAPI CDRom drive in your system.  If it cannot
find one, you will be presented with a list of 'old style' CDRom drive.  
Select yours from the list, and continue.

6. You are now ready to move onto the Main Install section.

2.2. Installing via a Network

1. You need to create both of the SmoothWall bootdisks.  You will need two
1.44Mb formatted floppies. From a Linux box, you need to be logged in as
'root' and do the following:

a) Label the disks 'SmoothWall Disk1' and 'SmoothWall Disk2'

b) There are two disk images on the cdrom: smoothwall-disk1-X.Y.Z and
smoothwall-disk2-X.Y.Z

c) Copy the image file to the floppy disk: dd if=smoothwall-disk1-X.Y.Z
of=/dev/fd0 bs=1k count=1440

d) Repeat the above, but replace the disk1 with disk2.

2. Now that you have both of the SmoothWall install disks, you are ready
to proceed. You will need to get the smoothwall.tgz file off the CD image.  
You can either use the loopback method, or copy from a burnt CD.

3. Now you need to copy this file to the directory used for sharing files
to the outside world.  You need access to a server running on the network
and also running a webserver or an FTP service.  We will assume you are
using HTTP (web):

Copy the file to the root directory of your webserver.  Assuming the CDROM
is mounted under /mnt/cdrom, and web server path is /home/httpd/htdocs,
you would execute the command:

     cp /mnt/cdrom/smoothwall.tgz /home/httpd/htdocs

4. You should now have both of the disks made, and the file ready to be
served from your web/ftp server.  Now, you need to go over to the box you
are going to install SmoothWall onto, and put the "SmoothWall Disk1" disk
into the floppy drive. Then switch the box on. You should get a prompt
saying 'LILO boot:'

5. Press 'Enter' and the kernel will load, and after a few seconds, you
will get the install program loaded. If you have any problems, it's
probably because your boot disk is corrupt, get a new one.

6. After going through the information dialogs, you will get to the
'Select Installation Media' dialog.  Select 'FTP or HTTP' as your install
method.

7. You will now need to change disks to Disk2, and select 'Ok'.

8. You will now be warned that the install program is about to wipe ALL
THE DATA ON YOUR HARDDISK!!!!  TAKE NOTE!!  This procedure CANNOT be
undone.  Select'Ok' to continue.

9. You are now ready to move to the Main Install section.

3. Main Install

This is the main install section for SmoothWall.  Regardless of the
install method you use, you will need to follow the instructions here.

1. After partitioning, the Install program will attempt to detect which
network card you have installed in this machine.  It will check for the
presence of around 40 cards.  If this fails, you will need to enter the
Linux module name for the particular card.  EXAMPLE:

For our installation we used a standard NE 2000 network card, which comes
under the module name ne.  Because this an ISA card, and requires one
additional parameter, the IO port address, the autodetection will fail.  
We entered the module name and parameters when asked.  In our case, this
was 'ne io=0x300'. The module will then load successfully and installation
can continue.

2. You have now reached the network setup page.  This page requires you to
enter an IP (Internet Protocol) Address which will be the address to
access your machine on the local network.  We suggest you write down all
information in this section as it can be handy to have the information
ready for client configuration.  Choose a suitable IP address, if your
network is already setup then select an approprate IP.

EXAMPLE:

A network has computers on the 192.168.0.0 network.  Routers are commonly
placed at the end or start of the address range so we will choose an IP
address of 192.168.0.1.

Network Address:

With our example this would be: 192.168.0.0
  
Network Mask:

The network mask in our example is: 255.255.255.0.  This means the last
digit in our address is used for the host, the rest is the network
portion.

Press return on the OK button.

If you are performing a network install, at this point you will be asked to
enter a URL so the Install program can download the smoothwall.tgz file. 
Assuming you copied the smoothwall.tgz to a webserver with IP address of
192.168.1.2, the URL entered in the box would be:

    http://192.168.1.2/smoothwall.tgz

3. SmoothWall will now proceed to install on your system, watch the status
bar and it will give you a idea into what it is doing.

4. Now, set the root password which will be the account password for the
user root when you reboot your machine. This account is only needed if you
want to be able to directly login to SmoothWall and access the shell. Now
set the password for the SmoothWall admin web user.  This password will be
used when using the web pages contained in SmoothWall.  This user can
Dial, Hangup and setup the necessary details for the site.

5. Almost finished. LILO (the Linux bootloader) will then install to make
the harddisk bootable.  If you installed via the CDROM, the SmoothWall
CDROM disk will eject.  Select Ok to reboot the machine.

Please remember to remove all media from drives.  As if you do not your
drive may close with the Smoothwall CD still in it and will re-initialise
the installation procedure.

Congratulations !!!

6. SmoothWall Linux has now successfully been installed on your system, as
your system reboots wait for the LILO prompt. Hit the return key.  
SmoothWall will then boot and start its services.  Then you should be
presented with a login in prompt similar to this:

    SmoothWall vX.Y.Z - http://www.smoothwall.org
    smoothwall login:

Your machine is now running SmoothWall Linux, please now consult the
configuration guide on how to configure your SmoothWall firewall dialup
router.



Microsoft Windows, Nero, Adaptec DirectCD and CDRWin are registered
trademarks of their registered owners, Linux is a registered trademark of
Linus Torvalds, SmoothWall is a trademark of Lawrence Manning and Richard
Morrell. SmoothWall is based on VA Linux 6.2.1 which is an optimised
release of RedHat 6.2.

Further bug track reports, FAQ's and instructions will be available at
www.smoothwall.org

We draw your attention to the terms and conditions of the GNU Public
Licence under which SmoothWall is developed and distributed - a copy of
this can be found on the installation media or on www.gnu.org