Read All of this before installing, or the new version will
not work correctly.  You must have mSQL installed for it to run.
This Documentation _really_ needs more work, so if you have any
problems, just mail me.

melhiser@co.union.nc.us


Compiling:

Modify you make file to reflect the location of the mSQL libtrary and
header files on your system.

From there a simple make world should make and install the binary files.
Or, you can do a make all, and the bin's will be installed to the
./bin directory for you to install where you need.


Installation:

There are now 2 binary files created, one a daemon that listens for
update requests.  This daemon can be loaded on all machines that
will be doing the masquerading so that you may administrate all machines
using masquerading from one central site.

Copy the masqdhosts from the ./etc directory to your /etc directory
of all the machines that will run masqd and modify it to allow the
users you choose to update the masquerade tables.

Now you need to set up your mSQL databases.  First make an entry in
your msql.acl file that looks like this:

database=firewall
read=*
write=root,melhiser
host=viper.co.union.nc.us,localhost
access=local,remote


The database name MUST be "firewall". All other pieces are up to your
choosing.  Please consult the documentation for mSQL for further details
on configuring these options.


Now create the database firewall with this command:

msqladmin create firewall


All of the config is basically done. And you are ready to try it out now.

Start masqd  : masqd [<port>] & <--- The Default Port is 9100
Start msqld  : msqld &
Run masqtool : masqtool [<msqlHOST>] & <-- Default host is localhost

If there are no Masqd hosts defined, it will ask you which machine is
running Masqd and the port that masqd is running on (The default port
masqd runs on is 9100), otherwise, it will only ask for the hostname of
the machine running masqd you want to modify.

That is about it.  You may find that having these lines in one of your rc
files to be usefull as well.  That way the daemons are started, and
the masqerading is re-set anytime you reboot your system.  I have found
that rc.local works as good as any place else.  ;)


# ---    Lines to start Masqd and Initialize Masquerade Tables  ---#
/sbin/masq-route
/sbin/masqd &
#------------------------------------------------------------------#


Good Luck, and E-mail any questions to:  melhiser@co.union.nc.us

As Always, this product comes with no warrenty expressed or implied, use at
your own risk... blah blah blah blah... ;)

You are free to distribute this to anyone/anywhere you feel like.
