billbarker 2004/02/29 16:32:18 Modified: src/doc index.html serverxml.html Added: src/doc readme-3.3.2 Log: Updating the documentation to reflect changes since 3.3.1. Revision Changes Path 1.13 +3 -2 jakarta-tomcat/src/doc/index.html Index: index.html =================================================================== RCS file: /home/cvs/jakarta-tomcat/src/doc/index.html,v retrieving revision 1.12 retrieving revision 1.13 diff -u -r1.12 -r1.13 --- index.html 29 Feb 2004 22:42:50 -0000 1.12 +++ index.html 1 Mar 2004 00:32:18 -0000 1.13 @@ -44,7 +44,8 @@ <ul> <li> <a href="readme">Tomcat 3.3 Release Notes</a></li> -<li> <a href="readme-3.3.1">Tomcat 3.3.1 Release Notes</a><br> </li> +<li> <a href="readme-3.3.1">Tomcat 3.3.1 Release Notes</a></li> +<li> <a href="readme-3.3.2">Tomcat 3.3.2 Release Notes</a><br> </li> <li> Using Tomcat <ul> 1.35 +215 -5 jakarta-tomcat/src/doc/serverxml.html Index: serverxml.html =================================================================== RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v retrieving revision 1.34 retrieving revision 1.35 diff -u -r1.34 -r1.35 --- serverxml.html 29 Feb 2004 22:42:50 -0000 1.34 +++ serverxml.html 1 Mar 2004 00:32:18 -0000 1.35 @@ -276,6 +276,7 @@ </ul></li> <li>Server <ul> + <li><a href="#CoyoteConnector">CoyoteConnector</a></li> <li><a href="#Http10Connector">Http10Connector</a></li> <li><a href="#JniConnector">JniConnector</a></li> <li><a href="#Ajp12Connector">Ajp12Connector</a></li> @@ -1187,6 +1188,206 @@ <hr size="5"> +<h3><a name="CoyoteConnector">CoyoteConnector</a></h3> + +<p><b>Type:</b> Server</p> + +<h4>Description</h4> + +<p>Handles incoming AJP13 and HTTP, or optionally HTTPS, requests. <b>[Tomcat 3.3.2]</b></p> + +<h4>Attributes</h4> + +<table border="1" cellpadding="2" cellspacing="0"> + <tr valign="top"> + <th>Attribute</th> + <th>Description</th> + <th>Default</th> + </tr> + <tr valign="top"> + <td>socketCloseDelay</td> + <td>Specifies the number of milliseconds to delay before closing the socket + after processing a request. If negative, the delay is disabled. Setting + a value greater or equal to zero is intended to help with diagnosing + client errors resulting from unread data in the body of the HTTP request. + If this unread data arrives just before or during the closing of the + socket, the client may see a "Connection aborted by peer" error.</td> + <td>-1</td> + </tr> + <tr valign="top"> + <td>processorClassName</td> + <td>The Coyote processor class to use. The values are + <code>org.apache.coyote.http11.Http11Processor</code> for the HTTP/1.1 + connector, and <code>org.apache.jk.server.JkCoyoteHandler</code> for + the AJP13 connector.</td> + <td>org.apache.coyote.http11.Http11Processor</td> + </tr> + <tr valign="top"> + <td><b>HTTP/1.1 Connection Properties</b></td> + <td> </td> + <td> </td> + </tr> + <tr valign="top"> + <td>disableUploadTimeout</td> + <td>If <code>true</code> then use the same timeout for uploads and for + keep-alives.</td> + <td>true</td> + </tr> + <tr> + <td>maxKeepAliveRequests</td> + <td>The maxiumum number of keep-alive requests to allow on the same + socket connection.</td> + <td>100</td> + </tr> + <tr valign="top"> + <td>secure</td> + <td>Enables use of a SSL socket factory and act as an HTTPS server.</td> + <td>false</td> + </tr> + <tr valign="top"> + <td>keystoreFile</td> + <td>Keystore containing the Server certificate</td> + <td>PureTLS: server.pem<br> + JSSE: .keystore in directory specified by the user.home System property</td> + </tr> + <tr valign="top"> + <td>keypass</td> + <td>Password to the keystore.</td> + <td>changeit</td> + </tr> + <tr valign="top"> + <td>clientauth</td> + <td>Enables requirement for client authentication.</td> + <td>false</td> + </tr> + <tr valign="top"> + <td><b>Socket Properties</b></td> + <td> </td> + <td> </td> + </tr> + <tr valign="top"> + <td>address</td> + <td>Address to which the server socket binds.</td> + <td><i>null, bind on all addresses</i></td> + </tr> + <tr valign="top"> + <td>backlog</td> + <td>Maximum length of the backlog queue for the server socket.</td> + <td>100</td> + </tr> + <tr valign="top"> + <td>port</td> + <td>Port on which to receive requests.</td> + <td><i>no default, must be specified</i></td> + </tr> + <tr valign="top"> + <td>SSLImplementation</td> + <td>Class which implements the + <code>org.apache.tomcat.util.net.SSLImplementation</code> interface. + This setting controls which SSL support is used by secure connections. + Currently supported are:<br> + <ol> + <li>PureTLS - specify + <code>org.apache.tomcat.util.net.PureTLSImplementation</code></li> + <li>JSSE - specify + <code>org.apache.tomcat.util.net.JSSEImplementation</code></li> + </ol></td> + <td><i>not set</i><br> + default behavior will detect PureTLS and JSSE and choose the one + available, or PureTLS if both are available.</td> + </tr> + <tr valign="top"> + <td>timeout</td> + <td>Socket read timeout in seconds.</td> + <td>300</td> + </tr> + <tr valign="top"> + <td><b>Thread Pool Properties</b></td> + <td> </td> + <td> </td> + </tr> + <tr valign="top"> + <td>maxThreads</td> + <td>Maximum number of threads in Thread pool.</td> + <td>200</td> + </tr> + <tr valign="top"> + <td>maxSpareThreads</td> + <td>Maximun number of spare threads. Unused threads will be terminated as + needed to keep the number of spare threads under this number.</td> + <td>50</td> + </tr> + <tr valign="top"> + <td>minSpareThreads</td> + <td>Minimum number of spare threads. Additional threads will be created + as needed to keep the number of spare threads up to this number.</td> + <td>4</td> + </tr> +</table> + +<p><b>Note:</b> You may specify attributes that do +not appear in the list above. These attribute settings will be saved in a list +and made available to the secure socket factory when <code>secure</code> is set +<code>true</code>. Supported attributes are:</p> + +<h4>PureTLS</h4> + +<table border="1" cellpadding="2" cellspacing="0"> + <tr valign="top"> + <th>Attribute</th> + <th>Description</th> + <th>Default</th> + </tr> + <tr> + <td>rootfile</td> + <td>File containing root certificates.</td> + <td>root.pem</td> + </tr> + <tr> + <td>randomfile</td> + <td>File to initialize random number generation.</td> + <td>random.pem</td> + </tr> +</table> + +<h4>JSSE</h4> + +<table border="1" cellpadding="2" cellspacing="0"> + <tr valign="top"> + <th>Attribute</th> + <th>Description</th> + <th>Default</th> + </tr> + <tr> + <td>algorithm</td> + <td>Algorithm used to encode the certificate.</td> + <td>SunX509</td> + </tr> + <tr> + <td>keystoreType</td> + <td>Type of keystore.</td> + <td>JKS</td> + </tr> + <tr> + <td>keystorePass</td> + <td>Password to Keystore file.</td> + <td><i>defaults to keypass setting</i></td> + </tr> + <tr> + <td>protocol</td> + <td>Protocol for the SSL.</td> + <td>TLS</td> + </tr> +</table> + +<h4>Example(s)</h4> + +<pre> +<CoyoteConnector port="8080" timeout="60" /> +</pre> + +<hr size="5"> + <!-- ======================================== --> <h3><a name="Http10Connector">Http10Connector</a></h3> @@ -2175,7 +2376,8 @@ <p>JMX MBeans support has been added to Tomcat 3.3.2, which allow you to manage Tomcat from any JMX console (JRMP) or via a simple browser by the build in HTTP Adaptor</p> -<p>To enable JMX, you should add the <MxInterceptor /> in server.xml</p> +<p>To enable JMX, you should add the optional JmxSupport module to the +$TOMCAT_HOME/modules directory.</p> <p>To also activate the HTTP/JRMP Adaptor you should at least define the port</p> <h4>Attributes</h4> @@ -2770,13 +2972,21 @@ <td><i>not specified</i></td> </tr> <tr valign="top"> - <td>useInternal<br><b>[Tomcat 3.3.2-dev]</b></td> - <td>Controls how to handle welcome pages for URLs ending in "e;/"e;. + <td>useInternal<br><b>[Tomcat 3.3.2]</b></td> + <td>Controls how to handle welcome pages for URLs ending in "/". If <code>true</code>, then the welcome page is served via an internal sub-request. If <code>false</code> than it returns an external redirect to the actual welcome page URL.</td> <td>false</td> </tr> + <tr valign="top"> + <td>strict23Welcome<br><b>[Tomcat 3.3.2]</b></td> + <td>Controls how to handle welcome pages for mapped servlets + If <code>true</code>, then the mapped servlets are checked for a + possible match. If <code>false</code> than only physical files are + checked.</td> + <td>false</td> + </tr> </table> <h4>Example(s)</h4> @@ -2816,7 +3026,7 @@ <h4>Example(s)</h4> <pre> -&tl;TagPoolManagerInterceptor /> +<TagPoolManagerInterceptor /> </pre> <hr size="5"> 1.1 jakarta-tomcat/src/doc/readme-3.3.2 Index: readme-3.3.2 =================================================================== Apache Tomcat 3.3.2 =================== Release Notes ============= $Id: readme-3.3.2,v 1.1 2004/03/01 00:32:18 billbarker Exp $ This document describes the changes that have been made since the release of Tomcat 3.3.1 Final. ========= Bug Fixes ========= The release in which the fix appears is indicated in brackets. Feature Additions: Bug No. Description 8099 Preserve the query string when redirecting to the welcome page. Removed '.sh' extension from Unix shell scripts. (Re-) Open the log files with "append", so that log rotation can be configured to be other than daily. Package an Ant compiler adapter that compiles JSPs with the correct naming convention and an Ant task which creates .ver files. These tasks allow the Tomcat work directory to be pre-populated with compiled JSPs. 13285 Added improvements to the admin web-app to include support for vhosts. Server: Bug No. Description Bug fixed in SimpleSessionStore in session attribute reloading during context reloads. 7770 Fixed thread race problem in accessing the Hooks. 8092 Fixed JSP source exposure proplem. 9165 Fix auto-detection of tomcat.install for certain 1.1.x JDKs. 7654 Make certain that the Context Classloader is set before a servlet class is loaded. This allows JAXP and log4j classes to be created in the constructor of the servlet, instead of in init. Fix problem with multiple Context adds on Context reload under high traffic. Preserve sessions across session reloadings. Fix Cookie case name problem under Windows for Session Cookie. Fix problems with URL normalization when the URL attempts to access a file above the ROOT. Prevent session sharing when switching from HTTPS to HTTP. This removes a way to hijack sensitive sessions. The old behavior can be restored by setting the secureCookie="false" attribute on the SessionId element in server.xml. Fix the handling of response.encodeURL("") to conform to the w3 spec. 15894 Fix race condition on reusing Sessions. Updated DecodeInterceptor to treat URL paths containing null characters as unsafe. Fix problem where the AccessLog was printing the content-length of the Request instead of the Response. 24123 Fix problem where the AccessLog wasn't logging request that produce no output. Also log the Request's content length for PUT requests. Partially update to use commons-logging. Jasper: Bug No. Description 11463 Fix PageContext.removeAttribute(String) to work for a page with session=false. 13378 Fix dependency on GenericServlet in the generated .java file. 23101 Fix case dependency problem on Windows platforms. Fix high byte chars (xlate to unicode) Fix a problem when a jsp include another jsp with relative path. Configuration: Bug No. Description 8634 Allow alternative location for modules.xml Connectors: Bug No. Description Documentation: Bug No. Description
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]