2017-11-17 17:22 GMT+03:00 <ma...@apache.org>: > Author: markt > Date: Fri Nov 17 14:22:15 2017 > New Revision: 1815568 > > URL: http://svn.apache.org/viewvc?rev=1815568&view=rev > Log: > Update the installation instructions for the ISAPI redirector. > > Modified: > tomcat/jk/trunk/xdocs/webserver_howto/iis.xml > [...] > -</section> > +<subsection name="Configuring the ISAPI Redirector"> > + > +<p><i>These instructions have been written based on Windows Server 2012 R2. > +Other versions should be broadly the same. As the installation process is > tested > +on other Windows versions, these instructions will be upadted to note any > +version specific information.</i> > +</p> > > -<section name="Configuring the ISAPI Redirector"> > <p> > -In this document I will assume that isapi_redirect.dll is placed in > -<b>c:\tomcat\bin\win32\i386\isapi_redirect.dll</b> and > -that the properties files which you created are in <b>c:\tomcat\conf</b>. > +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 <b>C:\Program Files\Apache Software > Foundation\Tomcat > +9.0</b>. This is referred to as ${tomcat_home} for the remainder of this > +document. > +</p> > + > +<ol> > +<li> > +Create a directory <b>${tomcat_home}\isapi</b> > +</li> > +<li> > +Allow the IIS process to create the ISAPI redirector log file. Enter the > +following at a command prompt: > +<source> > +>icacls "C:\Program Files\Apache Software Foundation\Tomcat 9.0\isapi" > /grant "IIS APPPOOL\DefaultAppPool":(OI)(CI)M > +</source> > +</li> > +<li> > +Download the appropriate (32-bit or 64-bit) isapi_redirect.dll for your > +operating system and place it in <b>${tomcat_home}\isapi</b> > +</li> > +<li> > +Create <b>${tomcat_home}\isapi\isapi_redirect.properties</b> to configure > the ISAPI > +redirctor. Configuration can also be performed via registry settings - see > +below. The contents of this file should be: > +<source> > +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 > +</source> > +Be careful Windows doesn't add a <b>.txt</b> extension to the file. > +</li> > +<li> > +Create <b>${tomcat_home}\isapi\workers.properties</b> 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: > +<source> > +worker.list=tomcat01 > +worker.tomcat01.type=ajp13 > +worker.tomcat01.host=localhost > +worker.tomcat01.port=8009 > +</source> > +</li> > +<li> > +Create <b>${tomcat_home}\isapi\uriworkermap.properties</b> to configure which > +requests will be passed to Tomcat. To expose the examples web application the > +contents of this file should be: > +<source> > +/examples/*=tomcat01 > +</source> > +</li> > +<li> > +Using the IIS management console, add a new virtual directory to your IIS web > +site. In a clean install, this will be the <b>Default Web Site</b>. The name > of > +the virtual directory must be <b>jakarta</b>. Its physical path should be > the
It is a bit odd to see "jakarta" nowadays. Does the value come from the value of "extension_uri" in an above configuration file (isapi_redirect.properties)? > +directory where you placed <b>isapi_redirect.dll</b>. > +</li> > +<li> > +Select the newly created vitual directory in the management console and then > +double-click <b>Handler Mappings</b>. Select the (currently disabled) > +<b>ISAPI-dll</b> entry and then click <b>Edit Feature Permissions</b> in the > +action pane. In the dialog box that opens, select <b>Execute</b> so all three > +permissions are selected. Click <b>OK</b> and <b>ISAPI-dll</b> should now be > in > +the enabled state. > +</li> > +<li> > +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 <b>ISAPI > Filters</b>. > +From the action pane, click <b>Add...</b>. For the filter name use > <b>tomcat</b> > +and the executable should be the full path to <b>isapi_redirect.dll</b>. Once > +configured, click <b>OK</b>. > +</li> > +<li> > +Still using the IIS managament console configure the ISAPI redirector as > +allowed. Select your server (not the web site) and then double-click on > <b>ISAPI > +and CGI Restrictions</b>. From the action pane, click <b>Add...</b>. Select > the > +isapi_redirect.dll, add a descripion (e.g. tomcat) and select the <b>Allow > +extension path to execute</b> and then click <b>OK</b>. > +</li> > +<li> > +Restart IIS (stop + start the IIS service). > +</li> > +</ol> > + > +<p> > +That's all, you should now start Tomcat and ask IIS to serve you the > /examples > +context. Try <a > href="http://localhost/examples/";>http://localhost/examples/</a> > +for example and execute some of the Servlet or JSP examples. > </p> > <p> > +If this does not work successfully, refer to the Troubleshooting section > below for help on correcting the problem. > +</p> > +</subsection> Best regards, Konstantin Kolinko --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org
