$Id: INSTALL,v 1.3 2003/04/27 23:31:45 mardan Exp $


Install:
-------------------------------------------------------------------------------

First off all, compile sendmail with libmilter if you haven't allready done 
that. (http://tweegy.demon.nl/projects/spammilt/Installation and 
Configuration.html) Read the html-page it is very usefull.


Add a user and group 'smmsp' to your system if it doen't excists allready, 
with a uid and gid of 90 or whatever uid/gid number you like.
Then do a 'mkdir -p /var/spammilt'
'cd /var'
'chown smmsp.smmsp spammilt' 

Now untar the source by typing tar -xvzf spammilt-x.y.tar.gz wherever you 
stored the source file, by typing 'tar -xvzf spammilt-x.y.tar.gz'
cd into spammilt-x.y
type 'make' or 'make BAYESIAN_ANNOYANCE=1' if you want to use the Annoyance-
filter package, which is explained on the bottom of this document.

If all goes well you got a binary called 'spammiltd'.
Now do a 'make install' and if you wish you can also install the example 
files for the black, white and dnsbl-ignore lists. It will be installed in 
'/etc/mail/spam'. Just rename them to without the '.example'
Or create the files yourself: 'black.list', 'white.list' and 'dnsbl-ignore.list',
which should be located in '/etc/mail/spam' and add your own blacklisted, 
whitelisted domains, words and ignored dnsbl servers or anything else for 
which you want to scan the email-header.

Next add to your sendmail.mc the following lines, edit the parameters if you 
have to. (See html-page)

"define(`_FFR_MILTER', `1')dnl"
"INPUT_MAIL_FILTER(`spammilt', 
	`S=local:/var/spammilt/spammilt.sock, F=T, 
	T=S:1m;R:1m;E:2m')dnl"

After this make your sendmail.cf
(spammiltd will scan the sendmail.cf automatic at startup to detect the socket 
location.)


Now, add some startup lines to your sendmail startup script.(see 
example below) Make sure spammiltd is started BEFORE sendmail is!

(start)
"/usr/sbin/spammiltd -s spamaccount@foo.bar -D"

(stop)
"killall spammiltd"


Finally give sendmail a restart.
 
-------------------------------------------------------------------------------


Annoyance-filter:
-------------------------------------------------------------------------------

Annoyance-filter is a commandline Bayasian-way scan-utility. You can 
download it overhere http://www.fourmilab.ch/annoyance-filter/. You will have 
better results with the fight against spam if you use it.
For installation follow the discription on the page. After you compiled you can
install it in '/usr/local/annoyance-filter' , which is the default directory 
where spammiltd will look for if you enable it. (with -x switch)

-------------------------------------------------------------------------------