You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by ma...@apache.org on 2012/03/25 22:49:53 UTC
svn commit: r1305124 [6/17] - in
/tomcat/site/trunk/docs/connectors-doc-archive: ./ jk2/ jk2/common/
jk2/common/printer/ jk2/images/ jk2/jk/ jk2/jk/printer/ jk2/jk2/
jk2/jk2/printer/ jk2/printer/
Added: tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk/domhowto.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk/domhowto.html?rev=1305124&view=auto
==============================================================================
--- tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk/domhowto.html (added)
+++ tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk/domhowto.html Sun Mar 25 20:49:51 2012
@@ -0,0 +1,1198 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html xmlns="http://www.w3.org/TR/xhtml1/strict">
+<head>
+<title>Domino HowTo</title>
+<!--
+ Copyright 1999-2004 The Apache Software Foundation
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<meta content="1999-2004 The Apache Software Foundation" name="copyright"/>
+<meta content="$Date$" name="last-changed"/>
+<meta content="Andy Armstrong" name="author"/>
+<meta content="andy@tagish.com" name="email"/>
+<meta content="Henri Gomez" name="author"/>
+<meta content="hgomez@apache.org" name="email"/>
+<link href="..//style.css" type="text/css" rel="stylesheet"/>
+<link href="../images/tomcat.ico" rel="shortcut icon"/>
+</head>
+<body link="#525D76" vlink="#525D76" alink="#525D76" text="#000000" bgcolor="#ffffff">
+<a name="TOP"/>
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr height="1">
+<td class="nil" height="1" bgcolor="#ffffff" width="150">
+<img hspace="0" vspace="0" height="1" width="150" border="0" src="../images/pixel.gif"/>
+</td>
+<td class="nil" height="1" bgcolor="#ffffff" width="*">
+<img hspace="0" vspace="0" height="1" width="370" border="0" src="../images/pixel.gif"/>
+</td>
+</tr>
+<tr>
+<td width="*" colspan="2" class="logo" bgcolor="#ffffff">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left">
+<img align="left" height="48" width="505" border="0" src="../images/jakarta.gif"/>
+</td>
+<td align="right">
+<img align="right" border="0" src="../images/mod_jk.jpg"/>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td colspan="2" width="*" align="right" class="head" bgcolor="#999999">
+<nobr>
+<a href="http://www.apache.org/" class="head">Apache Software Foundation</a> |
+ <a href="http://jakarta.apache.org/" class="head">Jakarta Project</a> |
+ <a href="http://jakarta.apache.org/tomcat/" class="head">Apache Tomcat</a>
+</nobr>
+</td>
+</tr>
+<tr>
+<td valign="top" width="150" bgcolor="#ffffff">
+<table class="menu" cellpadding="0" cellspacing="0" width="150" border="0">
+<tr height="1">
+<td class="nil" height="1" bgcolor="#cccccc" width="10">
+<img hspace="0" vspace="0" height="1" width="10" border="0" src="../images/pixel.gif"/>
+</td>
+<td class="nil" height="1" bgcolor="#cccccc" width="140">
+<img hspace="0" vspace="0" height="1" width="140" border="0" src="../images/pixel.gif"/>
+</td>
+</tr>
+<tr height="6">
+<td colspan="2" width="150" bgcolor="#d0d0d0">Presentation</td>
+</tr>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../index.html">Overview</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr height="6"/>
+<tr height="6">
+<td colspan="2" width="150" bgcolor="#d0d0d0">Commons</td>
+</tr>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../common/AJPv13.html">AJPv13</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../common/AJPv13-extensions-proposal.html">AJPv13 extensions Proposal</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../common/doccontrib.html">How to Contribute to the Documentation</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../common/tools.html">Tools</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../faq.html">FAQ</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr height="6"/>
+<tr height="6">
+<td colspan="2" width="150" bgcolor="#d0d0d0">JK</td>
+</tr>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk/quickhowto.html">Quick Start HowTo</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk/aphowto.html">Apache HowTo</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk/domhowto.html">Domino HowTo</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td width="10" bgcolor="#cccccc"/>
+<td width="140" bgcolor="#cccccc">
+<a href="#Introduction" class="menu">Introduction</a>
+</td>
+</tr>
+<tr height="1"/>
+<tr>
+<td width="10" bgcolor="#cccccc"/>
+<td width="140" bgcolor="#cccccc">
+<a href="#Installation on Windows" class="menu">Installation on Windows</a>
+</td>
+</tr>
+<tr height="1"/>
+<tr>
+<td width="10" bgcolor="#cccccc"/>
+<td width="140" bgcolor="#cccccc">
+<a href="#Installation on Linux" class="menu">Installation on Linux</a>
+</td>
+</tr>
+<tr height="1"/>
+<tr>
+<td width="10" bgcolor="#cccccc"/>
+<td width="140" bgcolor="#cccccc">
+<a href="#Building for Windows" class="menu">Building for Windows</a>
+</td>
+</tr>
+<tr height="1"/>
+<tr>
+<td width="10" bgcolor="#cccccc"/>
+<td width="140" bgcolor="#cccccc">
+<a href="#Building for Linux" class="menu">Building for Linux</a>
+</td>
+</tr>
+<tr height="1"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk/iishowto.html">IIS HowTo</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk/neshowto.html">Netscape/iPlanet HowTo</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk/workershowto.html">Workers HowTo</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr height="6"/>
+<tr height="6">
+<td colspan="2" width="150" bgcolor="#d0d0d0">JK2</td>
+</tr>
+<tr height="6"/>
+<tr height="6">
+<td colspan="2" width="150" bgcolor="#d0d0d0">Configuration in the Tomcat</td>
+</tr>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/configtc.html">Configuration options</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/configtccom.html">Coyote/JK2 Handlers</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/configtcex.html">Examples</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr height="6"/>
+<tr height="6">
+<td colspan="2" width="150" bgcolor="#d0d0d0">Configuration in the Web Server</td>
+</tr>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/configweb.html">Configuration file</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/configwebcom.html">Components</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/configwebex.html">Examples</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr height="6"/>
+<tr height="6">
+<td colspan="2" width="150" bgcolor="#d0d0d0">Installation</td>
+</tr>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/installhowto.html">Installation of jk2 in the Web Server</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr height="6"/>
+<tr height="6">
+<td colspan="2" width="150" bgcolor="#d0d0d0">Howto</td>
+</tr>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/confighowto.html">Quick Start JK2 Configuration Guide</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/vhosthowto.html">Apache 2.0.43 - Tomcat 4.1.12 - jk2 - virtual host HOWTO</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/davhowto.html">Apache 2.x/mod-dav - Tomcat/jk2 - HOWTO</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr height="6"/>
+</table>
+</td>
+<td class="body" valign="top" width="*" bgcolor="#ffffff">
+<table cellspacing="4" width="100%" border="0">
+<tr>
+<td nowrap="true" valign="top" align="left">
+<h2>Domino HowTo</h2>
+</td>
+<td nowrap="true" valign="top" align="right">
+<small>
+<a href="../jk/printer/domhowto.html">
+<img alt="Printer Friendly Version" border="0" src="../images/printer.gif"/>
+<br/>print-friendly<br/>version
+ </a>
+</small>
+</td>
+</tr>
+</table>
+<a name="Introduction">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="section" bgcolor="#525D76">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Introduction</td>
+</tr>
+</table>
+</a>
+<p class="section">
+<b>
+<font color="#333333">Important Note:</font>
+</b> The JK based connector described here has been superceded by a JK2 based connector
+that works with all current Tomcat versions. Use of this connector has been deprecated. Go
+<b>
+<a href="../jk2/installhowto.html">here</a>
+</b> to find out how to install the new connector.</p>
+<p class="section">
+This document explains how to set up Domino to cooperate with Tomcat.
+</p>
+<p class="section">
+It is recommended that you also read the <b>
+<a href="../jk/workershowto.html">Workers HowTo</a>
+</b> document
+to learn how to setup the working entities between your WebServer and Tomcat Engines.
+</p>
+<p class="section">
+Recent versions of the Lotus Domino web server have had the ability to host Java servlets,
+but at the time of writing the Domino servlet container uses JDK 1.2.2 and it is not (apparently)
+possible to replace this with JDK 1.3.
+</p>
+<p class="section">
+That means if you want to use JAAS or any other API
+that is JDK 1.3 only in your servlets you're stuck.
+</p>
+<a name="sub_Document Conventions and Assumptions">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Document Conventions and Assumptions</td>
+</tr>
+</table>
+</a>
+<p class="section">
+${tomcat_home} is the root directory of tomcat.
+Your Tomcat installation should have the following subdirectories:
+
+<ul>
+<li>
+${tomcat_home}\conf - Where you can place various configuration files
+</li>
+<li>
+${tomcat_home}\webapps - Containing example applications
+</li>
+<li>
+${tomcat_home}\bin - Where you place web server plugins
+</li>
+</ul>
+</p>
+<p class="section">
+In all the examples in this document ${tomcat_home} will be <b>
+<font color="#333333">c:\jakarta-tomcat</font>
+</b>.
+A worker is defined to be a tomcat process that accepts work from the Domino server.
+</p>
+<br/>
+<a name="sub_Supported Configuration">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Supported Configuration</td>
+</tr>
+</table>
+</a>
+<p class="section">
+The Domino Tomcat redirector was developed and tested on:
+<ul>
+<li>
+WinNT4.0-i386 SP6a (it should be able to work on other versions of the NT service pack.) and Win2K Professional
+</li>
+<li>
+RedHat Linux 7
+</li>
+<li>
+Lotus Domino 5.0.6a
+</li>
+<li>
+Tomcat 3.2.x, Tomcat 3.3.x, Tomcat 4.0.x, Tomcat 4.1.x and Tomcat 5
+</li>
+</ul>
+</p>
+<p class="section">
+The redirector uses <b>
+<font color="#333333">ajp12</font>
+</b> and <b>
+<font color="#333333">ajp13</font>
+</b> to send requests to the Tomcat containers.
+It probably also works with Tomcat in process, but that hasn't been tested.
+</p>
+<br/>
+<a name="sub_Who support ajp protocols ?">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Who support ajp protocols ?</td>
+</tr>
+</table>
+</a>
+<p class="section">
+The ajp12 protocol is only available in Tomcat 3.2.x and 3.3.x.
+</p>
+<p class="section">
+The <b>
+<font color="#333333">ajp12</font>
+</b> has been <b>
+<font color="#333333">deprecated</font>
+</b> with Tomcat 3.3.x and you should use instead
+<b>
+<font color="#333333">ajp13</font>
+</b> which is the only ajp protocol known by Tomcat 4.0.x, 4.1.x and 5.
+</p>
+<p class="section">
+Of course Tomcat 3.2.x and 3.3.x also support ajp13 protocol.
+</p>
+<p class="section">
+Others servlet engines such as <b>
+<font color="#333333">jetty</font>
+</b> have support for ajp13 protocol
+</p>
+<br/>
+<br/>
+<a name="Installation on Windows">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="section" bgcolor="#525D76">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Installation on Windows</td>
+</tr>
+</table>
+</a>
+<p class="section">
+The Tomcat redirector requires 3 entities:
+</p>
+<ul>
+<li>
+tomcat_redirect.dll - The Domino plugin; either obtain a pre-built DLL or build it yourself
+(see the build section).
+</li>
+<li>
+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.
+</li>
+<li>
+tomcat_redirector.reg - Registry entries
+</li>
+</ul>
+<p class="section">
+We'll assume that tomcat redirector is placed in <b>
+<font color="#333333">c:\jk\lib\tomcat_redirector.dll</font>
+</b>,
+the properties file is in<b>
+<font color="#333333">c:\jk\conf</font>
+</b>
+and you created a log directory <b>
+<font color="#333333">c:\jk\logs</font>
+</b>
+</p>
+<p class="section">
+Copy the file <b>
+<font color="#333333">tomcat_redirector.dll</font>
+</b> to the Domino program directory
+(this is the directory, which may be called something like <b>
+<font color="#333333">c:\Lotus\Domino</font>
+</b>, that contains a file called
+<b>
+<font color="#333333">nlnotes.exe</font>
+</b>).
+</p>
+<p class="screendos">
+<div align="center">
+<table bgcolor="#000000" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#000000">
+<div class="screendos">Copy redirector dll to Domino program directory</div>
+<code>
+<nobr>
+<em class="screendos">c:\></em>
+<b class="screendos">copy c:\jk\lib\tomcat_redirector.dll c:\Lotus\Domino</b>
+</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<p class="section">
+Shortly we will tell Domino where to find this file, but before we do that we need to make some registry entries.
+The simplest way is to edit the supplied file <b>
+<font color="#333333">tomcat_redirector.reg</font>
+</b>, which initially will look like this :
+</p>
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<code class="screen">
+<nobr>REGEDIT4</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr/>
+</code>
+<br/>
+<code class="screen">
+<nobr>[HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Dsapi Redirector\1.0]</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>"log_file"="c:\\jk\\logs\\domino.log"</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>"log_level"="debug"</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>"worker_file"="c:\\jk\\conf\\workers.properties"</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>"worker_mount_file"="c:\\jk\\conf\\uriworkermap.properties"</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>"tomcat_start"="c:\\jakarta-tomcat\\bin\\tomcat.bat start"</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>"tomcat_stop"="c:\\jakarta-tomcat\\bin\\tomcat.bat stop"</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<p class="section">
+Edit this file to reflect the location where Tomcat has been installed, i.e. replace the instances
+of <b>
+<font color="#333333">c:\\jakarta-tomcat</font>
+</b> and <b>
+<font color="#333333">c:\\jk</font>
+</b> with the appropriate path remembering to <b>
+<font color="#333333">retain the double backslashes</font>
+</b>.
+</p>
+<p class="section">
+Once you've made the necessary changes save this file and double click on it to enter it into the registry.
+</p>
+<p class="section">
+Note that the files referred to by the worker_file and worker_mount_file keys need to exist and contain sane values.
+Default Tomcat installations will have these files. Note also that recent versions of Tomcat write a file called uriworkermap.properties-auto when they start up that can be renamed uriworkermap.properties to obtain default behaviour.
+</p>
+<a name="sub_Note for Windows 2000 users">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Note for Windows 2000 users</td>
+</tr>
+</table>
+</a>
+<p class="section">
+For some reason Windows 2000 seems to have a problem resolving the references to localhost
+in the default workers.properties.
+</p>
+<p class="section">
+The easiest solution is to replace 'localhost' with '127.0.0.1' everywhere it appears.
+</p>
+<br/>
+<a name="sub_Automatically Starting Tomcat">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Automatically Starting Tomcat</td>
+</tr>
+</table>
+</a>
+<p class="section">
+The last two registry entries above provide commands that the redirector DLL will use to
+start and stop Tomcat when the Domino http server starts and stops respectively.
+</p>
+<p class="section">
+If you don't require this behaviour these two lines can be omitted
+(or deleted if you've already placed them in the registry).
+</p>
+<br/>
+<a name="sub_Configuring Domino">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Configuring Domino</td>
+</tr>
+</table>
+</a>
+<p class="section">
+Finally we need to configure Domino to use the DSAPI extension DLL.
+For those who are unfamiliar with Domino server configuration most of a server's configurable behavior
+is dictated by a document called the "server document" in a database called the
+<b>
+<font color="#333333">"Public Name and Address Book"</font>
+</b> or <b>
+<font color="#333333">"NAB"</font>
+</b> for short
+</p>
+<p class="section">
+(N.B. Lotus have renamed the NAB to "Domino Directory" from Domino 5 onwards).
+Each Domino server will have a NAB (called names.nsf) and each NAB will have a number of server documents
+including one for the current server.
+</p>
+<p class="section">
+If you have not previously configured a Domino server you may need to refer to the supplied documentation,
+or you may need to pass this document to your tame Domino administrator.
+</p>
+<p class="section">
+Assuming you know your way around a Domino server document what we're going to do is actually quite simple.
+Open the server document for this server, place it in Edit mode, then locate the DSAPIsection and the 'DSAPI filter file names' field on the Internet Protocols tab, HTTP sub-tab. Add "tomcat_redirector.dll" to the DSAPI field, then save and close the document.
+</p>
+<br/>
+<a name="sub_Restart Domino">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Restart Domino</td>
+</tr>
+</table>
+</a>
+<p class="section">
+In order to get these settings to take effect and make sure that you haven't disrupted anything
+else you should now restart the Domino server.
+</p>
+<p class="section">If the server is running as a service and you have changed any relevant system variables
+(JAVA_HOME, TOMCAT_HOME, CLASSPATH) since the last time you restarted the computer you should
+do a complete restart now because updates to system variables are not seen by services until after a reboot.
+</p>
+<p class="section">
+If all goes well you should see something like this on the server console when the web server starts up :
+</p>
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<code class="screen">
+<nobr>29/05/2001 18:54:13 JVM: Java Virtual Machine initialized.</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>29/05/2001 18:54:14 Attempting to start Tomcat: c:\jakarta-tomcat\bin\tomcat.bat start</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>Including all jars in c:\jakarta-tomcat\lib in your CLASSPATH.</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr/>
+</code>
+<br/>
+<code class="screen">
+<nobr>Using CLASSPATH: c:\jakarta-tomcat\classes;c:\jakarta-tomcat\lib\ant.jar;c:\jakarta-tomcat\lib\servlet.jar</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr/>
+</code>
+<br/>
+<code class="screen">
+<nobr>Starting Tomcat in new window</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>29/05/2001 18:54:15 Apache Tomcat Interceptor (Jakarta/DSAPI/1.0) loaded</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>29/05/2001 18:54:16 HTTP Web Server started</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<p class="section">
+At about the same time Tomcat should open in a new window (assuming you enabled the autostart option in the registry settings).
+</p>
+<p class="section">
+You should now be able to visit a URL that is handled by Tomcat.
+Something like may be available, depending on how Tomcat is configured :
+</p>
+<p class="section">
+If that all works you're done ;-)
+</p>
+<br/>
+<br/>
+<a name="Installation on Linux">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="section" bgcolor="#525D76">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Installation on Linux</td>
+</tr>
+</table>
+</a>
+<p class="section">
+The Tomcat redirector requires 3 entities:
+</p>
+<ul>
+<li>
+libtomcat.so - The Domino plugin; either obtain a pre-built shared lib or build it yourself
+(see the build section).
+</li>
+<li>
+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.
+</li>
+<li>
+libtomcat.ini - configuration entries
+</li>
+</ul>
+<p class="section">
+Copy the file <b>
+<font color="#333333">libtomcat.so</font>
+</b> to the Domino program directory which may be called
+something like <b>
+<font color="#333333">/opt/lotus/notes/5601/linux</font>
+</b>, it should contains a file called <b>
+<font color="#333333">libnotes.so</font>
+</b>
+and copy <b>
+<font color="#333333">libtomcat.ini</font>
+</b> to the Domino data directory.
+</p>
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<div class="screen">Copy redirector shared lib to Domino program directory</div>
+<code>
+<nobr>
+<em class="screen">[user@host] ~ $ </em>
+<b class="screen">cp c:\jk\lib\libtomcat.so /opt/lotus/notes/5601/linux</b>
+</nobr>
+</code>
+<br/>
+<div class="screen">Copy config to Domino data directory</div>
+<code>
+<nobr>
+<em class="screen">[user@host] ~ $ </em>
+<b class="screen">cp c:\jk\conf\libtomcat.ini /opt/datalotus</b>
+</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<p class="section">
+Note that if you're building the redirector from source these files should already
+have been copied to the appropriate locations.
+</p>
+<p class="section">
+Before using the redirector you may like to review the settings in <b>
+<font color="#333333">libtomcat.ini</font>
+</b> which,
+by default, will look something like this:
+</p>
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<code class="screen">
+<nobr>log_file=/var/log/domino.log</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>log_level=debug</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>worker_file=/var/tomcat3/conf/workers.properties</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>worker_mount_file=/var/tomcat3/conf/uriworkermap.properties</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>tomcat_start=/var/tomcat3/bin/tomcat.sh start</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>tomcat_stop=/var/tomcat3/bin/tomcat.sh stop</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<p class="section">
+If you're building the redirector from the source you may not need to make any changes,
+otherwise you may have to edit this file to reflect the location where Tomcat has been installed,
+i.e. replace the instances of /usr/local/apache/tomcat with the appropriate path.
+</p>
+<p class="section">
+Note that the files referred to by the <b>
+<font color="#333333">worker_file</font>
+</b> and <b>
+<font color="#333333">worker_mount_file</font>
+</b> keys need to exist
+and contain sane values.
+</p>
+<p class="section">
+Default Tomcat installations will have these files.
+Note also that recent versions of Tomcat write a file called <b>
+<font color="#333333">uriworkermap.properties-auto</font>
+</b>
+when they start up that can be renamed <b>
+<font color="#333333">uriworkermap.properties</font>
+</b> to obtain default behaviour.
+</p>
+<a name="sub_Automatically Starting Tomcat">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Automatically Starting Tomcat</td>
+</tr>
+</table>
+</a>
+<p class="section">
+The last two registry entries above provide commands that the redirector will use to start and stop
+Tomcat when the Domino http server starts and stops respectively.
+</p>
+<p class="section">
+If you don't require this behaviour these two lines can be deleted.
+</p>
+<br/>
+<a name="sub_Configuring Domino">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Configuring Domino</td>
+</tr>
+</table>
+</a>
+<p class="section">
+Finally we need to configure Domino to use the DSAPI extension.
+</p>
+<p class="section">
+For those who are unfamiliar with Domino server configuration most of a server's
+configurable behavior is dictated by a document called the "server document" in a database called the
+<b>
+<font color="#333333">"Public Name and Address Book"</font>
+</b> or <b>
+<font color="#333333">"NAB"</font>
+</b> for short
+</p>
+<p class="section">
+N.B. Lotus have renamed the NAB to "Domino Directory" from Domino 5 onwards).
+</p>
+<p class="section">
+Each Domino server will have a NAB (called names.nsf) and each NAB will have a number of server documents
+including one for the current server.
+
+If you have not previously configured a Domino server you may need to refer to the supplied documentation,
+or you may need to pass this document to your tame Domino administrator.
+</p>
+<p class="section">
+Assuming you know your way around a Domino server document what we're going to do is actually quite simple.
+</p>
+<p class="section">
+Open the server document for this server, place it in Edit mode, then locate the
+<b>
+<font color="#333333">DSAPIsection</font>
+</b> and the <b>
+<font color="#333333">'DSAPI filter file names'</font>
+</b> field on the Internet Protocols tab,
+HTTP sub-tab.
+</p>
+<p class="section">
+Add <b>
+<font color="#333333">"libtomcat.so"</font>
+</b> to the DSAPI field, then save and close the document.
+</p>
+<br/>
+<a name="sub_Restart Domino">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Restart Domino</td>
+</tr>
+</table>
+</a>
+<p class="section">
+In order to get these settings to take effect and make sure that you haven't
+disrupted anything else you should now restart the Domino HTTP server.
+</p>
+<p class="section">
+At the Domino console type
+</p>
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<code>
+<nobr>
+<em class="screen">[user@host] ~ $ </em>
+<b class="screen">tell http quit</b>
+</nobr>
+</code>
+<br/>
+<code>
+<nobr>
+<em class="screen">[user@host] ~ $ </em>
+<b class="screen">load http</b>
+</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<p class="section">
+You should see the HTTP server reload along with messages that will confirm that the redirector
+has loaded and that Tomcat has (if you used Tomcat autostart) started.
+</p>
+<p class="section">
+You should now be able to visit a URL that is handled by Tomcat. Something like
+</p>
+<br/>
+<br/>
+<a name="Building for Windows">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="section" bgcolor="#525D76">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Building for Windows</td>
+</tr>
+</table>
+</a>
+<p class="section">
+To compile it you'll need the JK Domino sources and Microsoft Visual C++ 6.0.
+</p>
+<p class="section">
+You will probably also want the Lotus Notes C API version 5.0.7 or later.
+You can build the DLL without the C API, in which case you'll need to define the macro NO_CAPI in config.h.
+If you do this Domino logging from the DLL will be disabled.
+</p>
+<ul>
+<li>
+Change directory to the domino plugin source directory.
+</li>
+<li>
+Edit <b>
+<font color="#333333">dsapi.dsp</font>
+</b> and update the include and library path to reflect your own Domino server installation
+(search for a <b>
+<font color="#333333">/I compiler</font>
+</b> option and <b>
+<font color="#333333">/libpath</font>
+</b> linker option)
+</li>
+<li>
+Make the source with MSDEV
+</li>
+</ul>
+<p class="screendos">
+<div align="center">
+<table bgcolor="#000000" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#000000">
+<div class="screendos">Change directory to the dsapi plugins source directory</div>
+<code>
+<nobr>
+<em class="screendos">c:\></em>
+<b class="screendos">cd c:\home\apache\jk\domino</b>
+</nobr>
+</code>
+<br/>
+<div class="screendos">Build the sources using MSDEV</div>
+<code>
+<nobr>
+<em class="screendos">c:\></em>
+<b class="screendos">MSDEV dsapi.dsp /MAKE ALL</b>
+</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<br/>
+<a name="Building for Linux">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="section" bgcolor="#525D76">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Building for Linux</td>
+</tr>
+</table>
+</a>
+<p class="section">
+You will probably also want the Lotus Notes C API version 5.0.3 for Unix or later.
+</p>
+<p class="section">
+You can build the redirector without the C API, in which case you'll need to define the macro NO_CAPI in config.h.
+If you do this, Domino logging from the redirector will be disabled.
+</p>
+<ul>
+<li>
+Change directory to the Domino plugin source directory.
+</li>
+<li>
+Edit <b>
+<font color="#333333">Makefile</font>
+</b> and update the include and library path to reflect your own Domino server installation
+</li>
+</ul>
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<div class="screen">edit the Makefile providing appropriate values for these variables</div>
+<code class="screen">
+<nobr># The root of your Domino installation. Mine's in /usr/local/lotus, but your's</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr># may well be /opt/lotus</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>NOTESROOT=/usr/local/lotus</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr/>
+</code>
+<br/>
+<code class="screen">
+<nobr># The place where the Notes API is installed</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>NOTESAPI=$(NOTESROOT)/notesapi</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr/>
+</code>
+<br/>
+<code class="screen">
+<nobr># The Domino program directory.</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>NOTESHOME=$(NOTESROOT)/notes/5061/linux</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr/>
+</code>
+<br/>
+<code class="screen">
+<nobr># The Domino data directory (the directory containing names.nsf)</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>NOTESDATA=$(NOTESROOT)/notes/data</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr/>
+</code>
+<br/>
+<code class="screen">
+<nobr># The include path for the Notes C API headers</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>NOTESINC=$(NOTESAPI)/include</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr/>
+</code>
+<br/>
+<code class="screen">
+<nobr># Where tomcat is installed. This is where conf, lib, webapps et al normally are</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>TOMCATHOME=/var/tomcat3</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr/>
+</code>
+<br/>
+<code class="screen">
+<nobr># Your JDK's include directory</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>JAVAINC=$(JAVA_HOME)/include</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<ul>
+<li>
+Now you should build via make
+</li>
+</ul>
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<div class="screen">Launch build via make</div>
+<code>
+<nobr>
+<em class="screen">[user@host] ~ $ </em>
+<b class="screen">make</b>
+</nobr>
+</code>
+<br/>
+<div class="screen">place the redirector (libtomcat.so) and its settings file (libtomcat.ini) in the appropriate places</div>
+<code>
+<nobr>
+<em class="screen">[user@host] ~ $ </em>
+<b class="screen">make install</b>
+</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<br/>
+</td>
+</tr>
+</table>
+</body>
+</html>
Propchange: tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk/domhowto.html
------------------------------------------------------------------------------
svn:executable = *
Added: tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk/iishowto.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk/iishowto.html?rev=1305124&view=auto
==============================================================================
--- tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk/iishowto.html (added)
+++ tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk/iishowto.html Sun Mar 25 20:49:51 2012
@@ -0,0 +1,1344 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html xmlns="http://www.w3.org/TR/xhtml1/strict">
+<head>
+<title>IIS HowTo</title>
+<!--
+ Copyright 1999-2004 The Apache Software Foundation
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<meta content="1999-2004 The Apache Software Foundation" name="copyright"/>
+<meta content="$Date$" name="last-changed"/>
+<meta content="Henri Gomez" name="author"/>
+<meta content="hgomez@apache.org" name="email"/>
+<meta content="Gal Shachor" name="author"/>
+<meta content="shachor@il.ibm.com" name="email"/>
+<meta content="Yoav Shapira" name="author"/>
+<meta content="yoavs@apache.org" name="email"/>
+<link href="..//style.css" type="text/css" rel="stylesheet"/>
+<link href="../images/tomcat.ico" rel="shortcut icon"/>
+</head>
+<body link="#525D76" vlink="#525D76" alink="#525D76" text="#000000" bgcolor="#ffffff">
+<a name="TOP"/>
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr height="1">
+<td class="nil" height="1" bgcolor="#ffffff" width="150">
+<img hspace="0" vspace="0" height="1" width="150" border="0" src="../images/pixel.gif"/>
+</td>
+<td class="nil" height="1" bgcolor="#ffffff" width="*">
+<img hspace="0" vspace="0" height="1" width="370" border="0" src="../images/pixel.gif"/>
+</td>
+</tr>
+<tr>
+<td width="*" colspan="2" class="logo" bgcolor="#ffffff">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left">
+<img align="left" height="48" width="505" border="0" src="../images/jakarta.gif"/>
+</td>
+<td align="right">
+<img align="right" border="0" src="../images/mod_jk.jpg"/>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td colspan="2" width="*" align="right" class="head" bgcolor="#999999">
+<nobr>
+<a href="http://www.apache.org/" class="head">Apache Software Foundation</a> |
+ <a href="http://jakarta.apache.org/" class="head">Jakarta Project</a> |
+ <a href="http://jakarta.apache.org/tomcat/" class="head">Apache Tomcat</a>
+</nobr>
+</td>
+</tr>
+<tr>
+<td valign="top" width="150" bgcolor="#ffffff">
+<table class="menu" cellpadding="0" cellspacing="0" width="150" border="0">
+<tr height="1">
+<td class="nil" height="1" bgcolor="#cccccc" width="10">
+<img hspace="0" vspace="0" height="1" width="10" border="0" src="../images/pixel.gif"/>
+</td>
+<td class="nil" height="1" bgcolor="#cccccc" width="140">
+<img hspace="0" vspace="0" height="1" width="140" border="0" src="../images/pixel.gif"/>
+</td>
+</tr>
+<tr height="6">
+<td colspan="2" width="150" bgcolor="#d0d0d0">Presentation</td>
+</tr>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../index.html">Overview</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr height="6"/>
+<tr height="6">
+<td colspan="2" width="150" bgcolor="#d0d0d0">Commons</td>
+</tr>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../common/AJPv13.html">AJPv13</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../common/AJPv13-extensions-proposal.html">AJPv13 extensions Proposal</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../common/doccontrib.html">How to Contribute to the Documentation</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../common/tools.html">Tools</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../faq.html">FAQ</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr height="6"/>
+<tr height="6">
+<td colspan="2" width="150" bgcolor="#d0d0d0">JK</td>
+</tr>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk/quickhowto.html">Quick Start HowTo</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk/aphowto.html">Apache HowTo</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk/domhowto.html">Domino HowTo</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk/iishowto.html">IIS HowTo</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td width="10" bgcolor="#cccccc"/>
+<td width="140" bgcolor="#cccccc">
+<a href="#Introduction" class="menu">Introduction</a>
+</td>
+</tr>
+<tr height="1"/>
+<tr>
+<td width="10" bgcolor="#cccccc"/>
+<td width="140" bgcolor="#cccccc">
+<a href="#Installation" class="menu">Installation</a>
+</td>
+</tr>
+<tr height="1"/>
+<tr>
+<td width="10" bgcolor="#cccccc"/>
+<td width="140" bgcolor="#cccccc">
+<a href="#Configuring the ISAPI Redirector" class="menu">Configuring the ISAPI Redirector</a>
+</td>
+</tr>
+<tr height="1"/>
+<tr>
+<td width="10" bgcolor="#cccccc"/>
+<td width="140" bgcolor="#cccccc">
+<a href="#Building ISAPI redirector" class="menu">Building ISAPI redirector</a>
+</td>
+</tr>
+<tr height="1"/>
+<tr>
+<td width="10" bgcolor="#cccccc"/>
+<td width="140" bgcolor="#cccccc">
+<a href="#Troubleshooting" class="menu">Troubleshooting</a>
+</td>
+</tr>
+<tr height="1"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk/neshowto.html">Netscape/iPlanet HowTo</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk/workershowto.html">Workers HowTo</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr height="6"/>
+<tr height="6">
+<td colspan="2" width="150" bgcolor="#d0d0d0">JK2</td>
+</tr>
+<tr height="6"/>
+<tr height="6">
+<td colspan="2" width="150" bgcolor="#d0d0d0">Configuration in the Tomcat</td>
+</tr>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/configtc.html">Configuration options</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/configtccom.html">Coyote/JK2 Handlers</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/configtcex.html">Examples</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr height="6"/>
+<tr height="6">
+<td colspan="2" width="150" bgcolor="#d0d0d0">Configuration in the Web Server</td>
+</tr>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/configweb.html">Configuration file</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/configwebcom.html">Components</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/configwebex.html">Examples</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr height="6"/>
+<tr height="6">
+<td colspan="2" width="150" bgcolor="#d0d0d0">Installation</td>
+</tr>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/installhowto.html">Installation of jk2 in the Web Server</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr height="6"/>
+<tr height="6">
+<td colspan="2" width="150" bgcolor="#d0d0d0">Howto</td>
+</tr>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/confighowto.html">Quick Start JK2 Configuration Guide</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/vhosthowto.html">Apache 2.0.43 - Tomcat 4.1.12 - jk2 - virtual host HOWTO</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr>
+<td colspan="2" width="150" bgcolor="#cccccc">
+<nobr>
+<a class="menu" href="../jk2/davhowto.html">Apache 2.x/mod-dav - Tomcat/jk2 - HOWTO</a>
+</nobr>
+</td>
+</tr>
+<tr height="2"/>
+<tr height="6"/>
+</table>
+</td>
+<td class="body" valign="top" width="*" bgcolor="#ffffff">
+<table cellspacing="4" width="100%" border="0">
+<tr>
+<td nowrap="true" valign="top" align="left">
+<h2>IIS HowTo</h2>
+</td>
+<td nowrap="true" valign="top" align="right">
+<small>
+<a href="../jk/printer/iishowto.html">
+<img alt="Printer Friendly Version" border="0" src="../images/printer.gif"/>
+<br/>print-friendly<br/>version
+ </a>
+</small>
+</td>
+</tr>
+</table>
+<a name="Introduction">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="section" bgcolor="#525D76">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Introduction</td>
+</tr>
+</table>
+</a>
+<p class="section">
+This document explains how to set up IIS to cooperate with Tomcat.
+</p>
+<p class="section">
+Normally IIS can not execute Servlets and Java Server Pages (JSPs),
+configuring IIS to use the JK ISAPI redirector plugin will let IIS send servlet and
+JSP requests to Tomcat (and this way, serve them to clients).
+</p>
+<p class="section">
+It is recommanded that you also read the <b>
+<a href="../jk/workershowto.html">Workers HowTo</a>
+</b> document
+to learn how to setup the working entities between your WebServer and Tomcat Engines.
+</p>
+<a name="sub_Document Conventions and Assumptions">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Document Conventions and Assumptions</td>
+</tr>
+</table>
+</a>
+<p class="section">
+${tomcat_home} is the root directory of tomcat.
+Your Tomcat installation should have the following subdirectories:
+
+<ul>
+<li>
+${tomcat_home}\conf - Where you can place various configuration files
+</li>
+<li>
+${tomcat_home}\webapps - Containing example applications
+</li>
+<li>
+${tomcat_home}\bin - Where you place web server plugins
+</li>
+</ul>
+</p>
+<p class="section">
+In all the examples in this document ${tomcat_home} will be <b>
+<font color="#333333">c:\jakarta-tomcat</font>
+</b>.
+A worker is defined to be a tomcat process that accepts work from the IIS server.
+</p>
+<br/>
+<a name="sub_Supported Configuration">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Supported Configuration</td>
+</tr>
+</table>
+</a>
+<p class="section">
+The IIS-Tomcat redirector was developed and tested on:
+<ul>
+<li>
+WinNT4.0-i386 SP4/SP5/SP6a (should be able to work with other service packs), Win2K and WinXP and Win98
+</li>
+<li>
+IIS4.0 and PWS4.0 (numerous people have working IIS 5 and IIS 6 configurations)
+</li>
+<li>
+Tomcat 3.2 and later, Tomcat 4.x and Tomcat 5
+</li>
+</ul>
+</p>
+<p class="section">
+The redirector uses <b>
+<font color="#333333">ajp12</font>
+</b> and <b>
+<font color="#333333">ajp13</font>
+</b> to send requests to the Tomcat containers. There is also an option to use Tomcat in process,
+more about the in-process mode can be found in the in process howto.
+</p>
+<br/>
+<a name="sub_IIS 5 and 6 Notes">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>IIS 5 and 6 Notes</td>
+</tr>
+</table>
+</a>
+<p class="section">
+There are extra steps you need to take for configuring Tomcat with IIS 5 and 6. Please see the appropriate links from
+<b>
+<a href="http://wiki.apache.org/jakarta-tomcat/Tomcat_2fLinks">Tomcat Useful Links</a>
+</b>.
+</p>
+<br/>
+<a name="sub_Who support ajp protocols ?">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Who support ajp protocols ?</td>
+</tr>
+</table>
+</a>
+<p class="section">
+The ajp12 protocol is only available in Tomcat 3.2.x and 3.3.x.
+</p>
+<p class="section">
+The <b>
+<font color="#333333">ajp12</font>
+</b> has been <b>
+<font color="#333333">deprecated</font>
+</b> with Tomcat 3.3.x and you should use instead
+<b>
+<font color="#333333">ajp13</font>
+</b> which is the only ajp protocol known by Tomcat 4.x and 5.
+</p>
+<p class="section">
+Of course Tomcat 3.2.x and 3.3.x also support ajp13 protocol.
+</p>
+<p class="section">
+Others servlet engines such as <b>
+<font color="#333333">jetty</font>
+</b> have support for ajp13 protocol
+</p>
+<br/>
+<a name="sub_How does it work ?">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>How does it work ?</td>
+</tr>
+</table>
+</a>
+<p class="section">
+<ol>
+<li>
+The IIS-Tomcat redirector is an IIS plugin (filter + extension), IIS load the redirector plugin and calls its
+filter function for each in-coming request.
+</li>
+<li>
+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 transfer the request to the extension.
+</li>
+<li>
+The extension collects the request parameters and forwards them to the appropriate worker using the defined
+protocol like <b>
+<font color="#333333">ajp13</font>
+</b>.
+</li>
+<li>
+The extension collects the response from the worker and returns it to the browser.
+</li>
+</ol>
+</p>
+<br/>
+<br/>
+<a name="Installation">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="section" bgcolor="#525D76">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Installation</td>
+</tr>
+</table>
+</a>
+<p class="section">
+A pre-built version of the ISAPI redirector server plugin, isapi_redirect.dll, is available under
+the win32/i386 directory of jakarta-tomcat-connectors distribution.
+For those using Netscape as your browser, try downloading a zip version of the file, if available.
+There can be problems using Netscape to download DLL files.
+
+You can also build a copy locally from the source present in jakarta-tomcat-connectors distribution.
+
+The Tomcat redirector requires three entities:
+
+<ul>
+<li>
+<b>
+<font color="#333333">isapi_redirect.dll</font>
+</b> - The IIS server plugin, either obtain a pre-built DLL or build it yourself (see the build section).
+</li>
+<li>
+<b>
+<font color="#333333">workers.properties</font>
+</b> - 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.
+</li>
+<li>
+<b>
+<font color="#333333">uriworkermap.properties</font>
+</b> - A file that maps URL-Path patterns to workers.
+A sample uriworkermap.properties can be found under the conf directory as well.
+</li>
+</ul>
+</p>
+<p class="section">
+The installation includes the following parts:
+
+<ul>
+<li>
+Configuring the ISAPI redirector with a default /examples context and checking that you can serve servlets with IIS.
+</li>
+<li>
+Adding more contexts to the configuration.
+</li>
+</ul>
+</p>
+<br/>
+<a name="Configuring the ISAPI Redirector">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="section" bgcolor="#525D76">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Configuring the ISAPI Redirector</td>
+</tr>
+</table>
+</a>
+<p class="section">
+In this document I will assume that isapi_redirect.dll is placed in
+<b>
+<font color="#333333">c:\jakarta-tomcat\bin\win32\i386\isapi_redirect.dll</font>
+</b> and
+that you created the properties files are in <b>
+<font color="#333333">c:\jakarta-tomcat\conf</font>
+</b>.
+</p>
+<p class="section">
+<ol>
+<li>
+In the registry, create a new registry key named
+<b>
+<font color="#333333">"HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0"</font>
+</b>
+</li>
+<li>
+Add a string value with the name <b>
+<font color="#333333">extension_uri</font>
+</b> and a value of <b>
+<font color="#333333">/jakarta/isapi_redirect.dll</font>
+</b>
+</li>
+<li>
+Add a string value with the name <b>
+<font color="#333333">log_file</font>
+</b> and a value pointing to where you want your
+log file to be (for example <b>
+<font color="#333333">c:\jakarta-tomcat\logs\isapi.log</font>
+</b>).
+</li>
+<li>
+Add a string value with the name <b>
+<font color="#333333">log_level</font>
+</b> and a value for your log level
+(can be debug, info, error or emerg).
+</li>
+<li>
+Add a string value with the name <b>
+<font color="#333333">worker_file</font>
+</b> and a value which is the full path
+to your workers.properties file (for example <b>
+<font color="#333333">c:\jakarta-tomcat\conf\workers.properties</font>
+</b>)
+</li>
+<li>
+Add a string value with the name <b>
+<font color="#333333">worker_mount_file</font>
+</b> and a value which is the full path
+to your uriworkermap.properties file (for example <b>
+<font color="#333333">c:\jakarta-tomcat\conf\uriworkermap.properties</font>
+</b>)
+</li>
+<li>
+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:\jakarta-tomcat\bin\win32\i386).
+While creating this new virtual directory assign it with execute access.
+</li>
+<li>
+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 jakarta),
+its executable must be our c:\jakarta-tomcat\bin\win32\i386\isapi_redirect.dll.
+For PWS, you'll need to use regedit and add/edit the <b>
+<font color="#333333">"Filter DLLs"</font>
+</b> key under
+<b>
+<font color="#333333">HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\W3SVC\Parameters</font>
+</b>.
+This key contains a "," separated list of dlls ( full paths ) -
+you need to insert the full path to isapi_redirect.dll.
+</li>
+<li>
+Restart IIS (stop + start the IIS service), make sure that the jakarta filter is marked with a green up-pointing arrow.
+Under Win98 you may need to <b>
+<font color="#333333">cd WINDOWS\SYSTEM\inetsrv</font>
+</b> 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.
+</li>
+</ol>
+</p>
+<p class="section">
+That's all, you should now start Tomcat and ask IIS to serve you the /examples context.
+Try <b>
+<a href="http://localhost/examples/jsp/index.html">http://localhost/examples/jsp/index.html</a>
+</b> for example and
+execute some of the JSP examples.
+</p>
+<p class="section">
+If this does not work successfully, refer to the Troubleshooting section below for help on correcting the problem.
+</p>
+<a name="sub_Adding additional Contexts">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Adding additional Contexts</td>
+</tr>
+</table>
+</a>
+<p class="section">
+The examples context is useful for verifying your installation,
+but you will also need to add your own contexts. Adding a new context requires two operations:
+</p>
+<p class="section">
+<ol>
+<li>
+Adding the context to Tomcat (I am not going to talk about this).
+</li>
+<li>
+Adding the context to the ISAPI redirector.
+</li>
+</ol>
+</p>
+<p class="section">
+Adding a context to the ISAPI redirector is simple, all you need to do is to edit
+your uriworkermap.properties and to add a line that looks like:
+</p>
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<code class="screen">
+<nobr>/context/*=worker_name</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<p class="section">
+Workers and their name are defined in workers.properties, by default workers.properties comes
+with a single pre-configured worker named <b>
+<font color="#333333">"defworker"</font>
+</b> so you can use it.
+As an example, if you want to add a context named "shop", the line that you should add to
+uriworkermap.properties will be:
+</p>
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<code class="screen">
+<nobr>/shop/*=defworker</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<p class="section">
+A feature is present till Tomcat 3.2, where a uriworkermap.properties-auto is automatically
+written each time Tomcat is started. This file includes settings for each of the contexts that
+Tomcat will serve during its run.
+</p>
+<p class="section">
+Each context has settings to have Tomcat handle servlet and JSP requests,
+but by default static content is left to be served by IIS.
+</p>
+<p class="section">
+Each context also has a commented out setting to have Tomcat handle all requests to the context.
+You can rename this file (so it won't be overwritten the next time Tomcat is started) and
+uncomment this setting or make other customizations.
+</p>
+<p class="section">
+You may also use this file as is in your worker_mount_file setting.
+</p>
+<br/>
+<a name="sub_Advanced Context Configuration">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Advanced Context Configuration</td>
+</tr>
+</table>
+</a>
+<p class="section">
+Sometimes it is better to have IIS serve the static pages (html, gif, jpeg etc.)
+even if these files are part of a context served by Tomcat.
+</p>
+<p class="section">
+For example, consider the html and gif files in the examples context, there is no need
+to serve them from the Tomcat process, IIS will suffice.
+</p>
+<p class="section">
+Making IIS serve static files that are part of the Tomcat contexts requires the following:
+<ol>
+<li>
+Configuring IIS to know about the Tomcat contexts
+</li>
+<li>
+Configuring the redirector to leave the static files for IIS
+</li>
+</ol>
+</p>
+<p class="section">
+Adding a Tomcat context to IIS requires the addition of a new IIS virtual directory that covers the Tomcat context.
+For example adding a /example IIS virtual directory that covers the c:\jakarta-tomcat\webapps\examples directory.
+</p>
+<p class="section">
+Configuring the redirector is somewhat harder, you will need to specify the exact
+URL-Path pattern(s) that you want Tomcat to handle (usually only JSP files and servlets).
+This requires a change to the uriworkermap.properties :
+
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<div class="screen">For the examples context it requires to replace the following line</div>
+<code class="screen">
+<nobr>/examples/*=defworker</nobr>
+</code>
+<br/>
+<div class="screen">with the following two lines</div>
+<code class="screen">
+<nobr>/examples/*.jsp=defworker</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>/examples/servlet/*=defworker</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+</p>
+<p class="section">
+As you can see the second configuration is more explicit, it actually instruct the redirector
+to redirect only requests to resources under /examples/servlet/ and resources under /examples/
+whose name ends with .jsp.
+This is similar to what is automically written to the uriworkermap.properties-auto file for each context.
+</p>
+<p class="section">
+You can even be more explicit and provide lines such as:
+
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<code class="screen">
+<nobr>/example/servletname=defworker</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+</p>
+<p class="section">
+that instructs the redirector to redirect request whose URL-Path equals /example/servletname
+to the worker named defworker.
+</p>
+<br/>
+<a name="sub_Protecting the WEB-INF Directory">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Protecting the WEB-INF Directory</td>
+</tr>
+</table>
+</a>
+<p class="section">
+Each servlet application (context) has a special directory named WEB-INF,
+this directory contains sensitive configurations data and Java classes and must be kept hidden from web users.
+Using the IIS management console it is possible to protect the WEB-INF directory from user access,
+this however requires the administrator to remember that.
+</p>
+<p class="section">
+To avoid this need the redirector plugin automatically protects your WEB-INF directories by rejecting
+any request that contains WEB-INF in its URL-Path.
+</p>
+<br/>
+<a name="sub_Advanced Worker Configuration">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Advanced Worker Configuration</td>
+</tr>
+</table>
+</a>
+<p class="section">
+Sometimes you want to serve different contexts with different Tomcat processes
+(for example to spread the load among different machines).
+To achieve such goal you will need to define several workers and assign each context with its own worker.
+</p>
+<p class="section">
+Defining workers is done in workers.properties, this file includes two types of entries:
+</p>
+<p class="section">
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<div class="screen">An entry that lists all the workers defined</div>
+<code class="screen">
+<nobr>worker.list=worker1, worker2</nobr>
+</code>
+<br/>
+<div class="screen">Entries that define the host and port associated with these workers</div>
+<code class="screen">
+<nobr>worker.worker1.host=localhost</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>worker.worker1.port=8009</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>worker.worker1.type=ajp13</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>worker.worker2.host=otherhost</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>worker.worker2.port=8009</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>worker.worker2.type=ajp13</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+</p>
+<p class="section">
+The above example defined two workers, now we can use these workers to serve two different contexts
+each with its own worker :
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<div class="screen">example uriworkermap.properties fragment</div>
+<code class="screen">
+<nobr>/examples/*=worker1</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>/webpages/*=worker2</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+</p>
+<p class="section">
+As you can see the <b>
+<font color="#333333">examples</font>
+</b> context is served by <b>
+<font color="#333333">worker1</font>
+</b> while the
+<b>
+<font color="#333333">webpages</font>
+</b> context is served by <b>
+<font color="#333333">worker2</font>
+</b>.
+</p>
+<p class="section">
+More informations on using and configuring workers in the <b>
+<a href="../jk/workershowto.html">Workers HowTO</a>
+</b>
+</p>
+<br/>
+<br/>
+<a name="Building ISAPI redirector">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="section" bgcolor="#525D76">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Building ISAPI redirector</td>
+</tr>
+</table>
+</a>
+<p class="section">
+The redirector was developed using Visual C++ Ver.6.0, so having this environment is a prereq if you want
+to perform a custom build. You should also have IIS developer SDK
+
+The steps that you need to take are:
+<ul>
+<li>
+Change directory to the isapi plugins source directory.
+</li>
+<li>
+Make the source with MSDEV
+</li>
+</ul>
+<p class="screendos">
+<div align="center">
+<table bgcolor="#000000" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#000000">
+<div class="screendos">Change directory to the isapi plugins source directory</div>
+<code>
+<nobr>
+<em class="screendos">c:\></em>
+<b class="screendos">cd c:\home\apache\jk\isapi</b>
+</nobr>
+</code>
+<br/>
+<div class="screendos">Build the sources using MSDEV</div>
+<code>
+<nobr>
+<em class="screendos">c:\></em>
+<b class="screendos">MSDEV isapi.dsp /MAKE ALL</b>
+</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+</p>
+<p class="section">
+If msdev is not in your path, enter the full path to msdev.exe.
+This will build both release and debug versions of the redirector plugin.
+An alternative will be to open the isapi workspace file (isapi.dsw) in msdev and
+build it using the build menu.
+</p>
+<br/>
+<a name="Troubleshooting">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="section" bgcolor="#525D76">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Troubleshooting</td>
+</tr>
+</table>
+</a>
+<p class="section">
+It is easy to have the ISAPI redirector not work the first time you try to install it.
+</p>
+<p class="section">
+If this happens to you, here are some steps to follow to try to correct the problem.
+</p>
+<p class="section">
+These steps aren't guaranteed to cover all possible problems,
+but they should help find the typical mistakes.
+</p>
+<p class="section">
+If you make any corrections during these steps, restart the IIS service as described above in the last step
+of the installation, then retry the step.
+</p>
+<p class="section">To enable error tracking, make sure web site activity is being logged.
+For PWS 4.0 make sure "Save Web Site Activity Log" is checked in the Advanced Options of the Personal Web Manager.
+</p>
+<p class="section">
+Note: These steps assume your <b>
+<font color="#333333">worker_mount_file</font>
+</b> setting points to an unmodified copy of the
+<b>
+<font color="#333333">uriworkermap.properties</font>
+</b> file.<br/>
+Results may be misleading if <b>
+<font color="#333333">worker_mount_file</font>
+</b> points to a modified <b>
+<font color="#333333">uriworkermap.properties</font>
+</b>
+or the <b>
+<font color="#333333">uriworkermap.properties-auto</font>
+</b> file.<br/>
+It is also assumed that the <b>
+<font color="#333333">"/examples" context</font>
+</b> works correcly if you access Tomcat directly.
+</p>
+<a name="sub_Win98">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>Win98</td>
+</tr>
+</table>
+</a>
+<p class="section">
+Start the IIS service and Tomcat.
+</p>
+<p class="section">
+Check for the presence of the ISAPI redirector log file you specified in the log_file setting.
+If not found, verify the following:
+</p>
+<ul>
+<li>
+Check the "Filter DLLs" setting in the "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\W3SVC\Parameters"
+key and make sure the path is correct.
+</li>
+<li>
+Check the spelling of the "HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0" key.
+Case isn't important, but an incorrect letter will prevent the isapi_redirect.dll from finding its registry settings.
+</li>
+<li>
+Check the log_file setting for typos, name and data. Also insure the directory in which the log file will appear already exists.
+</li>
+</ul>
+<p class="section">
+Invoke the URL <b>
+<a href="http://localhost/examples/jsp/index.html">http://localhost/examples/jsp/index.html</a>
+</b>
+in your browser.
+Case is important in Tomcat. The characters following "localhost" in the URL must be lower case.
+If the page fails to appear, stop the IIS service (required to view the IIS log file).
+Then examine the last line in the IIS log file in found in SYSTEM/LogFiles/W3SVC1 :
+</p>
+<p class="section">
+If the last line contains:
+</p>
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<code class="screen">
+<nobr>GET "/examples/jsp/index.html HTTP/1.1" 404</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<p class="section">
+then the ISAPI redirector is not recognizing that it should be handling requests for the "/examples" context.
+Check the following:
+</p>
+<ul>
+<li>
+Check the extension_uri name for typos.
+</li>
+<li>
+Check the worker_file setting for typos, name and data.
+</li>
+<li>
+Check the worker_mount_file setting typos, name and data.
+</li>
+</ul>
+<p class="section">If the last line contains something like:
+</p>
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<code class="screen">
+<nobr>GET "/jakarta/isapi_redirect.dll HTTP1.1"</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<p class="section">
+then the ISAPI redirector is recognizing that it should handle the request,
+but is not successful at getting Tomcat to service the request.
+</p>
+<p class="section">
+You should check the HTTP error code following GET "/..." :
+</p>
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<div class="screen">Error 404</div>
+<code class="screen">
+<nobr>GET "/..." 404</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<ul>
+<li>
+Make sure you entered the URL correctly.
+</li>
+<li>
+Make sure the virtual directory created was called "jakarta".
+It should display in Personal Web Manager as "/jakarta" (without the quotes).
+</li>
+<li>
+Make sure the extension_uri data begins with "/jakarta/" (without the quotes).
+</li>
+</ul>
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<div class="screen">Error 500</div>
+<code class="screen">
+<nobr>GET "/..." 500</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<ul>
+<li>
+Make sure that "isapi_redirect.dll" follows "/jakarta/" in the extension_uri setting.
+</li>
+<li>
+Check the workers.properties file and make sure the port setting for worker.ajp12.port is the same as the port specified in the server.xml for the "Apache AJP12 support".
+</li>
+</ul>
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<div class="screen">Error 200 or 403</div>
+<code class="screen">
+<nobr>GET "/..." 200</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>GET "/..." 403</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<ul>
+<li>
+Make sure you have checked Execute Access
+for the jakarta virtual directory in the Advanced Options of the Personal Web Manager.
+</li>
+</ul>
+<p class="section">
+If the above settings are correct, the index.html page should appear in your browser.
+You should also be able to click the Execute links to execute the JSP examples.
+</p>
+<br/>
+<a name="sub_WinNT/Win2K/WinXP">
+<table width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td align="left" valign="top" class="subsection" bgcolor="#828DA6">
+<img border="0" vspace="0" hspace="0" align="left" valign="top" src="../images/corner.gif"/>WinNT/Win2K/WinXP</td>
+</tr>
+</table>
+</a>
+<p class="section">
+Start the World Wide Web Publishing Service and Tomcat.
+</p>
+<p class="section">
+Check for the presence of the ISAPI redirector log file you specified in the log_file setting.
+If not found, check the following:
+</p>
+<ul>
+<li>
+Check the "executable" you set for the filter in the IIS Management Console and make sure the path is correct.
+</li>
+<li>Check the spelling of the "HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0" key.
+Case isn't important, but an incorrect letter will prevent the isapi_redirect.dll from finding its registry settings.
+</li>
+<li>
+Check the log_file setting for typos, name and data. Also insure the directory in which the log file will appear already exists.
+</li>
+</ul>
+<p class="section">
+Check the jakarta filter you added and make sure its status shows a green upward-pointing arrow.
+If not, check the following:
+</p>
+<ul>
+<li>
+Check the worker_file setting for typos, name and data.
+</li>
+<li>
+Check the worker_mount_file setting typos, name and data.
+</li>
+</ul>
+<p class="section">
+Invoke the URL <b>
+<a href="http://localhost/examples/jsp/index.html">http://localhost/examples/jsp/index.html</a>
+</b>
+in your browser. Case is important in Tomcat. The characters following "localhost" in the URL must be lower case.
+If the page fails to appear, examine the last line in the IIS server log file in found in SYSTEM32/LogFiles/W3SVC1.
+</p>
+<p class="section">
+The last line should contain something like: GET "/jakarta/isapi_redirect.dll HTTP1.1",
+which indicates the ISAPI redirector is recognizing that it should handle the request.
+</p>
+<p class="section">
+You should check the HTTP error code following GET "/..." :
+</p>
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<div class="screen">Error 404</div>
+<code class="screen">
+<nobr>GET "/..." 404</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<ul>
+<li>
+Make sure you entered the URL correctly.
+</li>
+</ul>
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<div class="screen">Error 500</div>
+<code class="screen">
+<nobr>GET "/..." 500</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<ul>
+<li>
+Make sure the virtual directory created was called "jakarta".
+</li>
+<li>
+Make sure that the extension_uri setting is correct.
+</li>
+<li>
+Check the workers.properties file and make sure the port setting for worker.ajp12.port is the same as the port specified in the server.xml for the "Apache AJP12 support".
+</li>
+</ul>
+<p class="screen">
+<div align="center">
+<table bgcolor="#cccccc" cellpadding="2" cellspacing="0" border="1" width="80%">
+<tr>
+<td align="left" bgcolor="#cccccc">
+<div class="screen">Error 200 or 403</div>
+<code class="screen">
+<nobr>GET "/..." 200</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>GET "/..." 403</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<ul>
+<li>
+Make sure you have checked Execute Access for the jakarta virtual directory in the
+Advanced Options of the Personal Web Manager.
+</li>
+</ul>
+<p class="section">
+If the above settings are correct, the index.html page should appear in your browser.
+You should also be able to click the Execute links to execute the JSP examples.
+</p>
+<br/>
+<br/>
+</td>
+</tr>
+</table>
+</body>
+</html>
Propchange: tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk/iishowto.html
------------------------------------------------------------------------------
svn:executable = *
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org