Apache Tomcat

Dieses Dokument beschreibt die Einrichtung des Apache Tomcat Servers, den Sie für die Webservices von BlueSpice benötigen.

==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".

|-| style="width: 25%;"|center| style="width: 25%;"|center| style="width: 25%;"|center| style="width: 25%;"|center|-| style="width: 25%;"|center| style="width: 25%;"|center| style="width: 25%;"|center| style="width: 25%;"|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