larryi 01/09/17 20:28:27
Modified: src/doc tomcat-ug.html
Log:
Add a table containing the default server.xml and info that is partially
filled in.
Revision Changes Path
1.15 +178 -2 jakarta-tomcat/src/doc/tomcat-ug.html
Index: tomcat-ug.html
===================================================================
RCS file: /home/cvs/jakarta-tomcat/src/doc/tomcat-ug.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- tomcat-ug.html 2001/09/03 12:42:09 1.14
+++ tomcat-ug.html 2001/09/18 03:28:27 1.15
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
- <!-- $Id: tomcat-ug.html,v 1.14 2001/09/03 12:42:09 larryi Exp $ -->
+ <!-- $Id: tomcat-ug.html,v 1.15 2001/09/18 03:28:27 larryi Exp $ -->
<!-- Copyright 1999-2001 Apache Software Foundation -->
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" type="text/css" href="style.css">
@@ -805,7 +805,7 @@
</table>
<p>Additionally you can, or Tomcat will, create the following
-directories:</p>\
+directories:</p>
<table border="1" width="75%" VALIGN="center">
<tr>
@@ -990,9 +990,185 @@
<p><i>This section will describe the default configuration supplied with Tomcat
3.3</i></p>
+<table border="1">
+ <tr><th>Module Entry</th><th>Status</th><th>Description</th></tr>
+ <tr><td><<a href="serverxml.html#LoaderInterceptor11">LoaderInterceptor11</a>
+ useApplicationLoader="true" /></td><td> </td>
+ <td> </td></tr>
+ <tr><td><<a href="serverxml.html#TrustedLoader">TrustedLoader</a> /></td>
+ <td> </td>
+ <td>Provides special handling for "trusted" contexts which have
+ a <code>interceptors.xml</code> file in their <code>WEB-INF</code>
+ directory.</td></tr>
+ <tr><td><<a href="serverxml.html#LogSetter">LogSetter</a>
+ name="tc_log" timestamps="true"<br>
+ verbosityLevel="INFORMATION"
/></td><td> </td>
+ <td>Sets up Tomcat's log output channel. In the absence of a <code>path</code>
+ setting, output goes to <code>stderr</code>.</td></tr>
+ <tr><td><<a href="serverxml.html#LogEvents">LogEvents</a> enabled="false"
/></td><td> </td>
+ <td> </td></tr>
+ <tr><td><<a href="serverxml.html#ContextXmlReader">ContextXmlReader</a>
+ config="conf/server.xml" /></td><td> </td>
+ <td>Reads context definitions from the <code>server.xml</code> file for
+ backwards compatibility. This may be removed if you don't put
+ context definitions in your <code>server.xml</code> file.</td></tr>
+ <tr><td><<a href="serverxml.html#ContextXmlReader">ContextXmlReader</a>
+ config="conf/apps.xml" /></td><td> </td>
+ <td>Reads context definitions from the <code>conf/apps.xml</code> file
+ and any files matching the pattern <code>apps-*.xml</code> in the
+ <code>conf</code> directory.</td></tr>
+ <tr><td><<a href="serverxml.html#AutoDeploy">AutoDeploy</a>
+ source="modules" target="modules"
+ redeploy="true" /></td><td> </td>
+ <td>Expands ".war" files in the <code>modules</code>
directory.</td></tr>
+ <tr><td><<a href="serverxml.html#AutoWebApp">AutoWebApp</a>
+ dir="modules" host="DEFAULT"
trusted="true"/></td><td> </td>
+ <td>Auto-creates contexts for subdirectories in the <code>modules</code>
+ directory. These contexts are defaulted to "trusted".</td></tr>
+ <tr><td><<a href="serverxml.html#AutoDeploy">AutoDeploy</a>
+ source="webapps" target="webapps" /></td><td> </td>
+ <td>Expands ".war" files in the <code>webapps</code>
directory.</td></tr>
+ <tr><td><<a href="serverxml.html#AutoWebApp">AutoWebApp</a>
+ dir="webapps" host="DEFAULT" /></td><td> </td>
+ <td>Auto-creates contexts for the subdirectories in the <code>webapps</code>
+ directory.</td></tr>
+ <tr><td><<a href="serverxml.html#PolicyLoader">PolicyLoader</a><br>
+
securityManagerClass="java.lang.SecurityManager"<br>
+ policyFile="conf/tomcat.policy"
/></td><td> </td>
+ <td>Sets a policy file and security manager if "sandbox" is
+ specified on the command line without also specifying a policy file
+ on the command line.</td></tr>
+ <tr><td><<a href="serverxml.html#SimpleMapper1">SimpleMapper1</a>
/></td><td> </td>
+ <td>Handles the mapping of requests to contexts.</td></tr>
+ <tr><td><<a href="serverxml.html#SessionExpirer">SessionExpirer</a>
+ checkInterval="60" /></td><td> </td>
+ <td>Handles the destruction of sessions after they expire.</td></tr>
+ <tr><td><<a href="serverxml.html#SessionIdGenerator">SessionIdGenerator</a><br>
+
randomClass="java.security.SecureRandom"<br>
+ randomFile="/dev/urandom"
/></td><td> </td>
+ <td>Generates session ID's for requests that need a new session.</td></tr>
+ <tr><td><<a href="serverxml.html#LogSetter">LogSetter</a>
+ name="servlet_log"<br>
+ timestamps="true"<br>
+ verbosityLevel = "INFORMATION"<br>
+ path="logs/servlet-${yyyyMMdd}.log"
+ /></td><td> </td>
+ <td>Sets up the "servlet" log output channel.</td></tr>
+ <tr><td><<a href="serverxml.html#LogSetter">LogSetter</a>
+ name="JASPER_LOG"<br>
+ timestamps="true"<br>
+ path="logs/jasper-${yyyyMMdd}.log"<br>
+ verbosityLevel = "INFORMATION"
/></td><td> </td>
+ <td>Sets up the Jasper's log output channel.</td></tr>
+ <tr><td><<a href="serverxml.html#WebXmlReader">WebXmlReader</a>
+ validate="true" /></td><td> </td>
+ <td>Reads the <code>web.xml</code> file for each context.</td></tr>
+ <tr><td><<a href="serverxml.html#ErrorHandler">ErrorHandler</a>
+ showDebugInfo="true" /></td><td> </td>
+ <td>Provides error handling for requests that encounter an error.</td></tr>
+ <tr><td><<a href="serverxml.html#WorkDirSetup">WorkDirSetup</a>
+ cleanWorkDir="false" /></td><td> </td>
+ <td>Sets the "work" directory for contexts which don't have the
+ "work" directory set explicitly.</td></tr>
+ <tr><td><<a href="serverxml.html#Jdk12Interceptor">Jdk12Interceptor</a>
+ /></td><td> </td>
+ <td>Insures the proper context classloader is in effect during servlet
+ execution.</td></tr>
+ <tr><td><<a href="serverxml.html#InvokerInterceptor">InvokerInterceptor</a>
+ /></td><td> </td>
+ <td> </td></tr>
+ <tr><td><<a href="serverxml.html#JspInterceptor">JspInterceptor</a>
+ keepGenerated="true"<br>
+ largeFile="false"<br>
+ useJspServlet="false"
/></td><td> </td>
+ <td>Handles translation, compilation, and loading of JSP pages.</td></tr>
+ <tr><td><<a href="serverxml.html#StaticInterceptor">StaticInterceptor</a>
+ listings="true" /></td><td> </td>
+ <td>Generates the response for requests for static files and
directories.</td></tr>
+ <tr><td><ReloadInterceptor fullReload="true"
/></td><td> </td>
+ <td> </td></tr>
+ <tr><td><<a href="serverxml.html#SimpleSessionStore">SimpleSessionStore</a>
+ maxActiveSessions="-1" /></td><td> </td>
+ <td>Creates, stores, and maintains session objects.</td></tr>
+ <tr><td><<a href="serverxml.html#AccessInterceptor">AccessInterceptor</a>
+ /></td><td> </td>
+ <td>Checks if requests require authentication. Provides the basic handling
+ for BASIC and FORM authentication.</td></tr>
+ <tr><td><<a
href="serverxml.html#CredentialsInterceptor">CredentialsInterceptor</a>
+ /></td><td> </td>
+ <td>Extracts user name and password information for use by an
+ "authentication" module.</td></tr>
+ <tr><td><<a href="serverxml.html#SimpleRealm">SimpleRealm</a>
+ filename="conf/users/global-users.xml" /></td><td> </td>
+ <td>"authentication" module that checks user name and passwords
+ against data obtained from an XML file. Since this module appears outside
+ of a Context definition, the user names and passwords in the specified
+ file apply to all contexts.</td></tr>
+ <tr><td><JDBCRealm<br>
+ debug="99"<br>
+
driverName="sun.jdbc.odbc.JdbcOdbcDriver"<br>
+ connectionURL="jdbc:odbc:TOMCAT"<br>
+ userTable="users"
userNameCol="user_name"<br>
+ userCredCol="user_pass"<br>
+ userRoleTable="user_roles"<br>
+ roleNameCol="role_name"
/></td><td>Disabled</td>
+ <td> </td></tr>
+ <tr><td><<a
href="serverxml.html#LoadOnStartupInterceptor">LoadOnStartupInterceptor</a>
+ /></td><td> </td>
+ <td>Pre-loads servlets indicated as <load-on-startup> in a web.xml
+ file.</td></tr>
+ <tr><td><Servlet22Interceptor /></td><td> </td>
+ <td> </td></tr>
+ <tr><td><<a href="serverxml.html#LogSetter">LogSetter</a>
+ name="tag_pool_log" timestamps="true"<br>
+ path="logs/tagpool-${yyyyMMdd}.log"<br>
+ verbosityLevel="INFORMATION"
/></td><td>Disabled</td>
+ <td> </td></tr>
+ <tr><td><<a
href="serverxml.html#TagPoolManagerInterceptor">TagPoolManagerInterceptor</a>
+ /></td><td>Disabled</td>
+ <td>Manages a pool of custom tag libary tag objects.</td></tr>
+ <tr><td><<a href="serverxml.html#DecodeInterceptor">DecodeInterceptor</a>
+ /></td><td> </td>
+ <td>Handles the determination of the encoding of a request.</td></tr>
+ <tr><td><SessionId cookiesFirst="true" noCookies="false"
/></td><td> </td>
+ <td> </td></tr>
+ <tr><td><<a href="serverxml.html#ApacheConfig">ApacheConfig</a>
+ noRoot="true" /></td><td> </td>
+ <td>Auto-generates a configuration file for use with
<code>mod_jk</code>.</td></tr>
+ <tr><td><<a href="serverxml.html#IISConfig">IISConfig</a>
+ noRoot="true" /></td><td> </td>
+ <td>Auto-generates a configuration file for use with
<code>isapi_redirect.dll</code>.</td></tr>
+ <tr><td><NSConfig noRoot="true" /></td><td> </td>
+ <td> </td></tr>
+ <tr><td><AccessLogInterceptor/></td><td>Disabled</td>
+ <td> </td></tr>
+ <tr><td><Http10Connector port="8080"<br>
+ secure="false"<br>
+ maxThreads="100"<br>
+ maxSpareThreads="50"<br>
+ minSpareThreads="10"
/></td><td> </td>
+ <td> </td></tr>
+ <tr><td><Http10Connector port="8443" secure="true"
/></td><td>Disabled</td>
+ <td> </td></tr>
+ <tr><td><JniConnector /></td><td> </td>
+ <td> </td></tr>
+ <tr><td><Ajp12Connector tomcatAuthentication="false"
port="8007" /></td><td> </td>
+ <td> </td></tr>
+ <tr><td><Ajp13Connector port="8009" /></td><td> </td>
+ <td> </td></tr>
+</table>
+
<h4>Tomcat Server Customization</h4>
<p><i>This section will describe the most common customizations</i></p>
+
+<h4><a name="standard_contexts">Tomcat's Standard Contexts</a></h4>
+
+<p><i>This section will describe contexts included in Tomcat 3.3</i></p>
+
+<h4><a name="customizing_contexts">Customizing Contexts</a></h4>
+
+<p><i>This section will describe how to add and customize contexts in Tomcat
3.3</i></p>
<hr size="5">
