HOWTO configure subdomain
=========================
by Thomas Chung <tchung.AT.openwebmail.org>
last updated 2003-10-24

Sources: Matt's solution - http://sourceforge.net/forum/message.php?msg_id=1548159
         Introduction to Server Side Includes - http://httpd.apache.org/docs/howto/ssi.html

1) create a mail directory on virtual host

   # cd /var/www/html/vhost/example.com
   # mkdir mail

2) create index.shtml (Server-Parsed HTML) file with following line

   # vi index.shtml

<!--#include virtual="/cgi-bin/openwebmail/openwebmail.pl" -->
 
3) edit httpd.conf file to add an option "includes" and a subdomain "webmail"
   
   # vi /etc/httpd/conf/httpd.conf
   
   Scroll down to <Directory "/var/www/html"> section and add following below existing Options:
   
   Options +Includes

   Scroll down to <VirtualHost *> section add following below existing virtual hosts:

   <VirtualHost *>
	DocumentRoot /var/www/html/vhost/example.com/mail
	ServerName mail.example.com
	ServerAlias webmail.example.com
   </VirtualHost>

4) reload httpd.conf

   # service httpd graceful

5) test the subdomain from a browser for either:
 
   http://mail.example.com
   http://webmail.example.com

NOTE: make sure you have above subdomains added to your DNS server prior to this HOWTO.