1. Install Apache2, MySql server and PHP5 with required modules. You may already have some or all of these packages installed.

apt-get install apache2 php5-cli php5 mysql-server libdbd-mysql-perl php5-gd php5-mysql libapache2-mod-php5


2. Download the latest version of MailWatch

wget http://downloads.sourceforge.net/project/mailwatch/mailwatch/1.0.5/mailwatch-1.0.5.tar.gz


At the time this tutorial was written, version 1.0.5 was the latest version. Check this location for latest version: http://sourceforge.net/projects/mailwatch/files/

3. Extract and enter the mailwatch directory

tar zxvf mailwatch-1.0.5.tar.gz
cd mailwatch-1.0.5


4. Create the database and tables

mysql -p < create.sql


5. Create a MySql user used for MailScanner logging (mysql -u root -p)

GRANT ALL ON mailscanner.* TO '{username}'@'localhost' IDENTIFIED BY '{password}';
FLUSH PRIVILEGES;


Replace {username} and {password} with a username and password of choice.

6. Configure the MailScanner logger (pico MailWatch.pm)

my($db_user) = '{username}';
my($db_pass) = '{password}';


On line 43 and 44, input your MySql user created in step 5

7. Move the MailScanner logger to correct directory

mv MailWatch.pm /usr/share/MailScanner/MailScanner/CustomFunctions/


8. Edit Mail Scanner config to enable MailWatch logger (pico /etc/MailScanner/MailScanner.conf)

Always Looked Up Last = &MailWatchLogging


9. Create a MailWatch web admin user (mysql -u root -p)

USE mailscanner;
INSERT INTO users VALUES ('{username}',md5('{password}'),'Administrator name','A','0','0','0','0','0');


Replace {username} and {password} with a username and password used to enter the web interface.

10. Move the web interface to the web server's root

mv mailscanner /var/www/mailwatch


11. Make the temp and cache directories writeable

chmod 777 /var/www/mailwatch/temp
chmod 777 /var/www/mailwatch/images/cache


12. Copy the example config file

mv /var/www/mailwatch/conf.php.example /var/www/mailwatch/conf.php


13. Configure the web interface (pico /var/www/mailwatch/conf.php)

define('DB_USER', '{username}');
define('DB_PASS', '{password}');
define('MAILWATCH_HOME', '/var/www/mailscanner');


Type the MySql username and password created in step 5

14. Install PEAR PHP framework

apt-get install php-pear


15. Install required PEAR packages

pear install DB
pear install DB_Pager
pear install Mail_mimeDecode-1.5.1


16. On line 37, add /usr/share/php to the mailwatch include path (pico /var/www/mailwatch/functions.php)

ini_set('include_path','.:'.MAILWATCH_HOME.'/pear:'.MAILWATCH_HOME.'/fpdf:'.MAILWATCH_HOME.'/xmlrpc:/usr/share/php');


17. Restart Apache and MailScanner

/etc/init.d/apache2 restart
/etc/init.d/mailscanner restart


18. You're all set. Enter the web interface at this location http://yourserver/mailwatch

1. Install the PEAR framework

get install php-pear


2. Restart apache

/etc/init.d/apace2 restart


3. Install a PEAR package (optional)

pear install Net_Ping-2.4.5


You can install any PEAR package using this command but in this example we'll install the Net_Ping package

4. Here's a sample PHP code to use the Net_Ping package (optional)

require_once "Net/Ping.php";
$ping = Net_Ping::factory();
 
$host = 'debiantutorials.com';
$count = 3;
 
if (PEAR::isError($ping))
{
    echo $ping->getMessage();
}
else
{
    $ping->setArgs(array('count' => $count));
    $res = $ping->ping($host);
    foreach ($res->_raw_data as $line)
    {
        echo $line . "\n";
    }
}


This code will ping the host debiantutorials.com three times and echo the results

1. Installing the XCache package

apt-get install php5-xcache


2. Restart Apache

/etc/init.d/apache2 restart


That's it. XCache is now installed.

1. Download a copy of Zend Optimizer / Guard from the location below and put it into /tmp

http://www.zend.com/en/products/guard/downloads


2. Extract

cd /tmp
tar zxvf ZendOptimizer-3.3.9-linux-glibc23-i386.tar.gz


Replace with your actual filename

3. Create a directory to contain Zend optimizer

mkdir /usr/local/lib/Zend


3. Move the Zend optimizer lib to a permanent location

mv ZendOptimizer-3.3.9-linux-glibc23-i386/data/5_2_x_comp/ZendOptimizer.so /usr/local/lib/Zend/


Your ZendOptimizer directory name may be different since it includes version numbers and platform. I'm using the 5_2_x_comp directory because I have PHP 5.2 installed.

4. Add reference to your php.ini file (pico /etc/php5/apache2/php.ini)

zend_extension = /usr/local/lib/Zend/ZendOptimizer.so
zend_optimizer.optimization_level = 15


5. Restart apache

/etc/init.d/apache2 restart


1. Download ionCube loaders

wget http://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86.tar.gz


2. Extract

tar zxvf ioncube_loaders_lin_x86.tar.gz


3. Move to a permanent location

mv ioncube /usr/local/


4. Add reference to your php.ini file (pico /etc/php5/apache2/php.ini)

zend_extension = /usr/local/ioncube/ioncube_loader_lin_5.2.so


There are a few versions of the loader in the tar archive and you can choose the one that suites your needs

5. Restart apache

/etc/init.d/apache2 restart


In this tutorial you will be guided through the installation process and to configure the web server to use MySQL backend.

First install the lighttpd package and the MySQL backend module
apt-get install lighttpd lighttpd-mod-mysql-vhost


Create a MySQL database, table and insert some sample data
mysql -u root -p
 
GRANT SELECT ON lighttpd.* TO vhosts@localhost IDENTIFIED BY 'mypasswd';
FLUSH PRIVILEGES;
CREATE DATABASE lighttpd;
USE lighttpd;
 
CREATE TABLE vhosts (
domain varchar(64) NOT NULL PRIMARY KEY,
docroot varchar(128) NOT NULL
);
 
INSERT INTO vhosts VALUES ('test.com','/var/www/test.com/');
INSERT INTO vhosts VALUES ('www.test.com','/var/www/test.com/');
 
quit;


Create a configuration file for the mysql backend (pico /etc/lighttpd/conf-available/10-mysql-vhost.conf). Add the following lines:
server.modules += ( "mod_mysql_vhost" )
 
mysql-vhost.db = "lighttpd"
mysql-vhost.user = "vhosts"
mysql-vhost.pass = "mypasswd"
mysql-vhost.sock = "/var/run/mysqld/mysqld.sock"
mysql-vhost.sql = "SELECT docroot FROM vhosts WHERE domain='?';"


Make sure you change the db, user and pass variables to a valid mysql user and database on the local server.

Enable the mysql backend module
ln /etc/lighttpd/conf-available/10-mysql-vhost.conf /etc/lighttpd/conf-enabled/10-mysql-vhost.conf


Install PHP5 packages
apt-get install php5-cgi php5-mysql php5-gd php5-imagick php5-imap php5-mcrypt php5-snmp php5-sqlite php5-tidy php5-xmlrpc php5-xsl


Configure PHP5 to display correct values for PATH_INFO and PHP_SELF (pico /etc/php5/cgi/php.ini). Change the following variable found in your php.ini file:
cgi.fix_pathinfo = 1


Configure fastcgi to use PHP5 insted of the default PHP4 (pico /etc/lighttpd/conf-available/10-fastcgi.conf)
"bin-path" => "/usr/bin/php5-cgi",


Enable fastcgi/PHP5:
ln /etc/lighttpd/conf-available/10-fastcgi.conf /etc/lighttpd/conf-enabled/10-fastcgi.conf


Restart the lighttpd web server:
/etc/init.d/lighttpd restart


Now you're all set and you should be able to browse to test.com. (make sure the host exists in DNS or has been placed in your local hosts file)

Lighttpd caches the vhost configurations until next restart so you'll have to restart lighttpd everytime a change is made in the MySQL database.