cvs commit: jakarta-tomcat/src/doc serverxml.html index.html tomcat-apache-howto.html tomcat-ug.html mod_jk-howto.html tomcat-ssl-howto.html Tomcat-on-NetWare-HowTo.html
hgomez 2002/11/07 05:23:33 Modified:src/doc/images banner.gif src/doc serverxml.html index.html tomcat-apache-howto.html tomcat-ug.html mod_jk-howto.html tomcat-ssl-howto.html Tomcat-on-NetWare-HowTo.html Log: Use the latest jakarta logo... Revision ChangesPath 1.2 +77 -50jakarta-tomcat/src/doc/images/banner.gif Binary file 1.31 +2 -2 jakarta-tomcat/src/doc/serverxml.html Index: serverxml.html === RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v retrieving revision 1.30 retrieving revision 1.31 diff -u -r1.30 -r1.31 --- serverxml.html3 Nov 2002 02:52:01 - 1.30 +++ serverxml.html7 Nov 2002 13:23:32 - 1.31 -18,7 +18,7 tr td width=50%a href=http://jakarta.apache.org/index.html;img - src=images/banner.gif width=350 height=100 + src=images/banner.gif width=505 height=48 alt=The Jakarta Project border=0/a/td td width=50% align=rightimg border=0 src=images/tomcat.gif width=100 height=71 alt=The mighty Tomcat - Meow!/td /tr 1.11 +3 -3 jakarta-tomcat/src/doc/index.html Index: index.html === RCS file: /home/cvs/jakarta-tomcat/src/doc/index.html,v retrieving revision 1.10 retrieving revision 1.11 diff -u -r1.10 -r1.11 --- index.html14 Feb 2002 14:25:53 - 1.10 +++ index.html7 Nov 2002 13:23:32 - 1.11 -15,8 +15,8 p align=left a href=http://jakarta.apache.org/index.html; img src=images/banner.gif - width=350 - height=100 + width=505 + height=48 alt=The Jakarta Project border=0/a /td 1.4 +3 -3 jakarta-tomcat/src/doc/tomcat-apache-howto.html Index: tomcat-apache-howto.html === RCS file: /home/cvs/jakarta-tomcat/src/doc/tomcat-apache-howto.html,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- tomcat-apache-howto.html 9 Feb 2001 04:21:27 - 1.3 +++ tomcat-apache-howto.html 7 Nov 2002 13:23:32 - 1.4 -14,8 +14,8 p align=left a href=http://jakarta.apache.org/index.html; img src=images/banner.gif - width=350 - height=100 + width=505 + height=48 alt=The Jakarta Project border=0/a /td 1.26 +2 -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.25 retrieving revision 1.26 diff -u -r1.25 -r1.26 --- tomcat-ug.html18 Apr 2002 13:58:00 - 1.25 +++ tomcat-ug.html7 Nov 2002 13:23:32 - 1.26 -18,7 +18,7 tr td width=50%a href=http://jakarta.apache.org/index.html;img - src=images/banner.gif width=350 height=100 + src=images/banner.gif width=505 height=48 alt=The Jakarta Project border=0/a/td td width=50% align=rightimg border=0 src=images/tomcat.gif width=100 height=71 alt=The mighty Tomcat - Meow!/td /tr 1.16 +1 -1 jakarta-tomcat/src/doc/mod_jk-howto.html Index: mod_jk-howto.html === RCS file: /home/cvs/jakarta-tomcat/src/doc/mod_jk-howto.html,v retrieving revision 1.15 retrieving revision 1.16 diff -u -r1.15 -r1.16 --- mod_jk-howto.html 21 Oct 2001 15:28:44 - 1.15 +++ mod_jk-howto.html 7 Nov 2002 13:23:32 - 1.16 -36,7 +36,7 !-- Banner element, all hail the Project! -- table BORDER=0 CELLSPACING=0 CELLPADDING=0 WIDTH=100% tr -td ALIGN=LEFT WIDTH=50%a href=http://jakarta.apache.org/index.html;img SRC=images/banner.gif ALT=The Jakarta Project BORDER=0 height=100 width=350/a/td +td ALIGN=LEFT WIDTH=50%a href=http://jakarta.apache.org/index.html;img SRC=images/banner.gif ALT=The Jakarta Project BORDER=0 height=48 width=505/a/td td ALIGN=RIGHT WIDTH=50%img SRC=images/tomcat.gif ALT=The mighty Tomcat - Meow! BORDER=0 height=71 width=100/td /tr 1.14 +1 -1 jakarta-tomcat/src/doc/tomcat-ssl-howto.html Index: tomcat-ssl-howto.html
cvs commit: jakarta-tomcat/src/doc serverxml.html
billbarker2002/11/02 18:42:13 Modified:src/doc serverxml.html Log: Document new attribute to SessionId. Revision ChangesPath 1.29 +11 -3 jakarta-tomcat/src/doc/serverxml.html Index: serverxml.html === RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v retrieving revision 1.28 retrieving revision 1.29 diff -u -r1.28 -r1.29 --- serverxml.html19 Sep 2002 11:13:18 - 1.28 +++ serverxml.html3 Nov 2002 02:42:13 - 1.29 -2501,13 +2501,21 /tr tr valign=top tdcheckSSLSessionIdbrb[Tomcat 3.3.1]/b/td -tdIf true, Tomcat session will be verified against SSL session to prevent +tdIf codetrue/code, Tomcat session will be verified against SSL session to prevent (malicious) use of other users' sessions. In order for this to work, SSL has to be enabled (through Apache) and SSL Session ID has to be known to Tomcat. More information can be found in mod_jk documentation./td tdfalse/td /tr - + tr valign=top +tdsecureCookiebrb[Tomcat 3.3.2]/b/td +tdIf codetrue/code, then Tomcat will mark the Session ID cookie as + as Secure if the session is created over a SSL connection. A + conforming browser will only send the cookie back to a page that is using + SSL. The effect is that if a session is created from a SSL page, than + it is not available to any non-SSL pages./td +tdtrue/td + /tr /table h4Example(s)/h4 -- To unsubscribe, e-mail: mailto:tomcat-dev-unsubscribe;jakarta.apache.org For additional commands, e-mail: mailto:tomcat-dev-help;jakarta.apache.org
cvs commit: jakarta-tomcat/src/doc serverxml.html
billbarker2002/11/02 18:52:01 Modified:src/doc serverxml.html Log: Note to self: check with the less-forgiving browser first. Revision ChangesPath 1.30 +2 -2 jakarta-tomcat/src/doc/serverxml.html Index: serverxml.html === RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v retrieving revision 1.29 retrieving revision 1.30 diff -u -r1.29 -r1.30 --- serverxml.html3 Nov 2002 02:42:13 - 1.29 +++ serverxml.html3 Nov 2002 02:52:01 - 1.30 -2507,7 +2507,7 Tomcat. More information can be found in mod_jk documentation./td tdfalse/td /tr - tr valign=top + tr valign=top tdsecureCookiebrb[Tomcat 3.3.2]/b/td tdIf codetrue/code, then Tomcat will mark the Session ID cookie as as Secure if the session is created over a SSL connection. A -- To unsubscribe, e-mail: mailto:tomcat-dev-unsubscribe;jakarta.apache.org For additional commands, e-mail: mailto:tomcat-dev-help;jakarta.apache.org
cvs commit: jakarta-tomcat/src/doc serverxml.html
hgomez 2002/09/19 00:57:07
Modified:src/doc serverxml.html
Log:
Add information about MXInterceptor
Revision ChangesPath
1.27 +62 -1 jakarta-tomcat/src/doc/serverxml.html
Index: serverxml.html
===
RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- serverxml.html11 Sep 2002 17:35:26 - 1.26
+++ serverxml.html19 Sep 2002 07:57:06 - 1.27
@@ -228,6 +228,7 @@
lia href=#JservConfigJservConfig/a/li
lia href=#LoaderInterceptor11LoaderInterceptor11/a/li
lia href=#LogSetterLogSetter/a/li
+ lia href=#MXInterceptorMXInterceptor/a/li
lia href=#NSConfigNSConfig/a/li
lia href=#PolicyLoaderPolicyLoader/a/li
lia href=#TrustedLoaderTrustedLoader/a/li
@@ -2146,6 +2147,66 @@
lt;LogSetter name=quot;tc_logquot; verbosityLevel=quot;DEBUGquot; /gt;
lt;LogSetter name=quot;servlet_logquot; timestamps=quot;truequot;
verbosityLevel=quot;INFORMATIONquot;
path=quot;logs/servlet-${MMdd}.logquot; /gt;
+/pre
+
+hr size=5
+
+!-- --
+
+h3a name=MXInterceptorMXInterceptor/a/h3
+
+pbType:/b Configuration/p
+
+h4Description/h4
+
+pJMX MBeans support has been added to Tomcat 3.3.2, which allow you to manage
+Tomcat from any JMX console or via a simple browser by the build in HTTP Adaptor/p
+pTo enable JMX, you should add the lt;MxInterceptor /gt; in server.xml/p
+pTo also activate the HTTP Adaptor you should at least define the listen port/p
+
+h4Attributes/h4
+
+table border=1 cellpadding=2 cellspacing=0
+ tr valign=top
+thAttribute/th
+thDescription/th
+thDefault/th
+ /tr
+ tr valign=top
+tdport/td
+tdport where the JMX HTTP Adaptor will listen to, HTTP Adaptor will only be
loaded if the port is set/td
+td-1, no http adaptor loaded/td
+ /tr
+ tr valign=top
+tdhost/td
+tdhost/ip where the JMX HTTP Adaptor will listen to, only available when
using codeMX4J/code HTTP Adaptor/td
+tdnull/td
+ /tr
+ tr valign=top
+tdauthentication/td
+tdauthentication used by the JMX HTTP Adaptor, only available when using
codeMX4J/code HTTP Adaptor,
+it could be codenone/code, codebasic/code, codedigest/code/td
+tdnone/td
+ /tr
+ tr valign=top
+tduser/td
+tdthe user account which to be used with authentication/td
+tdnone, should be set to enable authentication/td
+ /tr
+ tr valign=top
+tdpassword/td
+tdthe password which to be used with authentication/td
+tdnone, should be set to enable authentication/td
+ /tr
+/table
+
+
+
+h4Example(s)/h4
+
+pre
+lt;MxInterceptor port=quot;8999quot; host=quot;mysystemquot;
authentication=quot;basicquot; user=quot;adminquot;
password=quot;changeillicoquot;/gt;
+lt;MxInterceptor /gt;
/pre
hr size=5
--
To unsubscribe, e-mail: mailto:[EMAIL PROTECTED]
For additional commands, e-mail: mailto:[EMAIL PROTECTED]
cvs commit: jakarta-tomcat/src/doc serverxml.html
hgomez 2002/09/19 04:13:18 Modified:src/doc serverxml.html Log: typo, it's MxInterceptor and not MXInterceptor Revision ChangesPath 1.28 +4 -4 jakarta-tomcat/src/doc/serverxml.html Index: serverxml.html === RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v retrieving revision 1.27 retrieving revision 1.28 diff -u -r1.27 -r1.28 --- serverxml.html19 Sep 2002 07:57:06 - 1.27 +++ serverxml.html19 Sep 2002 11:13:18 - 1.28 @@ -228,7 +228,7 @@ lia href=#JservConfigJservConfig/a/li lia href=#LoaderInterceptor11LoaderInterceptor11/a/li lia href=#LogSetterLogSetter/a/li - lia href=#MXInterceptorMXInterceptor/a/li + lia href=#MxInterceptorMxInterceptor/a/li lia href=#NSConfigNSConfig/a/li lia href=#PolicyLoaderPolicyLoader/a/li lia href=#TrustedLoaderTrustedLoader/a/li @@ -2153,7 +2153,7 @@ !-- -- -h3a name=MXInterceptorMXInterceptor/a/h3 +h3a name=MxInterceptorMxInterceptor/a/h3 pbType:/b Configuration/p @@ -2206,7 +2206,7 @@ pre lt;MxInterceptor port=quot;8999quot; host=quot;mysystemquot; authentication=quot;basicquot; user=quot;adminquot; password=quot;changeillicoquot;/gt; -lt;MxInterceptor /gt; +lt;erceptor /gt; /pre hr size=5 -- To unsubscribe, e-mail: mailto:[EMAIL PROTECTED] For additional commands, e-mail: mailto:[EMAIL PROTECTED]
cvs commit: jakarta-tomcat/src/doc serverxml.html
larryi 2002/09/11 10:35:26
Modified:src/doc serverxml.html
Log:
A correction for LogSetter I had lying around
Revision ChangesPath
1.26 +5 -3 jakarta-tomcat/src/doc/serverxml.html
Index: serverxml.html
===
RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- serverxml.html8 May 2002 02:27:54 - 1.25
+++ serverxml.html11 Sep 2002 17:35:26 - 1.26
@@ -2116,8 +2116,8 @@
tr valign=top
tdpath/td
tdPath to the desired log file. You may embed a
- codejava.text.SimpleDateFormat/code string enclosed within '{}'
- to create a path that encorporates the current date and or time./td
+ codejava.text.SimpleDateFormat/code string enclosed within quot;${}quot;
+ to create a path that encorporates the current date and/or time./td
tdnull, log output goes to stderr/td
/tr
tr valign=top
@@ -2144,6 +2144,8 @@
pre
lt;LogSetter name=quot;tc_logquot; verbosityLevel=quot;DEBUGquot; /gt;
+lt;LogSetter name=quot;servlet_logquot; timestamps=quot;truequot;
+verbosityLevel=quot;INFORMATIONquot;
path=quot;logs/servlet-${MMdd}.logquot; /gt;
/pre
hr size=5
--
To unsubscribe, e-mail: mailto:[EMAIL PROTECTED]
For additional commands, e-mail: mailto:[EMAIL PROTECTED]
cvs commit: jakarta-tomcat/src/doc serverxml.html
larryi 02/03/19 03:48:05
Modified:src/doc serverxml.html
Log:
Document saveOriginal attribute in DecodeInterceptor. The best we
can do for Bugzilla #4416.
Revision ChangesPath
1.23 +17 -1 jakarta-tomcat/src/doc/serverxml.html
Index: serverxml.html
===
RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- serverxml.html12 Mar 2002 04:14:49 - 1.22
+++ serverxml.html19 Mar 2002 11:48:05 - 1.23
@@ -4,7 +4,7 @@
!DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN
html
head
- !-- $Id: serverxml.html,v 1.22 2002/03/12 04:14:49 larryi Exp $ --
+ !-- $Id: serverxml.html,v 1.23 2002/03/19 11:48:05 larryi Exp $ --
!-- Copyright 1999-2001 Apache Software Foundation --
meta http-equiv=Content-Type content=text/html; charset=iso-8859-1
link rel=stylesheet href=style.css
@@ -1097,6 +1097,22 @@
%2F ('/'), and %5C ('\'). If any are found in the URI, the request is
considered quot;unsafequot; and a 403 Forbidden error is returned./td
tdtrue/td
+ /tr
+ tr valign=top
+tdsaveOriginal/td
+tdIf codetrue/code, a copy of the original request URI is saved
+ before it is decoded. This saved copy is later used as the return value
+ HttpServletRequest.getRequestURI(). If codefalse/code, then
+ HttpServletRequest.getRequestURI() returns a re-encoded version of the
+ decoded request URI. Setting this attribute to codetrue/code most
+ closely follows the Servlet 2.2 spec. However, codefalse/code is
+ the default because codetrue/code can't be implemented when
+ Tomcat is connected to Netscape Web Server 4.1 or earlier. The original
+ un-escaped request URI isn't made available to the connector. Also,
+ the IIS connector that shipped with Tomcat 3.3(a) did not support
+ passing the original request URI, though the current one does, using
+ the codeuri_select/code setting./td
+tdfalse/td
/tr
/table
--
To unsubscribe, e-mail: mailto:[EMAIL PROTECTED]
For additional commands, e-mail: mailto:[EMAIL PROTECTED]
cvs commit: jakarta-tomcat/src/doc serverxml.html
larryi 02/02/23 19:47:16 Modified:src/doc serverxml.html Log: Document updates to AutoWebApp. Revision ChangesPath 1.21 +51 -2 jakarta-tomcat/src/doc/serverxml.html Index: serverxml.html === RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v retrieving revision 1.20 retrieving revision 1.21 diff -u -r1.20 -r1.21 --- serverxml.html8 Feb 2002 20:24:53 - 1.20 +++ serverxml.html24 Feb 2002 03:47:16 - 1.21 @@ -4,7 +4,7 @@ !DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN html head - !-- $Id: serverxml.html,v 1.20 2002/02/08 20:24:53 larryi Exp $ -- + !-- $Id: serverxml.html,v 1.21 2002/02/24 03:47:16 larryi Exp $ -- !-- Copyright 1999-2001 Apache Software Foundation -- meta http-equiv=Content-Type content=text/html; charset=iso-8859-1 link rel=stylesheet href=style.css @@ -864,15 +864,57 @@ /tr tr valign=top tdhost/td -tdVirtual host into which each application will be deployed./td +tdVirtual host into which each application will be deployed.br +bNote:/b If this attribute is specified in codeserver.xml/code, +the handling for codehostChar/code and codehostDotChar/code is +disabled./td tdDEFAULT/td /tr tr valign=top +tdhostCharbrb[Tomcat 3.3.1]/td +tdCharacter used to designate the end of the host portion of the + directory name. For example, a directory named quot;mydomain@myappquot; + would deploy to virtual host quot;mydomainquot; as the quot;/myappquot; + context. Deriving a host name from the directory name is disabled if + the codehost/code attribute is specified in codeserver.xml/code. + Also see the codehostDotChar/code attribute for including periods in + the host name.br + bNote:/b This attribute was implemented, but not configurable in + Tomcat 3.3. However, a bug in Tomcat 3.3 makes this feature unusable. The + '@' character is incorrectly included in the context name. This bug has + been corrected in Tomcat 3.3.1./td +td@/td + /tr + tr valign=top +tdhostDotCharbrb[Tomcat 3.3.1]/td +tdCharacter used as a substitute for periods in the host portion of the + directory name. For example, a directory named + quot;www_mydomain_com@myappquot; would deploy to virtual host + quot;www.mydomain.comquot; as the quot;/myappquot; context. Also see + the codehostChar/code attribute for designating the end of the host + name.br + bNote:/b This attribute was implemented, but not configurable in + Tomcat 3.3. However, a bug in the handing for codehostChar/code in + Tomcat 3.3 makes this feature unusable. It is fully funtional in + Tomcat 3.3.1./td +td_/td + /tr + tr valign=top tdignoreDot/td tdIgnore dirs starting with '.'/td tdtrue/td /tr tr valign=top +tdpathSlashCharbrb[Tomcat 3.3.1]/td +tdCharacter used as a substitute for slashes in the context path portion + of the directory name. For example, a directory named + quot;my_appquot; would deploy to the default host as the + quot;/my/appquot; context.br + bNote:/b This attribute was implemented, but not configurable in + Tomcat 3.3./td +td_/td + /tr + tr valign=top tdprefixbrb[Tomcat 3.3.1]/b/td tdPrefix to add to the context path for each deployed web application. The context path will consist of the prefix followed subdirectory name./td @@ -888,11 +930,18 @@ /tr /table +pbNote:/b The special directory name handling controlled by +codehostChar/code, codehostDotChar/code, and codepathSlashChar/code +is always enabled. If you wish to include '_' characters in a web application +directory name, disable the feature by redefining the codepathSlashChar/code +to an empty string./p + h4Example(s)/h4 pre lt;AutoWebApp dir=quot;webappsquot; host=quot;DEFAULTquot; /gt; lt;AutoWebApp dir=quot;myhostquot; host=quot;myhost.comquot; /gt; + lt;AutoWebApp dir=quot;webappsquot; pathSlashChar= /gt; /pre hr size=5 -- To unsubscribe, e-mail: mailto:[EMAIL PROTECTED] For additional commands, e-mail: mailto:[EMAIL PROTECTED]
cvs commit: jakarta-tomcat/src/doc serverxml.html
larryi 02/02/08 12:24:53 Modified:src/doc serverxml.html Log: Document the updated delay attribute in Http10Connector and new attributes on Ajp13Connector. Revision ChangesPath 1.20 +60 -10jakarta-tomcat/src/doc/serverxml.html Index: serverxml.html === RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v retrieving revision 1.19 retrieving revision 1.20 diff -u -r1.19 -r1.20 --- serverxml.html5 Feb 2002 02:19:22 - 1.19 +++ serverxml.html8 Feb 2002 20:24:53 - 1.20 @@ -4,7 +4,7 @@ !DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN html head - !-- $Id: serverxml.html,v 1.19 2002/02/05 02:19:22 larryi Exp $ -- + !-- $Id: serverxml.html,v 1.20 2002/02/08 20:24:53 larryi Exp $ -- !-- Copyright 1999-2001 Apache Software Foundation -- meta http-equiv=Content-Type content=text/html; charset=iso-8859-1 link rel=stylesheet href=style.css @@ -542,6 +542,17 @@ pHandles incoming Ajp13 requests. Ajp13 is a protocol used by the mod_jk based web server connectors./p +pIn Tomcat 3.3.1, some attributes were added for supporting password protected +shutdown using Ajp13. This feature is actived by setting the +codeshutDownEnabled/code to codetrue/code, or setting a password using +the codesecret/code or codeuseSecret/code attributes. Also, if a +password is set, authentication of Ajp13 connections can also be performed. +This feature requires the codeauthenticateRequests/code attribute be set +codetrue/code in addition to a password, and the mod_jk based +connector support this feature. The connectors available with Tomcat 3.3.x do +not support this feature. Connectors that do support this feature will be made +available through the jakarta-tomcat-connectors project./p + h4Attributes/h4 table border=1 cellpadding=2 cellspacing=0 @@ -551,9 +562,38 @@ thDefault/th /tr tr valign=top +tdajpidFilebrb[Tomcat 3.3.1]/td +tdFile in which to record Ajp13 connector info and password./td +tdconf/ajp13.id/td + /tr + tr valign=top +tdauthenticateConnectionbrb[Tomcat 3.3.1]/td +tdIf true and a password has been set, password checking is performed on +the first Ajp13 request of a newly opened connection. If the password +doesn't match, the request is ignored and the connection closed. If +they match, the connection is quot;authenticatedquot; and the current +and future requests on that connection are processed normally. If false +or a password isn't set, password checking of the Ajp13 connection is +disabled. The password is set using either the codesecret/code or +codeuseSecret/code attributes. This feature also requires a mod_jk +based connector that supports sending the password. The connectors +available with Tomcat 3.3.x do not support this feature./td +tdfalse/td + /tr + tr valign=top +tdsecretbrb[Tomcat 3.3.1]/td +tdThe desired shutdown password. If set, the codeshutDownEnable/code +attribute is automatically set codetrue/code. The password can +also be used for authentication of Ajp13 connections if supported by the +mod_jk based connector. The connectors supplied with Tomcat 3.3.x do +not support this feature./td +tdinot specified/i/td + /tr + tr valign=top tdshutDownEnable/td -tdEnable shutdown signal via this connector. Normally shutdown is done - through a href=#Ajp12ConnectorAjp12Connector/a./td +tdEnable shutdown signal via this connector. This attribute is +automatically set codetrue/code if a password is set using the +codesecret/code or codeuseSecret/code attributes./td tdfalse/td /tr tr valign=top @@ -567,6 +607,15 @@ tdtrue/td /tr tr valign=top +tduseSecretbrb[Tomcat 3.3.1]/td +tdEnables use of a random number as the shutdown password. If set, the +codeshutDownEnable/code attribute is automatically set +codetrue/code. The password can also be used for authentication of +Ajp13 requests if supported by the mod_jk based connector. The +connectors supplied with Tomcat 3.3.x do not support this feature./td +tdfalse/td + /tr + tr valign=top tdbSocket Properties/b/td tdnbsp;/td tdnbsp;/td @@ -1074,13 +1123,14 @@ tdnull, iuse default Tomcat server string/i/td /tr tr valign=top -tddelaySocketClosebrb[Tomcat 3.3.1]/b/td -tdWhen set true, a Thread.sleep(0) is executed just prior to closing - the socket for a request. This can help when running a test against - Tomcat on a very fast system. Otherwise, thread execution may complete - the socket close before
cvs commit: jakarta-tomcat/src/doc serverxml.html
larryi 02/02/04 18:06:20 Modified:src/doc serverxml.html Log: Document some recent changes and a little rearranging. Revision ChangesPath 1.18 +40 -34jakarta-tomcat/src/doc/serverxml.html Index: serverxml.html === RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v retrieving revision 1.17 retrieving revision 1.18 diff -u -r1.17 -r1.18 --- serverxml.html2 Feb 2002 15:58:05 - 1.17 +++ serverxml.html5 Feb 2002 02:06:19 - 1.18 @@ -4,7 +4,7 @@ !DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN html head - !-- $Id: serverxml.html,v 1.17 2002/02/02 15:58:05 larryi Exp $ -- + !-- $Id: serverxml.html,v 1.18 2002/02/05 02:06:19 larryi Exp $ -- !-- Copyright 1999-2001 Apache Software Foundation -- meta http-equiv=Content-Type content=text/html; charset=iso-8859-1 link rel=stylesheet href=style.css @@ -800,30 +800,23 @@ thDefault/th /tr tr valign=top -tdpdir/p -/td -tdpDirectory from which to load the web applictions. Relative paths - are interpreted as relative to TOMCAT_HOME./p -/td -tdpwebapps/p +tddir /td +tdDirectory from which to load the web applictions. Relative paths + are interpreted as relative to TOMCAT_HOME./td +tdwebapps/td /tr tr valign=top -tdpprefix/p -/td -tdpPrefix to add to the context path for each deployed web application. - The context path will consist of the prefix followed subdirectory name./p -/td -tdpDEFAULT/p -/td +tdflat/td +tdEach dir will be treated as a webapp in the same host. If codefalse/code, + each dir will be treated as a host name and its subdirs as + web applications. You can add apps to multiple virtual hosts. /td +tdtrue/td /tr tr valign=top -tdphost/p -/td -tdpVirtual host into which each application will be deployed./p -/td -tdpDEFAULT/p -/td +tdhost/td +tdVirtual host into which each application will be deployed./td +tdDEFAULT/td /tr tr valign=top tdignoreDot/td @@ -831,10 +824,17 @@ tdtrue/td /tr tr valign=top -tdflat/td -tdEach dir will be treated as a webapp in the same host. If codefalse/code, - each dir will be treated as a host name and its subdirs as - web applications. You can add apps to multiple virtual hosts. /td +tdprefixbrb[Tomcat 3.3.1]/b/td +tdPrefix to add to the context path for each deployed web application. + The context path will consist of the prefix followed subdirectory name./td +tdiempty string/i/td + /tr + tr valign=top +tdreloadable/td +tdIf true, reloading will be enabled by default for each context. If +false, reloading will be disabled by default for each context. This +setting, enabled or disabled, may be overridden in an explicit +context declaration./td tdtrue/td /tr /table @@ -1023,6 +1023,15 @@ thDefault/th /tr tr valign=top +tddefaultRedirectStatus/td +tdSets the default status code for use by the RedirectHandler if as +status code has not already been set. It may be set to quot;301quot; +or quot;302quot;. This primarily affects the status code used + when the a href=#StaticInterceptorStaticInterceptor/a module + redirects a 7quot;directoryquot; URL that doesn't end with a '/'/td +td301/td + /tr + tr valign=top tdshowDebugInfo/td tdEnables the inclusion of extra information in the default error output, such as stack traces. This extra information can expose data about @@ -1064,16 +1073,13 @@ tdnull, iuse default Tomcat server string/i/td /tr tr valign=top -tdsocketCloseDelaybrb[Tomcat 3.3.1]/b/td -tdWhen set to 0, a Thread.yield() is executed just prior to closing - the socket for a request. When set greater than 0, the thread will - quot;spinquot; in a wait loop for the specified number of milliseconds - before closing the socket. If less than 0, no extra action is performed - before closing the socket.br - This delay can help when running tests against Tomcat on certain systems - where the normal sequence of thread execution between Tomcat and client - results in a quot;Socket reset by peerquot; error./td -td-1/td +tddelaySocketClosebrb[Tomcat 3.3.1]/b/td +tdWhen set true, a Thread.sleep(0) is executed just prior to closing + the socket for a request. This can help when running a test against + Tomcat on a very fast system. Otherwise, thread execution may complete + the socket close before the test thread gets a chance to read the
cvs commit: jakarta-tomcat/src/doc serverxml.html
larryi 02/02/04 18:19:22 Modified:src/doc serverxml.html Log: Forgot to mention welcome files are affected by defaultRedirectStatus. Revision ChangesPath 1.19 +3 -2 jakarta-tomcat/src/doc/serverxml.html Index: serverxml.html === RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v retrieving revision 1.18 retrieving revision 1.19 diff -u -r1.18 -r1.19 --- serverxml.html5 Feb 2002 02:06:19 - 1.18 +++ serverxml.html5 Feb 2002 02:19:22 - 1.19 @@ -4,7 +4,7 @@ !DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN html head - !-- $Id: serverxml.html,v 1.18 2002/02/05 02:06:19 larryi Exp $ -- + !-- $Id: serverxml.html,v 1.19 2002/02/05 02:19:22 larryi Exp $ -- !-- Copyright 1999-2001 Apache Software Foundation -- meta http-equiv=Content-Type content=text/html; charset=iso-8859-1 link rel=stylesheet href=style.css @@ -1028,7 +1028,8 @@ status code has not already been set. It may be set to quot;301quot; or quot;302quot;. This primarily affects the status code used when the a href=#StaticInterceptorStaticInterceptor/a module - redirects a 7quot;directoryquot; URL that doesn't end with a '/'/td + redirects a quot;directoryquot; URL that doesn't end with a '/' and + redirects to welcome files./td td301/td /tr tr valign=top -- To unsubscribe, e-mail: mailto:[EMAIL PROTECTED] For additional commands, e-mail: mailto:[EMAIL PROTECTED]
cvs commit: jakarta-tomcat/src/doc serverxml.html
larryi 02/02/02 07:58:05 Modified:src/doc serverxml.html Log: Add documentation for some recent changes. Revision ChangesPath 1.17 +106 -16 jakarta-tomcat/src/doc/serverxml.html Index: serverxml.html === RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v retrieving revision 1.16 retrieving revision 1.17 diff -u -r1.16 -r1.17 --- serverxml.html13 Jan 2002 02:28:28 - 1.16 +++ serverxml.html2 Feb 2002 15:58:05 - 1.17 @@ -4,7 +4,7 @@ !DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN html head - !-- $Id: serverxml.html,v 1.16 2002/01/13 02:28:28 larryi Exp $ -- + !-- $Id: serverxml.html,v 1.17 2002/02/02 15:58:05 larryi Exp $ -- !-- Copyright 1999-2001 Apache Software Foundation -- meta http-equiv=Content-Type content=text/html; charset=iso-8859-1 link rel=stylesheet href=style.css @@ -1064,13 +1064,16 @@ tdnull, iuse default Tomcat server string/i/td /tr tr valign=top -tddelaySocketClosebrb[Tomcat 3.3.1]/b/td -tdWhen set true, a Thread.sleep(0) is executed just prior to closing - the socket for a request. This can help when running a test against - Tomcat on a very fast system. Otherwise, thread execution may complete - the socket close before the test thread gets a chance to read the data - resulting in a Socket reset by peer error./td -tdfalse/td +tdsocketCloseDelaybrb[Tomcat 3.3.1]/b/td +tdWhen set to 0, a Thread.yield() is executed just prior to closing + the socket for a request. When set greater than 0, the thread will + quot;spinquot; in a wait loop for the specified number of milliseconds + before closing the socket. If less than 0, no extra action is performed + before closing the socket.br + This delay can help when running tests against Tomcat on certain systems + where the normal sequence of thread execution between Tomcat and client + results in a quot;Socket reset by peerquot; error./td +td-1/td /tr tr valign=top tdbConnection Properties/b/td @@ -1085,7 +1088,8 @@ tr valign=top tdkeystore/td tdKeystore containing the Server certificate/td -td.keystore in directory specified by the user.home System property/td +tdPureTLS: server.pembr +JSSE: .keystore in directory specified by the user.home System property/td /tr tr valign=top tdkeypass/td @@ -1118,6 +1122,22 @@ tdino default, must be specified/i/td /tr tr valign=top +tdSSLImplementationbrb[Tomcat 3.3.1]/b/td +tdClass which implements the +codeorg.apache.tomcat.util.net.SSLImplementation/code interface. +This setting controls which SSL support is used by secure connections. +Currently supported are:br +ol +liPureTLS - specify +codeorg.apache.tomcat.util.net.PureTLSImplementation/code/li +liJSSE - specify +codeorg.apache.tomcat.util.net.JSSEImplementation/code/li +/ol/td +tdinot set/ibr +default behavior will detect PureTLS and JSSE and choose the one +available, or PureTLS if both are available./td + /tr + tr valign=top tdtimeout/td tdSocket read timeout in seconds./td td300/td @@ -1151,6 +1171,61 @@ /tr /table +pbNote:/b In Tomcat 3.3.1 and later, 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 codesecure/code is set +codetrue/code. Supported attributes are:/p + +h4PureTLS/h4 + +table border=1 cellpadding=2 cellspacing=0 + tr valign=top +thAttribute/th +thDescription/th +thDefault/th + /tr + tr +tdrootfile/td +tdFile containing root certificates./td +tdroot.pem/td + /tr + tr +tdrandomfile/td +tdFile to initialize random number generation./td +tdrandom.pem/td + /tr +/table + +h4JSSE/h4 + +table border=1 cellpadding=2 cellspacing=0 + tr valign=top +thAttribute/th +thDescription/th +thDefault/th + /tr + tr +tdalgorithm/td +tdAlgorithm used to encode the certificate./td +tdSunX509/td + /tr + tr +tdkeystoreType/td +tdType of keystore./td +tdJKS/td + /tr + tr +tdkeystorePass/td +tdPassword to Keystore file./td +tdidefaults to keypass setting/i/td + /tr + tr +tdprotocol/td +tdProtocol for the SSL./td +tdTLS/td + /tr +/table + h4Example(s)/h4 pre @@ -1232,7 +1307,7 @@ tr valign=top tdisapiRedirectornbsp;nbsp;brb[Tomcat 3.3.1]/b/td tdName of the ISAPI connector DLL. This setting controls the
cvs commit: jakarta-tomcat/src/doc serverxml.html
larryi 02/01/12 18:28:29 Modified:src/doc serverxml.html Log: Document update to IISConfig. Revision ChangesPath 1.16 +37 -4 jakarta-tomcat/src/doc/serverxml.html Index: serverxml.html === RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v retrieving revision 1.15 retrieving revision 1.16 diff -u -r1.15 -r1.16 --- serverxml.html11 Jan 2002 07:17:17 - 1.15 +++ serverxml.html13 Jan 2002 02:28:28 - 1.16 @@ -4,7 +4,7 @@ !DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN html head - !-- $Id: serverxml.html,v 1.15 2002/01/11 07:17:17 billbarker Exp $ -- + !-- $Id: serverxml.html,v 1.16 2002/01/13 02:28:28 larryi Exp $ -- !-- Copyright 1999-2001 Apache Software Foundation -- meta http-equiv=Content-Type content=text/html; charset=iso-8859-1 link rel=stylesheet href=style.css @@ -1064,6 +1064,15 @@ tdnull, iuse default Tomcat server string/i/td /tr tr valign=top +tddelaySocketClosebrb[Tomcat 3.3.1]/b/td +tdWhen set true, a Thread.sleep(0) is executed just prior to closing + the socket for a request. This can help when running a test against + Tomcat on a very fast system. Otherwise, thread execution may complete + the socket close before the test thread gets a chance to read the data + resulting in a Socket reset by peer error./td +tdfalse/td + /tr + tr valign=top tdbConnection Properties/b/td tdnbsp;/td tdnbsp;/td @@ -1159,15 +1168,22 @@ h4Description/h4 pGenerate configuration files for isapi_redirect.dll to be used for connecting -IIS to Tomcat. Two files will be generated, codeiis_redirect.reg/code and +IIS to Tomcat. In Tomcat 3.3, two files will be generated, codeiis_redirect.reg/code and codeuriworkermap.properties/code. Both files will be written to codeconf/auto/code relative to TOMCAT_HOME. The codeiis_redirect.reg/code contains the needed registry entries for the codeiis_redirect.dll/code. You may enter the settings into the registry by double-clicking on this file in Windows Explorer. The codeuriworkermap.properties/code file will be read -by the codeisapi_redirect.dll/code to get the mappings for determining +by the codeisapi_redirect.dll/code to get the mappings that determine which requests should be passed to Tomcat./p +pIn Tomcat 3.3.1, an additional file is written. The default is to write +an codeisapi_redirect.properties/code file to the same directory as the +codeiis_redirect.reg/code file. It contains the same configuration +information as the codeiis_redirect.reg/code, and offers an alternative +method of configuring the redirector instead of relying on the registry. +See the document mentioned in the next paragraph for details on its use./p + pFor additional information on connecting Tomcat to IIS, see the a href=tomcat-iis-howto.htmlTomcat IIS HowTo/a document./p @@ -1214,6 +1230,23 @@ tdconf/jk/workers.properties/td /tr tr valign=top +tdisapiRedirectornbsp;nbsp;brb[Tomcat 3.3.1]/b/td +tdName of the ISAPI connector DLL. This setting controls the name of + the redirector DLL included in the configuration settings. This setting + appears in the registry settings configuration file specified by the + coderegConfig/code attribute. It is also written to a file with the + same name as the DLL, but with a quot;.propertiesquot; extension. + The quot;propertiesquot; file will be written to the same directory + as the registry settings configuration file.br + br + bNote:/b This quot;propertiesquot; file may be placed in the same + directory as the Tomcat redirector plugin DLL being used by IIS. + Provided its base name is the same as the DLL (e.g. isapi_redirect.dll and + isapi_redirect.properties) the configuration settings in the file will + be used instead of settings found in the registry./td +tdisapi_redirect.dll/td + /tr + tr valign=top tdjkLog/td tdPath to log file to be used by codeisapi_redirect.dll/code./td tdlogs/iis_redirect.log/td @@ -1698,7 +1731,7 @@ thDefault/th /tr tr valign=top -tdadditionalJarsbrb[Tomcat 3.3.1]/td +tdadditionalJarsbrb[Tomcat 3.3.1]/b/td tdList of jars to be added to each web application separated by the specified codejarSeparator/code. If not an absolute path, the path is assumed to be relative to codeTOMCAT_HOME/lib/container/code./td -- To unsubscribe, e-mail: mailto:[EMAIL PROTECTED] For additional commands, e-mail: mailto:[EMAIL PROTECTED]
cvs commit: jakarta-tomcat/src/doc serverxml.html
billbarker02/01/10 23:17:17 Modified:src/doc serverxml.html Log: Document new attribute to LoaderInterceptor11 Revision ChangesPath 1.15 +7 -1 jakarta-tomcat/src/doc/serverxml.html Index: serverxml.html === RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v retrieving revision 1.14 retrieving revision 1.15 diff -u -r1.14 -r1.15 --- serverxml.html1 Jan 2002 00:33:20 - 1.14 +++ serverxml.html11 Jan 2002 07:17:17 - 1.15 @@ -4,7 +4,7 @@ !DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN html head - !-- $Id: serverxml.html,v 1.14 2002/01/01 00:33:20 larryi Exp $ -- + !-- $Id: serverxml.html,v 1.15 2002/01/11 07:17:17 billbarker Exp $ -- !-- Copyright 1999-2001 Apache Software Foundation -- meta http-equiv=Content-Type content=text/html; charset=iso-8859-1 link rel=stylesheet href=style.css @@ -1749,6 +1749,12 @@ sets the context classloader's parent to the a href=tomcat-ug.html#configuring_classesServer Classloader/a./td tdtrue/td + /tr + tr valign=top +tduse11Loader/td +tdIf codetrue/code, use the 1.1 Classloader even under Java2. +For compatiblity with Tomcat 3.2.x./td +tdfalse/td /tr /table -- To unsubscribe, e-mail: mailto:[EMAIL PROTECTED] For additional commands, e-mail: mailto:[EMAIL PROTECTED]
cvs commit: jakarta-tomcat/src/doc serverxml.html
larryi 01/12/31 14:30:25 Modified:src/doc serverxml.html Log: Document attributes added to StaticInterceptor Revision ChangesPath 1.13 +25 -1 jakarta-tomcat/src/doc/serverxml.html Index: serverxml.html === RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v retrieving revision 1.12 retrieving revision 1.13 diff -u -r1.12 -r1.13 --- serverxml.html5 Dec 2001 11:28:49 - 1.12 +++ serverxml.html31 Dec 2001 22:30:25 - 1.13 @@ -4,7 +4,7 @@ !DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN html head - !-- $Id: serverxml.html,v 1.12 2001/12/05 11:28:49 larryi Exp $ -- + !-- $Id: serverxml.html,v 1.13 2001/12/31 22:30:25 larryi Exp $ -- !-- Copyright 1999-2001 Apache Software Foundation -- meta http-equiv=Content-Type content=text/html; charset=iso-8859-1 link rel=stylesheet href=style.css @@ -2389,6 +2389,9 @@ pGenerates the response for requests that map to static files or directories. The display of directory listings may be disabled./p +pIn Tomcat 3.3.1, some additional attributes were added to allow control +of locale and character encoding of directory listings./p + h4Attributes/h4 table border=1 cellpadding=2 cellspacing=0 @@ -2402,12 +2405,33 @@ tdEnables the display of directory listings when requested./td tdtrue/td /tr + tr valign=top +tduseAcceptLanguagebrb[Tomcat 3.3.1]/b/td +tdEnables the use of an Accept-Language header in the request to determine +the locale. If codefalse/code, then the system default locale (i.e. +Locale.getDefault()) is used./td +tdtrue/td + /tr + tr valign=top +tduseCharsetbrb[Tomcat 3.3.1]/b/td +tdSpecfies the desired character set to use for encoding the directory +listings. If unset, the default ISO-8859-1 is used. If set to +quot;localequot;, then the locale established by the +codeuseAcceptLanguage/code attribute is used./td +tdinot specified/i/td + /tr /table h4Example(s)/h4 pre lt;StaticInterceptor listing=quot;falsequot; /gt; +lt;StaticInterceptor listing=quot;truequot; +useAcceptLanguag=quot;truequot; useCharset=quot;localequot;/gt; +lt;StaticInterceptor listing=quot;truequot; +useAcceptLanguag=quot;truequot; useCharset=quot;UTF-8quot;/gt; +lt;StaticInterceptor listing=quot;truequot; +useAcceptLanguag=quot;falsequot; useCharset=quot;localequot;/gt; /pre hr size=5 -- To unsubscribe, e-mail: mailto:[EMAIL PROTECTED] For additional commands, e-mail: mailto:[EMAIL PROTECTED]
cvs commit: jakarta-tomcat/src/doc serverxml.html
larryi 01/12/31 16:33:20 Modified:src/doc serverxml.html Log: Fix typo Revision ChangesPath 1.14 +2 -2 jakarta-tomcat/src/doc/serverxml.html Index: serverxml.html === RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v retrieving revision 1.13 retrieving revision 1.14 diff -u -r1.13 -r1.14 --- serverxml.html31 Dec 2001 22:30:25 - 1.13 +++ serverxml.html1 Jan 2002 00:33:20 - 1.14 @@ -4,7 +4,7 @@ !DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN html head - !-- $Id: serverxml.html,v 1.13 2001/12/31 22:30:25 larryi Exp $ -- + !-- $Id: serverxml.html,v 1.14 2002/01/01 00:33:20 larryi Exp $ -- !-- Copyright 1999-2001 Apache Software Foundation -- meta http-equiv=Content-Type content=text/html; charset=iso-8859-1 link rel=stylesheet href=style.css @@ -2414,7 +2414,7 @@ /tr tr valign=top tduseCharsetbrb[Tomcat 3.3.1]/b/td -tdSpecfies the desired character set to use for encoding the directory +tdSpecifies the desired character set to use for encoding the directory listings. If unset, the default ISO-8859-1 is used. If set to quot;localequot;, then the locale established by the codeuseAcceptLanguage/code attribute is used./td -- To unsubscribe, e-mail: mailto:[EMAIL PROTECTED] For additional commands, e-mail: mailto:[EMAIL PROTECTED]
cvs commit: jakarta-tomcat/src/doc serverxml.html
larryi 01/12/05 03:28:49
Modified:src/doc serverxml.html
Log:
Document feature updates to ServerXmlReader, ContextXmlReader, and
LoaderInterceptor11, plus other miscellaneous updates.
Revision ChangesPath
1.12 +89 -27jakarta-tomcat/src/doc/serverxml.html
Index: serverxml.html
===
RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- serverxml.html2001/11/08 21:43:24 1.11
+++ serverxml.html2001/12/05 11:28:49 1.12
@@ -4,7 +4,7 @@
!DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN
html
head
- !-- $Id: serverxml.html,v 1.11 2001/11/08 21:43:24 bojan Exp $ --
+ !-- $Id: serverxml.html,v 1.12 2001/12/05 11:28:49 larryi Exp $ --
!-- Copyright 1999-2001 Apache Software Foundation --
meta http-equiv=Content-Type content=text/html; charset=iso-8859-1
link rel=stylesheet href=style.css
@@ -40,14 +40,50 @@
will be read after codeserver.xml/code, allowing local configurations./p
-h3Variable substitution/h3
+h3a name=substitutionVariable substitution/a/h3
-pEach attribute value may use the ant-style variable substitution ( ${variable}
-). The values are stored as ContextManager properties, and defined using
-either lt;property name=quot;fooquot; value=quot;barquot; /gt;, as attributes
in the
-lt;ContextManagergt; element, or in the command line using quot;-foo barquot;
-syntax, or as system properties./p
+pIn Tomcat 3.3.1, each attribute value may use the ant-style variable
+substitution by using quot;${ivariable/i}quot; in the attribute string, i.e.
+iattribute/i=quot;itext/i${ivariable/i}itext/iquot;. (Note: A
+bug prevented this from working in Tomcat 3.3.)/p
+
+pThe ivariable/i must specify a ContextManager property or System property,
+with ContextManager properties taking precedence. If a matching property
+isn't found, the attribute string is left as is. Note that the properties are
+not the same as attributes, and attributes are not accessible via variable
+substitution./p
+
+pThere are two predefined ContextManager properties,
+quot;codetomcat.home/codequot; and quot;codetomcat.install/codequot;.
+These correspond to the ContextManager codehome/code and codeinstallDir/code
+attributes, respectively. There are three methdos for setting additional
+ContextManager properties./p
+
+ol
+ liInclude a codeiname/i=quot;ivalue/iquot;/code
+specification on the ContextManager element in codeserver.xml/code,
+where iname/i doesn't correspond to a ContextManager attribute. For
+example:br
+prelt;ContextManager ... my.prop=myvalue ... gt;/pre/li
+ liInclude a codeProperty/code element within the scope of the
+ContextManager element in codeserver.xml/code. For example:br
+pre
+lt;ContextManager ... gt;
+lt;Property name=quot;my.propquot; value=quot;myvaluequot; /gt;
+...
+lt;/ContextManagergt;/pre
+This form of setting properties is logged if the ContextManager's debug
+level is one or greater.brbr/li
+ liInclude quot;code-iname/i ivalue/i/codequot; as command line
+arguments, where iname/i doesn't match any of the arguments supported
+by the a href=tomcat-ug.html#tomcat_task_argsquot;startquot; task/a.
+For example:br
+prebin/startup.sh -my.prop myvalue/pre/li
+/ol
+pbNote:/b The property values may themselves use quot;variable
+substitutionquot;, provided the specified property is already defined./p
+
h3Common Parameters/h3
pAll modules have the following common attributes:/p
@@ -133,7 +169,7 @@
thDefault/th
/tr
tr valign=top
-tdinstall/td
+tdinstallDir/td
tdBase directory for tomcat installation. It is typically guessed by the
startup program, but you can override it here./td
tdTOMCAT_HOME or one level above the location of the startup script or
@@ -830,8 +866,13 @@
the default context settings./p
pFor details on the syntax of the context configuration file, refer to the
-a href=tomcat-ug.html#customizing_contextsCustomizing Contexts/a section
-of the a href=tomcat-ug.htmlTomcat 3.3 Users Guide/a./p
+a href=tomcat-ug.html#customizing_contextsAdding and Customizing Contexts/a
+section of the a href=tomcat-ug.htmlTomcat 3.3 Users Guide/a./p
+
+pbNote:/b In Tomcat 3.3.1, ant-style variable substitution is supported
+in the XML files. Details are included in the quot;Adding and Customizing
Contextsquot;
+section mentioned above./p
+
h4Attributes/h4
table border=1 cellpadding=2 cellspacing=0
@@ -1404,23 +1445,18 @@
h4Description/h4
-pGenerate configuration file for mod_jk to be included in Apache's httpd.conf./p
+pGenerate configuration file
cvs commit: jakarta-tomcat/src/doc serverxml.html
larryi 01/10/21 08:40:27 Modified:src/doc serverxml.html Log: Fixed typos. Submitted by: Jeff Turner Revision ChangesPath 1.9 +13 -13jakarta-tomcat/src/doc/serverxml.html Index: serverxml.html === RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- serverxml.html2001/10/19 03:16:13 1.8 +++ serverxml.html2001/10/21 15:40:27 1.9 @@ -4,7 +4,7 @@ !DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN html head - !-- $Id: serverxml.html,v 1.8 2001/10/19 03:16:13 larryi Exp $ -- + !-- $Id: serverxml.html,v 1.9 2001/10/21 15:40:27 larryi Exp $ -- !-- Copyright 1999-2001 Apache Software Foundation -- meta http-equiv=Content-Type content=text/html; charset=iso-8859-1 link rel=stylesheet href=style.css @@ -32,7 +32,7 @@ number of settable properties and implements one or more 'hooks', providing a piece of functionality./p -pThe modules can be configured and assembled in sevaral ways, but the +pThe modules can be configured and assembled in several ways, but the default and most flexible mechanism uses XML files. Each module is described by an XML element, with attributes used to set module properties. The main configuration file is located in codeTOMCAT_HOME/conf/server.xml/code, used to @@ -69,8 +69,8 @@ h2Configuration Elements/h2 -pServer.xml is an XML document. Most elements corespond to tomcat modules, -with java setters beeing automatically associated with element attributes. The +pServer.xml is an XML document. Most elements correspond to Tomcat modules, +with Java setters being automatically associated with element attributes. The javadoc will contain most details, in this document we focus on the common and supported behaviors. /p @@ -105,8 +105,8 @@ dl dtlt;imodule_name/igt;/dt ddAdds a module to the configuration. Module names are defined in - module.xml, where each tag is associated with a class name that - implements the module. Each element attribute coresponds to a setter + modules.xml, where each tag is associated with a class name that + implements the module. Each element attribute corresponds to a setter method in the implementing class./dd dtlt;Contextgt;/dt ddDefines a web application. This is a legacy method of specifying a @@ -654,7 +654,7 @@ /tr tr valign=top tdforwardAll/td -tdIf codetrue/code, forward all requests to Tomcat. This helps insure that all the +tdIf codetrue/code, forward all requests to Tomcat. This helps ensure that all the behavior configured in the web.xml file functions correctly. If codefalse/code, let Apache serve static resources. Warning: When codefalse/code, some configuration in the web.xml may not be duplicated in Apache. Review the mod_jk @@ -996,7 +996,7 @@ h4Description/h4 -pHandles incomming HTTP, or optionally HTTPS, requests./p +pHandles incoming HTTP, or optionally HTTPS, requests./p h4Attributes/h4 @@ -1182,7 +1182,7 @@ /tr tr valign=top tdforwardAll/td -tdIf codetrue/code, forward all requests to Tomcat. This helps insure that all the +tdIf codetrue/code, forward all requests to Tomcat. This helps ensure that all the behavior configured in the web.xml file functions correctly. If codefalse/code, let IIS serve static resources. Warning: When codefalse/code, some configuration in the web.xml may not be duplicated in IIS. Review the configuration @@ -1327,7 +1327,7 @@ h4Description/h4 -pInsures that the proper context classloader is in effect during servlet +pEnsures that the proper context classloader is in effect during servlet execution./p h4Attributes/h4 @@ -1449,7 +1449,7 @@ /tr tr valign=top tdforwardAll/td -tdIf codetrue/code, forward all requests to Tomcat. This helps insure that all the +tdIf codetrue/code, forward all requests to Tomcat. This helps ensure that all the behavior configured in the web.xml file functions correctly. If codefalse/code, let Apache serve static resources. Warning: When codefalse/code, some configuration in the web.xml may not be duplicated in Apache. Review the tomcat-apache.conf @@ -1902,7 +1902,7 @@ /tr tr valign=top tdforwardAll/td -tdIf codetrue/code, forward all requests to Tomcat. This helps insure that all the +tdIf codetrue/code, forward all requests to Tomcat. This helps ensure that all the behavior configured in the web.xml file functions correctly. If codefalse/code, let Netscape serve static resources. Warning: When codefalse/code,
cvs commit: jakarta-tomcat/src/doc serverxml.html
larryi 01/10/18 20:16:13
Modified:src/doc serverxml.html
Log:
Finish documenting the modules
Revision ChangesPath
1.8 +246 -173 jakarta-tomcat/src/doc/serverxml.html
Index: serverxml.html
===
RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- serverxml.html2001/10/09 17:46:27 1.7
+++ serverxml.html2001/10/19 03:16:13 1.8
@@ -1,11 +1,12 @@
?xml version=1.0 encoding=iso-8859-1?
!DOCTYPE html PUBLIC -//W3C//DTD XHTML 1.1//EN
http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd;
-html xmlns=http://www.w3.org/1999/xhtml;
+!DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN
+html
head
- !-- $Id: serverxml.html,v 1.7 2001/10/09 17:46:27 larryi Exp $ --
+ !-- $Id: serverxml.html,v 1.8 2001/10/19 03:16:13 larryi Exp $ --
!-- Copyright 1999-2001 Apache Software Foundation --
- meta http-equiv=Content-Type content=text/html; charset=iso-8859-1 /
+ meta http-equiv=Content-Type content=text/html; charset=iso-8859-1
link rel=stylesheet href=style.css
titleServer.xml Configuration in Tomcat 3.3/title
/head
@@ -35,8 +36,8 @@
default and most flexible mechanism uses XML files. Each module is described
by an XML element, with attributes used to set module properties. The main
configuration file is located in codeTOMCAT_HOME/conf/server.xml/code, used to
-configure the server. Additional
/codeTOMCAT_HOME/conf/server-iname/i.xml/code files
-will be read after /codeserver.xml/code, allowing local configurations./p
+configure the server. Additional
codeTOMCAT_HOME/conf/server-iname/i.xml/code files
+will be read after codeserver.xml/code, allowing local configurations./p
h3Variable substitution/h3
@@ -44,7 +45,7 @@
pEach attribute value may use the ant-style variable substitution ( ${variable}
). The values are stored as ContextManager properties, and defined using
either lt;property name=quot;fooquot; value=quot;barquot; /gt;, as attributes
in the
-lt;ContextManagergt; element, or in the command line using -foo bar
+lt;ContextManagergt; element, or in the command line using quot;-foo barquot;
syntax, or as system properties./p
h3Common Parameters/h3
@@ -129,14 +130,14 @@
tr valign=top
thAttribute/th
thDescription/th
-tdDefault/th
+thDefault/th
/tr
tr valign=top
tdinstall/td
tdBase directory for tomcat installation. It is typically guessed by the
startup program, but you can override it here./td
tdTOMCAT_HOME or one level above the location of the startup script or
- tomcat.jar (if java -jar is used for startup)./td
+ tomcat.jar (if quot;java -jarquot; is used for startup)./td
/tr
tr valign=top
tdworkDir/td
@@ -192,7 +193,6 @@
lia href=#LoaderInterceptor11LoaderInterceptor11/a/li
lia href=#LogSetterLogSetter/a/li
lia href=#NSConfigNSConfig/a/li
- lia href=#PathSetterPathSetter/a/li
lia href=#PolicyLoaderPolicyLoader/a/li
lia href=#TrustedLoaderTrustedLoader/a/li
lia href=#WorkDirSetupWorkDirSetup/a/li
@@ -215,7 +215,6 @@
liLoggers
ul
lia href=#AccessLogInterceptorAccessLogInterceptor/a/li
- lia href=#AccountingInterceptorAccountingInterceptor/a/li
lia href=#LogEventsLogEvents/a/li
/ul/li
liMappers
@@ -282,45 +281,12 @@
!-- --
h3a name=AccessLogInterceptorAccessLogInterceptor/a/h3
-
-pbType:/b /p
-
-h4Description/h4
-
-p/p
-
-h4Attributes/h4
-
-table border=1 cellpadding=2 cellspacing=0
- tr valign=top
-thAttribute/th
-thDescription/th
-thDefault/th
- /tr
- tr valign=top
-tdnbsp;/td
-tdnbsp;/td
-tdnbsp;/td
- /tr
-/table
-
-h4Example(s)/h4
-pre
-
-/pre
+pbType:/b Loggers/p
-hr size=5
-
-!-- --
-
-h3a name=AccountingInterceptorAccountingInterceptor/a/h3
-
-pbType:/b /p
-
h4Description/h4
-p/p
+pCreates log files in the style of the Apache servers quot;AccessLogquot;./p
h4Attributes/h4
@@ -331,16 +297,91 @@
thDefault/th
/tr
tr valign=top
-tdnbsp;/td
-tdnbsp;/td
-tdnbsp;/td
+tdlogFile/td
+tdName of the log file./td
+tdlogs/AccessLog/td
+ /tr
+ tr valign=top
+tdformat/td
+tdA string describing the logfile format. Possible values are
+ quot;combinedquot; (Apache httpd combined format, default),
+ quot;commonquot; (Apache httpd common format) or a format string like
+ pre
+'%h %l %u %t quot;%rquot; %s %b quot;%{Referer}quot;
quot;%{User-Agent}quot;'
+
cvs commit: jakarta-tomcat/src/doc serverxml.html
larryi 01/10/01 19:52:39 Modified:src/doc serverxml.html Log: Document some more modules. Revision ChangesPath 1.5 +454 -5jakarta-tomcat/src/doc/serverxml.html Index: serverxml.html === RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- serverxml.html2001/09/18 03:25:57 1.4 +++ serverxml.html2001/10/02 02:52:39 1.5 @@ -3,7 +3,7 @@ http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd; html xmlns=http://www.w3.org/1999/xhtml; head - !-- $Id: serverxml.html,v 1.4 2001/09/18 03:25:57 larryi Exp $ -- + !-- $Id: serverxml.html,v 1.5 2001/10/02 02:52:39 larryi Exp $ -- !-- Copyright 1999-2001 Apache Software Foundation -- meta http-equiv=Content-Type content=text/html; charset=iso-8859-1 / link rel=stylesheet href=style.css @@ -336,12 +336,185 @@ h3a name=Ajp12ConnectorAjp12Connector/a/h3 +pbType:/b Server/p + +h4Description/h4 + +pHandle incoming Ajp12 requests. Ajp12 is a protocol used by the mod_jk +based web server connectors and the mod_jserv connector./p + +h4Parameters/h4 + +table border=1 cellpadding=2 cellspacing=0 + tr valign=top +thAttribute/th +thDescription/th +thDefault/th + /tr + tr valign=top +tdajpidFile/td +tdFile in which to record Ajp12 connector info and password./a./td +tdconf/ajp12.id/td + /tr + tr valign=top +tdsecret/td +tdThe desired shutdown password./td +tdinot specified/i/td + /tr + tr valign=top +tdtomcatAuthentication/td +tdEnables Tomcat's authentication, ignoring any authentication from the + web server sending the requests./td +tdtrue/td + /tr + tr valign=top +tduseSecret/td +tdEnables use of a random number as the shutdown password./td +tdfalse/td + /tr + tr valign=top +tdbSocket Properties/b/td +tdnbsp;/td +tdnbsp;/td + /tr + tr valign=top +tdaddress/td +tdAddress to which the server socket binds./td +tdinull, bind on all addresses/i/td + /tr + tr valign=top +tdbacklog/td +tdMaximum length of the backlog queue for the server socket./td +td100/td + /tr + tr valign=top +tdport/td +tdPort on which to receive requests./td +tdino default, must be specified/i/td + /tr + tr valign=top +tdbThread Pool Properties/b/td +tdnbsp;/td +tdnbsp;/td + /tr + tr valign=top +tdmaxThreads/td +tdMaximum number of threads in Thread pool./td +td200/td + /tr + tr valign=top +tdmaxSpareThreads/td +tdMaximun number of spare threads. Unused threads will be terminated as + needed to keep the number of spare threads under this number./td +td50/td + /tr + tr valign=top +tdminSpareThreads/td +tdMinimum number of spare threads. Additional threads will be created + as needed to keep the number of spare threads up to this number./td +td4/td + /tr + tr valign=top +tdpools/td +tdEnables use of a Thread pool./td +tdtrue/td + /tr +/table + +h4Example(s)/h4 + +pre +lt;Ajp12Interceptor port=quot;8007quot; ajpidFile=conf/ajp12_2.id /gt; +/pre + hr size=5 !-- -- h3a name=Ajp13ConnectorAjp13Connector/a/h3 +pbType:/b Server/p + +h4Description/h4 + +pHandle incoming Ajp13 requests. Ajp13 is a protocol used by the mod_jk +based web server connectors./p + +h4Parameters/h4 + +table border=1 cellpadding=2 cellspacing=0 + tr valign=top +thAttribute/th +thDescription/th +thDefault/th + /tr + tr valign=top +tdshutDownEnable/td +tdEnable shutdown signal via this connector. Normally shutdown is done + through a href=#Ajp12InterceptorAjp12Interceptor/a./td +tdfalse/td + /tr + tr valign=top +tdtomcatAuthentication/td +tdEnables Tomcat's authentication, ignoring any authentication from the + web server sending the requests./td +tdtrue/td + /tr + tr valign=top +tdbSocket Properties/b/td +tdnbsp;/td +tdnbsp;/td + /tr + tr valign=top +tdaddress/td +tdAddress to which the server socket binds./td +tdinull, bind on all addresses/i/td + /tr + tr valign=top +tdbacklog/td +tdMaximum length of the backlog queue for the server socket./td +td100/td + /tr + tr valign=top +tdport/td +tdPort on which to receive requests./td +tdino default, must be specified/i/td + /tr + tr valign=top +tdbThread Pool Properties/b/td +tdnbsp;/td +tdnbsp;/td + /tr + tr valign=top +tdmaxThreads/td +tdMaximum number of threads
cvs commit: jakarta-tomcat/src/doc serverxml.html
larryi 01/09/17 20:25:57
Modified:src/doc serverxml.html
Log:
Update with the modules I have documented so far.
Revision ChangesPath
1.4 +936 -119 jakarta-tomcat/src/doc/serverxml.html
Index: serverxml.html
===
RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- serverxml.html2001/09/03 02:13:15 1.3
+++ serverxml.html2001/09/18 03:25:57 1.4
@@ -3,7 +3,7 @@
http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd;
html xmlns=http://www.w3.org/1999/xhtml;
head
- !-- $Id: serverxml.html,v 1.3 2001/09/03 02:13:15 larryi Exp $ --
+ !-- $Id: serverxml.html,v 1.4 2001/09/18 03:25:57 larryi Exp $ --
!-- Copyright 1999-2001 Apache Software Foundation --
meta http-equiv=Content-Type content=text/html; charset=iso-8859-1 /
link rel=stylesheet href=style.css
@@ -172,7 +172,7 @@
be grouped as follows:/p
ul
- liAccess Authentication and Authorization
+ liAccess, Authentication, and Authorization
ul
lia href=#AccessInterceptorAccessInterceptor/a/li
lia href=#CredentialsInterceptorCredentialsInterceptor/a/li
@@ -202,7 +202,7 @@
lia href=#Jdk12InterceptorJdk12Interceptor/a/li
lia href=#StaticInterceptorStaticInterceptor/a/li
/ul/li
- liFacade
+ liServlet 2.2 Facade
ul
lia href=#WebXmlReaderWebXmlReader/a/li
lia href=#JspInterceptorJspInterceptor/a/li
@@ -242,51 +242,6 @@
!-- --
-h3PolicyLoader/h3
-
-h4 id=Descriptio3Description/h4
-
-pRun tomcat in a sandbox. The module will be active only if sandbox
-property is set on the ContextManager ( as an attribute or via a command line
-option ). This minimizes the number of command line arguments.
-Note that it is required to define the policy file before starting tomcat
-( in some VMs it works if you set it at runtime, but it's safer to set it
-in the command line )./p
-
-pMake sure -Djava.security.policy=$TOMCAT_HOME/lib/tomcat.policy is
-included in the startup line, or an equivalent policy is present in the
-embedding system/p
-
-h4 id=Parameters3Parameters/h4
-
-table border=1 cellpadding=2 cellspacing=0
- tbody
-tr valign=top
- tdbAttribute/b/td
- tdbDescription/b/td
- tdpbDefault/b/p
- /td
-/tr
-tr valign=top
- tdsecurityManagerClass/td
- tdCustomize the security manager/td
- tdpjava.lang.SecurityManager/p
- /td
-/tr
-tr valign=top
- tdsandbox/td
- tdForce the use of a sandbox, regardless of command line/td
- tdfalse
- /td
-/tr
- /tbody
-/table
-
-h4Examples/h4
-prelt;PolicyLoader /gt;/pre
-
-!-- --
-
h3ELEMENT/h3
pbType:/b /p
@@ -332,22 +287,63 @@
h3a name=AccessInterceptorAccessInterceptor/a/h3
+pbType:/b Access, Authentication, and Authorization/p
+
+h4Description/h4
+
+pDetermines if security constraints specified in the web.xml apply to
+a request and provides the handling for BASIC and FORM authentication if
+necessary./p
+
+h4Parameters/h4
+
+table border=1 cellpadding=2 cellspacing=0
+ tr valign=top
+thAttribute/th
+thDescription/th
+thDefault/th
+ /tr
+ tr valign=top
+tdignoreCase/td
+tdEnables case insensitive operation when matching a request to a
+ security constraint./td
+tdfalse on Unix based systemsbr
+ true on Windows based systems/td
+ /tr
+/table
+
+h4Example(s)/h4
+
+pre
+lt;AccessInterceptor /gt;
+/pre
+
+hr size=5
+
!-- --
h3a name=AccessLogInterceptorAccessLogInterceptor/a/h3
+hr size=5
+
!-- --
h3a name=AccountingInterceptorAccountingInterceptor/a/h3
+hr size=5
+
!-- --
h3a name=Ajp12ConnectorAjp12Connector/a/h3
+hr size=5
+
!-- --
h3a name=Ajp13ConnectorAjp13Connector/a/h3
+hr size=5
+
!-- --
h3a name=ApacheConfigApacheConfig/a/h3
@@ -408,7 +404,7 @@
tr valign=top
tdjkLog/td
tdPath to log file to be used by mod_jk./td
-td/td
+tdlogs/mod_jk.log/td
/tr
tr valign=top
tdjkDebug/td
@@ -475,7 +471,7 @@
/tr
tr valign=top
tdsource/td
-tdDirectory where .war files are located./td
+tdDirectory where quot;.warquot; files are located./td
td${tomcat.home}/webapps/td
/tr
tr valign=top
@@ -507,7 +503,7 @@
h4Description/h4
-pAutomatically
cvs commit: jakarta-tomcat/src/doc serverxml.html
larryi 01/09/02 19:13:15 Modified:src/doc serverxml.html Log: Document a couple more modules. Revision ChangesPath 1.3 +167 -10 jakarta-tomcat/src/doc/serverxml.html Index: serverxml.html === RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- serverxml.html2001/08/27 02:19:10 1.2 +++ serverxml.html2001/09/03 02:13:15 1.3 @@ -3,7 +3,7 @@ http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd; html xmlns=http://www.w3.org/1999/xhtml; head - !-- $Id: serverxml.html,v 1.2 2001/08/27 02:19:10 larryi Exp $ -- + !-- $Id: serverxml.html,v 1.3 2001/09/03 02:13:15 larryi Exp $ -- !-- Copyright 1999-2001 Apache Software Foundation -- meta http-equiv=Content-Type content=text/html; charset=iso-8859-1 / link rel=stylesheet href=style.css @@ -84,7 +84,7 @@ pThis is the main element in server.xml. It has a single child describing the tomcat configuration, ContextManager./p -h4 id=ExamplesExamples/h4 +h4Examples/h4 prelt;Servergt; lt;ContextManager gt; ... ( tomcat configuration ) @@ -95,7 +95,7 @@ h3ContextManager/h3 -h4 id=DescriptioDescription/h4 +h4Description/h4 pThis is the main tag, used to set generic Tomcat options. The following are some of the childen it supports:/p @@ -121,7 +121,7 @@ in ant./dd /dl -h4 id=ParametersParameters/h4 +h4Parameters/h4 table border=1 cellpadding=2 cellspacing=0 tr valign=top @@ -151,7 +151,7 @@ /tr /table -h4 id=Examples1Examples/h4 +h4Example(s)/h4 pre lt;ContextManager install=quot;/opt/tomcatquot; workDir=quot;/var/tomcatquot; home=quot;/varquot; /gt; /pre @@ -320,7 +320,7 @@ /tr /table -h4Examples/h4 +h4Example(s)/h4 pre @@ -358,6 +358,22 @@ pGenerate configuration file for mod_jk to be included in Apache's httpd.conf./p +pFor additional information on connecting Tomcat to Apache via mod_jk, see the +a href=mod_jk-howto.htmlWorking with mod_jk/a document./p + +pbImportant Note:/b The configuration files are not written as part of a +normal startup of Tomcat. To generate the configuration files on demand, +append: +prejkconf/pre +or +pre-jkconf/pre +to the startup command. Tomcat will initialize sufficiently to write the +configuration files and then exit. This may be done while Tomcat 3.3 is running. +To generate the configuration files during normal startup, add: +prejkconf=quot;truequot;/pre +to the codelt;ContextManager ... gt;/code element in the +codeserver.xml/code file./p + h4Parameters/h4 table border=1 cellpadding=2 cellspacing=0 @@ -431,7 +447,7 @@ /tr /table -h4Examples/h4 +h4Example(s)/h4 pre lt;ApacheConfig forwardAll=quot;truequot; noRoot=quot;falsequot; /gt; @@ -475,7 +491,7 @@ /tr /table -h4Examples/h4 +h4Example(s)/h4 pre lt;AutoDeploy source=quot;webappsquot; target=quot;webappsquot; /gt; @@ -541,7 +557,7 @@ /tr /table -h4Examples/h4 +h4Example(s)/h4 pre lt;AutoWebApp dir=quot;webappsquot; host=quot;DEFAULTquot; /gt; @@ -554,6 +570,45 @@ h3a name=ContextXmlReaderContextXmlReader/a/h3 +pbType:/bConfiguration/p + +h4Description/h4 + +pThis module is responsible for reading the XML files that specify contexts to +be served by Tomcat. You specify a single file to read. However, in addition +to that file, all other files in the same directory will be read that match the +pattern quot;ibase/i-*.xmlquot;, where ibase/i is the base name (i.e. +no extension) of the file you specified. Each file may configure one or more +context. Where the context matches a context automatically created by the +a href=#AutoWebAppAutoWebApp/a module, the configuration file will override +the defaults context settings./p + +pFor details on the syntax of the context configuration file, refer to the +a href=tomcat-ug.htmlTomcat 3.3 Users Guide/a./p +h4Parameters/h4 + +table border=1 cellpadding=2 cellspacing=0 + tr valign=top +thAttribute/th +thDescription/th +thDefault/th + /tr + tr valign=top +tdconfig/td +tdContext configuration file to read. It may configure one or more + contexts./td +tdconf/server.xml/td + /tr +/table + +h4Example(s)/h4 + +pre + lt;ContextXmlReader config=quot;conf/myapps.xmlquot; /gt; +/pre + +hr size=5 + !-- -- h3a name=CredentialsInterceptorCredentialsInterceptor/a/h3 @@ -574,6 +629,108 @@ h3a name=IISConfigIISConfig/a/h3 +pbType:/b Configuration/p + +h4Description/h4 + +pGenerate configuration files for
cvs commit: jakarta-tomcat/src/doc serverxml.html
larryi 01/08/26 19:19:10
Modified:src/doc serverxml.html
Log:
Added alphabetical list of standard modules, plus a bit of rearranging
and miscellaneous editing.
Revision ChangesPath
1.2 +575 -218 jakarta-tomcat/src/doc/serverxml.html
Index: serverxml.html
===
RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- serverxml.html2001/08/21 05:58:36 1.1
+++ serverxml.html2001/08/27 02:19:10 1.2
@@ -3,32 +3,45 @@
http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd;
html xmlns=http://www.w3.org/1999/xhtml;
head
+ !-- $Id: serverxml.html,v 1.2 2001/08/27 02:19:10 larryi Exp $ --
+ !-- Copyright 1999-2001 Apache Software Foundation --
meta http-equiv=Content-Type content=text/html; charset=iso-8859-1 /
+ link rel=stylesheet href=style.css
titleServer.xml configuration in tomcat 3.3/title
- meta name=CREATED content=20010812;22403100 /
- meta name=CHANGED content=20010813;9534200 /
/head
body
+!-- Banner element, all hail the Project! --
+
+table border=0 width=100% cellspacing=0 cellpadding=0
+ tr
+ td width=50%a
+ href=http://jakarta.apache.org/index.html;img
+ src=images/banner.gif width=350 height=100
+ alt=The Jakarta Project border=0/a/td
+ td width=50% align=rightimg border=0 src=images/tomcat.gif
width=100 height=71 alt=The mighty Tomcat - Meow!/td
+ /tr
+/table
+
h2General configuration/h2
pTomcat is implemented using a set of modules. Each module has a
-number of settable properties and implements one or few 'hooks', implementing a
+number of settable properties and implements one or more 'hooks', providing a
piece of functionality./p
pThe modules can be configured and assembled in sevaral ways, but the
default and most flexible mechanism uses XML files. Each module is described
by an XML element, with attributes used to set module properties. The main
-configuration file is located in TOMCAT_HOME/conf/server.xml, used to
-configure the server. Additional TOMCAT_HOME/conf/server-[NAME].xml files
-will be read after server.xml, allowing local configurations./p
+configuration file is located in codeTOMCAT_HOME/conf/server.xml/code, used to
+configure the server. Additional
/codeTOMCAT_HOME/conf/server-iname/i.xml/code files
+will be read after /codeserver.xml/code, allowing local configurations./p
h3Variable substitution/h3
-pEach attribute value may use ant-style variable substitution ( ${variable}
+pEach attribute value may use the ant-style variable substitution ( ${variable}
). The values are stored as ContextManager properties, and defined using
-either lt;property name='foo' value='bar' /gt;, as attributes in the
+either lt;property name=quot;fooquot; value=quot;barquot; /gt;, as attributes
in the
lt;ContextManagergt; element, or in the command line using -foo bar
syntax, or as system properties./p
@@ -37,23 +50,18 @@
pAll modules have the following common attributes:/p
table border=1 cellpadding=2 cellspacing=0
- tbody
-tr valign=top
- tdpbAttribute/b/p
- /td
- tdpbDescription/b/p
- /td
- tdpbDefault/b/p
- /td
-/tr
-tr valign=top
- tdpdebug/p
- /td
- tdpDisplay debug information on the module execution/p
- /td
- td0/td
-/tr
- /tbody
+ tr valign=top
+thAttribute/th
+thDescription/th
+thDefault/th
+ /tr
+ tr valign=top
+tdpdebug/p
+/td
+tdpDisplay debug information on the module execution/p
+/td
+td0/td
+ /tr
/table
h2Configuration Elements/h2
@@ -63,6 +71,12 @@
javadoc will contain most details, in this document we focus on the common
and supported behaviors. /p
+h2Parent Configuration Elements/h2
+
+pThe purpose of the server.xml is to define the configuration of an instance
+of the Tomcat 3.3 web server. The parent configuration elements in the
+server.xml file represent that instance./p
+
!-- --
h3Server/h3
@@ -83,125 +97,149 @@
h4 id=DescriptioDescription/h4
-pMain tag, used to set generic tomcat options. It has few types of
-childrens:/p
+pThis is the main tag, used to set generic Tomcat options. The following are
+some of the childen it supports:/p
dl
- dtlt;[MODULE_NAME]gt;/dt
-ddDefine a module. Module names are defined in module.xml, where each tag is
- associated with a class name that implements the module. Each element
- attribute coresponds to a setter method in the implementing class /dd
+ dtlt;imodule_name/igt;/dt
+
