Setup:Installation Guide/System Preparation/Windows/Apache Tomcat

Apache Tomcat is required for the PDF export, VisualDiff (BlueSpice pro only) and the LaTeX renderer (BlueSpice pro only). The following steps are optional and only required if you want to use one or more of these services in your BlueSpice installation.

Operation of Apache Tomcat requires OpenJDK. If you have not installed it, follow the link above.

Download

Open the official download page (1) in your browser and go to the version 9 10 (2) download page.

Download the "32-bit/64-bit Windows Service Installer"

Please note that the download on your Windows server with Internet Explorer only works if you have configured the Internet Explorer Advanced Security Settings in the Server Manager. Please refer to the technical documentation from Microsoft.

This guide uses version 910.0.16 12 of Apache Tomcat and is just an example of the latest version that you can download at the time of installation.

Installing Apache Tomcat

Open the downloaded file "apache-tomcat-910.0.1612.exe".

Start the installation by clicking "Next >":

Confirm the license agreement by clicking "I Agree":

Click "Next >":

Click "Next >" again:

Wählen Select (1) Sie das Home-Verzeichnis Ihrer OpenJDK-the home directory of your OpenJDK Installation (2) aus und klicken auf "Next >and click "Next>" (3):

Starten Sie jetzt die Installation von Tomcat:

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

Start the Tomcat Installation:

At the end of the installation, leave both preselected checkboxes (1) and finish the setup (2)

Konfiguration von Configuring Apache Tomcat

Wechseln Sie in das Installationsverzeichnis von Tomcat. Standardmäßig finden Sie dies unter Change to the installation directory of Tomcat. By default, you can find it at C:\Program Files\Apache Software Foundation\Tomcat 9.0\conf.

Öffnen Sie hier die Datei Open the context.xml in einem Texteditor und ersetzen Sie die einmal vorkommende Zeile file in a text editor and replace the one-time line

<Context>

durch with

<Context mapperContextRootRedirectEnabled="true">

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 Save and close the file.

In the same directory, open the file server.xml in a text editor and make sure that the complete block

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

wie folgt lautetlooks like this:

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

Speichern und schließen Sie die Datei.

Suchen Sie im Startmenü den Eintrag Save and close the file.

Find the entry "Configure Tomcat" und öffnen diesenin the start menu and open it:

Stellen Sie den Set "Startup type" auf to "Automatic" (1) und starten and start Tomcat (2). Anschließend Beenden Sie die Konfigurations-Konsole Then exit the configuration console (3):

Überprüfen der Installation

Reviewing the installation

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

Installation der Webapps

in a browser on the server.
You should now see the homepage of the Tomcat server:

Installing the web apps

Nach erfolgreicher Installation von BlueSpice befolgen Sie bitte folgende weitere Schritte zur Installation der Webservices und Aktivierung der jeweiligen BlueSpice-Erweiterung

Please unzip the installed BlueSpice folder and move the subfolder to C:\bluespice\var\www. Rename the folder to "w".

After the successful installation of BlueSpice, please follow the next steps to install the web services and activate the respective BlueSpice extension:

• PDF-Export
• VisualDiff (nur BlueSpice pro only)
• LatexRenderer (nur BlueSpice nurBlueSpice pro only)

Nächster SchrittNext step

Haben Sie alle Schritte erfolgreich abgeschlossen können Sie die zuvor heruntergeladene Datei If you have completed all steps successfully, you can delete the previously downloaded "apache-tomcat-910.0.1611.exe" von Ihrer Festplatte löschen und zum nächsten Schritt file from your hard drive and continue to the next step " Elasticsearch" weiter gehen.