view release on metacpan or  search on metacpan

pods/quick_install.pod  view on Meta::CPAN

(http://www.mailscanner.info) ) has done its work. This is a good
approach if you handle a lot of mail. If not, then you can skip this
step and mail will be delivered to the local machine in the normal way.

First, make sure the mail server you want to handle the mail is
configured correctly to handle mail for your desired domains.

Then, configure the mail server on the machine that Spamcannibal is
running on as follows. No other configuration should be required.

Sendmail has a file C</etc/mail/mailertable> , and postfix has a file
C</etc/postfix/transport> into which you can put the following line for
each domain you wish to pass through to the "real" mail server:

 mydomain.com smtp:[192.168.20.102]

(where C<mydomain.com> is the domain you are handling mail for, and
C<192.168.20.102> is the address of the mail server you want to hand
the mail off to once Spamcannibal has done its thing)

Don't forget to rebuild the config databases (for sendmail, go to C<
/etc/mail> and type "make." For postfix go to C< /etc/postfix> run
C<postmap transport> ).

Restart the mail daemon to make sure it's got the new configuration OK
and make sure you can send a mail though your system OK before
proceeding.

=head2 X<12>12. Configure the web server and check the web interface

Spamcannibal comes with some cgi scripts that let you view what's going
on in your tarpit, and other things. To enable this, tell your web
server to execute scripts in /usr/local/spamcannibal/public_html

For apache, add the following in C<httpd.conf> :

 Alias /tarpit/ /usr/local/spamcannibal/public_html/
 
 <Directory /usr/local/spamcannibal/public_html/>
 AllowOverride None
 Options ExecCGI -MultiViews +SymLinksIfOwnerMatch
 Order allow,deny
 Allow from all
 </Directory>

(You should really tweak the "Allow from" directory suit your setup.)

Note: you might also need the following line if you don't already have
it:

 AddHandler cgi-script .cgi

=head2 X<13>13. Set up the Admin Web Interface

Activate the admin script by renaming it and setting up the password:

 cd /usr/local/spamcannibal/public_html
 cp spam_report.cgi.exmple to spam_report.cgi
 cd ../private
 cp passwd.initial passwd
 chown spam:spam passwd
 chmod 600 passwd

(the passwd file must be owned by the C<spam> user)

Set the admin password (default is blank):

 htpasswd /usr/local/spamcannibal/private/passwd admin

Reload apache, and go to the admin interface at:

 http://www.yourserver.com/tarpit/admin.cgi

Click on "View DB" and have a look around. You should start to see a
few addresses being logged in various states. Whether you'll see any
tarpitting activity depends on the amount of mail you handle.

Assuming you encountered no errors, congratulations! You are now
running a fully-fledged tarpit!

For a general overview of what's going on, go to:

 http://www.yourserver.com/tarpit/spam_report.cgi

=cut

#Pod::HTML2Pod conversion notes:
#From file sc_install.html
# 18807 bytes of input
#Fri Sep 17 23:47:14 2004 gilgongo
# Will try to render <a name='...'>
# Will try to render <a href='...'>