From LedHed's Wiki
Revision as of 14:51, 6 October 2007 by Ledhed (Talk | contribs)

Jump to: navigation, search

Overview

DSpam has several ways for its users to perform training tasks, the WebUI is one of them. The WebUI has several components, Performance, Preferences, Quarantine, History, Etc... This article will explain how to install the DSpam WebUI (which for many is the hardest part if the DSpam installation)


Prerequisites

1. DSpam is installed and working properly.
If you followed the installation steps in DSpam General then you should be in good shape
2. Apache web server is installed and working properly.
3. Suexec has been installed.
4. A dspam user and group have been created.

Note: suexec doesn't like to work with user accounts with UID's below 500 (verify this because it can be different for each disro)



Installation

Installing the WebUI isn't anything more than copying a few files and directories.

1. Obtain dspam source.

wget http://dspam.nuclearelephant.com/sources/dspam-3.X.X.tar.gz
tar -xvzf dspam-3.X.X.tar.gz
cd dspam-3.X.X

2. Create a directory for the WebUI (/var/www/ is a good place for RedHat distros) create this directory near the apache 'documentroot' directory which can be found by searching httpd.conf

mkdir -p /var/www/dspam

3. Copy the contents of webui/cgi-bin/ to the new dspam WebUI directory

cp -R webui/cgi-bin/* /var/www/dspam
cp -R webui/htdocs /var/www/dspam

4. Set permissions and ownership of the new dspam/ directory

chmod 755 /var/www/dspam
chown -R dspam.dspam /var/www/dspam

5. Edit the WebUI configuration file

vim /var/www/dspam/configure.pl

Most of the settings in configure.pl are fine as they are. Only a few changes need to be made. (This greatly depends on how complex you make your install, using the default paths make life a little easier)

Change this line:

$CONFIG{'WEB_ROOT'}     = ""; # URL location of included htdocs/ files

To

$CONFIG{'WEB_ROOT'}     = "htdocs/"; # URL location of included htdocs/ files

and this line:

$CONFIG{'LOCAL_DOMAIN'} = "domain.tld";

To

$CONFIG{'LOCAL_DOMAIN'} = "YourDomainName.com";

6. Define the DSpam Admins

vim /var/www/dspam/admins

Add the email account username of anyone whom you would like to grant Admin access in the WebUI

Example: Assumes email account usernames = full email address

root
[email protected]
[email protected]