Entwicklungstools
Als IDE wird in dieser Anleitung die auf Eclipse basierende IDE Spring Tool Suite in der Version spring-tool-suite-3.2.0.RELEASE verwendet.
Einrichtung
Die Einrichtung gliedert sich in folgende Schritte:
- Benötigte Software installieren
- Nuclos + Nuclos API Repository auschecken
- Projekt importieren
- Projekt einrichten
- Nuclos Server + Nuclos Client starten
Benötigte Software installieren
Installation der IDE:
Download der Spring Tool Suite und Installation nach Anleitung.
Installation von GIT (Versionsverwaltung).
sudo apt-get install git
Für die Nuclos Entwicklung muss Oracle Java verwendet werden, IcedTea o.ä funktioniert nicht zuverlässig. Wer sich unsicher ist welche JVM Standardmäßig verwendet wird kann das wie folgt prüfen:
$ java -version java version "1.7.0_25" Java(TM) SE Runtime Environment (build 1.7.0_25-b15) Java HotSpot(TM) 64-Bit Server VM (build 23.25-b01, mixed mode)
Nuclos + Nuclos API Repository auschecken
Nuclos steht als Maven Projekt zur Verfügung. SpringSource importiert das Git Projekt und erzeugt auf Grundlage der Mavenkonfiguration die benötigten Projekte im geöffneten Workspace.
Beim ersten Projektimport muss ein Connector für GIT bzw EGIT installiert werden, da dieser normalerweise nicht vorhanden ist.
Über den Link m2e Marketplace wird ein Auswahlfenster geöffnet in dem der m2e-egit Connector ausgewählt werden kann.
SpringSource wird den Connector herunterladen, installieren und die IDE neustarten.
Sobald der Connector installiert wurde kann an der selben Stelle mit dem Import von Nuclos fortgesetzt werden.
Als SCM URL wird das Repository, also https://bitbucket.org/nuclos/nuclos.git für nuclos, https://bitbucket.org/nuclos/nuclos-api.git für nuclos-api ausgewählt.
Das Auschecken und importieren des Projektes dauert etwas länger, je nach Auslastung von System und Netzwerk.
Wenn keine Probleme aufgetreten sind, enthält der Package Explorer nach dem Vorgang mehrere Projekte. Diese stellen die einzelnen Module von Nuclos dar.
Nuclos Server einrichten
Apache Tomcat einrichten
Für den Nuclos Server wird der Tomcat Application Server in der Version 7 (Core) benötigt.
http://tomcat.apache.org/download-70.cgi
Es bedarf keiner Installation. Das heruntergeladene Archiv muss lediglich entpackt werden.
$ tar xzf apache-tomcat-7.0.42.tar.gz
In SpringSource muss über File->New oder wie im ScreenShot über die Serveransicht ein neuer Server angelegt werden.
Als Server Typ wird Tomcat v7.0 Server ausgewählt. Als Tomcat installation directory wird das Verzeichnis angegeben, in das der Server vorher entpackt wurde.