install-0.7.7

一个用Java开发的Web邮局

Installation instructions for WebMail 0.7.7
===========================================


There are two approaches to installing WebMail >= 0.7.7, both require the Tomcat
(or a similar Servlet API 2.2 + WebApp compatible) server.

1. Installation of a pre-compiled WAR-file (Webapp ARchive)
2. Build and install from source

The first installation method is almost always the preferred choice. Building 
from source may be relevant to you if you need to do modifications to the
source.

1. Installation of a pre-compiled WAR-file
------------------------------------------

This installation method is very simple:

1. Drop the webmail.war-file in your webapp-home. Under Apache Tomcat, this
   is usually /var/lib/tomcat/webapps, but you might find it under different
   locations on your system.
2. chown www-data.www-data webmail.war, i.e. change the owner of the WAR-file
   to the WWW-User (the user under which Tomcat is running)
3. Restart Tomcat (or do any steps required by your servlet engine to deploy
   the WAR-file)

WebMail is then available by calling http://yourhost/webmail/index.jsp

Please don't forget to visit the administration interface first. You can access 
it by calling http://yourhost/webmail/admin.jsp



2. Build and install from source
--------------------------------

WebMail is compiled by using the Ant build-system. For the installation, you 
will need a running JDK 1.2 (or greater).

The following steps are required (for a quick-start):
1. Set your JAVA_HOME environment variable (to the directory where the JDK is
   installed)
2. Change the build.sh script such that the TOMCAT_HOME is set properly
3. Run ./build.sh install-tomcat to compile and install WebMail in your webapp-
   home. Make sure you have write-permissions on that directory.
4. chown -R www-data.www-data the webmail/ directory in the WebApp-home

Please see build.xml for further possible targets that may be used.