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

Pre-Requisites

• A Jetty Installation - you can obtain a release from SourceForge and learn how to get it running at http://jetty.mortbay.com
• A running IMAP server
• A jwma WAR distribution package (webmail.war)

Deployment

The WAR distribution works best, however, it seems as if it needs to be extracted by hand. Please see the test walkthrough for the bits & pieces of configuration that are necessary to run from Jetty.

Test Walkthrough

1. Download the binary distribution to a directory of your choice
   • http://sourceforge.net/projects/jetty -> Files
2. Unpack the distribution in the directory of your choice (example):
   • tar -xvzf Jetty-4.2.6.tgz
   • unzip .zip
3. Change to the webapps in jetty's directory, and create a folder named webmail
4. Move the downloaded WAR distribution (jwma) to the newly created webapps/webmail directory within jetty's directory
5. Extract the WAR file using jar -xvf webmail.war (in <jetty's dir>/webapps/webmail)
6. Optionally you can now move webmail.war to the parent directory (i.e. webapps), so that it is not accessible from outside)
7. Edit <jetty 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 <jetty 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. Edit the etc/demo.xml file to add following context:
   

   <Call name="addWebApplication">
     <Arg>/webmail/*</Arg>
     <Arg><SystemProperty name="jetty.home" default="."/>/webapps/webmail</Arg>
   </Call>

10. Edit bin/jetty.sh, to ensure that you have JETTY_HOME set. Also ensure you have a valid JAVA_HOME set.
11. Start the server using bin/jetty.sh or bin\jetty.bat
12. Log in to jwma webmail, using http://<yourhost.yourdomain>:<yourport>/webmail

© 2000-2003 jwma team