How to install Open Webmail on Red Hat Enterprise Linux 3
=========================================================
By Thomas Chung (tchung AT openwebmail.org)
Last Updated 2003-12-01


pre-requisites:  httpd-2.0.46-25.ent.i386.rpm and httpd service is running
                 sendmail-8.12.10-1.i386.rpm and sendmail service is running


1. install all perl rpm packages if you haven't installed yet.

2. install the latest openwebmail rpm build from daily build directory

3. initialize openwebmail database using openwebmail-tool.pl

   cd /var/www/cgi-bin/openwebmail
   ./openwebmail-tool.pl --init

   3.0) Ignore the warning

       "The perl on your system has serious bug in routine tell()!
	While openwebmail can work properly with this bug, other perl application
	may not function properly and thus cause data loss.
                                                                                                                        
	We suggest that you should patch your perl as soon as possible."

   3.1) change the following 3 options in openwebmail.conf

 	from
        	dbm_ext           .db
        	dbmopen_ext       none
        	dbmopen_haslock   no
        to
        	dbm_ext           .db
        	dbmopen_ext       %dbm_ext%
        	dbmopen_haslock   no

   3.2) execute './openwebmail-tool.pl --init' again

   	You won't see the same suggestion for changes or modification.

4. create a user account if you haven't created one yet

5. login to openwebmail using a user account
   http://localhost.localdomain/cgi-bin/openwebmail/openwebmail.pl

For Virtual Hosting Domains
===========================

If you are hosting mutiple domains with virtualHost directive,
add following lines in httpd.conf to access openwebmail login screen for each domain.
ex) http://domain.com/webmail

# Open Webmail ScriptAlias, Alias
ScriptAlias /webmail "/var/www/cgi-bin/openwebmail/openwebmail.pl"
Alias /data "/var/www/data"

Don't forget to restart httpd.