==============================================================================
                                                                       INSTALL
==============================================================================

To install rblsd, take the following steps:

- Before doing anything, read README.
- Run 
	$ ./configure

  If you want to change the installation prefix (default: /usr/local),
  then run:
 	$ ./configure --prefix=/path/to/install

  Then, rblsd and spamc2 would reside in /path/to/install/bin/
- Skim through the top of the config.h file.  Don't worry, this isn't the
  full configuration (anymore!), but if you want to change things such as
  the location of rblsd.conf or the syslog facility to use, then this is
  the place to do it.
- Run:
	$ make
  and, if you're installing into a system directory (like /usr/bin),
  run this as root:
	# make install
- While we're talking about building the executable, there is something you
  should know: do not allow users to run rblsd as root on the system, this can
  lead to a gaping security hole.
- Copy the rblsd.conf file to the location specified in config.h
  (/etc/rblsd.conf by default)
- Modify rblsd.conf to your liking.

As far as software installation goes, that's all there is to it.

If you've installed rblsd before, or are upgrading, you should know that the
installation of rblsd hasn't changed, except for the addition of rblsd.conf.
Placing rblsd.conf in its proper location is the only extra step to be taken
(after modifying it, of course).

Now you must work rblsd into your mail system.  If you have or have had
SpamAssassin running on your system, then the next part is simple.  All you
will need to do is change the command line options to spamc.  If you wish to
keep SpamAssassin on your system, in addition to having rblsd, then change
'spamc' to 'spamc2' and see README for more information on how to use spamc2.

If you do not and have not had SpamAssassin on your system, then you should
still seek out documentation that instructs you on doing so.  This area is
well documented as many people have gone through the same process.  Listed
is a small collection of documents found on the Internet on the subject.

While browsing these documents, you should keep a few things in mind. 
First, many sites also instruct you on installing spamassassin itself.  You
can identify these sequences easily because they involve typing a lot of
things into Perl, and something called 'CPAN'.  Skip over all of these
instructions as they do not apply to rblsd.  What you are interested in, is
the instructions that involve configuration files (and in some cases, source
code) of the mail server you use.  Also, you will need to identify the
location of "spamc" (or, in older documentation "spamassassin" or
"/usr/bin/spamassassin") and change the command line options that are passed
to it.  For more information on these options, see README.


Links:

- Spamassassin with qmail / Vpopmail
  http://sylvestre.ledru.info/howto/howto_qmail_spamassassin.php
- Spamassassin and qmail (the things said about SA don't all apply to rblsd :)
  http://www.magma.com.ni/~jorge/spamassassin.html
- Installing Spamassassin with exim (only the bottom part applies)
  http://bogmog.sourceforge.net/document_show.php3?doc_id=28
- Exim SpamAssassin at SMTP time
  http://marc.merlins.org/linux/exim/sa.html
- Exim 4 and Spamassassin
  http://www.arise.demon.co.uk/exim_spamassassin.html
- Postfix+Procmail+SpamAssassin
  http://linux.duke.edu/~mstenner/docs/sa-docs/setup.html
- Procmail and SpamAssassin
  http://systems.cs.uoregon.edu/Solaris/QSspamassassin.php
- SpamAssassin web site
  http://www.spamassassin.org/
- rblsd Links Page
  http://rblsd.sourceforge.net/links.php

The rblsd Links Page may, in the future, contain updated links.  If you want
to submit a link, then send me an e-mail, and I'll put it up.

This collection is not complete, and you may need to search on your own.
A good place to start is the spamassassin website.

If you run into difficulty installing rblsd then join the troubleshooting
mailing list, and ask for help.  If you find success installing rblsd and
want to share your wisdom, then join the troubleshooting mailing list and
assist in helping others.

To join the rblsd troubleshooting list, visit

	http://lists.sourceforge.net/lists/listinfo/rblsd-troubleshoot

and fill in the necessary information to join.

==============================================================================
RBL Spam Daemon                                  http://rblsd.sourceforge.net/
Copyright 2003-2004, John Jordan                 jjjordan@XXX.sourceforge.net
==============================================================================
                                                 (XXX = users)