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

Pre-Requisites

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

Deployment

The WAR distribution will be unpacked and running without any further configuration, if your IMAP and SMTP servers are located on the same host. Please see the test walkthrough for the bits & pieces of configuration that are necessary to run on Orion.
Thanks to Markus Homberg, for valuable hints on how to make things work out.


Test Walkthrough

1. Download the binary distribution to a directory of your choice:
   • Unix/Linux/Windows: zip
2. Unpack the distribution in the directory of your choice:
   • jar -xvf orion1.5.2.zip
3. Change to the directory, and create a folder called webapps
4. Move the downloaded WAR distribution (jwma) to the newly created webapps directory within orion's directory
5. Edit the config/application.xml file to add
   <web-module id="webmail-web" path="../webapps/webmail.war" />
6. Edit the config/default-web-site.xml file to
   • add <web-app application="default" name="webmail-web" root="/webmail" />
   • change the port of the web-site host if necessary
7. Start the server using java -jar orion.jar (this will cause jwma to be deployed).
8. Edit <orion 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.
9. Edit <orion 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.
10. Restart the server, using the method you consider approbiate (I have tried to figure out how to use java -jar admin.jar, but it does not seem to work, it just get's stuck, so I use kill -9 on my unix box, and 7. to restart it.)
11. Log in to jwma webmail, using http://<yourhost.yourdomain>:<yourport>/webmail

Version note

jwma has been tested against the latest stable Orion release, which is v1.5.2

Note: Orion is only free for development purposes. For commercial deployment, a license has to be obtained..

© 2000-2003 jwma team