Install Apache Tomcat Connector

If you have not used Apache Tomcat so far, the easiest method to install Apache Tomcat Connector will be to copy the files provided in ApacheConnector_Tomcat90.zip from the WebOffice10.9-DVD. If this is the case please continue with the Fresh Install. Otherwise, if Apache Tomcat has been used before and the files uriworkermap.properties, web.xml, context.xml, server.xml or workers.properties.minimal have been customized continue with Manual Install.

 

icon_comment

Backup your Tomcat installation folder before installing the Apache Tomcat Connector!

In order to finish the Apache Tomcat Connector configuration it is necessary to update the file uriworkermap.properties after installing the WebOffice application. It will be described during the WebOffice installation process in chapter Update Apache Tomcat Connector Configuration (Optional).

The currently recommended version in combination with Apache Tomcat 9.0.54 is Apache Tomcat Connectors (v1.2.48 - 64bit) for Microsoft IIS.

The IIS_IUSR user must be given write permission to the configured directory in which Apache Tomcat Connector is to log. Normally, it is configured to write the log file isapi_redirect.YYYY-MM-DD.log to the directory C:\Tomcat\logs.

Fresh Install (Apache Tomcat has not been used before or none of the files to be copied have been customized)

Extract the zipped file ApacheConnector_Tomcat90.zip from the WebOffice10.9-DVD:

WebOffice10.9-DVD\Software\Miscellaneous\Apache Tomcat Connectors\ApacheConnector_Tomcat90.zip

 

Clean the Windows Registry if any previous version of Apache Tomcat Connector is installed.

Precondition: Java Development Kit 11 (64bit) - upgrade Java to this version if any previous version is installed.

Precondition: Apache Tomcat 9.0.54 on C:\Tomcat - upgrade Tomcat to this version if any previous version is installed.

If any newer version of Java or Tomcat is used, please contact your corresponding WebOffice Support Team to check if this version is already supported.

 

icon_comment

The following steps can be partially automated with the following script:

WebOffice10.9-DVD\Software\Miscellaneous\Automatization\Automate_Install_ApacheTomcatConnectors.bat

This script must be copied to the folder of the extracted ApacheConnector_Tomcat90.zip file and run as an administrator.

 

The further steps (for installation without using script) are:

1.Copy file rewrite.properties to C:\Tomcat\conf.

2.Copy file server.xml to C:\Tomcat\conf.

3.Copy file uriworkermap.properties to C:\Tomcat\conf.

4.Copy file workers.properties.minimal to C:\Tomcat\conf.

5.Copy file context.xml to C:\Tomcat\conf.

6.Create the directory C:\Tomcat_Connector.

7.Copy file isapi_redirect.dll to C:\Tomcat_Connector.

8.Copy file isapi_redirect.properties to C:\Tomcat_Connector.

9.Adjust the parameter in isapi_redirect.properties to your file paths.

10.Adjust the file uriworkermap.properties as described in chapter Update Apache Tomcat Connector Configuration (Optional).
 

Adjusting parameters in 'isapi_redirect.properties'

Adjusting parameters in 'isapi_redirect.properties'

11.Continue with the following steps in Windows IIS (Internet Information Services) 7.5, 8.0, 8.5 or 10:

12.Create virtual directory Jakarta and set the file path to C:\Tomcat_Connector
 

Add a virtual directory 'Jakarta' in the IIS Manager

Add a virtual directory 'Jakarta' in the IIS Manager

13.In IIS Manager, on the left panel of the window, navigate to Default Web Site and click it, then double-click Authentication and click Anonymous Authentication. Verify that it is Enabled.
 

Open Authentication of Default Web Site in IIS Manager

Open Authentication of Default Web Site in IIS Manager

 

Status for "Anonymous Authentication" has to be activated

Status for "Anonymous Authentication" has to be activated

14.Navigate back to Default Web Site, expand it and select Jakarta. Double-click Authentication from the middle panel. Click Anonymous Authentication. Verify that it is Enabled.

15.Click Jakarta again. Double-click Handler Mappings. If ISAPI.dll is disabled, select Edit Feature permissions from the right-hand side and enable Execute.
 

Open Handler Mappings of jakarta virtual directory in IIS Manager

Open Handler Mappings of jakarta virtual directory in IIS Manager

 

Activate 'ISAPI.dll'

Activate 'ISAPI.dll'

16.Add Jakarta as an ISAPI filter in the Default Web Site. Go to Default Web Site, double-click ISAPI-Filter and click Add....
 

Go to Default Web Site and open ISAPI Filters in IIS Manager

Go to Default Web Site and open ISAPI Filters in IIS Manager

 

Add 'Jakarta' as an ISAPI filter

Add 'Jakarta' as an ISAPI filter

17.Add Jakarta as an ISAPI/CGI exception on the WebServer. Click in the left field on your WebServer, then on ISAPI and CGI Restrictions and here on Add.... Check the box Allow extension path to execute.
 

Navigate to the webserver and open ISAPI and CGI Restrictions in IIS Manager

Navigate to the webserver and open ISAPI and CGI Restrictions in IIS Manager

 

Add 'Jakarta' as ISAPI/CGI restriction

Add 'Jakarta' as ISAPI/CGI restriction

18.Make sure that read access rights for certain users are set to the following folders:

oInstallation path of Java (e.g. C:\Program Files\Java\<Java-JDK>) for users:

IUSR,

Authenticated users,

network service

oInstallation path of Tomcat_Connector, where the file isapi_redirect.dll is located (e.g. C:\Tomcat_Connector) for users:

IUSR,

Authenticated users,

network service

oFolder conf in the Apache Tomcat installation path (e.g. C:\Tomcat\conf) for user:

IIS_IUSRS (local user)
 

Add 'IUSR', 'Authentificated User' and 'Network Service'

Add 'IUSR', 'Authentificated User' and 'Network Service'

Manual Install (Apache Tomcat was used before and the files "uriworkermap.properties", "context.xml", "server.xml" or "workers.properties.minimal" have been customized)

1.Open the file context.xml with an XML editor and change the file according to the screenshot below.
 

Changes in context.xml; on the right side the default file, on the left side with required changes

Changes in context.xml; on the right side the default file, on the left side with required changes

2.Open the file server.xml with an XML editor and change the file according to the screenshot below.
 

Changes in server.xml; on the right side the default file, on the left side with required changes

Changes in server.xml; on the right side the default file, on the left side with required changes

3.Continue with step 10 of Fresh Install.