LEAF Linux Embedded Appliance Framework Files

##################################################################
############ README FOR DACHSTEIN INSTALL SCRIPTS ################
############ by Lynn Avants GPL2 2002             ################
##################################################################


## General Description

The scripts.tar.gz archive contains a two folders with a set of install scripts
for the Dachstein v1.0.2 floppy and cdrom releases respectively. These scripts
only work on regular ethernet (cable) connections right now (ie... no ppp or
pppoe support yet-these will be released as seperate releases when I get them
written). Typical uses will be on non-login cablemodem/network connections.
The scripts generate Dachstein-compliant /etc/modules and /etc/network.conf
files with prompted save and backup options. The backup option is only set to
work on a 1.68M floppy for the DCD floppy version and 1.44M floppy for the
DCD cdrom image. For those using different size/type disks, the scripts will
work, but you will have to backup manually. The scripts should make setup for
first time users _much_ less confusing. Respectively, if you have used the
"mountain" branch images for some time, you'll fine it won't be any different
to setup... it could save a little time if you can spare the disk space though.



## Includes....How to get on your disk.

You can unpack the scripts with the command (In Linux):

        tar -xvzf ./scripts.tar.gz | tar xv

You will have a folder named "scripts" with two folders inside of it.
These two folders, named "cd-scripts" and "floppy-scripts" will contain
the proper scripts for your version of Dachstein. The individual scripts
are named:

        install.sh
        install.modules.sh
        install.network.sh
        lrcfg

You will need to copy these files to the "/usr/sbin/" directory on Dachstein.
After moving the files into the this directory, make a "Full" backup of the
"root" package from the "lrcfg" menu if you plan to keep these scripts....
if you don't want to keep them, they will be gone after a reboot. You might
notice that lrcfg is already on the DCD disk, this is a patched file that adds
the "i) install" option to the lrcfg menu that appears when you login to DCD.

With the scripts in place, your now ready to use them!



## How to use them

To use the scripts, either use the "i) install" option on the "lrcfg" menu or
type in "install.sh" from the command-prompt. You will find two options on the
menu, one to configure your modules (drivers) and one to configure your networking
setup. Here is an idea on how to prepare for an easy installation with them:



        Modules:
        Go to http://www.linuxdoc.org/HOWTO/Ethernet-HOWTO-4.html and find the
        correct module(s) for your network cards. You will have to know which
        module(s) to use.



        Networking:
        If your using a static ip address from your ISP, you will need your ip address,
        your netmask length (21, 16, etc...), the broadcast address, your default
        gateway, and your DNS servers ip address(es).

        If your using DHCP from your ISP, you might need your default gateway ip address.

*Note* You should be able to get this information from a Windows box by Running the
"winipcfg" or "ipconfig" utilities and selecting the network card.



These scripts support connections for DHCP and static external (ISP) addresses,
configuration as a firewall, filtered router, unfiltered router, and a bridge.
(Note, I haven't personally haven't tested the Bridge configuration yet, but as I
remember right, it should work-- let me know if you have luck with it or not).
There is also an option to change the private LAN addressing. I would not suggest
using this as you will have to manually reconfigure other packages that will break
if this addressing is changed from the defaults.

The cdrom scripts have some extra features that the floppy scripts don't, these include
support for the included ip_masq helper modules and port forwarding of one port
through the firewall to the internal network (ie.. webserver, ftp server, etc...).
I can provide more options if enough people want it, but I kept it simple to
keep from confusing new users and keep the size down.


Now we are ready to use the scripts, armed with the needed information. Simply enter the
information I suggested getting above when prompted. If I didn't suggest getting the
prompted information, you probably don't need it... it should be safe to just press
the "Enter" button and accept the default choice. After running both scripts and
backing up the packages (auto-prompted in the scripts), exit the menu's and reboot
the computer. You have a working router/firewall. I would suggest changing (and backing
up) the root password, then flipping the tab on the floppy to write-protect it...
it's hard to make accidental changes to a disk that you can't write to! If you
need to change anything, you can re-run the script(s) at any time.



## Client Computer Setup

In the TCP/IP configuration of your network card on the client computers, you will
need to set them up like this:

        Automatically Get an Ip Address (DHCP)
        DHCP server = 192.168.1.254
        WINS = Disabled (unless you have a WINS server on your LAN)
        Gateway = 192.168.1.254
        DNS setup:
                Host = (your choice)
                Domain = private.network
                DNS servers = 192.168.1.254

That is it, you should be done!



## Support and contact info

Support can be found at the "leaf-user" mailing list at http://leaf.sourceforge.net
Be sure to check the archives of the mailing list for similar problems with
Dachstein (someone else might have already had the same problem and a solution ).
If you can't find a fix that works, post to the list following the advice and links
from: http://leaf.sourceforge.net/content.php?menu=13&page_id=18 .

Enjoy!
Lynn Avants
guitarlynn@sourceforge.net
http://leaf.sourceforge.net/devel/guitarlynn/