source: nutchez-0.1/tomcat/webapps/docs/config/systemprops.html @ 160

Last change on this file since 160 was 66, checked in by waue, 16 years ago

NutchEz - an easy way to nutch
File size: 19.9 KB
Line 
1<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>Apache Tomcat Configuration Reference - System Properties</title></head><body vlink="#525D76" alink="#525D76" link="#525D76" text="#000000" bgcolor="#ffffff"><table cellspacing="0" width="100%" border="0"><!--PAGE HEADER--><tr><td><!--PROJECT LOGO--><a href="http://tomcat.apache.org/"><img border="0" alt="
2    The Apache Tomcat Servlet/JSP Container
3  " align="right" src="../images/tomcat.gif"></a></td><td><font face="arial,helvetica,sanserif"><h1>Apache Tomcat 6.0</h1></font></td><td><!--APACHE LOGO--><a href="http://www.apache.org/"><img border="0" alt="Apache Logo" align="right" src="../images/asf-logo.gif"></a></td></tr></table><table cellspacing="4" width="100%" border="0"><!--HEADER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade></td></tr><tr><!--LEFT SIDE NAVIGATION--><td nowrap="true" valign="top" width="20%"><p><strong>Links</strong></p><ul><li><a href="../index.html">Docs Home</a></li><li><a href="index.html">Config Ref. Home</a></li></ul><p><strong>Top Level Elements</strong></p><ul><li><a href="server.html">Server</a></li><li><a href="service.html">Service</a></li></ul><p><strong>Executors</strong></p><ul><li><a href="executor.html">Executor</a></li></ul><p><strong>Connectors</strong></p><ul><li><a href="http.html">HTTP</a></li><li><a href="ajp.html">AJP</a></li></ul><p><strong>Containers</strong></p><ul><li><a href="context.html">Context</a></li><li><a href="engine.html">Engine</a></li><li><a href="host.html">Host</a></li><li><a href="cluster.html">Cluster</a></li></ul><p><strong>Nested Components</strong></p><ul><li><a href="globalresources.html">Global Resources</a></li><li><a href="loader.html">Loader</a></li><li><a href="manager.html">Manager</a></li><li><a href="realm.html">Realm</a></li><li><a href="resources.html">Resources</a></li><li><a href="valve.html">Valve</a></li></ul><p><strong>Cluster Elements</strong></p><ul><li><a href="cluster.html">Cluster</a></li><li><a href="cluster-manager.html">Manager</a></li><li><a href="cluster-channel.html">Channel</a></li><li><a href="cluster-membership.html">Channel/Membership</a></li><li><a href="cluster-sender.html">Channel/Sender</a></li><li><a href="cluster-receiver.html">Channel/Receiver</a></li><li><a href="cluster-interceptor.html">Channel/Interceptor</a></li><li><a href="cluster-valve.html">Valve</a></li><li><a href="cluster-deployer.html">Deployer</a></li><li><a href="cluster-listener.html">ClusterListener</a></li></ul><p><strong>Global Settings</strong></p><ul><li><a href="systemprops.html">System properties</a></li></ul></td><!--RIGHT SIDE MAIN BODY--><td align="left" valign="top" width="80%"><table cellspacing="4" width="100%" border="0"><tr><td valign="top" align="left"><h1>Apache Tomcat Configuration Reference</h1><h2>System Properties</h2></td><td nowrap="true" valign="top" align="right"><small><a href="printer/systemprops.html"><img alt="Printer Friendly Version" border="0" src="../images/printer.gif"><br>print-friendly<br>version
4                    </a></small></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote>
5  <p>The follow sections list the system properties that may be set to modify
6  the default Tomcat behaviour.</p>
7</blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Clustering"><strong>Clustering</strong></a></font></td></tr><tr><td><blockquote>
8  <table cellpadding="5" border="1"><tr><th bgcolor="#023264" width="15%"><font color="#ffffff">Property</font></th><th bgcolor="#023264" width="85%"><font color="#ffffff">Description</font></th></tr><tr><td valign="center" align="left"><code>org.apache.catalina. tribes.dns_lookups</code></td><td valign="center" align="left">
9      <p>If <code>true</code>, the clustering module will attempt to use DNS to
10      resolve any host names provided in the cluster configuration. If not
11      specified, the default value of <code>false</code> will be used.</p>
12    </td></tr></table>
13
14</blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Expression Language"><strong>Expression Language</strong></a></font></td></tr><tr><td><blockquote>
15  <table cellpadding="5" border="1"><tr><th bgcolor="#023264" width="15%"><font color="#ffffff">Property</font></th><th bgcolor="#023264" width="85%"><font color="#ffffff">Description</font></th></tr><tr><td valign="center" align="left"><code>org.apache.el.parser.COERCE_TO_ZERO</code></td><td valign="center" align="left">
16      <p>If <code>true</code>, when coercing expressions to numbers
17      <code>""</code> and <code>null</code> will be coerced to zero as required
18      by the specification. If not specified, the default value of
19      <code>true</code> will be used.</p>
20    </td></tr></table>
21</blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Jasper"><strong>Jasper</strong></a></font></td></tr><tr><td><blockquote>
22  <table cellpadding="5" border="1"><tr><th bgcolor="#023264" width="15%"><font color="#ffffff">Property</font></th><th bgcolor="#023264" width="85%"><font color="#ffffff">Description</font></th></tr><tr><td valign="center" align="left"><code>org.apache.jasper.compiler. Generator.VAR_EXPRESSIONFACTORY</code></td><td valign="center" align="left">
23      <p>The name of the variable to use for the expression language expression
24      factory. If not specified, the default value of
25      <code>_el_expressionfactory</code> will be used.</p>
26    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.compiler. Generator.VAR_INSTANCEMANAGER</code></td><td valign="center" align="left">
27      <p>The name of the variable to use for the instance manager factory. If
28      not specified, the default value of <code>_jsp_instancemanager</code> will
29      be used.</p>
30    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.compiler. Parser.STRICT_QUOTE_ESCAPING</code></td><td valign="center" align="left">
31      <p>If <code>false</code> the requirements for escpaing quotes in JSP
32      attributes will be relaxed so that a missing required quote will not
33      cause an error. If not specified, the specification compliant default of
34      <code>true</code> will be used.</p>
35    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.runtime. BodyContentImpl.LIMIT_BUFFER</code></td><td valign="center" align="left">
36      <p>If <code>true</code>, any tag buffer that expands beyond
37      <code>org.apache.jasper.Constants.DEFAULT_TAG_BUFFER_SIZE</code> will be
38      destroyed and a new buffer created of the default size. If not specified,
39      the default value of <code>false</code> will be used.</p>
40    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.runtime. JspFactoryImpl.USE_POOL</code></td><td valign="center" align="left">
41      <p>If <code>true</code>, a ThreadLocal <code>PageContext</code> pool will
42      be used. If not specified, the default value of <code>true</code> will be
43      used.</p>
44    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.runtime. JspFactoryImpl.POOL_SIZE</code></td><td valign="center" align="left">
45      <p>The size of the ThreadLocal <code>PageContext</code>. If not specified,
46      the default value of <code>8</code> will be used.</p>
47    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. JSP_SERVLET_BASE</code></td><td valign="center" align="left">
48      <p>The base class of the Servlets generated from the JSPs. If not
49      specified, the default value of
50      <code>org.apache.jasper.runtime.HttpJspBase</code> will be used.</p>
51    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. SERVICE_METHOD_NAME</code></td><td valign="center" align="left">
52      <p>The name of the service method called by the base class. If not
53      specified, the default value of <code>_jspService</code> will be used.</p>
54    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. SERVLET_CLASSPATH</code></td><td valign="center" align="left">
55      <p>The name of the ServletContext attribute that provides the classpath
56      for the JSP. If not specified, the default value of
57      <code>org.apache.catalina.jsp_classpath</code> will be used.</p>
58    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. JSP_FILE</code></td><td valign="center" align="left">
59      <p>The name of the request attribute for <code>&lt;jsp-file&gt;</code>
60      element of a servlet definition. If present on a request, this overrides
61      the value returned by <code>request.getServletPath()</code> to select the
62      JSP page to be executed. If not specified, the default value of
63      <code>org.apache.catalina.jsp_file</code> will be used.</p>
64    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. PRECOMPILE</code></td><td valign="center" align="left">
65      <p>The name of the query parameter that causes the JSP engine to just
66      pregenerate the servlet but not invoke it. If not specified, the default
67      value of <code>org.apache.catalina.jsp_precompile</code> will be used.</p>
68    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. JSP_PACKAGE_NAME</code></td><td valign="center" align="left">
69      <p>The default package name for compiled jsp pages. If not specified, the
70      default value of <code>org.apache.jsp</code> will be used.</p>
71    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. TAG_FILE_PACKAGE_NAME</code></td><td valign="center" align="left">
72      <p>The default package name for tag handlers generated from tag files. If
73      not specified, the default value of <code>org.apache.jsp.tag</code> will
74      be used.</p>
75    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. ALT_DD_ATTR</code></td><td valign="center" align="left">
76      <p>The servlet context attribute under which the alternate deployment
77      descriptor for this web application is stored. If not specified, the
78      default value of <code>org.apache.catalina.deploy.alt_dd</code> will
79      be used.</p>
80    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. TEMP_VARIABLE_NAME_PREFIX</code></td><td valign="center" align="left">
81      <p>Prefix to use for generated temporary variable names. If not specified,
82      the default value of <code>_jspx_temp</code> will be used.</p>
83    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. USE_INSTANCE_MANAGER_FOR_TAGS</code></td><td valign="center" align="left">
84      <p>If <code>true</code>, the instance manager is used to obtain tag
85      handler instances. If not specified, <code>false</code> will be used.</p>
86    </td></tr></table>
87
88</blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Security"><strong>Security</strong></a></font></td></tr><tr><td><blockquote>
89
90  <table cellpadding="5" border="1"><tr><th bgcolor="#023264" width="15%"><font color="#ffffff">Property</font></th><th bgcolor="#023264" width="85%"><font color="#ffffff">Description</font></th></tr><tr><td valign="center" align="left"><code>org.apache.catalina.connector. RECYCLE_FACADES</code></td><td valign="center" align="left">
91      <p>If this is <code>true</code> or if a security manager is in use a new
92      facade object will be created for each request. If not specified, the
93      default value of <code>false</code> will be used.</p>
94    </td></tr><tr><td valign="center" align="left"><code>org.apache.catalina.connector. CoyoteAdapter.ALLOW_BACKSLASH</code></td><td valign="center" align="left">
95      <p>If this is <code>true</code> the '\' character will be permitted as a
96      path delimiter. If not specified, the default value of <code>false</code>
97      will be used.</p>
98    </td></tr><tr><td valign="center" align="left"><code>org.apache.tomcat.util.buf. UDecoder.ALLOW_ENCODED_SLASH</code></td><td valign="center" align="left">
99      <p>If this is <code>true</code> '%2F' and '%5C' will be permitted as path
100      delimiters. If not specified, the default value of <code>false</code> will
101      be used.</p>
102    </td></tr><tr><td valign="center" align="left"><code>org.apache.coyote. USE_CUSTOM_STATUS_MSG_IN_HEADER</code></td><td valign="center" align="left"><p>If this is
103      <code>true</code> custom HTTP status messages will be used within HTTP
104      headers. Users must ensure that any such message is ISO-8859-1 encoded,
105      particularly if user provided input is included in the message, to prevent
106      a possible XSS vulnerability. If not specified the default value of
107      <code>false</code> will be used.</p>
108    </td></tr></table>
109
110</blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Specification"><strong>Specification</strong></a></font></td></tr><tr><td><blockquote>
111
112  <table cellpadding="5" border="1"><tr><th bgcolor="#023264" width="15%"><font color="#ffffff">Property</font></th><th bgcolor="#023264" width="85%"><font color="#ffffff">Description</font></th></tr><tr><td valign="center" align="left"><code>org.apache.catalina. STRICT_SERVLET_COMPLIANCE</code></td><td valign="center" align="left">
113      <p>If this is <code>true</code> the following actions will occur:
114      <ul>
115      <li>any wrapped request or response object passed to an application
116      dispatcher will be checked to ensure that it has wrapped the original
117      request or response. (SRV.8.2 / SRV.14.2.5.1)
118      </li>
119      <li>a call to <code>Response.getWriter()</code> if no character encoding
120      has been specified will result in subsequent calls to
121      <code>Response.getCharacterEncoding()</code> returning
122      <code>ISO-8859-1</code> and the <code>Content-Type</code> response header
123      will include a <code>charset=ISO-8859-1</code> component. (SRV.15.2.22.1)
124      </li>
125      <li>every request that is associated with a session will cause the
126      session's last accessed time to be updated regardless of whether or not
127      the request explicity accesses the session. (SRV.7.6) 
128      </li>
129      <li>
130        cookies will be parsed strictly, by default v0 cookies will not work with any invalid characters.
131        <br>If set to false, any v0 cookie with invalid character will be switched to a v1 cookie and
132        the value will be quoted.
133      </li>
134      <li>
135        <code>ServletContext.getResource/getResourceAsStream</code> must start with "/"<br>
136        if set to false, code like <code>getResource("myfolder/myresource.txt")</code> will work
137      </li>
138      </ul>
139      </p>
140    </td></tr><tr><td valign="center" align="left"><code>org.apache.catalina.session. StandardSession.ACTIVITY_CHECK</code></td><td valign="center" align="left">
141      <p>If this is <code>true</code> or if
142      <code>org.apache.catalina.STRICT_SERVLET_COMPLIANCE</code> is
143      <code>true</code> Tomcat will track the number of active requests for each
144      session. When determining if a session is valid, any session with at least
145      one active request will always be considered valid. If not specified, the
146      default value of <code>false</code> will be used.</p>
147    </td></tr></table>
148
149</blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Other"><strong>Other</strong></a></font></td></tr><tr><td><blockquote>
150
151  <table cellpadding="5" border="1"><tr><th bgcolor="#023264" width="15%"><font color="#ffffff">Property</font></th><th bgcolor="#023264" width="85%"><font color="#ffffff">Description</font></th></tr><tr><td valign="center" align="left"><code>catalina.useNaming</code></td><td valign="center" align="left">
152      <p>If this is <code>false</code> it will override the
153      <code>useNaming</code> attribute for all <a href="context.html">
154      Context</a> elements.</p>
155    </td></tr><tr><td valign="center" align="left"><code>jvmRoute</code></td><td valign="center" align="left">
156      <p>Provides a default value for the <code>jvmRoute</code> attribute of the
157      <a href="engine.html">Engine</a> element. It does not override the a value
158      configured on the <a href="engine.html">Engine</a> element.</p>
159    </td></tr><tr><td valign="center" align="left"><code>org.apache.catalina.loader. WebappClassLoader.ENABLE_CLEAR_REFERENCES</code></td><td valign="center" align="left">
160      <p>If <code>true</code>, Tomcat attempts to null out any static or final
161      fields from loaded classes when a web application is stopped as a work
162      around for apparent garbage collection bugs and application coding errors.
163      </p>
164      <p>There have been some issues reported with log4j when this option is
165      <code>true</code>.</p>
166      <p>Applications without memory leaks using recent JVMs should operate
167      correctly with this option set to <code>false</code>.</p>
168      <p>If not specified, the default value of <code>true</code> will be used.
169      </p>
170    </td></tr><tr><td valign="center" align="left"><code>catalina.config</code></td><td valign="center" align="left">
171      <p>The URL for the catalina.properties configuration file.</p>
172    </td></tr><tr><td valign="center" align="left"><code>tomcat.util.buf.StringCache.byte.enabled</code></td><td valign="center" align="left">
173      <p>If <code>true</code>, the String cache is enabled for
174      <code>ByteChunk</code>. If not specified, the default value of
175      <code>false</code> will be used.</p>
176    </td></tr><tr><td valign="center" align="left"><code>tomcat.util.buf.StringCache.char.enabled</code></td><td valign="center" align="left">
177      <p>If <code>true</code>, the String cache is enabled for
178      <code>CharChunk</code>. If not specified, the default value of
179      <code>false</code> will be used.</p>
180    </td></tr><tr><td valign="center" align="left"><code>tomcat.util.buf.StringCache.trainThreshold</code></td><td valign="center" align="left">
181      <p>The number of times <code>toString()</code> must be called before the
182      cache is activated. If not specified, the default value of
183      <code>20000</code> will be used.</p>
184    </td></tr><tr><td valign="center" align="left"><code>tomcat.util.buf.StringCache.cacheSize</code></td><td valign="center" align="left">
185      <p>The size of the String cache. If not specified, the default value of
186      <code>200</code> will be used.</p>
187    </td></tr><tr><td valign="center" align="left"><code>tomcat.util.buf.StringCache.maxStringSize</code></td><td valign="center" align="left">
188      <p>The maximum length of String that will be cached. If not specified, the
189      default value of <code>128</code> will be used.</p>
190    </td></tr><tr><td valign="center" align="left"><code>org.apache.tomcat.util. http.FastHttpDateFormat.CACHE_SIZE</code></td><td valign="center" align="left">
191      <p>The size of the cache to use parsed and formatted date value. If not
192      specified, the default value of <code>1000</code> will be used.</p>
193    </td></tr><tr><td valign="center" align="left"><code>org.apache.tomcat.util. net.NioSelectorShared</code></td><td valign="center" align="left">
194      <p>If <code>true</code>, use a shared selector for servlet write/read. If
195      not specified, the default value of <code>true</code> will be used.</p>
196    </td></tr></table>
197
198</blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font size="-1" color="#525D76"><em>
199        Copyright &copy; 1999-2008, Apache Software Foundation
200        </em></font></div></td></tr></table></body></html>
Note: See TracBrowser for help on using the repository browser.