From dev-return-189497-archive-asf-public=cust-asf.ponee.io@tomcat.apache.org Wed Mar 7 16:57:10 2018 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by mx-eu-01.ponee.io (Postfix) with SMTP id 9D8DB180656 for ; Wed, 7 Mar 2018 16:57:08 +0100 (CET) Received: (qmail 96019 invoked by uid 500); 7 Mar 2018 15:56:57 -0000 Mailing-List: contact dev-help@tomcat.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: "Tomcat Developers List" Delivered-To: mailing list dev@tomcat.apache.org Received: (qmail 95979 invoked by uid 99); 7 Mar 2018 15:56:57 -0000 Received: from Unknown (HELO svn01-us-west.apache.org) (209.188.14.144) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 07 Mar 2018 15:56:57 +0000 Received: from svn01-us-west.apache.org (localhost [127.0.0.1]) by svn01-us-west.apache.org (ASF Mail Server at svn01-us-west.apache.org) with ESMTP id 1D5C33A0A00 for ; Wed, 7 Mar 2018 15:56:56 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1826124 [6/7] - in /tomcat/site/trunk/docs/connectors-doc: ./ ajp/ ajp/printer/ common_howto/ common_howto/printer/ miscellaneous/ miscellaneous/printer/ news/ news/printer/ printer/ reference/ reference/printer/ webserver_howto/ webserver... Date: Wed, 07 Mar 2018 15:56:55 -0000 To: dev@tomcat.apache.org From: markt@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20180307155656.1D5C33A0A00@svn01-us-west.apache.org> Modified: tomcat/site/trunk/docs/connectors-doc/reference/printer/status.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/reference/printer/status.html?rev=1826124&r1=1826123&r2=1826124&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/reference/printer/status.html (original) +++ tomcat/site/trunk/docs/connectors-doc/reference/printer/status.html Wed Mar 7 15:56:54 2018 @@ -1,4 +1,4 @@ -The Apache Tomcat Connectors - Reference Guide - Status Worker Reference
Apache Tomcat :: Apache Software Foundation

The Apache Tomcat Connectors - Reference Guide

Status Worker Reference
Introduction
+The Apache Tomcat Connectors - Reference Guide - Status Worker Reference
Apache Tomcat :: Apache Software Foundation

The Apache Tomcat Connectors - Reference Guide

Status Worker Reference
Introduction

Tomcat Connectors has a special type of worker, the so-called status worker. @@ -545,5 +545,5 @@ in parameters named "val0", "val1", ....

- Copyright © 1999-2016, Apache Software Foundation + Copyright © 1999-2018, Apache Software Foundation
\ No newline at end of file Modified: tomcat/site/trunk/docs/connectors-doc/reference/printer/uriworkermap.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/reference/printer/uriworkermap.html?rev=1826124&r1=1826123&r2=1826124&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/reference/printer/uriworkermap.html (original) +++ tomcat/site/trunk/docs/connectors-doc/reference/printer/uriworkermap.html Wed Mar 7 15:56:54 2018 @@ -1,4 +1,4 @@ -The Apache Tomcat Connectors - Reference Guide - uriworkermap.properties configuration
Apache Tomcat :: Apache Software Foundation

The Apache Tomcat Connectors - Reference Guide

uriworkermap.properties configuration
Introduction
+The Apache Tomcat Connectors - Reference Guide - uriworkermap.properties configuration
Apache Tomcat :: Apache Software Foundation

The Apache Tomcat Connectors - Reference Guide

uriworkermap.properties configuration
Introduction

The forwarding of requests from the web server to tomcat gets configured by defining mapping rules. @@ -427,5 +427,5 @@ and the source of the rule definition: '

- Copyright © 1999-2016, Apache Software Foundation + Copyright © 1999-2018, Apache Software Foundation
\ No newline at end of file Modified: tomcat/site/trunk/docs/connectors-doc/reference/printer/workers.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/reference/printer/workers.html?rev=1826124&r1=1826123&r2=1826124&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/reference/printer/workers.html (original) +++ tomcat/site/trunk/docs/connectors-doc/reference/printer/workers.html Wed Mar 7 15:56:54 2018 @@ -1,4 +1,4 @@ -The Apache Tomcat Connectors - Reference Guide - workers.properties configuration
Apache Tomcat :: Apache Software Foundation

The Apache Tomcat Connectors - Reference Guide

workers.properties configuration
Introduction
+The Apache Tomcat Connectors - Reference Guide - workers.properties configuration
Apache Tomcat :: Apache Software Foundation

The Apache Tomcat Connectors - Reference Guide

workers.properties configuration
Introduction

A Tomcat worker is a Tomcat instance that is waiting to execute servlets or any other content @@ -1092,5 +1092,5 @@ This feature has been added in jk 1.2

- Copyright © 1999-2016, Apache Software Foundation + Copyright © 1999-2018, Apache Software Foundation
\ No newline at end of file Modified: tomcat/site/trunk/docs/connectors-doc/reference/status.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/reference/status.html?rev=1826124&r1=1826123&r2=1826124&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/reference/status.html (original) +++ tomcat/site/trunk/docs/connectors-doc/reference/status.html Wed Mar 7 15:56:54 2018 @@ -1,4 +1,4 @@ -The Apache Tomcat Connectors - Reference Guide - Status Worker Reference
Apache Tomcat :: Apache Software Foundation

Links

Common HowTo

Web Server HowTo

Reference Guide

AJP Protocol Reference

Miscellaneous Documentation

News

The Apache Tomcat Connectors - Reference Guide

Status Worker Reference

Printer Friendly Version
print-friendly
version +The Apache Tomcat Connectors - Reference Guide - Status Worker Reference
Apache Tomcat :: Apache Software Foundation

Links

Common HowTo

Web Server HowTo

Reference Guide

AJP Protocol Reference

Miscellaneous Documentation

News

The Apache Tomcat Connectors - Reference Guide

Status Worker Reference

Printer Friendly Version
print-friendly
version
Introduction

@@ -546,5 +546,5 @@ in parameters named "val0", "val1", ....

- Copyright © 1999-2016, Apache Software Foundation + Copyright © 1999-2018, Apache Software Foundation
\ No newline at end of file Modified: tomcat/site/trunk/docs/connectors-doc/reference/uriworkermap.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/reference/uriworkermap.html?rev=1826124&r1=1826123&r2=1826124&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/reference/uriworkermap.html (original) +++ tomcat/site/trunk/docs/connectors-doc/reference/uriworkermap.html Wed Mar 7 15:56:54 2018 @@ -1,4 +1,4 @@ -The Apache Tomcat Connectors - Reference Guide - uriworkermap.properties configuration
Apache Tomcat :: Apache Software Foundation

Links

Common HowTo

Web Server HowTo

Reference Guide

AJP Protocol Reference

Miscellaneous Documentation

News

The Apache Tomcat Connectors - Reference Guide

uriworkermap.properties configuration

Printer Friendly Version
print-friendly
version +The Apache Tomcat Connectors - Reference Guide - uriworkermap.properties configuration
Apache Tomcat :: Apache Software Foundation

Links

Common HowTo

Web Server HowTo

Reference Guide

AJP Protocol Reference

Miscellaneous Documentation

News

The Apache Tomcat Connectors - Reference Guide

uriworkermap.properties configuration

Printer Friendly Version
print-friendly
version
Introduction

@@ -428,5 +428,5 @@ and the source of the rule definition: '

- Copyright © 1999-2016, Apache Software Foundation + Copyright © 1999-2018, Apache Software Foundation
\ No newline at end of file Modified: tomcat/site/trunk/docs/connectors-doc/reference/workers.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/reference/workers.html?rev=1826124&r1=1826123&r2=1826124&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/reference/workers.html (original) +++ tomcat/site/trunk/docs/connectors-doc/reference/workers.html Wed Mar 7 15:56:54 2018 @@ -1,4 +1,4 @@ -The Apache Tomcat Connectors - Reference Guide - workers.properties configuration
Apache Tomcat :: Apache Software Foundation

Links

Common HowTo

Web Server HowTo

Reference Guide

AJP Protocol Reference

Miscellaneous Documentation

News

The Apache Tomcat Connectors - Reference Guide

workers.properties configuration

Printer Friendly Version
print-friendly
version +The Apache Tomcat Connectors - Reference Guide - workers.properties configuration
Apache Tomcat :: Apache Software Foundation

Links

Common HowTo

Web Server HowTo

Reference Guide

AJP Protocol Reference

Miscellaneous Documentation

News

The Apache Tomcat Connectors - Reference Guide

workers.properties configuration

Printer Friendly Version
print-friendly
version
Introduction

@@ -1093,5 +1093,5 @@ This feature has been added in jk 1.2

- Copyright © 1999-2016, Apache Software Foundation + Copyright © 1999-2018, Apache Software Foundation
\ No newline at end of file Modified: tomcat/site/trunk/docs/connectors-doc/webserver_howto/apache.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/webserver_howto/apache.html?rev=1826124&r1=1826123&r2=1826124&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/webserver_howto/apache.html (original) +++ tomcat/site/trunk/docs/connectors-doc/webserver_howto/apache.html Wed Mar 7 15:56:54 2018 @@ -1,4 +1,4 @@ -The Apache Tomcat Connectors - Web Server HowTo - Apache HTTP Server HowTo
Apache Tomcat :: Apache Software Foundation

Links

Common HowTo

Web Server HowTo

Reference Guide

AJP Protocol Reference

Miscellaneous Documentation

News

The Apache Tomcat Connectors - Web Server HowTo

Apache HTTP Server HowTo

Printer Friendly Version
print-friendly
version +The Apache Tomcat Connectors - Web Server HowTo - Apache HTTP Server HowTo
Apache Tomcat :: Apache Software Foundation

Links

Common HowTo

Web Server HowTo

Reference Guide

AJP Protocol Reference

Miscellaneous Documentation

News

The Apache Tomcat Connectors - Web Server HowTo

Apache HTTP Server HowTo

Printer Friendly Version
print-friendly
version
Introduction

This document explains how to connect Tomcat to the popular open source web server, Apache HTTP Server. @@ -1180,5 +1180,5 @@ The --enable-shared=jk is also working a

- Copyright © 1999-2016, Apache Software Foundation + Copyright © 1999-2018, Apache Software Foundation
\ No newline at end of file Modified: tomcat/site/trunk/docs/connectors-doc/webserver_howto/iis.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/webserver_howto/iis.html?rev=1826124&r1=1826123&r2=1826124&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/webserver_howto/iis.html (original) +++ tomcat/site/trunk/docs/connectors-doc/webserver_howto/iis.html Wed Mar 7 15:56:54 2018 @@ -1,4 +1,4 @@ -The Apache Tomcat Connectors - Web Server HowTo - ISAPI redirector for Micrsoft IIS HowTo
Apache Tomcat :: Apache Software Foundation

Links

Common HowTo

Web Server HowTo

Reference Guide

AJP Protocol Reference

Miscellaneous Documentation

News

The Apache Tomcat Connectors - Web Server HowTo

ISAPI redirector for Micrsoft IIS HowTo

Printer Friendly Version
print-friendly
version +The Apache Tomcat Connectors - Web Server HowTo - ISAPI redirector for Micrsoft IIS HowTo
Apache Tomcat :: Apache Software Foundation

Links

Common HowTo

Web Server HowTo

Reference Guide

AJP Protocol Reference

Miscellaneous Documentation

News

The Apache Tomcat Connectors - Web Server HowTo

ISAPI redirector for Micrsoft IIS HowTo

Printer Friendly Version
print-friendly
version
Introduction

This document explains how to set up the ISAPI redirector for IIS to cooperate with Tomcat. @@ -47,60 +47,23 @@ A worker is defined to be a tomcat proce
Supported Configuration

-The IIS to Tomcat redirector works for: +The IIS to Tomcat redirector is supported for: +

    -
  • -WinNT4.0-i386 SP4/SP5/SP6a (should be able to work with other service packs), Win98, WinXP, Win2K, -and probably also Win2K3, Vista and Windows 7. -
    • -
  • -IIS4.0 and PWS4.0, IIS 5 to IIS 7. -
    • -
  • -Tomcat 3.2 to Tomcat 8. -
    • +
  • IIS running on Windows 7 or later
    • +
  • IIS running on Windows Server 2008 SP2 or later
    • +
  • Tomcat 7 or later
-

- -

-The mod_jk module uses the AJP protocol to send requests to the Tomcat containers. -The AJP version typically used is ajp13. -

-
- -
IIS 5 and 6 Notes
-

-There are extra steps you need to take for configuring Tomcat with IIS 5 and 6. Please see the appropriate links from -Tomcat Useful Links. -

-
- -
IIS 7 notes
-

-There is a known bug in IIS that may result in incomplete log messages. See bug 45769 -for further details. -

-
- -
64 Bit notes
-

-In a 64 Bit environment - at least for IIS 7 - the used IIS Application Pool -should have "Enable 32-bit Applications" set to "False". Otherwise the redirector will -not be called and returns an http code 404. If you think, the 32bit version of -isapi_redirect.dll would do the job instead, you will get an http code 500, -because the library is not loadable into a 64 Bit IIS. -

-
- -
Who supports AJP protocols?

-Tomcat supports ajp13 since Tomcat 3.2. -Others servlet engines such as Jetty or JBoss also support the ajp13 protocol +The redirector may work with IIS running on older versions of Windows but such +configurations are not supported.

-The ajp12 protocol has been deprecated and you should no longer use it. -The ajp14 protocol is considered experimental. +The mod_jk module uses the AJP protocol to send requests to the Tomcat +containers. The AJP version used is ajp13. All current versions Tomcat +support the ajp13 protocol. Others servlet engines such as Jetty and +JBoss also support the ajp13 protocol.

@@ -109,20 +72,21 @@ The ajp14 protocol is considered

  1. -The ISAPI redirector is a Microsoft IIS plugin (filter + extension). IIS loads the redirector plugin and calls its -filter function for each in-coming request. +The ISAPI redirector is a Microsoft IIS plugin (filter + extension). IIS loads +the redirector plugin and calls its filter function for each in-coming request.
  2. -The filter then tests the request URL against a list of URI-paths held inside uriworkermap.properties, -If the current request matches one of the entries in the list of URI-paths, -the filter transfers the request to the extension. +The filter then tests the request URL against a list of URI-paths held inside +uriworkermap.properties. If the current request matches one of the entries in +the list of URI-paths, the filter transfers the request to the extension.
  3. -The extension collects the request parameters and forwards them to the appropriate worker using the defined -protocol like ajp13. +The extension collects the request parameters and forwards them to the +appropriate worker using the defined protocol like ajp13.
  4. -The extension collects the response from the worker and returns it to the browser. +The extension collects the response from the worker and returns it to the +browser.

@@ -130,23 +94,29 @@ The extension collects the response from
Installation

-A pre-built version of the ISAPI redirector plugin, isapi_redirect.dll, is available under -the win32/i386 directory of the Tomcat Connectors distribution. +Pre-built versions of the ISAPI redirector plugin, isapi_redirect.dll, for +32-bit and 64-bit environments are available from the +Apache Tomcat +Connectors Downloads page. -You can also build a copy locally from the Tomcat Connectors source distribution. +You can also build a copy locally from the Tomcat Connectors source +distribution. The ISAPI redirector requires three entities:

  • -isapi_redirect.dll - The ISAPI redirector for Microsoft IIS plugin, either obtain a pre-built DLL or build it yourself (see the build section). +isapi_redirect.dll - The ISAPI redirector for Microsoft IIS plugin, +either obtain a pre-built DLL or build it yourself (see the build section).
  • -workers.properties - A file that describes the host(s) and port(s) used by the workers (Tomcat processes). +workers.properties - A file that +describes the host(s) and port(s) used by the workers (Tomcat processes). A sample workers.properties can be found under the conf directory.
  • -uriworkermap.properties - A file that maps URL-Path patterns to workers. +uriworkermap.properties - A +file that maps URL-Path patterns to workers. A sample uriworkermap.properties can be found under the conf directory as well.
@@ -157,7 +127,8 @@ The installation includes the following
  • -Configuring the ISAPI redirector with a default /examples context and checking that you can serve servlets with IIS. +Configuring the ISAPI redirector with a default /examples context and checking +that you can serve servlets with IIS.
  • Adding more contexts to the configuration. @@ -165,13 +136,135 @@ Adding more contexts to the configuratio

-
Configuring the ISAPI Redirector
+
Configuring the ISAPI Redirector
+ +

These instructions have been written based on Windows Server 2012 R2 and +tested with all supported Windows operating systems up to Windows 10 / Windows +Server 2016. +

+

-In this document I will assume that isapi_redirect.dll is placed in -c:\tomcat\bin\win32\i386\isapi_redirect.dll and -that the properties files which you created are in c:\tomcat\conf. +These installation instructions have been tested with a default installation of +IIS plus ISAPI Extensions and Filters on a clean, fully patched OS installation +with Tomcat 9 installed in C:\Program Files\Apache Software Foundation\Tomcat +9.0. This is referred to as ${tomcat_home} for the remainder of this +document.

+ +
    +
  1. +Create a directory ${tomcat_home}\isapi +
    2. +
  2. +Allow the IIS process to create the ISAPI redirector log file. Modify the path +as necessary if the log file is to be written to a different directory. Enter +the following at a command prompt: +
    +>icacls "C:\Program Files\Apache Software Foundation\Tomcat 9.0\isapi" /grant "IIS APPPOOL\DefaultAppPool":(OI)(CI)M
+
    +On client operating systems with User Account Control (UAC) enabled, the command +prompt must be opened using Run as administrator for the above command to +complete successfully. +
    3. +
  3. +Download the appropriate (32-bit or 64-bit) isapi_redirect.dll for your +operating system and place it in ${tomcat_home}\isapi +
    4. +
  4. +Create ${tomcat_home}\isapi\isapi_redirect.properties file to configure the ISAPI +redirctor. Configuration can also be performed via registry settings - see +below. The contents of this file should be: +
    +extension_uri=/jakarta/isapi_redirect.dll
+log_file=C:\Program Files\Apache Software Foundation\Tomcat 9.0\isapi\isapi_redirect.log
+log_level=info
+worker_file=C:\Program Files\Apache Software Foundation\Tomcat 9.0\isapi\workers.properties
+worker_mount_file=C:\Program Files\Apache Software Foundation\Tomcat 9.0\isapi\uriworkermap.properties
+
    +Be careful so that Windows does not add a .txt extension to the file. +
    5. +
  5. +Create ${tomcat_home}\isapi\workers.properties file to configure the Tomcat +instances that requests will be passed to. For a single Tomcat instance on the +local machine the contents of this file should be: +
    +worker.list=tomcat01
+worker.tomcat01.type=ajp13
+worker.tomcat01.host=localhost
+worker.tomcat01.port=8009
+
    +
    6. +
  6. +Create ${tomcat_home}\isapi\uriworkermap.properties file to configure which +requests will be passed to Tomcat. To expose the examples web application the +contents of this file should be: +
    +/examples/*=tomcat01
+
    +
    7. +
  7. +Using the IIS management console, add a new virtual directory to your IIS web +site. In a clean install, this will be the Default Web Site. The name of +the virtual directory must be jakarta. Its physical path should be the +directory where you placed isapi_redirect.dll. +
    8. +
  8. +Select the newly created virtual directory in the management console and then +double-click Handler Mappings. Select the (currently disabled) +ISAPI-dll entry and then click Edit Feature Permissions in the +action pane. In the dialog box that opens, select Execute so all three +permissions are selected. Click OK and ISAPI-dll should now be in +the enabled state. +
    9. +
  9. +Again using the IIS management console, add the ISAPI redirector as a filter to +your web site. Select your web site and then double-click ISAPI Filters. +From the action pane, click Add.... For the filter name use tomcat +and the executable should be the full path to isapi_redirect.dll. Once +configured, click OK. +
    10. +
  10. +Still using the IIS management console, configure the ISAPI redirector as +allowed. Select your server (not the web site) and then double-click on ISAPI +and CGI Restrictions. From the action pane, click Add.... Select the +isapi_redirect.dll, add a descripion (e.g. tomcat) and select the Allow +extension path to execute and then click OK. +
    11. +
  11. +Restart IIS (stop + start the IIS service). +
    12. +
+ +

+That's all, you should now start Tomcat and ask IIS to serve you the /examples +context. Try http://localhost/examples/ +for example and execute some of the Servlet or JSP examples. +

+

+If this does not work successfully, refer to the Troubleshooting section below for help on correcting the problem. +

+
+ +
IIS logging
+

+If the IIS access logs show entries such as /jakarta/isapi_redirect.dll +rather than /examples/servlets then this can be corrected via the IIS +management console. Select your server (not the web site) and then double-click +on Modules. In the Actions pane, click +View Ordered List..., select the IsapiFilterModule and move it up +until it is above the HttpLoggingModule. +

+ +
+ +
Registry configuration
+ +

+As an alternative to using the isapi_redirector.properties file, the +ISAPI redirector may be configured via the registry. To do this, follow these +steps: +

  1. In the registry, create a new registry key named @@ -196,52 +289,26 @@ to your workers.properties file (for exa Add a string value with the name worker_mount_file and a value which is the full path to your uriworkermap.properties file (for example c:\tomcat\conf\uriworkermap.properties)
    2. -
  2. -Using the IIS management console, add a new virtual directory to your IIS/PWS web site. -The name of the virtual directory must be jakarta. -Its physical path should be the directory where you placed isapi_redirect.dll -(in our example it is c:\tomcat\bin\win32\i386). -While creating this new virtual directory assign it with execute access. -
    3. -
  3. -Using the IIS management console, add isapi_redirect.dll as a filter in your IIS/PWS web site. -The name of the filter should reflect its task (I use the name tomcat), -its executable must be our c:\tomcat\bin\win32\i386\isapi_redirect.dll. -For PWS, you'll need to use regedit and add/edit the "Filter DLLs" key under -HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\W3SVC\Parameters. -This key contains a "," separated list of dlls (full paths) - -you need to insert the full path to isapi_redirect.dll. -
    4. -
  4. -If you're using IIS 6.0 you must also do the following: -
    -Using the IIS management console, add the ISAPI Redirector to the Web -Service Extensions. -
      -
    1. Right-click on Web Service Extensions and choose Add a new Web Service -Extension.
      2. -
    2. Enter tomcat for the Extension Name.
      3. -
    3. Add the isapi_redirect.dll to the required files.
      4. -
    4. Check the Set extension status to Allowed.
      5. -
    5. Click on OK.
      6. -
    -
    5. -
  5. -Restart IIS (stop + start the IIS service), make sure that the tomcat filter is marked with a green up-pointing arrow. -Under Win98 you may need to cd WINDOWS\SYSTEM\inetsrv and type PWS /stop -( the DLL and log files are locked - even if you click the stop button, -PWS will still keep the DLLs in memory. ). Type pws to start it again. -
-

+ +
+ +
64 Bit notes

-That's all, you should now start Tomcat and ask IIS to serve you the /examples context. -Try http://localhost/examples/ for example and -execute some of the Servlet or JSP examples. +In a 64 Bit environment the used IIS Application Pool should have "Enable 32-bit +Applications" set to "False". To check this, select Application Pools in +the IIS management console, then right-click on the pool you are using and +select Set Application Pool Defaults.... Enable 32-Bit +Applications may be found in the General section. If this is not +configured correctly, the redirector will not be called and IIS will return an +HTTP code 404.

-If this does not work successfully, refer to the Troubleshooting section below for help on correcting the problem. +You must use the 64-bit version of the ISAPI redirector on 64-bit operating +systems. If you attempt to use the 32bit version, you will get an HTTP code 500 +for every request because the library is not loadable into a 64-bit IIS.

+
Adding additional Contexts

@@ -469,17 +536,14 @@ Alternatively the steps for an nmake com Issue "nmake -f Makefile.x86" for a 32 Bit build, or

  • -Issue "nmake -f Makefile.amd64" for a 64 Bit build, or -
    • -
  • -Issue "nmake -f Makefile.i64" for a Itanium Bit build +Issue "nmake -f Makefile.amd64" for a 64 Bit build
    • The resulting file isapi_redirect.dll (and the debug symbol file -isapi_redirect.pdb) is located in the "Release_x86" resp. "Release_amd64" -resp. "Release_ia64" sub directory. As an intermediate step the build -first creates a static PCRE library named pcre.lib in the sub directory -"pcre/Release_x86" resp. "pcre/Release_amd64" resp. "pcre/Release_ia64. +isapi_redirect.pdb) is located in the "Release_x86" or "Release_amd64" +sub directory. As an intermediate step the build first creates a static +PCRE library named pcre.lib in the sub directory "pcre/Release_x86" or +"pcre/Release_amd64".

    Troubleshooting

    @@ -728,5 +792,5 @@ You should also be able to click the lin

    - Copyright © 1999-2016, Apache Software Foundation + Copyright © 1999-2018, Apache Software Foundation
    \ No newline at end of file --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org For additional commands, e-mail: dev-help@tomcat.apache.org