jwma Deployment - Resin How-To
Main | Deployment | Configuration | Architecture | Development | Screenshots | SF Project Site
Index | Tomcat | Jetty | Resin | Orion

Pre-Requisites

• A running Resin Installation - you can obtain and learn how to get it running at http://www.caucho.com
• A running IMAP server
• A jwma WAR distribution package (webmail.war)

Standalone Deployment

The WAR distribution of jwma is plug & play. It will be automatically unpacked and running without any further configuration, if your IMAP and SMTP servers are located on the same host. It just has to be placed into the /path/to/resin/webapps directory. Below there is a walkthrough, that should give a guideline on how to get it running for sure, in a development environment.


Test Walkthrough

1. Download the binary distribution to a directory of your choice:
   • Unix/Linux: tarball
   • Windows: zip
2. Unpack the distribution in the directory of your choice:
   • tar -xvzf resin-2.1.16.tar.gz
   • unzip resin-2.1.16.zip
3. Move the downloaded WAR distribution to the webapps directory within Resin's directory
4. Edit bin/httpd.sh to ensure that you have RESIN_HOME set. Also ensure you have a valid JAVA_HOME set.
5. Edit the conf/resin.conf file to set the port of your choice for the http server (I use 8080 for example).
6. Start the server, using bin/httpd.sh start respectively bin\httpd.exe -conf conf\resin.conf (this will cause jwma to be unpacked).
7. Edit <resin dir>/webapps/webmail/WEB-INF/etc/configuration.xml to check and set following settings:
   • postoffice address (set to your IMAP server host name; fully qualified best)
   • postoffice type (set plain for UW style, mixed for others).
   • mta address (set to your SMTP server host name or address)
   • Other's if wished according to the specification document.
8. Edit <resin dir>/webapps/webmail/WEB-INF/etc/site_template.xml to check and set following settings:
   • <rootfolder></rootfolder> (e.g. INBOX for Courier and Cyrus, mail for UW)
   • <draftfolder ></draftfolder> (e.g. set INBOX.Drafts for Courier and Cyrus, mail.Drafts for UW)
   • <trashfolder></trashfolder> (e.g. set INBOX.Trash for Courier and Cyrus, mail.Trash for UW)
   • Other options if wished following the specification document.
9. Restart the server, using bin/httpd.sh restart respectively the GUI in windows, that popped up after starting resin (this will cause the new config to be loaded on startup).
10. Log in to jwma webmail, using http://<yourhost.yourdomain>:<yourport>/webmail

Version note

jwma was tested against the latest stable Resin developer release, which is v2.1.16, however, it is expected to run with any 2.x and probably even 1.x releases.
Note: Resin is only free for development purposes. For commercial use, a license has to be obtained..

© 2000-2003 jwma team