WatchTower 0.1 README

http://www.cs.berkeley.edu/~zf/spamwatch/


WatchTower is a distributed service using Approximate Text Addressing API on 
Tapestry to help people identify spams.  WatchTower can be used with SpamWatch 
Outlook Addin, which can also be downloaded from the address above.

This version runs on Linux with IBM JDK 1.3.


~~ Preparation ~~

After unpack the package, edit the first part of `bin/setup.sh' according to 
your machine.  You probably only need to change WATCHTOWER_HOME and JAVA_HOME. 
After you finish, type:

  source setup.sh
  

~~ Compile ~~

If you download the binary version, just skip to `run'.

`Ant' is needed to compile WatchTower, obtain it from:
  
  http://jakarta.apache.org/ant/

`Pond'(Oceanstore prototype) and `SEDA' are needed.  They are provided as binary 
files in libext/.  You probably do not need to download and compile them.  But 
in case you do, please Refer to this URL for more information:

  http://oceanstore.sourceforge.net/pond-sf.html

Follow the directions on that page to compile them.  After that, put these files 
in lib/

x Pond java classes, packaged as `pond.jar'.  This file can be obtained by 
doing:
  
  jar cf pond.jar ostore
  
  at the `pond' dir.

x SEDA java classes, packaged as `seda.jar'.  This file can be obtained by 
doing:

  jar cf seda.jar seda
  
  at the `seda/src' dir.

x Compiled SEDA native libraries `libMDWUtil.so' and `libNBIO.so', both 
available at `seda/lib'
  
After the Pond and SEDA stuff is set up, type this at the project home dir:

  ant


~~ Run ~~

Now you can start WatchTower by typing

  ./watchtower.sh
  
at the `bin/' directory.  This will start four instances of watchtower on port 3788-3791,
respectively.  Then you can tell your friends to connect their SpamWatch Outlook Addin to 
connect to these ports to help each fight spam.  :)


TODO: instructions on starting a federation of WatchTower on several machines.

$Id: watchtower-0.1-readme.txt,v 1.1.1.1 2003/10/31 07:58:17 zf Exp $