Download the Baruwa source and untar it:
# tar xzvf baruwa-<version>.tar.gz
# cd baruwa-<version>
Update your mailwatch database:
# mysql -p <mailwatch_database> < extras/baruwa-update.sql
Set the privileges for new tables:
mysql> GRANT ALL ON <mailwatch_database>.* TO
mysql> <mailwatch_user>@localhost IDENTIFIED BY '<mailwatch_password>';
mysql> flush privileges;
Install Baruwa
Run:
# python setup.py install
Configure the Baruwa settings
Edit the settings.py file which will be installed in the “baruwa” directory inside your Python’s site-packages directory, which is located where ever your Python installation lives. Some places to check are:
- /usr/lib/python2.4/site-packages (Unix, Python 2.4)
- /usr/lib/python2.6/site-packages (Unix, Python 2.6)
- /opt/local/lib/python2.4/site-packages (MacOSX, Ports Python 2.4)
Set the following options:
DATABASE_NAME = '<mailwatch_database>'
DATABASE_USER = '<mailwatch_user>'
DATABASE_PASSWORD = '<mailwatch_password>'
DATABASE_HOST = 'localhost'
If your MailScanner config file is not located in the standard location (/etc/MailScanner/MailScanner.conf) then edit the baruwa_settings.py file which is in the same directory as the settings.py file and set:
MS_CONFIG = '/etc/MailScanner/MailScanner.conf'
Setup Web server
Apache/Mod_WSGI
Use the sample configuration provided (extras/baruwa-mod_wsgi.conf) as a template. Copy to your apache configuration directory usually /etc/httpd/conf.d
Make sure that your apache is configured for name based virtual hosting such that you can run other sites on the same box if you wish to.
Edit /etc/httpd/conf.d/baruwa-mod_wsgi.conf and set ServerName to the hostname you will use to access Baruwa
Restart apache for the configuration to take effect.:
# /etc/init.d/httpd reload
Apache/Mod_python
TODO
Lighttpd
TODO
Nginx
TODO
Recreate your White/Black lists The Baruwa and Mailwatch lists formats are not compartible so just redo your lists in the easy to use baruwa interface.
Enjoy Baruwa
Point your browser to http://hostname_used login with admin user and password and start working. You can now use the interface to add users and process messages, etc etc.