MOA BUILD-SYSTEM
================


Einleitung
----------

Das MOA Build-System bietet eine einheitliche Build-Umgebung f�r
alle MOA Sub-Projekte.

Es bietet folgende Vorteile:
 - zentrale Installation des Build-Tools (Ant)
 - zentrale Ablage der Build-Scripts
 - standardisiertes Build �ber alle Sub-Projekte
 - einfache M�glichkeit, alle Sub-Projekte auf einmal zu erzeugen


Voraussetzungen
---------------

Das MOA Build-System setzt ein JDK 1.3.1 oder h�her voraus. Folgende
Umgebungsvariablen m�ssen (required) oder k�nnen (optional) gesetzt
sein:

 - JAVA_HOME (required): zeigt auf das vom Build-System zu verwendende
   JDK (ab Version 1.3.1)
 - CATALINA_HOME (optional): zeigt auf eine Tomcat-4.1 Installation; wird
   verwendet, um Web-Applikationen zu deployen
 - JMETER_HOME (optional): zeigt auf eine JMeter-1.8 Installation; wird
   verewndet, um das JMeter-Plugin zu deployen 


Aufruf
------

Unter Windows: 
  build [project [targets]]

Unter Unix: 
  build.sh [project [targets]]

Der Parameter 'project' spezifiziert das Sub-Projekt, f�r das das Build
aufzurufen ist. Der Wert 'all' gibt an, dass das Build f�r alle MOA Sub-Projekte
durchgef�hrt werden soll. 

Der Parameter 'targets' spezifiziert eine Liste von Build-Targets. Werden keine
Targets angegeben, wird automatisch der Default-Target des jeweiligen Projekts
ausgef�hrt.

Ein Aufruf ohne Parameter wird wie ein Aufruf mit dem Parameter 'all' interpretiert.


Sub-Projekte
------------

Als Sub-Projekte stehen derzeit zur Verf�gung:

 - common
 - spss.client
 - spss.server
 - id.server

Das MOA Build-System geht davon aus, dass die Sub-Projekte in der selben
Verzeichnis-Ebene zu finden sind wie das Build-System selbst.


Targets
-------

Sub-Projekte stellen ihre Targets in einem Build-File namens 'build.xml' in
ihrem Wurzelverzeichnis zur Verf�gung. Jedes Sub-Projekt hat grunds�tzlich 
die Freiheit, eigene Targets zu definieren. F�r ein m�glichst automatisiertes
Build und Deployment aller Sub-Projekte auf einmal, sollten einige Top-Level
Targets �ber alle Sub-Projekte hinweg standardisiert sein:

dist-all: erzeugt deploy-f�hige bzw. verteilbare Module

deploy-catalina: f�hrt das Deployment in einen Tomcat-4.1 durch

deploy-all: f�hrt das Deployment in Zielumgebungen durch