WAR-File
Aus Melin WebHelp
Melin ist nicht nur als Standalone-Version verfügbar, sondern auch als WAR-File zum Deployment in einem Application Server. Gegenüber der normalen Release weist das WAR-File einige kleine Unterschiede in der Konfiguration auf. Die Funktionalität ist jedoch ansonsten identisch.
Inhaltsverzeichnis |
[bearbeiten] Inhalt des WAR-Files
Das WAR-File wird aus einer normalen Release erstellt, Änderung am Code ist nicht notwendig.
- Paktetinhalt: In einer normalen Melin-Release sind drei Order: msite, tomcat, htdocs. In einem WAR-File gibt es nur den Ordner "htdocs/melin" mit der Applikation, für Konfigurationsdaten gibt es einen weiteren Ordner "msite" der außerhalb des webapps-Ordners liegt und Konfigurationsdaten enthält. Der Grund dafür ist daß diese Daten bei einem erneuten Deployment oder einem Update nicht verloren gehen sollen. Da der "home"-Ordner der normalen Release nicht enthalten ist heisst das auch daß sich User mit http://melinserver/melin/ einloggen (der letzte / ist wichtig bei manchen Browsern) statt mit http://melinserver:8200 anmeldet.
- In der web.xml dürfen keine Pfade zum SITE-DIR enthalten sein, schließlich vergibt der Application Server selbst sein Heimatverzeichnis. Entfernt man den SITE-DIR-Eintrag aus der web.xml sucht sich Melin die Konfigurationsdatei über Umgebungsvariablen. In einer Tomcat-Installation wird über die Variable "catalina.base" gesucht, an folgenden Orten:
catalina.base + "/melin/msite/demon/config/melinconfig.xml";
catalina.base.replaceAll("/tomcat", "/msite/demon/config/melinconfig.xml");
- Alternativ kann man auch die Umgebungsvariable MELIN_HOME setzen auf den Ordner in dem das msite-Verzeichnis liegt. Wenn man die genaue Position kennt kann man auch in der web.xml wieder das SITE-DIR setzen.
[bearbeiten] Manuelles Erstellen des WAR-Files
Ein WAR-File kann auch aus einer bestehenden Installation heraus erstellt werden. Ebenso kann ein normales Release-Paket dafür verwendet werden. Dieses muss zur Vorbereitung an beliebiger Stelle entpackt werden.
- Aus der Datei /htdocs/melin/WEB-INF/web.xml muss der Eintrag SITE-DIR entfernt werden.
- Nun wechselt man in den Ordner htdocs/melin und packt diesen mit allen Unterordnern zu einem neuen Archiv. Dieses nennt man dann um, zum Beispiel in melin.war. (Unter Unix: zip -r /tmp/melin.war *)
- Zuletzt packt man den Ordner "msite" zusammen. Dieser wird auf dem Application Server an einer beliebigen Stelle entpackt. Im Application Server muss anschließend die Umgebungsvariable MELIN_HOME auf den Ordner gesetzt werden in dem das msite-Verzeichnis liegt werden damit Melin diesen Ordner auch findet.
[bearbeiten] Einstellungen im Betrieb
Im Betrieb sollten möglichst viele Daten in der Datenbank abgelegt werden damit keine Daten durch ein erneutes Deployment verloren gehen.
- Nach der Einrichtung der Master-Datenbank sollte als erstes die Userverwaltung in der Systemeinstellung auf Datenhaltung in der Datenbank umgestellt werden (Wichtig: vorher umkopieren über den Link "Move existing data" in den Systemeinstellungen damit mindestens der Superuser-Account kopiert ist).
- Auch der Daemon läuft idealerweise als Teil des Application Servers (Konfiguriertbar unter Einstellungen/Serverprozesse).