Open Webmail RPM
================
Thomas Chung (tchung AT openwebmail.org)
Last Updated: 2007-07-30

**************************************************************
* Following instruction might be out-dated.
* See "packages" directory for specfic Red Hat / Fedora Release
**************************************************************


1. Download the rpm package for Open Wembail from "release" directory
2. Install it by typing "rpm -Uvh openwebmail*.rpm"

* If you want the latest features, install the latest rpm build from "daily-build" directory

If you haven't installed following required packages yet,

	CGI.pm-2.74.tar.gz       (required)
	MIME-Base64-2.12.tar.gz  (required)
	libnet-1.0901.tar.gz     (required)
        Text-Iconv-1.2.tar.gz    (required) <----- as of 2002-11-11
	Digest-MD5-2.33.tar.gz   (required) <----- as of 2004-04-10

as described in official readme, use perl-RPMs in "packages" directory 
AND make sure to read RHL/RHEL/FC specific HOWTO in "packages" directory


Sendmail Issue in RHL7.x, RHL8.0, RHL9, RHEL3, FC1
==================================================

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.)

Configure sendmail to accept incoming connections by as follows:

1. Modify /etc/mail/sendmail.mc
   Comment out the following line by prepedning with a 'dnl'.  
     
      DAEMON_OPTIONS(`Port=smtp,Addr=127.0.0.1, Name=MTA')

   Another appropriate step for a server system is to comment out the line
 
      FEATURE(`accept_unresolvable_domains')

   Then save the file.

2. Save a backup of the default /etc/sendmail.cf, then create new one.

   cp -p /etc/sendmail.cf /etc/sendmail.cf.save
   m4 /etc/mail/sendmail.mc > /etc/sendmail.cf

  NOTE: If you get following error, install sendmail-cf RPM package
  "sendmail.mc:10: m4: Cannot open /usr/share/sendmail-cf/m4/cf.m4: No such file or directory"

3. Restart sendmail
   
   sevice sendmail restart   

4. Make sure your firewall setting (ipchains or iptables) accept incoming mail

   (For example for iptables)
   # cp /etc/sysconfig/iptables /etc/sysconfig/iptables.save
   # vi /etc/sysconfig/iptables
   (Add following line)
   -A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 25 -j ACCEPT
   # service iptables restart

5. Send a test message from another computer and watch maillog if message is 
   being accepted for delivery.
   tail -f /var/log/maillog


Mandrake 8.2 Install Note:
==========================

In Mandrake Linux 8.2, Apache Configuration by default <Directory /var/www/cgi-bin> directive 
does not allow anyone to execute CGI program. Make sure to modify as follow 
in /etc/httpd/conf/commonhttpd.conf

   <Directory /var/www/cgi-bin>
      AllowOverride All
      Options ExecCGI
      Order allow,deny
      Allow from all
   </Directory>

Then, reload Apache Server using "service httpd reload"


SuSE 8.0 Install Note:
======================

In SuSE 8.0, make sure to use following setting in openwebmail.conf

dbm_ext                 .pag
dbmopen_ext             none
dbmopen_haslock         yes

(thanks to Julio Cesar Cunha - jccunha at users.sourceforge.net)

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"