#
#
#    Scalix Public License
#
#
#    The contents of this file are subject to the Scalix Public License
#    Version 1.1 ("License"); you may not use this file except in
#    compliance with the License. You may obtain a copy of the License at
#
# 
#    http://www.scalix.com/community/licensing 
#
# 
#    Software distributed under the License is distributed on an "AS IS"
#    basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
#    the License for the specific language governing rights and limitations
#    under the License.
#
# 
#    The Original Code is Scalix Server. 
#    The Initial Developer of the Original Code is Scalix Corporation. 
#    Copyright (C) 2006 Scalix Corporation. 
#    All Rights Reserved.
#    Additional Copyrights may apply - see the notice in each file
#
#
#
#
#
Scalix Messaging Services (SMS) Build Instructions

Basic steps:
  0) Install JDK 1.5.0_06 (or greater), Ant 1.6.5 (or greater)
  1) Download Scalix source from the web site and unpack it
  2) Change into the top-level of your Scalix installation
  3) Run ant
  4) Install SMS

Step 0) Set up your development environment (JDK 1.5.0_06 or greater,
Ant 1.6.5 or greater)

We'll assume that you know how to get and set up the JDK - if you
don't, then we suggest starting at http://java.sun.com and learning
more about Java, before returning to this README. Scalix runs with
JDK 1.5.0_06 and later.

Like many Open Source java projects, Scalix uses Apache Ant for build
control.  Specifically, you MUST use Ant version 1.6.5 or greater.

Ant is "kind of like make without make's wrinkles".  Ant is
implemented in java and uses XML-based configuration files.  You can
get it at:

  http://ant.apache.org

You'll need to download the Ant binary distribution.  Install it
according to the instructions at:

  http://ant.apache.org/manual

Step 1) Download SMS from the Web site

We'll assume you already did this, or you wouldn't be reading this
file.  However, you might have received this file by some alternate
route, or you might have an incomplete copy of the SMS, so: SMS
releases are available for download at:

  http://www.scalix.com/products/opensource.html

Download the tarred/gzipped version of the archive, and uncompress 
it into a directory of your choice.

Step 2) Change to the top-level of your SMS source installation

SMS' top-level directory contains the build.xml file. By default,
you do not need to change any of the settings in this file, but you do
need to run ant from this location so it knows where to find build.xml.

If you would like to change settings you can do so by creating one 
or more of the following files and placing your own property settings
in there:

    build.properties
    
Step 3) Run ant

Assuming you have ant in your PATH and have set ANT_HOME to the
location of your ant installation, typing "ant" at the shell prompt
and command prompt should run ant and build you a war file.  Ant will by 
default look for the "build.xml" file in your current directory, 
and build SMS.

Step 4) Install SMS

The result of a successful build will create a "war" (web archive) file 
in the "build" subdirectory.  This is a standard J2EE war file that can be 
installed in any Servlet container (e.g. Apache Tomcat).  Scalix 11 web 
applications require at least Apache Tomcat 5.5.x. You can use "ant deploy"
to copy the war file to the Tomcat installation configured in your
build.properties file.

For further information on Scalix , go to:
  http://www.scalix.com

To join the discussions on the forums, go to:
  http://www.scalix.com/community

Please post suggestions, questions, corrections or additions to this
document on the forums.

Copyright (C) 2006 Scalix Corporation.  All rights reserved.
