Keine Kategorien vergeben

Apache Tomcat


Vorwort

Dieses Dokument beschreibt die Installation von Apache Tomcat, der für die Dienste PDF-Export, VisualDiff (nur BlueSpice pro) sowie Math (nur BlueSpice pro) benötigt wird.

Download

Öffnen Sie in Ihrem Browser die offizielle Download-Seite (1) und wechseln auf die Download-Seite der Version 9 Version (2).

Tomcat Download 01

Downloaden Sie den "32-bit/64-bit Windows Service Installer"

Tomcat Download 02


Beachten Sie bitte, dass der Download auf Ihrem Windows Server mit Internet Explorer nur dann funktioniert, wenn Sie die Erweiterten Sicherheitseinstellungen für Internet Explorer im Servermanager entsprechend konfiguriert haben. Beachten Sie hierzu die technische Dokumentation von Microsoft.


Im Folgenden wird die Version 9.0.16 von Apache Tomcat verwendet und dient nur beispielhaft für die jeweils aktuellste Version, die Sie zum Zeitpunkt Ihrer Installation herunterladen können.


Installation von Apache Tomcat

Öffnen Sie die soeben heruntergeladene Datei "apache-tomcat-9.0.16.exe".

Starten Sie die Installation durch Klick auf "Next >":

Tomcat Installation 01

Stimmen Sie dem Lizenzvertrag durch Klick auf "I Agree" zu:

Tomcat Installation 02

Den nächsten Schritt bestätigen Sie durch Klick auf "Next >":

Tomcat Installation 03

Auch den nächsten Schritt bestätigen Sie durch Klick auf "Next >":

Tomcat Installation 04

Wählen (1) Sie das Home-Verzeichnis Ihrer OpenJDK-Installation (2) aus und klicken auf "Next >" (3):

Tomcat Installation 05

Starten Sie jetzt die Installation von Tomcat:

Tomcat Installation 06

Am Ende der Installation wählen Sie beide vorselektierten Haken ab (1) und beenden das Setup (2)

Tomcat Installation 07

Konfiguration von Apache Tomcat

Wechseln Sie in das Installationsverzeichnis von Tomcat. Standardmäßig finden Sie dies unter C:\Program Files\Apache Software Foundation\Tomcat 9.0\conf.

Öffnen Sie hier die Datei context.xml in einem Texteditor und ersetzen Sie die einmal vorkommende Zeile

<Context>

durch

<Context mapperContextRootRedirectEnabled="true">
Tomcat Konfiguration 01

Speichern und schließen Sie die Datei.

Öffnen Sie im selben Verzeichnis die Datei server.xml in einem Texteditor und stellen 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" />
Tomcat Konfiguration 02

Speichern und schließen Sie die Datei.

Suchen Sie im Startmenü den Eintrag "Configure Tomcat" und öffnen diesen:

Tomcat Konfiguration 03

Stellen Sie den "Startup type" auf "Automatic" (1) und starten Tomcat (2). Anschließend Beenden Sie die Konfigurations-Konsole (3):

Tomcat Konfiguration 04

Überprüfen der Installation

Zur Überprüfung, ob Tomcat korrekt läuft öffnen Sie in einem Browser auf dem Server die Adresse http://localhost:8080/.
Sie sollten nun die Startseite des Tomcat-Servers angezeigt bekommen:

Tomcat Check 01

Installation der Webapps

Zur Installation der entsprechenden Webapps im Tomcat-Service kopieren oder verschieben Sie bitte aus Ihrem BlueSpice-Paket folgende Dateien in das WebApps-Verzeichnis des Tomcat-Server. Standardmäßig finden Sie dies unter C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps:

  • extensions\BlueSpiceUEModulePDF\webservices\BShtml2PDF.war
  • extensions\BlueSpiceVisualDiff\webservices\BShtmlDiff.war (nur BlueSpice pro)
  • extensions\BlueSpiceLatexRenderer\webservices\BSLaTeX2PNG.war (nur BlueSpice pro)

Sie müssen hierzu Tomcat nicht neu starten. Er sollte nach kurzer Zeit die entsprechende Webapp in einen identisch benannten Ordner entpacken:

Tomcat Check 02

Die korrekte Funktionalität der Webapps können Sie dann im Browser direkt überprüfen:

  • http://localhost:8080/BShtml2PDF
    Tomcat Check 03
  • http://localhost:8080/BShtmlDiff (nur BlueSpice pro)
    Tomcat Check 03
  • http://localhost:8080/BSLaTeX2PNG (nur BlueSpice pro)
    Tomcat Check 03

Nächster Schritt

Haben Sie alle Schritte erfolgreich abgeschlossen können Sie die zuvor heruntergeladene Datei "apache-tomcat-9.0.16.exe" von Ihrer Festplatte löschen und zum nächsten Schritt "Elasticsearch" weiter gehen.

Anhänge

Diskussionen