raimund@716: Lada-Server
raimund@716: ===========
raimund@716: Die Software bietet Funktionalität zur Erfassung und Bearbeitung
raimund@716: von Messdaten. Sowie der Planung der Messungen.
raimund@716: 
raimund@716: Weitere Informationen finden sich auf der Projektwebseite unter
raimund@716: der Adresse: https://wald.intevation.org/projects/lada/
raimund@716: 
raimund@716: Die Software entstand im Rahmen einer Software Entwicklung durch die
raimund@716: Intevation GmbH im Auftrag des Bundesamt für Strahlenschutz in den Jahren 2013
raimund@716: bis 2015.
raimund@716: 
raimund@716: Kontakt
raimund@716: -------
raimund@716: Bundesamt für Strahlenschutz
raimund@716: SW2 Notfallschutz, Zentralstelle des Bundes (ZdB)
raimund@716: Willy-Brandt-Strasse 5
raimund@716: 38226 Salzgitter
raimund@716: info@bfs.de
raimund@716: 
raimund@716: Lizenz
raimund@716: ------
raimund@716: Die Software ist unter der GNU GPL v>=3 Lizenz verfügbar.
raimund@716: Details siehe die Datei `COPYING`.
raimund@716: 
raimund@716: Quelltext
raimund@716: ---------
raimund@716: Die Quelldateien lassen sich wie folgt auschecken:
raimund@716: ```
raimund@716: hg clone https://scm.wald.intevation.org/hg/lada/lada-server
raimund@716: ```
raimund@716: 
raimund@716: Entwicklung
raimund@716: -----------
raimund@716: Für die Entwicklung wird ein JDK7 und maven3 oder höher benötigt. Sämtliche
raimund@716: Abhängigkeiten werden von dem maven build System aufgelöst.
raimund@716: 
raimund@716: Installation
raimund@716: ------------
raimund@716: Zur Installation der Lada-Anwendung müssen folgende Schritte unternommen werden:
raimund@716: 
raimund@716:  $ mvn clean compile package
raimund@716:  $ cd /opt/wildfly8.2.Final/standalone/deployments
raimund@716:  $ cp /path/where/the/war/file/is/lada-server.war .
raimund@716:  $ touch lada-server.war.dodeploy
raimund@716: 
raimund@716: Zum Aktualisieren der Anwendung genügt es, wenn die lada-server.war Datei aktualisiert
raimund@716: wird.
raimund@716: 
raimund@716: Die Anwendung ist dann unter dem Pfad "/lada-server" (abhängig vom Archivnamen)
raimund@716: erreichbar.
raimund@716: 
raimund@716: Tests
raimund@716: -----
raimund@716: Die auf Arquillian basierenden Tests erfordern einen vollständig konfigurierten
raimund@716: und gestarteten Wildfly Application-Server, da für die Schnittstellentest eine
raimund@716: Clientanwendung simuliert wird und HTTP-Requests ausgeführt werden.
raimund@716: 
raimund@716: Das Ausführen der Tests erfolgt durch das Kommando
raimund@716: 
raimund@716:  $ mvn -Premote-test clean test
raimund@716: 
raimund@716: Dokumenation
raimund@716: ------------
raimund@716: Die Entwicklerdokumentation (Javadoc) kann mit dem folgenden Befehl im
raimund@716: Verzeichnis der Serveranwendung erzeugt werden:
raimund@716: 
raimund@716:  $ mvn javadoc:javadoc
raimund@716: 
raimund@716: Der Ordner 'target' enthält dann die Dokumentation im HTML-Format in dem
raimund@716: Verzeichnis 'site/apidocs'.