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

Pre-Requisites

• A running Tomcat Installation - you can obtain it and learn how to get it running at http://jakarta.apache.org/tomcat
• A running IMAP server
• A jwma WAR distribution package (webmail.war)

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/jakarta-tomcat/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 from
   • http://jakarta.apache.org/builds/jakarta-tomcat-4.0/release
2. Unpack the distribution in the directory of your choice (example):
   • tar -xvzf jakarta-tomcat-4.1.18.tar.gz
   • unzip jakarta-tomcat-4.1.18.zip
3. Move the downloaded WAR distribution to the webapps directory within tomcat's directory
4. Edit the conf/server.xml file to set the port of your choice in the active connector (I use 8090 for example).
5. Start the server, using bin/catalina.sh start respectively bin\catalina.bat start (this will cause jwma to be unpacked).
6. Edit <tomcat 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.
7. Edit <tomcat 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.
8. Restart the server, using bin/catalina.sh restart respectively bin\catalina.bat restart (this will cause the new config to be loaded on startup).
9. Log in to jwma webmail, using http://<yourhost.yourdomain>:<yourport>/webmail

© 2000-2003 jwma team