From 7a433b7053eea6bd2270bdb42bc22bfb5ab8e815 Mon Sep 17 00:00:00 2001 From: gregor Date: Mon, 7 Jul 2003 15:46:46 +0000 Subject: Initial commit git-svn-id: https://joinup.ec.europa.eu/svn/moa-idspss/trunk@4 d688527b-c9ab-4aba-bd8d-4036d912da1d --- build/README.txt | 80 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 build/README.txt (limited to 'build/README.txt') diff --git a/build/README.txt b/build/README.txt new file mode 100644 index 000000000..4c8a1cf27 --- /dev/null +++ b/build/README.txt @@ -0,0 +1,80 @@ +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 -- cgit v1.2.3