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 [14/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/jk2/installhowto.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/installhowto.html?rev=1305124&view=auto
==============================================================================
--- tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/installhowto.html (added)
+++ tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/installhowto.html Sun Mar 25 20:49:51 2012
@@ -0,0 +1,760 @@
+<!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>Installation of jk2 in the Web Server</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: 2004/08/11 18:06:27 $" name="last-changed"/>
+<meta content="Jean-Frederic Clere" name="author"/>
+<meta content="jfrederic.clere@fujitsu-siemens.com" name="email"/>
+<meta content="Andy Armstrng" name="author"/>
+<meta content="andy@tagish.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 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>
+<td width="10" bgcolor="#cccccc"/>
+<td width="140" bgcolor="#cccccc">
+<a href="#Installation" class="menu">Installation</a>
+</td>
+</tr>
+<tr height="1"/>
+<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>Installation of jk2 in the Web Server</h2>
+</td>
+<td nowrap="true" valign="top" align="right">
+<small>
+<a href="../jk2/printer/installhowto.html">
+<img alt="Printer Friendly Version" border="0" src="../images/printer.gif"/>
+<br/>print-friendly<br/>version
+            </a>
+</small>
+</td>
+</tr>
+</table>
+<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">
+      The actual build mechanism creates the dso files in the
+      build/jk2/${servername} subdirectory of the jakarta-tomcat-connectors/jk.
+      When configure --with-jni is used 2 dso files are created.
+      These files have to be copied in the right location of the web server
+      installation.
+    </p>
+<p class="section">
+      JNI support in JK2 require APR, which is provded in Apache 2.0, and is
+      available for many platforms, so Apache 1.3, IIS and NES/iPlanet should be
+      able to use it
+    </p>
+<a name="sub_Apache 1.3">
+<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"/>Apache 1.3</td>
+</tr>
+</table>
+</a>
+<p class="section">
+        In the following example Apache-1.3 is installed in
+        /home/apache13/ and the commands are executed in
+        the jakarta-tomcat-connectors directory.
+      </p>
+<p class="section">
+        Apache 1.3 require APR, and if APR has been built with pthread support
+        and your Apache 1.3 wasn't (general case in Unix platforms) you should :
+        <ul>
+<li>
+        Rebuild Apache 1.3 with pthread support (recommanded)
+        </li>
+<li>
+        Add the LoadFile /usr/lib/pthread.so in beginning of your httpd.conf
+        </li>
+</ul>
+      </p>
+<p class="section">
+        You should also ensure that the linker will be able to locate the apr shared libraries,
+        <b class="code">libapr.so</b>, and <b class="code">libaprutil.so</b>, make sure they have been installed
+        in linker search locations.
+      </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 the dso files in the modules location:</div>
+<code>
+<nobr>
+<em class="screen">[user@host] ~ $ </em>
+<b class="screen">cp jk/build/jk2/apache13/mod_jk2.so /home/apache13/modules</b>
+</nobr>
+</code>
+<br/>
+<div class="screen">Copy jkjni.so if you're using JNI</div>
+<code>
+<nobr>
+<em class="screen">[user@host] ~ $ </em>
+<b class="screen">cp jk/build/jk2/apache13/jkjni.so /home/apache13/modules</b>
+</nobr>
+</code>
+<br/>
+<div class="screen">You may have to add pthread library in the httpd.conf:</div>
+<code class="screen">
+<nobr>LoadFile /usr/lib/pthread.so</nobr>
+</code>
+<br/>
+<div class="screen">Add mod_jk2 loading in the httpd.conf</div>
+<code class="screen">
+<nobr>LoadModule jk2_module modules/mod_jk2.so</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<br/>
+<a name="sub_Apache 2">
+<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"/>Apache 2</td>
+</tr>
+</table>
+</a>
+<p class="section">
+        In the following example Apache-2.0 is installed in
+        /home/apache20/apache40 and the commands are executed in
+        the jakarta-tomcat-connectors 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 the dso files in the modules location:</div>
+<code>
+<nobr>
+<em class="screen">[user@host] ~ $ </em>
+<b class="screen">cp jk/build/jk2/apache2/mod_jk2.so /home/apache20/apache40/modules</b>
+</nobr>
+</code>
+<br/>
+<div class="screen">Copy jkjni.so if you're using JNI</div>
+<code>
+<nobr>
+<em class="screen">[user@host] ~ $ </em>
+<b class="screen">cp jk/build/jk2/apache2/jkjni.so /home/apache20/apache40/modules</b>
+</nobr>
+</code>
+<br/>
+<div class="screen">Add mod_jk2 loading in the httpd.conf:</div>
+<code class="screen">
+<nobr>LoadModule jk2_module modules/mod_jk2.so</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<br/>
+<a name="sub_IIS">
+<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</td>
+</tr>
+</table>
+</a>
+<p class="section">A pre-built version of the ISAPI redirector server plugin, isapi_redirector2.dll,
+        is available under the win32/i386 directory of jakarta-tomcat-connectors distribution.
+        You can also build a copy locally from the source present in jakarta-tomcat-connectors
+        distribution.<br/>The Tomcat redirector requires three entities:
+            <ul>
+<li>
+            <b>
+<font color="#333333">isapi_redirector2.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">workers2.properties</font>
+</b> - A file that describes the host(s) and port(s) used by the workers (Tomcat processes). 
+                A sample workers2.properties can be found under the conf directory.
+            </li>
+<li>
+            <b>
+<font color="#333333">jk2.properties</font>
+</b> - A configuration file used by mod_jk2 on the Tomcat side.
+            </li>
+</ul>
+        </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\2.0"</font>
+</b>
+            </li>
+<li>
+            Add a string value with the name <b>
+<font color="#333333">serverRoot</font>
+</b> and a value which is a full path
+            to your Tomcat installation (for example <b>
+<font color="#333333">c:\jakarta-tomcat</font>
+</b>).  If Tomcat is installed
+            on a different server, this entry must point to the location (directory) where the
+            workers2.properties file resides.
+            </li>
+<li>
+            Add a string value with the name <b>
+<font color="#333333">extensionUri</font>
+</b> and a value of <b>
+<font color="#333333">/jakarta/isapi_redirector2.dll</font>
+</b>
+            </li>
+<li>
+            Add a string value with the name <b>
+<font color="#333333">workersFile</font>
+</b> and a value which is the full path 
+            to your workers2.properties file (for example <b>
+<font color="#333333">c:\jakarta-tomcat\conf\workers2.properties</font>
+</b>)
+            </li>
+<li>
+            Add a string value with the name <b>
+<font color="#333333">logLevel</font>
+</b> and a value for your log level 
+            (can be DEBUG, INFO or ERROR).
+            </li>
+<li>Using the IIS management console, add a new virtual directory to your IIS web site.
+            The name of the virtual directory must be jakarta. 
+            Its physical path should be the directory where you placed isapi_redirector2.dll 
+            While creating this new virtual directory assign it with execute access.
+            </li>
+<li>
+            Using the IIS management console, add isapi_redirector2.dll as a filter in your IIS web site. 
+            The name of the filter should reflect its task (I use the name jakarta), 
+            its executable must full path to the isapi_redirector2.dll. 
+            </li>
+</ol>        
+        </p>
+<p class="section">Install using provided script <b>
+<font color="#333333">install4iis.js</font>
+</b>
+<br/>
+        This script creates the virtual directory and installs ISAPI filter for Default webserver<br/>
+        
+        <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">Open the command prompt and cd to bin folder</div>
+<code>
+<nobr>
+<em class="screen">[user@host] ~ $ </em>
+<b class="screen">cd C:\Program Files\Apache Software Foundation\Tomcat 5.0\bin</b>
+</nobr>
+</code>
+<br/>
+<div class="screen">Copy the isapi_redirector2.dll and install4iis.js to that folder</div>
+<code>
+<nobr>
+<em class="screen">[user@host] ~ $ </em>
+<b class="screen">cscript install4iis.js</b>
+</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+        </p>
+<p class="section">        
+        You may modify the default installation using various command line options.
+        To see what the options are type <b>
+<font color="#333333">csrcipt install4iis.js -h</font>
+</b>        
+        </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>
+<br/>
+<a name="sub_Lotus 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"/>Lotus Domino</td>
+</tr>
+</table>
+</a>
+<p class="section"/>
+<p class="section">If necessary build dsapi_redirector2.dll as per the instructions in the
+	jk/native2/server/dsapi directory. Copy the DLL into the Domino program
+	directory (this is the directory, which may be called something like
+	C:\Lotus\Domino, that contains a file called nlnotes.exe). 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
+	dsapi_redirector2.reg, 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>Windows Registry Editor Version 5.00</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr/>
+</code>
+<br/>
+<code class="screen">
+<nobr>[HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Dsapi Redirector\2.0]</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>"serverRoot"="D:\\Works\\Tomcat\\jakarta-tomcat-4.1.27"</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>"workersFile"="conf\\workers2.properties"</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>"tomcatStart"="bin\\startup.bat"</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>"tomcatStop"="bin\\shutdown.bat"</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>"tomcatTimeout"="30000"</nobr>
+</code>
+<br/>
+</td>
+</tr>
+</table>
+</div>
+</p>
+<p class="section">Change serverRoot to reflect the location of your Tomcat installation. The
+	other filename parameters can either be relative to serverRoot or absolute
+	paths. Once edited double click on dsapi_redirector2.reg to enter it into the
+	registry.</p>
+<p class="section">
+<b>
+<font color="#333333">Starting Tomcat:</font>
+</b> The last three 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. 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>
+<p class="section">
+<b>
+<font color="#333333">The Workers file:</font>
+</b> If necessary take the sample workers2.properties
+	file from jakarta- tomcat- connectors\jk\conf and place it in the location
+	specified in the registry settings above (typically the conf directory of your
+	Tomcat installation). Edit the file to suit your Tomcat setup.</p>
+<p class="section">
+<b>
+<font color="#333333">Configuring Domino:</font>
+</b> 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 "Public Name
+	and Address Book" or "NAB" for short (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. 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 DSAPI section and the 'DSAPI filter
+	file names' field on the Internet Protocols tab, HTTP sub- tab. Add
+	"dsapi_redirector2.dll" to the DSAPI field, then save and close the
+	document.</p>
+<p class="section">
+<b>
+<font color="#333333">Restart Domino:</font>
+</b> 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. 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. 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>14/11/2003 13:02:18   Attempting to start Tomcat: D:\...\startup.bat</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>Using CATALINA_BASE:   D:\Works\Tomcat\jakarta-tomcat-4.1.27</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>Using CATALINA_HOME:   D:\Works\Tomcat\jakarta-tomcat-4.1.27</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>Using CATALINA_TMPDIR: D:\Works\Tomcat\jakarta-tomcat-4.1.27\temp</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>Using JAVA_HOME:       C:\JBuilder8\jdk1.4</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>14/11/2003 13:02:18   Apache Tomcat Interceptor (Jakarta/DSAPI/2.0.0) loaded</nobr>
+</code>
+<br/>
+<code class="screen">
+<nobr>14/11/2003 13:02:19   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). You should now be able
+	to visit a URL that is handled by Tomcat. Something like</p>
+<p class="section">
+<b class="code">http://name-of-server/servlet/SnoopServlet</b>
+</p>
+<p class="section">may be available, depending on how Tomcat is configured. If that all works
+	you're done.</p>
+<p class="section">
+<b>
+<font color="#333333">Mailing Lists:</font>
+</b> There are two mailing lists dedicated to the Domino
+	Tomcat redirector:</p>
+<p class="section">
+<b>
+<a href="http://nomen.tagish.co.uk/mailman/listinfo/domino-tomcat-l">domino-tomcat-l</a>
+</b>
+</p>
+<p class="section">
+<b>
+<font color="#333333">domino-tomcat-l</font>
+</b> is a general discussion list for issues with the
+	redirector and also wider Tomcat/Domino integration issues such as calling the
+	Domino Java API from a Tomcat servlet. This list is fairly low volume so
+	please subscribe if you're actively using the redirector. If you have an issue
+	with the redirector please post it to the list where it will be seen not only
+	by the author but by other users who may be able to help with any problems.</p>
+<p class="section">
+<b>
+<a href="http://nomen.tagish.co.uk/mailman/listinfo/domino-tomcat-announce-l">domino-tomcat-announce-l</a>
+</b>
+</p>
+<p class="section">
+<b>
+<font color="#333333">domino-tomcat-announce-l</font>
+</b> is for announcements about the Domino Tomcat
+	redirector. Mainly this list will be used for new releases but serious
+	bugs will also be posted to it. This list will be very low volume; not more than
+	a few posts per month. For this reason if you'd like to keep track of new redirector versions
+	please subscribe to this list.</p>
+<br/>
+<br/>
+</td>
+</tr>
+</table>
+</body>
+</html>

Propchange: tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/installhowto.html
------------------------------------------------------------------------------
    svn:executable = *

Added: tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/confighowto.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/confighowto.html?rev=1305124&view=auto
==============================================================================
--- tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/confighowto.html (added)
+++ tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/confighowto.html Sun Mar 25 20:49:51 2012
@@ -0,0 +1,211 @@
+<!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>Quick Start JK2 Configuration Guide</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: 2004/03/04 04:46:34 $" name="last-changed"/>
+<meta content="Mladen Turk" name="author"/>
+<meta content="mturk@mappingsoft.com" 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 class="body" valign="top" width="*" bgcolor="#ffffff">
+<table cellspacing="4" width="100%" border="0">
+<tr>
+<td nowrap="true" valign="top" align="left">
+<h2>Quick Start JK2 Configuration Guide</h2>
+</td>
+<td nowrap="true" valign="top" align="right">
+<img border="0" hspace="0" vspace="0" height="1" width="1" src="../images/void.gif"/>
+</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 describes the configuration files used by JK2 on the
+  Tomcat and Web Server side:
+    <ul>
+<li>
+    <b>
+<font color="#333333">jk2.properties</font>
+</b> is used on the Tomcat side. It's installation path in
+    the $TOMCAT_HOME/conf directory.
+    </li>
+<li>
+    <b>
+<font color="#333333">workers2.properties</font>
+</b> is used on the webserver side. For the Apache
+    servers the default path is in the ServerRoot/conf directory.
+    </li>
+</ul>    
+  Although JK2 has many things in common with mod_jk, the configuration is quite
+  different, and all the directives should be inside the workers2.properties.
+  This enables JK2 to have the same configuration file no mater what the web server
+  it's connected to.
+</p>
+<br/>
+<a name="Minimum Configuration">
+<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"/>Minimum Configuration</td>
+</tr>
+</table>
+</a>
+<p class="section">
+    Minimum configuration is the simplest one to make the JK2 working. The used
+    channel will be socket, and lot of options are used by default. Both the
+    Tomcat and web server are on the same computer.
+</p>
+<p class="section">
+jk2.properties:
+<pre class="section">
+# The default port is 8009 but you can use another one
+# channelSocket.port=8019
+</pre>
+That is all needed on the Tomcat side to configure the JK2.
+</p>
+<p class="section">
+workers2.properties:
+<pre class="section">
+# Define the communication channel 
+[channel.socket:localhost:8009]
+info=Ajp13 forwarding over socket
+tomcatId=localhost:8009
+
+# Map the Tomcat examples webapp to the Web server uri space
+[uri:/examples/*]
+info=Map the whole webapp
+</pre>
+</p>
+<p class="section">
+Start the Tomcat and Web server and browse to the <b>
+<a href="../">http://localhost/examples/</a>
+</b>
+</p>
+<br/>
+<a name="Minimum JNI Configuration">
+<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"/>Minimum JNI Configuration</td>
+</tr>
+</table>
+</a>
+<p class="section">
+    Minimum JNI configuration is the simplest one to make the Tomcat working
+    from inside the web server as inprocess. The only comunication channel used
+    is JNI. The JK2 will register all the native calls by itself, so there is
+    no need to specify the native library on Java side.
+</p>
+<p class="section">
+jk2.properties:
+<pre class="section">
+# Add the apr and channelJni to the list of handlers
+handler.list=apr,request,container,channelJni
+# The native libraries will be registered by JK2
+apr.jniModeSo=inprocess
+</pre>
+</p>
+<p class="section">
+workers2.properties:
+<pre class="section">
+# Define the comunication channel 
+[channel.jni:jni]
+info=The jni channel, used if tomcat is started inprocess
+
+# Define the parameters for the Java Virtual Machine
+[vm:]
+info=Parameters used to load a JVM in the server process
+OPT=-Djava.class.path=${TOMCAT_HOME}/lib/tomcat-jni.jar;${TOMCAT_HOME}/lib/tomcat.jar
+OPT=-Dtomcat.home=${TOMCAT_HOME}
+OPT=-Dcatalina.home=${TOMCAT_HOME}
+OPT=-Xmx128M
+
+# JNI worker startup handler
+[worker.jni:onStartup]
+info=Command to be executed by the VM on startup. This one will start tomcat.
+class=org/apache/jk/apr/TomcatStarter
+ARG=start
+stdout=${serverRoot}/logs/stdout.log
+stderr=${serverRoot}/logs/stderr.log
+
+# JNI worker shutdown handler
+[worker.jni:onShutdown]
+info=Command to be executed by the VM on shutdown. This one will stop tomcat.
+class=org/apache/jk/apr/TomcatStarter
+ARG=stop
+
+# Map the Tomcat examples webapp to the Web server uri space
+[uri:/examples/*]
+info=Map the whole webapp
+</pre>
+</p>
+<p class="section">
+Start the Web server and browse to the <b>
+<a href="../">http://localhost/examples/</a>
+</b>
+</p>
+<br/>
+</td>
+</tr>
+</table>
+</body>
+</html>

Propchange: tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/confighowto.html
------------------------------------------------------------------------------
    svn:executable = *

Added: tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configtc.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configtc.html?rev=1305124&view=auto
==============================================================================
--- tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configtc.html (added)
+++ tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configtc.html Sun Mar 25 20:49:51 2012
@@ -0,0 +1,133 @@
+<!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>Configuration options</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: 2004/03/04 04:46:34 $" name="last-changed"/>
+<meta content="Jean-Frederic Clere" name="author"/>
+<meta content="jfrederic.clere@fujitsu-siemens.com" 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 class="body" valign="top" width="*" bgcolor="#ffffff">
+<table cellspacing="4" width="100%" border="0">
+<tr>
+<td nowrap="true" valign="top" align="left">
+<h2>Configuration options</h2>
+</td>
+<td nowrap="true" valign="top" align="right">
+<img border="0" hspace="0" vspace="0" height="1" width="1" src="../images/void.gif"/>
+</td>
+</tr>
+</table>
+<a name="Intro">
+<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"/>Intro</td>
+</tr>
+</table>
+</a>
+<p class="section">
+  This document describes the configuration file used by mod_jk2 on the
+  Tomcat site. Its default name is ${jkHome}/conf/jk2.properties,
+  where ${jkHome} is the well known ${catalina.base} property.
+</p>
+<br/>
+<a name="Config File Format">
+<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"/>Config File Format</td>
+</tr>
+</table>
+</a>
+<p class="section"> settings are specified in the following format:
+	<pre class="section">
+	handler.propertie=value
+	</pre>
+	</p>
+<br/>
+<a name="Generic properties">
+<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"/>Generic properties</td>
+</tr>
+</table>
+</a>
+<p class="section">
+			<table border="0">
+<tr>
+<td align="middle" valign="top" bgcolor="#039acc">Property name</td>
+<td align="middle" valign="top" bgcolor="#039acc">Default</td>
+<td align="middle" valign="top" bgcolor="#039acc">Description</td>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">handler.list</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">request,container,channelSocket</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">Handlers to load.</td>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">class.myhandler</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">No default value</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">Define the class of the handler myhandler.</td>
+</tr>
+</table>
+		</p>
+<br/>
+</td>
+</tr>
+</table>
+</body>
+</html>

Propchange: tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configtc.html
------------------------------------------------------------------------------
    svn:executable = *

Added: tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configtccom.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configtccom.html?rev=1305124&view=auto
==============================================================================
--- tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configtccom.html (added)
+++ tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configtccom.html Sun Mar 25 20:49:51 2012
@@ -0,0 +1,437 @@
+<!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>Coyote/JK2 Handlers</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: 2004/03/04 04:46:34 $" name="last-changed"/>
+<meta content="Jean-Frederic Clere" name="author"/>
+<meta content="jfrederic.clere@fujitsu-siemens.com" 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 class="body" valign="top" width="*" bgcolor="#ffffff">
+<table cellspacing="4" width="100%" border="0">
+<tr>
+<td nowrap="true" valign="top" align="left">
+<h2>Coyote/JK2 Handlers</h2>
+</td>
+<td nowrap="true" valign="top" align="right">
+<img border="0" hspace="0" vspace="0" height="1" width="1" src="../images/void.gif"/>
+</td>
+</tr>
+</table>
+<a name="apr">
+<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"/>apr</td>
+</tr>
+</table>
+</a>
+<p class="section">
+APR descriptor
+</p>
+<p class="section">
+			<table border="0">
+<tr>
+<td align="middle" valign="top" bgcolor="#039acc">Property name</td>
+<td align="middle" valign="top" bgcolor="#039acc">Default</td>
+<td align="middle" valign="top" bgcolor="#039acc">Description</td>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">NativeSo</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">jkjni</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">
+    Location of the jkjni dynamic library.
+    It is searched in java.library.path but a absolute path can be specified.
+  </td>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">jniModeSo</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">inprocess</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">
+    If set to "inprocess" the jk2 will regiter native library functions by itself.
+	If not then it has to be the absolute path of the jkjni dynamic library.
+  </td>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">baseDir</td>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">aprHome</td>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">soExt</td>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+</tr>
+</table>
+		</p>
+<br/>
+<a name="channelSocket">
+<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"/>channelSocket</td>
+</tr>
+</table>
+</a>
+<p class="section">
+					A communication transport from a remote Web Server.
+</p>
+<p class="section">
+			<table border="0">
+<tr>
+<td align="middle" valign="top" bgcolor="#039acc">Property name</td>
+<td align="middle" valign="top" bgcolor="#039acc">Default</td>
+<td align="middle" valign="top" bgcolor="#039acc">Description</td>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">port</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">8009</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">First port where Tomcat is listening</td>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">address</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">127.0.0.1</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">Local address where Tomcat is listening.</td>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">maxPort</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">port+10</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">Max port used to listen.</td>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">maxThreads</td>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">backLog</td>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">tcpNoDelay</td>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">soTimeout</td>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">soLinger</td>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">serverTimeout</td>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+</tr>
+</table>
+		</p>
+<br/>
+<a name="channelUnix">
+<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"/>channelUnix</td>
+</tr>
+</table>
+</a>
+<p class="section">	A AF_UNIX socket communication transport from a local Web Server.</p>
+<p class="section">
+			<table border="0">
+<tr>
+<td align="middle" valign="top" bgcolor="#039acc">Property name</td>
+<td align="middle" valign="top" bgcolor="#039acc">Default</td>
+<td align="middle" valign="top" bgcolor="#039acc">Description</td>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">file</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">No default value</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">
+    Name of the "file" associate with the socket.
+    That must be absolut path name.
+  </td>
+</tr>
+</table>
+		</p>
+<br/>
+<a name="channelJni">
+<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"/>channelJni</td>
+</tr>
+</table>
+</a>
+<p class="section">A in Web Server process communication.</p>
+<p class="section">
+			<table border="0">
+<tr>
+<td align="middle" valign="top" bgcolor="#039acc">Property name</td>
+<td align="middle" valign="top" bgcolor="#039acc">Default</td>
+<td align="middle" valign="top" bgcolor="#039acc">Description</td>
+</tr>
+</table>
+		</p>
+<br/>
+<a name="mx">
+<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"/>mx</td>
+</tr>
+</table>
+</a>
+<p class="section">mx4j adapter.</p>
+<p class="section">
+			<table border="0">
+<tr>
+<td align="middle" valign="top" bgcolor="#039acc">Property name</td>
+<td align="middle" valign="top" bgcolor="#039acc">Default</td>
+<td align="middle" valign="top" bgcolor="#039acc">Description</td>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">port</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">-1 (Disabled)</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">Port Number.</td>
+</tr>
+</table>
+		</p>
+<br/>
+<a name="shm">
+<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"/>shm</td>
+</tr>
+</table>
+</a>
+<p class="section">				shared memory objects handler.</p>
+<p class="section">
+			<table border="0">
+<tr>
+<td align="middle" valign="top" bgcolor="#039acc">Property name</td>
+<td align="middle" valign="top" bgcolor="#039acc">Default</td>
+<td align="middle" valign="top" bgcolor="#039acc">Description</td>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">file</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">/tmp/shm.file</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">Shared memory file.</td>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">host</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">localhost</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">Host name.</td>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">port</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">8009</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">Port number.</td>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">unixSocket</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">No default value</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">Unix socket where tomcat is listening.</td>
+</tr>
+</table>
+		</p>
+<br/>
+<a name="request">
+<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"/>request</td>
+</tr>
+</table>
+</a>
+<p class="section">Request handler</p>
+<p class="section">
+			<table border="0">
+<tr>
+<td align="middle" valign="top" bgcolor="#039acc">Property name</td>
+<td align="middle" valign="top" bgcolor="#039acc">Default</td>
+<td align="middle" valign="top" bgcolor="#039acc">Description</td>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">tomcatAuthentication</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">true</td>
+<td align="left" valign="top" bgcolor="#a0ddf0">the request handler will get the authenticated user from the HTTP server, honoring any auth done there.</td>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">ajpidDir</td>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">decodedUri</td>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">secret</td>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">useSecret</td>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+</tr>
+</table>
+		</p>
+<br/>
+<a name="modeler">
+<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"/>modeler</td>
+</tr>
+</table>
+</a>
+<p class="section">????</p>
+<p class="section">
+			<table border="0">
+<tr>
+<td align="middle" valign="top" bgcolor="#039acc">Property name</td>
+<td align="middle" valign="top" bgcolor="#039acc">Default</td>
+<td align="middle" valign="top" bgcolor="#039acc">Description</td>
+</tr>
+<tr/>
+</table>
+		</p>
+<br/>
+<a name="container">
+<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"/>container</td>
+</tr>
+</table>
+</a>
+<p class="section">????</p>
+<p class="section">
+			<table border="0">
+<tr>
+<td align="middle" valign="top" bgcolor="#039acc">Property name</td>
+<td align="middle" valign="top" bgcolor="#039acc">Default</td>
+<td align="middle" valign="top" bgcolor="#039acc">Description</td>
+</tr>
+<tr/>
+</table>
+		</p>
+<br/>
+<a name="modjk">
+<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"/>modjk</td>
+</tr>
+</table>
+</a>
+<p class="section">????</p>
+<p class="section">
+			<table border="0">
+<tr>
+<td align="middle" valign="top" bgcolor="#039acc">Property name</td>
+<td align="middle" valign="top" bgcolor="#039acc">Default</td>
+<td align="middle" valign="top" bgcolor="#039acc">Description</td>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">pass</td>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">statusPath</td>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">updateInterval</td>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">user</td>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">webServerHost</td>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+</tr>
+<tr>
+<td align="left" valign="top" bgcolor="#a0ddf0">webServerPort</td>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+<td align="left" valign="top" bgcolor="#a0ddf0"/>
+</tr>
+</table>
+		</p>
+<br/>
+</td>
+</tr>
+</table>
+</body>
+</html>

Propchange: tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configtccom.html
------------------------------------------------------------------------------
    svn:executable = *

Added: tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configtcex.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configtcex.html?rev=1305124&view=auto
==============================================================================
--- tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configtcex.html (added)
+++ tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configtcex.html Sun Mar 25 20:49:51 2012
@@ -0,0 +1,200 @@
+<!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>Examples</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: 2004/03/04 04:46:34 $" name="last-changed"/>
+<meta content="Jean-Frederic Clere" name="author"/>
+<meta content="jfrederic.clere@fujitsu-siemens.com" 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 class="body" valign="top" width="*" bgcolor="#ffffff">
+<table cellspacing="4" width="100%" border="0">
+<tr>
+<td nowrap="true" valign="top" align="left">
+<h2>Examples</h2>
+</td>
+<td nowrap="true" valign="top" align="right">
+<img border="0" hspace="0" vspace="0" height="1" width="1" src="../images/void.gif"/>
+</td>
+</tr>
+</table>
+<a name="jk2.properties">
+<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"/>jk2.properties</td>
+</tr>
+</table>
+</a>
+<p class="section">
+The examples below are working when the Web Server is configured according the 
+examples described in the configweb file.
+</p>
+<a name="sub_using normal socket">
+<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"/>using normal socket</td>
+</tr>
+</table>
+</a>
+<p class="section">
+There is no need to use the jkjni logic to use normal socket, so that just for
+Fun.
+</p>
+<p class="section">
+<pre class="section">
+# list of needed handlers.
+handler.list=apr,channelSocket,request
+
+# Override the default port for the channelSocket
+channelSocket.port=8019
+
+# Dynamic library
+apr.NativeSo=/home1/jakarta/jakarta-tomcat-connectors/jk/build/jk2/apache2/jkjni.so
+</pre>
+</p>
+<br/>
+<a name="sub_using AF_UNIX socket">
+<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"/>using AF_UNIX socket</td>
+</tr>
+</table>
+</a>
+<p class="section">
+Create and listen on a AF_UNIX socket. The location of the socket must be the
+same in the Web Server configuration file.
+</p>
+<p class="section">
+<pre class="section">
+# list of needed handlers.
+handler.list=apr,channelUnix,request
+
+# Location of the socket.
+channelUnix.file=${jkHome}/work/jk2.socket
+
+# Dynamic library
+jtc=/home1/jakarta/jakarta-tomcat-connectors
+apr.NativeSo=${jtc}/jk/build/jk2/apache2/jkjni.so
+</pre>
+</p>
+<br/>
+<a name="sub_using user defined class for communication">
+<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"/>using user defined class for communication</td>
+</tr>
+</table>
+</a>
+<p class="section">
+It is possible to have a user defined class for the communication.
+Here we have used the ChannelUn as example.
+</p>
+<p class="section">
+<pre class="section">
+# Define our own handler.
+class.mychannel=org.apache.jk.common.ChannelUn
+# list of needed handlers.
+handler.list=apr,mychannel,request
+
+# Location of the socket.
+channelUnix.file=${jkHome}/work/jk2.socket
+
+# Dynamic library
+jtc=/home1/jakarta/jakarta-tomcat-connectors
+apr.NativeSo=${jtc}/jk/build/jk2/apache2/jkjni.so
+</pre>
+</p>
+<br/>
+<a name="sub_using jni channel class for communication">
+<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"/>using jni channel class for communication</td>
+</tr>
+</table>
+</a>
+<p class="section">
+Here we have the minimum configuration needed for the jni communication.
+</p>
+<p class="section">
+<pre class="section">
+# list of needed handlers.
+handler.list=apr,request,channelJni
+
+# Dynamic library needs to be defined only if Tomcat is used
+# out of process
+jtc=/home1/jakarta/jakarta-tomcat-connectors
+apr.NativeSo=${jtc}/jk/build/jk2/apache2/jkjni.so
+# Or you can use the mod_jk2 directly
+apr.jniModeSo=/opt/apache2/modules/mod_jk2.so
+
+# If you wish to start the Tomcat from inside web server then
+# you don't need any above directive. Here is shown the default
+# value for the apr that you can ommit
+apr.jniModeSo=inprocess
+
+</pre>
+</p>
+<br/>
+<br/>
+</td>
+</tr>
+</table>
+</body>
+</html>

Propchange: tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configtcex.html
------------------------------------------------------------------------------
    svn:executable = *

Added: tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configweb.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configweb.html?rev=1305124&view=auto
==============================================================================
--- tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configweb.html (added)
+++ tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configweb.html Sun Mar 25 20:49:51 2012
@@ -0,0 +1,256 @@
+<!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>Configuration file</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: 2004/03/04 04:46:34 $" name="last-changed"/>
+<meta content="Costin Manolache" name="author"/>
+<meta content="cmanolache@yahoo.com" name="email"/>
+<meta content="Jean-Frederic Clere" name="author"/>
+<meta content="jfrederic.clere@fujitsu-siemens.com" 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 class="body" valign="top" width="*" bgcolor="#ffffff">
+<table cellspacing="4" width="100%" border="0">
+<tr>
+<td nowrap="true" valign="top" align="left">
+<h2>Configuration file</h2>
+</td>
+<td nowrap="true" valign="top" align="right">
+<img border="0" hspace="0" vspace="0" height="1" width="1" src="../images/void.gif"/>
+</td>
+</tr>
+</table>
+<a name="Intro">
+<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"/>Intro</td>
+</tr>
+</table>
+</a>
+<p class="section">Jk2 uses an architecture and configuration mechanism modeled after JMX. It consist of 
+"jk_bean" components, with a registry and API that attempts to mirror JMX.</p>
+<p class="section">As in JMX, multiple config formats and stores are possible. The default is a neutral .INI-style 
+file, and Apache2 also supports configuration in httpd.conf. Other formats and repositories can be
+easily implemented, but the general concept is the same.</p>
+<p class="section">Each component has a name, a type and a set of attributes. Reasonable defaults are provided, and 
+some components are created automatically using the defaults if not explicitely configured. 
+You need to specify the config only where you want to override the defaults.</p>
+<br/>
+<a name="Config file format">
+<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"/>Config file format</td>
+</tr>
+</table>
+</a>
+<p class="section">The config file is named "workers2.properties", located by default in ${serverRoot}/conf, 
+where ${serverRoot} is the web server dir, like /usr/local/apache. It is possible to modify the location
+of the file using server-specific directives.</p>
+<p class="section">Settings are grouped in sections - one section for each object. The section head is the component
+name, and must include the type and local name of the component, separated by ":". Inside each section
+you must define the attributes of the component. The attribute name is a simple string, with no '.' or
+special characters. The value is a string - no quoting is currently supported. It should be noted that
+the component name is processed to compute default for the component attributes - for example 
+[channel.socket:localhost:8009] name will create a socket channel object with host=locahost and 
+port=8009. You don't need to provide this information twice. It is highly recommended to use
+this naming scheme for consistency, even if you could use any name and then specify the properties
+explicitely.</p>
+<p class="section">The general syntax is:
+            <pre class="section">
+                [TYPE:NAME]
+                PROPERTY=VALUE
+            </pre>
+        </p>
+<p class="section">It is also possible to use an alternate format, mostly for backward compatibility:
+            <pre class="section">
+                TYPE:NAME.PROPERTY=VALUE 
+            </pre>
+        </p>
+<br/>
+<a name="Runtime reconfiguration">
+<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"/>Runtime reconfiguration</td>
+</tr>
+</table>
+</a>
+<p class="section">The main purpose of this reconfiguration is to implement "graceful" shutdown and 
+to allow adding or disabling of more tomcat instances in the load balancing mode</p>
+<p class="section">Each component has a "ver" attribute - it is initially set to the value in the 
+config file or 0 if this is not specified. Every time the config file is read, jk will 
+check the version number in the component, and reconfigure if it is different.</p>
+<p class="section">If Jk2 reloads the config file, it detect modified components using "ver" and reconfigures them.
+To avoid performance hits, the check is done only when the /jkstatus page is accessed - or 
+if the scoreboard signature changes. An access to /jkstatus will check the timestamp of the 
+config file and if a change is detected it'll reload the config file. In apache and multiprocess
+servers - this can only affect the current process, so /jkstatus will increment the scoreboard mark.
+All other processes in a multiprocess server will see the modified byte and reload before serving the next request.</p>
+<p class="section">Changing the file and forcing a reload is currently the easiest way to reconfigure. A JMX proxy 
+is in experimental stage and will allow the user to perform all configuration in JMX - using same 
+tools that he uses for tomcat, and completely transparent. The internal implementation will also
+save the file - it is the cleanest way to sync multi-process web servers.
+</p>
+<br/>
+<a name="Changing 'graceful' stop state">
+<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"/>Changing 'graceful' stop state</td>
+</tr>
+</table>
+</a>
+<p class="section">Each tomcat instance corresponds to a "channel" jk component that defines the host and port. The 
+channel can be set in a special "graceful" mode or back to active by setting the corresponding attribute.
+This mode disables sending any new requests to that tomcat instance - only requests for
+an existing session are permitted.</p>
+<p class="section">When you want to disable a tomcat instance, you should first set the channel in
+"graceful" mode, then wait until all existing sessions expire or are completed. If the sessions
+are serializable and tomcat is configured in clustering mode - you can also migrate the 
+sessions to a different instance.</p>
+<p class="section">1. Edit workers2.properties. Find the channel. Change "graceful" to "1" to disable or "0"
+        to reactivate". Increment "ver".<br/>
+      2. Access /jkstatus page. You should see the value changed in the channel and worker info.</p>
+<p class="section">When a worker is in this state, no new requests will be sent to that worker - only requests that have an 
+explicit session ID for that particular worker. It is recommended you wait for all sessions to expire 
+before stopping the tomcat instance, or you use a session migration mechanism.
+</p>
+<br/>
+<a name="Adding a new tomcat instance">
+<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"/>Adding a new tomcat instance</td>
+</tr>
+</table>
+</a>
+<p class="section">1. Edit workers2.properties. Add a new channel. If you want, also add a worker.ajp entry - 
+but this is optional</p>
+<p class="section">2. Access the /jkstatus page or triger reloading with a program. You should see the 
+new channel displayed in the status page, and requests should start going to the new tomcat instance</p>
+<br/>
+<a name="Advanced: reconfiguration using JMX">
+<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"/>Advanced: reconfiguration using JMX</td>
+</tr>
+</table>
+</a>
+<p class="section">This is very experimental. On tomcat side, you must enable the JMX proxy. This is done by
+setting "modjk.webServerHost" and "modjk.webServerPort" in jk2.properties to point to the web server 
+port that contains /jkstatus. ( recent versions of jk and mod_jk are required ). You can also add mx4j-tools.jar to 
+server/lib and set "mx.enable=true" in jk2.properties to enable the console, or use your favorite JMX
+console or tools. You could also select http and/or jrmp protocol, with mx.httpPort, mx.httpHost, mxjrmpPort
+and mx.jrmpPort</p>
+<p class="section">When tomcat starts up, it'll connect to the web server and create JMX mbean proxies for each
+mod_jk component. The data will be refreshed when JMX operations are performed - a set or invoke will
+allways refresh, while get will use cached values and refresh only periodically ( 5 sec default ).</p>
+<p class="section">Every time  a change is made, the config file will be written ( for persistence and to allow other 
+processes to get the same change ). The scoreboard will be changed, and then all other server processes will 
+act just like in the case of a file change. All comments will be lost - you should use "info" attributes
+in components and set "disabled" to 1 if you want to temporary disable some components.</p>
+<br/>
+<a name="Native server configuration">
+<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"/>Native server configuration</td>
+</tr>
+</table>
+</a>
+<p class="section">For Apache2 you can also use httpd.conf instead or in addition to workers2.properties.
+Other servers may support similar configuration - for example using registry or their native
+formats. This configuration mode is less tested - but provides some
+unique advantages (and disadvantages )</p>
+<p class="section">I'll describe the apache2 specifics, since this is the only one implemented. We use 2 directives - JkSet
+is a top-level directive is used to set global config options, and JkUriSet is used to set options
+ for Location sections</p>
+<p class="section">JkSet takes 2 parameters, the property name ( including component name ) and the value. (Note:
+probably we should change it to 3 params, and separate the component name from property )</p>
+<p class="section">Each Location that has a JkUriSet will automatically create a jk2 [uri] object,
+using the Location path and the vhost. All JkUriSet directives will set attributes
+in this [uri] object, exactly like properties in a ini file section</p>
+<p class="section">You can mix workers2.properties and JkUriSet - for example workers and global options
+can be set in worker2.properties, but all uri properties in httpd.conf. Some people 
+might preffer to have only one config file and use httpd.conf for all configuration.</p>
+<p class="section">The biggest benefit is that Apache2 mapping is used instead of jk2 to detect the
+requests that need to be sent to tomcat. Apache2 has been optimized and tuned to
+server huge number of servers and uris - if you have only few the diference may be
+hard to notice. Some people preffer to use the httpd.conf format and some tools 
+could be better used in this mode.</p>
+<p class="section">One major problem is that reconfiguration is not supported if httpd.conf is used. 
+You can still enable/disable/add workers if you use workers2.properties, and 
+you could add or change uri properties in that file. </p>
+<br/>
+<a name="Config generators">
+<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"/>Config generators</td>
+</tr>
+</table>
+</a>
+<p class="section">There is work in progress to support automatic generation of the config file. The code is
+included in org.apache.jk.config and consist of a number of ant tasks ( that work from CLI as well)
+ that process web.xml files and generate worker2.properties or server-specific config files</p>
+<br/>
+</td>
+</tr>
+</table>
+</body>
+</html>

Propchange: tomcat/site/trunk/docs/connectors-doc-archive/jk2/jk2/printer/configweb.html
------------------------------------------------------------------------------
    svn:executable = *



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org