Apache Tomcat

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

Installation

Linux

Install the latest version of the Apache Tomcat server in the package manager of your distribution. The package manager dissolves all dependencies and installs the required packages.  

Windows

Java

Apache Tomcat requires the Java Runtime Environment. If these is not already installed at your system, download (www.java.com) and install it. We recommend the 64 bit version for latest systems. 

Tomcat

Download the "32-bit/64-bit Windows Service Installer" from the Tomcat project website.  No modifications are necessary during the installation process. Confirm the single steps with "Next".

center	center	center	center
center	center	center	center

Ü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

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