= Entwickler-Installation des LUG-Framework =

Diese Anleitung dient dazu, daß man das erweiterte Lug-Projekt (also inklusive Datenbank-Oberfläche und Vereinsverwaltung als Beispiel) im Sourcecode herunterlädt und mit Eclipse daran mitarbeiten kann.


== Basissystem ==

Dieses Beispiel wird auf einem KUBUNTU – System (Version 10.04) entwickelt.
Hier wurden einige Programme bereits vorab installiert um das Beispiel verwenden zu können.

Im ersten Schritt wird JAVA von SUN (keine Alternative) installiert.

 sudo apt-get install kubuntu-restricted-extras

(hier werden bereits Teile von Java installiert)
Weitere Infos unter: http://wiki.ubuntuusers.de/ubuntu-restricted-extras

Die restliche JAVA-Installation wird recht gut bei ubuntuuser beschrieben:
http://wiki.ubuntuusers.de/Java/Installation

''Bitte beachten:''
UNBEDINGT mittels KONSOLE installieren.
Es erfolgt eine Abfrage zu den Lizenzbedingungen die nur in der Konsole sichtbar und bestätigt werden.

 sudo apt-get install sun-java6-jdk

das JDK für Entwickler

 sudo apt-get install sun-java6-fonts

Die Schriftart Lucida (normalerweise nicht benötigt)

* (bereits automatisch installiert: sun-java6-jre das JRE für normale Anwender)
* (bereits automatisch installiert: sun-java6-plugin Java-Plugin für Webbrowser)

 sudo apt-get install sun-java6-source

Quellpakete von Java (wird z.B. benötigt um ~JavaDoc der Standardbibliothek in Eclipse anzuzeigen (wie eine .JAR hinzufügen)

Anschließend werden die restlichen Programme installiert:

MERCURIAL mittels:

 sudo apt-get install mercurial
 
ANT durch:

 sudo apt-get install ant
ECLIPSE: ??????? Siehe EclipseInstallation, entweder

 sudo apt-get install eclipse

oder Von: http://www.eclipse.org/downloads/  wird bei diesem Beispiel "Eclipse IDE for Java Developers" benutzt.



== Installationsanweisungen ==


Im ersten Schritt wird im {{/home/benutzername/}} Verzeichnis die Datei: "{{.build.properties}}" (bitte auf den PUNKT am Anfang achten) erzeugt.

In dieser Datei werden folgende 3 Zeilen eingetragen;

 hguser=benutzername
 hgserver=hg.javaproject.de:2222
 hgdatum=2010-05-23

Als {{hguser}} wird der von ThomasBayen vergebene Benutzername auf dem Mercurial-Server eingegeben. {{hgdatum}} wird immer aktuell mitgeteilt, wenn es eine neue Version gibt.

Anschließend wird ein neues Arbeitsverzeichnis angelegt. (Workspace unter Eclipse genannt)
Das Verzeichnis trägt in diesem Beispiel den Namen: Eclipse-LUG
In dem Verzeichnis Eclipse-LUG wird folgender Befehl in der Konsole eingegeben:

 hg clone -U ssh://benutzername@hg.javaproject.de:2222/repos/Vereinsverwaltung Vereinsverwaltung
 
ACHTUNG: Hierbei muss natürlich das Wort benutzername durch Ihren benutzernamen ersetzt werden.....

Beim ersten Zugriff wird eine Sicherheitsabfrage erfolgen, die mit yes bestätigt werden muss:
{{The authenticity of host '~[hg.javaproject.de]:2222 (~[91.41.155.54]:2222)' can't be established.
RSA key fingerprint is 5d:01:17:cf:ca:ca:d7:88:73:d6:e3:f7:eb:e1:38:17.
Are you sure you want to continue connecting (yes/no)?}}

Nach Eingabe des Passwortes (für das Projekt) werden diverse Verzeichnisse angelegt.

Nun wird das Projekt mittels folgender Befehle installiert und gestartet:

 cd Vereinsverwaltung
 hg update -d 2010-05-23
 ant all
 ant sadomaso
 
Das Projekt besteht aus mehreren Teilprojekten. Diese werden nacheinander installiert. Für jedes Teilprojekt muss zur Zeit jeweils das Passwort eingegeben werden. Hierfür haben Sie ca. 1 Minute Zeit, d.H. Sie sollten während der Installation weder einen Kaffee holen gehen noch ein Telespiel in einem anderen Task machen.

Besser ist es, wenn man sich passwortlos per ssh public key auf dem Server einloggen kann: http://www.lug-kr.de/wiki/OpenSSH#section-OpenSSH-EinloggenPerSSHSchl_C3_BCssel - dann kann man den Kaffee beruhigter trinken.

Übrigens könnte man große Teile dieser Prozedur in ein Skript verpacken, dem man dann nur noch das Versionsdatum als Parameter übergibt. Wer hat Lust, das zu machen und auszuprobieren?

-- ThomasThiessen und ThomasBayen


== Alternative Installationsanweisung (bitte testen) ==

Die "~/.build.properties"-Datei wird wie oben angelegt, dabei muss das Datums-Tag nicht mehr angegeben werden. Dann startet man folgendes Skript:

 #!/bin/bash
 #Beispielaufruf:
 #./sadomaso.sh tbayen 2010-06-03
 echo verwendeter Benutzername: "$1"
 echo verwendete Version: "$2"
 rm -r sadomaso
 mkdir -p sadomaso
 cd sadomaso
 hg clone -U ssh://$1@hg.javaproject.de:2222/repos/Vereinsverwaltung Vereinsverwaltung
 cd Vereinsverwaltung
 hg update -d $2
 ant all
 ant -Dhgdatum=$2 sadomaso

Dieses Skript startet man mit

 ./sadomaso.sh benutzername 2010-06-03

wobei man die Parameter entsprechend ändern sollte.

== Einzelner Start des Programms ==

Ist alles einmal installiert, kann man im Verzeichnis "Vereinsverwaltung/dist/" das Programm direkt starten mit:

 java -jar Vereinsverwaltung.jar



----
[{Tag Java LugFramework}]