Apache Tomcat

This document describes the configuration of the Apache Tomcat server, which is needed for the Webservices of BlueSpice.

Installation

Linux

Installieren Sie die neueste verfügbare Version des Apache Tomcat Servers aus dem Paketmanager ihrer Distribution. Der Paketmanager löst alle Abhängigkeiten auf und installiert die nötigen Pakete.

Windows

Java

Apache Tomcat benötigt die Java Runtime Environment. Sofern diese auf Ihrem System noch nicht installiert ist, downloaden (www.java.com) und installieren Sie diese. Wir empfehlen bei aktuellen Systemen die 64-Bit-Version.

Tomcat

Downloaden Sie den "32-bit/64-bit Windows Service Installer" von der Webseite des Tomcat-Projekts. Während des Installationsvorgangs sind keine Modifikationen nötig. Bestätigen Sie die einzelnen Installationsschritte mit "Weiter".

center|150x117px	center|150x117px	center|150x117px	center|150x117px
center|150x117px	center|150x117px	center|150x117px	center|150x117px

Überprüfung der Installation

Ob der Apache Tomcat Server korrekt installiert und gestartet wurde kontrollieren Sie durch Aufruf von http://<hostname-oder-ip-des-servers>:8080. Bei korrekter Installation sollten Sie nun die Default-Seite des Servers angezeigt bekommen.

Konfiguration

Nun müssen zwei Konfigurationsdateien des Tomcat-Servers angepasst werden:

• context.xml
• server.xml

Diese finden sich per default

• unter Windows: C:\Program Files\Apache Software Foundation\Tomcat 8.5\conf
• unter Linux: /etc/tomcatX (wobei "X" für die jeweilige Tomcat-Version steht)

context.xml

Ersetzen Sie die einmal vorkommende Zeile

<context>

durch

<Context mapperContextRootRedirectEnabled="true">

server.xml

Stellen Sie sicher, dass der komplette Block

<Connector port="8080" protocol="HTTP/1.1"
	... />

wie folgt lautet:

<Connector port="8080" protocol="HTTP/1.1"
	connectionTimeout="20000"
	URIEncoding="UTF-8"
	redirectPort="8443"
	address="127.0.0.1" />

Neustart Tomcat

Starten Sie den Tomcat-Server neu:

• Linux: service tomcatX restart (wobei "X" für die jeweilige Tomcat-Version steht)
• Windows: Siehe Neustart_von_Tomcat

Besonderheiten unter Windows

Configure Tomcat

Sämtliche im folgenden anfallenden Einstellungen müssen in der Konfigurationsoberfläche von Tomcat erfolgen. Dies finden Sie im Startmenü unter dem Punkt "Configure Tomcat".

Neustart von Tomcat

Den Neustart führen Sie in der ersten Registerkarte der Konfigurationsoberfläche durch. Stoppen und starten Sie anschließend den Dienst neu.

center|200x192px

Autostart einrichten

Tomcat wird nicht automatisch mit Windows gestartet. Dies konfigurieren Sie in der selben Registerkarte, in der Sie auch den Dienst neu starten können. Stellen Sie hierzu bei "Startup type" auf "Automatic" um und speichern Sie Ihre Einstellung mit einem Klick auf "Übernehmen".

Besondere Vorsicht: Java Update

Tomcat benötigt Java. Der Pfad hierzu ist fest in Tomcat hinterlegt. Java ändert jedoch mit jedem Update seinen Installationspfad. Diese muss anschließend in Tomcat eingestellt werden, um die Funktionalität des Tomcat gewährleisten zu können.

Wechseln Sie hierzu in die Registerkarte "Java" und passen den Pfad zur jvm.dll unter "Java Virtual Machine" an - i.d.R. ist das dann C:\Program Files\Java\<Pfad-zur-aktuellen-Java-Installation>\bin\server\jvm.dll.

center|200x192px