How to install Open WebMail on Fedora Core 2
============================================
By Thomas Chung <tchung AT openwebmail.org>
On 2004-07-26

Prerequisite: httpd-2.0.49-4 and httpd service is running
	      sendmail-8.12.11-4.6 and sendmail service is running

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

NOTE : Stock FC2 perl-5.8.3-18 now includes required perl-CGI, perl-MIME-Base64, perl-libnet already

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

3. initialize openwebmail database using openwebmail-tool.pl

[root@localhost root]# cd /var/www/cgi-bin/openwebmail
[root@localhost openwebmail]# ./openwebmail-tool.pl --init
 
 
Please change './etc/dbm.conf' from
 
dbm_ext                 .db
dbmopen_ext             none
dbmopen_haslock         no
 
to
 
dbm_ext                 .db
dbmopen_ext             .db
dbmopen_haslock         no
 
 
And execute './openwebmail-tool.pl --init' again!
 
ps: If you are running openwebmail in persistent mode,
    don't forget to 'touch openwebmail*.pl', so speedycgi
    will reload all scripts, modules and conf files in --init.

NOTE : If you don't have etc/dbm.conf file, create it with above values.
       Values in etc/dbm.conf will overwrite values in etc/default/dbm.conf

[root@localhost openwebmail]# cd etc
[root@localhost etc]# vi dbm.conf

dbm_ext                 .db
dbmopen_ext             .db
dbmopen_haslock         no

[root@localhost etc]# cd .. 
[root@localhost openwebmail]# ./openwebmail-tool.pl --init
 
creating db /var/www/cgi-bin/openwebmail/etc/maps/b2g ...done.
creating db /var/www/cgi-bin/openwebmail/etc/maps/g2b ...done.
creating db /var/www/cgi-bin/openwebmail/etc/maps/lunar ...done.
Welcome to the Open WebMail!
                                                                                                                                                                                                    
This program is going to send a short message back to the developer,
so we could have the idea that who is installing and how many sites are
using this software, the content to be sent is:
                                                                                                                                                                                                    
OS: Linux 2.6.5-1.358smp i686
Perl: 5.008003
WebMail: Open WebMail 2.32 20040727
                                                                                                                                                                                                    
Send the site report?(Y/n) n
                                                                                                                                                                                                    
Thank you.
 
[root@localhost openwebmail]#

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 Sendmail Security
=====================
For security reasons, the default configuration of sendmail allows sending,
but not receiving over the net (by default it will only accept connections 
on the loopback interface.)

# cd /etc/mail
# vi sendmail.mc

dnl # The following causes sendmail to only listen on the IPv4 loopback address
dnl # 127.0.0.1 and not on any other network devices. Remove the loopback
dnl # address restriction to accept email from the internet or intranet.
dnl #
dnl DAEMON_OPTIONS(`Port=smtp,Addr=127.0.0.1, Name=MTA')dnl

dnl # We strongly recommend not accepting unresolvable domains if you want to
dnl # protect yourself from spam. However, the laptop and users on computers
dnl # that do not have 24x7 DNS do need this.
dnl #
dnl FEATURE(`accept_unresolvable_domains')dnl

dnl # This is the sendmail macro config file for m4. If you make changes to
dnl # /etc/mail/sendmail.mc, you will need to regenerate the
dnl # /etc/mail/sendmail.cf file by confirming that the sendmail-cf package is
dnl # installed and then performing a
dnl #
dnl #     make -C /etc/mail

# make -C /etc/mail
# service sendmail restart


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.