SRFirewall/INSTALL

45 lines
1.9 KiB
Plaintext

SRFirewall v2.0 http://www.sosdg.org/freestuff/firewall Written by:
Brielle Bruns <bruns@2mbit.com>
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
Installing is fairly straight forward:
1. Download to a location of your choosing, I recommend /usr/src
2. Run 'make install' to put files in /usr/local by default
3. Edit config files in /usr/local/etc/srfirewall
4. Run 'srfirewall' command to load the firewall and work its magic
If you are upgrading from a previous version and don't want to overwrite
your config files, use 'make upgrade'.
If you wish to install to some place other then /usr/local, you will need
to edit the Makefile PREFIX as well as the bin/srfirewall script to reflect
the new location.
If you want to run from SVN trunk (for the brave), here's how I would do it:
=== Begin commands ===
cd /usr/src
svn checkout http://firewall-sosdg.googlecode.com/svn/srfirewall srfirewall-trunk
ln -s /usr/src/srfirewall-trunk/lib /usr/local/lib/srfirewall
ln -s /usr/src/srfirewall-trunk/bin/srfirewall /usr/local/bin/srfirewall
cp -R /usr/src/srfirewall-trunk/etc /usr/local/etc/srfirewall
=== End commands ===
Then when you want to update to bleeding edge, all you have to run is 'svn update'.
You _will_ need to look for newly changed/added files and update appropriately.
To make the update process easier, I made the config script look for a local.conf file in
etc/srfirewall that can be used to override the default options. This will allow
you to replace all of the *.conf files on upgrade without losing local option changes.
The default options are designed to be 'sane' for a good portion of the many users,
so the use of local.conf only needs specific options you wish to override.
Files in etc/srfirewall/ipv{4,6} can be safely left alone during upgrade since
I plan to not make upstream changes to them once they are written and defined
for use.
When in doubt, check the CHANGELOG file for mention of new config options and/or
config files.