Difference between revisions of "Setup:Installation Guide/System Preparation/Windows/Apache Tomcat"

Tag: 2017 source edit
 
(3 intermediate revisions by the same user not shown)
Line 2: Line 2:
 
__TOC__
 
__TOC__
  
{{Hint|file=icon_optional.png|text=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.}}
+
{{Hint|file=icon_optional.png|text=Apache Tomcat is required for the PDF export. The following steps are optional and only required if you want to use this service in your BlueSpice installation.}}
{{Hint|file=icon_hint.png|text=Operation of Apache Tomcat requires [[Setup:Installation Guide/System Preparation/Windows/OpenJDK| OpenJDK]]. If you have not installed it, follow the link above.}}
+
{{Hint|file=hint.png|text=Operation of Apache Tomcat requires [[Setup:Installation Guide/System Preparation/Windows/OpenJDK| OpenJDK]]. If you have not installed it, follow the link above.}}
 
==Download==
 
==Download==
 
Open the [http://tomcat.apache.org/ official download page] (1) in your browser and go to the version 10 (2) download page.
 
Open the [http://tomcat.apache.org/ official download page] (1) in your browser and go to the version 10 (2) download page.
[[File:Setup:tc1.png|center|400x400px|Tomcat Download 01]]
+
[[File:Setup:Tomcat Download 01.png|center|400x400px|Tomcat Download 01|link=Special:FilePath/Setup:tc1.png]]
 
Download the "32-bit/64-bit Windows Service Installer"
 
Download the "32-bit/64-bit Windows Service Installer"
[[File:Setup:tc2.png|center|400x400px|Tomcat Download 02]]
+
[[File:Setup:Tomcat Download 02.png|center|400x400px|Tomcat Download 02|link=Special:FilePath/Setup:tc2.png]]
  
  
 
{{Hint|file=icon_required.png|text=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.}}
 
{{Hint|file=icon_required.png|text=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.}}
  
{{Hint|file=icon_hint.png|text=This guide uses version 10.0.12 of Apache Tomcat and is just an example of the latest version that you can download at the time of installation.}}
+
{{Hint|file=hint.png|text=This guide uses version 9.0.16 of Apache Tomcat and is just an example of the latest version that you can download at the time of installation.}}
 
==Installing Apache Tomcat==
 
==Installing Apache Tomcat==
 
Open the downloaded file "apache-tomcat-10.0.12.exe".
 
Open the downloaded file "apache-tomcat-10.0.12.exe".
  
 
Start the installation by clicking "Next >":
 
Start the installation by clicking "Next >":
[[File:Setup:tm v3.png|center|400x400px|Tomcat Installation 01]]
+
[[File:Setup:Tomcat_Install_01.png|center|400x400px|Tomcat Installation 01|link=Special:FilePath/Setup:tm_v3.png]]
 
Confirm the license agreement by clicking "I Agree":
 
Confirm the license agreement by clicking "I Agree":
  
[[File:Setup:Tomcat_Install_02.png|center|400px|Tomcat Installation 02]]
+
[[File:Setup:Tomcat_Install_02.png|center|400px|Tomcat Installation 02|link=Special:FilePath/Setup:Tomcat_Install_02.png]]
  
 
Click "Next >":
 
Click "Next >":
  
[[File:Setup:Tomcat_Install_03.png|center|400px|Tomcat Installation 03]]
+
[[File:Setup:Tomcat_Install_03.png|center|400px|Tomcat Installation 03|link=Special:FilePath/Setup:Tomcat_Install_03.png]]
  
 
Click  "Next >" again:
 
Click  "Next >" again:
[[File:Setup:tm v4.png|center|400x400px|Tomcat Installation 04]]
+
[[File:Setup:Tomcat Install 04.png|center|400x400px|Tomcat Installation 04|link=Special:FilePath/Setup:tm_v4.png]]
 
Select (1) the home directory of your [[Setup:Installation Guide/System Preparation/Windows/OpenJDK | OpenJDK Installation]] (2) and click "Next>" (3):
 
Select (1) the home directory of your [[Setup:Installation Guide/System Preparation/Windows/OpenJDK | OpenJDK Installation]] (2) and click "Next>" (3):
[[File:Setup:tm3.png|center|400x400px|Tomcat Installation 05]]
+
[[File:Setup:Tomcat Install 03.png|center|400x400px|Tomcat Installation 05|link=Special:FilePath/Setup:tm3.png]]
 
Start the Tomcat Installation:
 
Start the Tomcat Installation:
[[File:Setup:tm4.png|center|400x400px|Tomcat Installation 06]]
+
[[File:Setup:Tomcat Install 06.png|center|400x400px|Tomcat Installation 06|link=Special:FilePath/Setup:tm4.png]]
 
At the end of the installation, leave both preselected checkboxes (1) and finish the setup (2)
 
At the end of the installation, leave both preselected checkboxes (1) and finish the setup (2)
[[File:Setup:tm v7.png|center|400x400px|Tomcat Installation 07]]
+
[[File:Setup:Tomcat Install 07.png|center|400x400px|Tomcat Installation 07|link=Special:FilePath/Setup:tm_v7.png]]
  
 
==Configuring Apache Tomcat==
 
==Configuring Apache Tomcat==
Line 44: Line 44:
 
<pre>&lt;Context mapperContextRootRedirectEnabled="true"&gt;</pre>
 
<pre>&lt;Context mapperContextRootRedirectEnabled="true"&gt;</pre>
  
[[File:Setup:Tomcat_Configuration_01.png|center|400px|Tomcat Configuration 01]]
+
[[File:Setup:Tomcat_Configuration_01.png|center|400px|Tomcat Configuration 01|link=Special:FilePath/Setup:Tomcat_Configuration_01.png]]
  
 
Save and close the file.
 
Save and close the file.
Line 58: Line 58:
 
address="127.0.0.1" /&gt;</pre>
 
address="127.0.0.1" /&gt;</pre>
  
[[File:Setup:Tomcat_Configuration_02.png|center|400px|Tomcat Configuration 02]]
+
[[File:Setup:Tomcat_Configuration_02.png|center|400px|Tomcat Configuration 02|link=Special:FilePath/Setup:Tomcat_Configuration_02.png]]
  
 
Save and close the file.
 
Save and close the file.
Line 64: Line 64:
 
Find the entry "Configure Tomcat" in the start menu and open it:
 
Find the entry "Configure Tomcat" in the start menu and open it:
  
[[File:Setup:Tomcat_Configuration_03.png|center|400px|Tomcat Configuration 03]]
+
[[File:Setup:Tomcat_Configuration_03.png|center|400px|Tomcat Configuration 03|link=Special:FilePath/Setup:Tomcat_Configuration_03.png]]
  
 
Set "Startup type" to "Automatic" (1) and start Tomcat (2). Then exit the configuration console (3):
 
Set "Startup type" to "Automatic" (1) and start Tomcat (2). Then exit the configuration console (3):
[[File:Setup:tm5.png|center|479x479px|Tomcat Configuration 04]]
+
[[File:Setup:Tomcat_Configuration_04.png|center|479x479px|Tomcat Configuration 04|link=Special:FilePath/Setup:tm5.png]]
  
 
==Reviewing the installation==
 
==Reviewing the installation==
Line 74: Line 74:
  
  
[[File:Setup:tm6.png|center|400x400px|Tomcat Check 01]]
+
[[File:Setup:Tomcat_Check 01.png|center|400x400px|Tomcat Check 01|link=Special:FilePath/Setup:tm6.png]]
  
==Installing the web apps==
+
==Installing the web apps ==
 
{{Hint|text=Please unzip the installed BlueSpice folder and move the subfolder to C:\bluespice\var\www. Rename the folder to  "w".}}
 
{{Hint|text=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:
 
After the successful installation of BlueSpice, please follow the next steps to install the web services and activate the respective BlueSpice extension:
  
 
*[[Setup:Installation Guide/Webservices/PDF-Export|PDF-Export]]
 
*[[Setup:Installation Guide/Webservices/PDF-Export|PDF-Export]]
*[[Setup:Installation Guide/Webservices/VisualDiff|VisualDiff]] (BlueSpice pro only)
 
*[[Setup:Installation Guide/Webservices/LatexRenderer|LatexRenderer]] (BlueSpice pro only)
 
  
==Next step==
+
==Next step ==
 
If you have completed all steps successfully, you can delete the previously downloaded "apache-tomcat-10.0.11.exe" file from your hard drive and continue to the next step "[[Setup: Installation Guide/System Preparation/Windows/Elasticsearch | Elasticsearch]]".
 
If you have completed all steps successfully, you can delete the previously downloaded "apache-tomcat-10.0.11.exe" file from your hard drive and continue to the next step "[[Setup: Installation Guide/System Preparation/Windows/Elasticsearch | Elasticsearch]]".
  
 
[[en:{{FULLPAGENAME}}]]
 
[[en:{{FULLPAGENAME}}]]
 
[[de:Setup:Installationsanleitung/Systemvorbereitung/Windows/Apache_Tomcat]]
 
[[de:Setup:Installationsanleitung/Systemvorbereitung/Windows/Apache_Tomcat]]

Latest revision as of 09:57, 9 May 2022

icon optional.png
Apache Tomcat is required for the PDF export. The following steps are optional and only required if you want to use this service in your BlueSpice installation.
hint.png
Operation of Apache Tomcat requires OpenJDK. If you have not installed it, follow the link above.

Download[edit | edit source]

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

Tomcat Download 01

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

Tomcat Download 02


icon required.png
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.


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

Installing Apache Tomcat[edit | edit source]

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

Start the installation by clicking "Next >":

Tomcat Installation 01

Confirm the license agreement by clicking "I Agree":

Tomcat Installation 02

Click "Next >":

Tomcat Installation 03

Click "Next >" again:

Tomcat Installation 04

Select (1) the home directory of your OpenJDK Installation (2) and click "Next>" (3):

Tomcat Installation 05

Start the Tomcat Installation:

Tomcat Installation 06

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

Tomcat Installation 07

Configuring Apache Tomcat[edit | edit source]

Change to the installation directory of Tomcat. By default, you can find it at C:\Program Files\Apache Software Foundation\Tomcat 9.0\conf.

Open the context.xml file in a text editor and replace the one-time line

<Context>

with

<Context mapperContextRootRedirectEnabled="true">
Tomcat Configuration 01

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

looks like this:

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

Save and close the file.

Find the entry "Configure Tomcat" in the start menu and open it:

Tomcat Configuration 03

Set "Startup type" to "Automatic" (1) and start Tomcat (2). Then exit the configuration console (3):

Tomcat Configuration 04

Reviewing the installation[edit | edit source]

To check if Tomcat is working correctly, open the address http://localhost:8080/ in a browser on the server.
You should now see the homepage of the Tomcat server:


Tomcat Check 01

Installing the web apps[edit | edit source]

[[File:{{{file}}}|center]] 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:

Next step[edit | edit source]

If you have completed all steps successfully, you can delete the previously downloaded "apache-tomcat-10.0.11.exe" file from your hard drive and continue to the next step " Elasticsearch".

No categories assignedEdit

Discussions