Installationsanleitung

Konfiguration - Applikation

Tomcat stellt nur den Rahmen für die Standalone Applikation dar. Nun muss die Applikation selbst eingebracht werden, wie folgt:

Schritt 1: Herunterladen der Applikationsdatei

Sie erhalten die Applikationsdatei auf Anfrage zum Download bereitgestellt. Bitte nutzen Sie unser Kontaktformular, um den Download anzufragen:

Applikationsdownload anfragen

Nach dem Download erhalten Sie die Applikationsdatei "ROOT.war". Beachten Sie bitte, dass Sie eine .war-Datei herunterladen, die nicht ROOT.war heißt, sondern zur besseren Zuordnung die aktuelle Versionsnummer im Namen trägt. Ändern Sie den Namen der .war-Datei dann einfach nach ROOT.war um (wichtig: mit großem "ROOT").
Wenn Sie die Software auf Linux installiert haben, benötigen Sie auch genau diese ROOT.war.

Schritt 2

Im ersten Schritt haben Sie eine ZIP-Datei heruntergeladen (ROOT.zip). Entpacken Sie die Datei, so dass Sie die beinhaltete ROOT.war erhalten. Legen Sie die ROOT.war nun innerhalb des Installationsverzeichnis von Tomcat in dem Unterverzeichnis webapps ab (wenn dort bereits eine ROOT.war liegt, erstellen Sie eine Sicherungskopie der Datei).

Zur Information:
Wenn Sie die Datei als ROOT.war kopieren, wird die Applikation damit als sogenannte Root-Applikation installiert. Das bedeutet, dass die Applikation im Browser direkt über den Computernamen ohne Unterpfad aufgerufen wird, also etwa "http://computer123/". Möglicherweise betreiben Sie aber bereits eine Root-Applikation, die dann überschrieben werden würde.

In diesem Fall können Sie die Standalone Version auch in einem Unterverzeichnis installieren. Dazu benennen Sie die Datei ROOT.war einfach in xxx.war um, wobei "xxx" für ein beliebiges Unterverzeichnis steht.

Wenn Sie also beispielsweise die Datei in urlaub.war umbenennen, dann wird die Applikation automatisch im Pfad "urlaub" installiert und Ihre Mitarbeiter rufen dann die Standalone Version gemäß vorigem Beispiel über "http://computer123/urlaub" statt über "http://computer123/" auf.

Wenn Sie also die Datei ROOT.war umbenennen, um die Applikation in einem Unterpfad zu installieren, müssen Sie noch einen Konfigurationsparameter in der web.xml des Tomcat anpassen. Gehen Sie dann nochmal auf die Seite zu den Konfigurationsparametern und passen die Konfiguration an: Kapitel "Konfiguration - Einstellungen".

Schritt 3: Alten Ordner "`ROOT`" löschen

In dem unter Punkt 1 genannten Verzeichnis (webapps) sollte sich bereits ein Verzeichnis mit Namen "ROOT" befinden. Wenn dieses Verzeichnis nicht vorhanden ist, können Sie diesen Schritt überspringen. Wenn das Verzeichnis vorhanden ist:

Falls Tomcat gestartet ist, stoppen Sie Tomcat nun.

Wenn im Tomcat-Unterverzeichnis webapps ein Verzeichnis ROOT (Verzeichnis, nicht die Datei ROOT.war!) existiert, dann löschen Sie das Verzeichnis ROOT.

Zur Erläuterung: wenn Tomcat gestartet wird, prüft Tomcat, ob in dem webapps-Verzeichnis WAR-Dateien liegen. Falls ja, werden die in der WAR-Datei beinhalteten Dateien ausgepackt und in ein Verzeichnis mit gleichem Namen wie die WAR-Datei abgelegt. Wenn aber bereits ein Verzeichnis mit gleichem Namen existiert (wie bei ROOT.war und Verzeichnis ROOT der Fall), dann wird die WAR-Datei nicht extrahiert und stattdessen das bestehende Verzeichnis beibehalten. Das bedeutet, dass ROOT.war ignoriert werden würde. Deswegen muss das Verzeichnis "ROOT" gelöscht werden.

Weiter