Setting Up hMailServer for Local Email Testing
----------------------------------------------

hMailServer is an open source (as of version 4.x) email server for Windows.
It supports SMTP, POP, and IMAP. This document describes a simple setup
using hMailServer for testing the email functions of your web application
locally. If you own a static IP address and a domain name, and want to setup
a proper email server for regular usage, i.e. send and receive email via the
Internet, please check out the hMailServer documentation at
http://www.hmailserver.com/documentation/.

1. Download hMailServer from http://www.hmailserver.com/

2. Installation

  . Full installation
  . Use built-in MySQL

3. Configuration

  * Check out the configuration video at
    http://sun.calstatela.edu/~cysun/www/videos/hmailserver.wmv
  . Add a domain, e.g. localhost.localdomain
  . Add a catch-all address, e.g. cysun@localhost.localdomain. If an email is
    sent to this domain, but the address of the email does not match any
    existing account under this domain, the catch-all address will get this
    email.
  . Add an account, e.g. cysun@localhost.localdomain
  . Under Settings -> Protocols -> SMTP -> Delivery of e-mail, specify the
    host name to be localhost.
  . Under Advanced -> IP Ranges, delete Internet. This step is a safety
    measure to ensure that your email server won't be used for spam relay
    in case of some accidental misconfiguration.

4. Setup an email client to send and receive email from this email server.
   Check out the configuration video for an example of using Outlook
   Express 6. Note that the account name should be the full account name,
   e.g. cysun@localhost.localdomain, not just cysun.

5. CSNS Configuration: in build.properties, change the values of
   mail.smtp.username and mail.smtp.password to the username and password
   of the account you created under hMailServer.