| Line 8: | Line 8: | ||
== Prerequisites == | == Prerequisites == | ||
1. DSpam is installed and working properly.<br> | 1. DSpam is installed and working properly.<br> | ||
| + | ''If you followed the installation steps in [[DSpam General]] then you should be in good shape''<br> | ||
2. Apache web server is installed and working properly.<br> | 2. Apache web server is installed and working properly.<br> | ||
3. Suexec has been installed.<br> | 3. Suexec has been installed.<br> | ||
| − | + | 4. A dspam user and group have been created.<br> | |
| + | ''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)''<br> | ||
| + | |||
| + | |||
| + | == Installation == | ||
| + | Installing the WebUI isn't anything more than copying a few files and directories. | ||
| + | |||
| + | 1. Obtain dspam source.<br> | ||
| + | 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 | ||
| + | |||
| + | |||
[[Category:DSpam]] | [[Category:DSpam]] | ||
Revision as of 14:51, 6 October 2007
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]