Server-Installation

Es stehen vier Varianten an paketierten WAR-Dateien für eine Server-Installation zur Verfügung:

Hibernate	Infos: Wikipedia, Homepage
JPA/EclipseLink	Infos: Wikipedia, Homepage
ObjectDB	ObjectDB (JPA-Implementierung), Lizenz von Nöten
IBM BlueMix	EclipseLink/DB2, siehe folgender Artikel

Parameter: database
Werte: PersistenceFramework|JPAimplementation|Database|DDLstrategy| JDBC-URL|DatabaseUser|DatabasePasswort
Beispiel: JPA|ECLIPSELINK|H2|UPDATE|jdbc:h2:c:/TreeDBdata/db/treedb|tree|db
Erläuterung: Das Persistenz-Framework und die Datenbank werden durch einzelne Parameter, die durch ein | -Zeichen getrennt werden, beschrieben.

PersistenceLayer: – legt das Persistenz-Framework mit folgenden möglichen Werten fest: – HIBERNATE oder JPA.
JPAimplementation: HIBERNATEJPA, ECLIPSELINK, OBJECTDB
Für HIBERNATE als Persistenz-Framework hat dieser Parameter den Wert null.

Database: H2, DERBY, HSQLDB, MYSQL, MARIADB, POSTGRES, SQLSERVER, ORACLE, DB2,FIREBIRD, SQLITE
Für die jeweilige Datenbank muss der entsprechende JDBC-Treiber von der Hersteller-/Entwicklerseite im Verzeichnis \WEB-INF\lib installiert werden. Die aktuelle Version der TreeDB.war-Datei beinhaltet die JDBC-Treiber für folgende Datenbanken: H2, MYSQL und POSTGRES.

Hinweis: Für das jeweilige Datenbanksystem müssen eine Datenbank und ein dazugehöriger Benutzer mit den entsprechenden Rechten anlegt werden. Für diese Schritte konsultieren Sie bitte das Handbuch Ihres Datenbanksystems.

Parameter: DDLstrategy steht für Data Definition Language und legt fest, wie das Persistenz-Framework das Datenbankschema behandelt:
Werte: VALIDATE validiert nur das bestehende Datenbankschema ohne Änderungen
UPDATE aktualisiert das bestehende Datenbankschema. Existiert kein Datenbankschema, werden das Datenbankschema und die damit verbundene Datenbank neu angelegt.
CREATE legt ein neues Datenbankschema an und löscht alle bestehenden Daten.

Parameter: JDBC-URL repräsentiert die SQL-Datenbank-spezifischen Verbindungsparameter.
Beispiele:
H2-Datenbank: jdbc:h2:c:/TreeDBdata/db/treedb
MySQL-Datenbank: jdbc:mysql://10.0.0.38:3306/treedb

Parameter: DBuser ist der Datenbankbenutzer.
Parameter: DBpassword ist das Passwort des Datenbankbenutzers. Diese beiden Parameter dienen der Authentifizierung gegenüber der SQL-Datenbank.

Parameter: persistenceCfgCreateStrategy legt fest, wie die TreeDB für das jeweilige Persistenz-Framework – HIBERNATE oder JPA – die jeweilige Konfigurationsdatei anlegt. Diese Dateien hibernate.cfg.xml (HIBERNATE) und persistence.xml (JPA) werden, wenn möglich, automatisch aus dem zusammengesetzten Parameter database erzeugt.
Werte: DEFAULT_LOCATION – die TreeDB versucht dynamisch, die benötigte Konfigurationsdatei des jeweiligen Persistenz-Frameworks zu generieren. Sollte der Applikations-Server keine Schreibrechte besitzen, um die Konfigurationsdatei dynamisch anzulegen, muss stattdessen der
Parameter NO_FILE_CREATION verwendet werden
NO_FILE_CREATION – die benötige Konfigurationsdatei muss vom Benutzer manuell angelegt werden:
JPA: \META-INF\persistence.xml
HIBERNATE: \hibernate.xml.cfg
TEMPORARY – dieser Parameter ist nur für das Persistenz-Framework HIBERNATE gültig. Die Konfiguration des Frameworks geschieht rein programmativ ohne Zwischenschritt einer Dateisystem-basierten Konfigurationsdatei.

Parameter: serverURL ist die URL, unter der die Web-Applikation von extern erreichbar ist.
z.B. http://treedb.at
Links auf Ressourcen wie Bilder, Videos oder andere Daten bauen auf dieser URL auf. Achtung, serverURL beinhaltet nicht den Kontext der Applikation! http://treedb.at/TreeDB

Parameter: internalURL
Befindet sich der Applikations-Server hinter einem Reverse-Proxy in einer netzwerkmäßig eingeschränkten Umgebung, kann der Fall auftreten, dass die TreeDB nicht über die serverURL auf sich selbst zugreifen kann. Dies ist aber notwendig, wenn die TreeDB mit Hilfe des externen Programms wkhtmltopdf PDF-Dateien erzeugen soll. Für diesen speziellen Fall muss der Wert internalURL gesetzt werden: z.B. http://localhost:8080

Parameter: adminPassword legt für den vordefinierten Admin-Benutzer admin das Passwort fest. Dieses Passwort muss im Falle einer Neuinstallation gesetzt werden, um Benutzer mit administrativen Rechten anlegen zu können. Danach kann dieser Parameter wieder gelöscht werden. Das Passwort muss mindestens 5 Zeichen lang sein.

Parameter: PreferredLanguages definiert ein Liste von Sprachen, die von der TreeDB unterstützt werden.
Werte: z.B. de_DE,en_UK
Diese Liste dient dazu, einen Ersatz für eine nicht unterstützte Sprache zu finden. Beispiel: Die GUI-Sprache des Benutzers ist Polnisch, die Datenbank, die geöffnet wird, unterstützt aber nur Deutsch und Englisch – in diesem Fall wird der deutschen Version gemäß der Reihung in der Liste der Vorzug gegeben.

 
<init-param>
	<description>
	DAO parameter
	</description>
	<param-name>database</param-name>
	<param-value>HIBERNATE|null|H2|
          UPDATE|jdbc:h2:c:/TreeDBdata/db/treedb|tree|db</param-value>  
</init-param>

<init-param>
	<description>persistence config file write strategy: 
          NO_FILE_CREATION,DEFAULT_LOCATION,TEMPORARY</description>
	<param-name>persistenceCfgCreateStrategy</param-name>
	<param-value>DEFAULT_LOCATION</param-value>
</init-param>

<init-param>
	<description>Server URL</description>
	<param-name>serverURL</param-name>
	<param-value>http://localhost:8080</param-value>
</init-param>

<init-param>
	<description>internal Server URL</description>
	<param-name>internalServerURL</param-name>
	<param-value>http://localhost:8080</param-value>
</init-param>

<init-param>
	<description>preferred languages</description>
	<param-name>preferredLanguages</param-name>
	<param-value>de_DE,en_UK</param-value>
</init-param>

<init-param>
	<description>TreeDB Admin password</description>
	<param-name>adminPassword</param-name>
	<param-value>terbiu41m</param-value>
</init-param>