view release on metacpan or  search on metacpan

pods/INSTALL.pod  view on Meta::CPAN

Login as user spam.spam or whatever your spamcannibal user/group values are.

        chmod 700 sc_session.pl (or 1700)
        chmod 700 sc_remote.pl 
        chmod 4755 sc_sesswrap 

=head3 enabling admin management on user admin web page

Admin management is enabled by default by the installation procedure. The
B<sticky> bit on the sc_session.pl file is used as a flag to enable/disable
admin management support. With admin management disabled, you must add and
delete administrative user from the B<private/passwd> file using a text
editor. New users may be added with a blank password.

  i.e.	fred:

To  admin access to allow admins to add and delete users, login as the
spamcannibal user and type this:

	cd scripts
	./sc_session.pl admin on

to restrict access so that admin users must be added and removed by hand,

        ./sc_session.pl admin off

=head3 session and password file/directory permissions

Permissions for the session and password directories and their contents are
set by the installation routine. Should they happen to become altered you
can reset them as shown below:

Login as the spamcannibal user and set the directory permissions.

        chmod 700 private
        chmod 700 sess   

Then set the file permissions.

        chmod 600 private/passwd

=head3 permission settings for files in 'config'

The permissions on the files in the config directory are set by the
installation routine. Should they happen to become altered you can reset
them as shown below:

Login as the spamcannibal user and set the directory permissions.

	cd config
	chmod 640 *
	chmod 644 sc_web.conf

=head3 permission settings for the database environment

These permissions should be correctly set by the B<sc_initdb.pl> script. 
Should they happen to become altered you can reset
them as shown below as the root user:

	cd /var/run
	chown -R spam dbtarpit
	chgrp -R spam dbtarpit
	chmod 755 dbtarpit
	cd dbtarpit
	chmod 660 *

=head2 Installing optional LaBrea::Tarpit report statistics pages

The optional LaBrea::Tarpit statistics pages show the number and IP
addresses of spam/virus hosts that are currently visiting or have recently
visited your site. 

=head3 LaBrea::Tarpit module installation

No configuration needs to be done for LaBrea::Tarpit. The innards are used,
but none of the scripts or daemons. Just install it in the usual perl manner
and forget it.

	perl Makefile.PL
	make
	make test
	make install

=head3 edit sc_web.conf

In the sc_web.conf file, find the commented out line:

   top     => './incl/top.incl',	# used by all pages
   logo1   => './incl/logo1.incl',	# for the home page
   logo2   => './incl/logo2.incl',	# for all other pages
 #  stats	=> './incl/stats.incl',		# OPTIONAL Labrea stats pages
   nav     => './incl/nav.incl',	# for all user pages
   nav2    => './incl/nav2.incl',	# for all admin pages

and remove the comment mark from the 'stats' line.

=head3 configuring spam_report.cgi

Rename this script spam_report.cgi or spam_report.(your perl executable).
This web script may be run either as standard 'cgi' or on a mod-perl
enhanced web server. Simple rename the file to reflect the extension used on
your system for perl web scripts. This must be the same extension as used
for admin.??? and cannibal.???

This script is from an older generation of modules and has the
configuration embedded in the script itself. Most of the varibles are set to
their optimum default values but certain ones must be configured
specifically for your site. You must configure:

=over 4

=item * d_port REQUIRED

The port to interrogate on the localhost or a remote host to get data for
the web process.

Pick a port on your system that is appropriate. The sister dameon from
LaBrea::Tarpit defaults to 8686, don't use that one.

=item * d_host REQUIRED