INSTALLATION INSTRUCTIONS


PREREQUISTES

OpenBSD or another OS with the pf firewall [1]
python 2.3+
ZopeInterface 2.7.5+ [2]
Twisted core 2.0.0+
bzip2

Notes:
1. This is not needed if you want to run in "test" mode where no rules are
   actually modified.
2. This is required by Twisted core.


EXAMPLE INSTRUCTIONS - OPENBSD 4.5

export ver="$(uname -r)"
export arch="$(uname -m)"
export PKG_PATH="ftp://ftp.openbsd.org/pub/OpenBSD/$ver/packages/$arch/"
pkg_add zope-2.10.5p0
pkg_add py-xml
pkg_add py-zopeinterface
pkg_add py-twisted-core
ln -sf /usr/local/bin/python2.5 /usr/local/bin/python
ln -sf /usr/local/bin/pydoc2.5 /usr/local/bin/pydoc


Installing dfd_keeper

wget http://www.subspacefield.org/security/dfd_keeper/code/dfd_keeper.tar.gz
tar xvzf dfd_keeper.tar.gz
cd dfd_keeper
python ./setup.py install


GETTING STARTED


To see it in action without changing your firewall rules, run the example:
./keeper_example.py --test &

Now give it a second and connect to the listening port using netcat:
nc -v -v localhost 8007

If all goes well, you should see the dfd_keeper prompt.

Now optionally modify your startup files to invoke it.
I recommend putting the following line(s) in /etc/rc.local:

if [ -x /etc/keeper.py ]
then
   /etc/keeper.py >> /var/log/keeper 2>&1 &
fi