Gitiles
Code Review Sign In
source.supwisdom.com / UniIdentify / tomcat / 67d615191938bb60e9b73af6701f5339749950ca / . / tomcat-uidm / webapps / docs / config / systemprops.html
blob: 83089dce571b8a7823d813d7f5e1ab2f07cce158 [file] [log] [blame]
Hongqing Liu71898292014-10-15 13:31:32 +0800[diff] [blame]1<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>Apache Tomcat Configuration Reference (6.0.41) - System Properties</title><style type="text/css" media="print">
Hongqing Liufd5ee812014-05-10 16:32:51 +0800[diff] [blame]2 .noPrint {display: none;}
3 td#mainBody {width: 100%;}
4 </style></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="0"><!--PAGE HEADER--><tr><td><!--PROJECT LOGO--><a href="http://tomcat.apache.org/"><img src="../images/tomcat.gif" align="right" alt="
5 The Apache Tomcat Servlet/JSP Container
Hongqing Liu71898292014-10-15 13:31:32 +0800[diff] [blame]6 " border="0"></a></td><td><h1><font face="arial,helvetica,sanserif">Apache Tomcat 6.0</font></h1><font face="arial,helvetica,sanserif">Version 6.0.41, May 19 2014</font></td><td><!--APACHE LOGO--><a href="http://www.apache.org/"><img src="../images/asf-logo.gif" align="right" alt="Apache Logo" border="0"></a></td></tr></table><table border="0" width="100%" cellspacing="4"><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade="noshade" size="1"></td></tr><tr><!--LEFT SIDE NAVIGATION--><td width="20%" valign="top" nowrap="nowrap" class="noPrint"><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="listeners.html">Listeners</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>web.xml</strong></p><ul><li><a href="filter.html">Filter</a></li></ul><p><strong>Other</strong></p><ul><li><a href="systemprops.html">System properties</a></li></ul></td><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left" id="mainBody"><h1>Apache Tomcat Configuration Reference</h1><h2>System Properties</h2><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Table of Contents"><!--()--></a><a name="Table_of_Contents"><strong>Table of Contents</strong></a></font></td></tr><tr><td><blockquote>
Hongqing Liufd5ee812014-05-10 16:32:51 +0800[diff] [blame]7<ul><li><a href="#Introduction">Introduction</a></li><li><a href="#Clustering">Clustering</a></li><li><a href="#Expression_Language">Expression Language</a></li><li><a href="#Jasper">Jasper</a></li><li><a href="#Security">Security</a></li><li><a href="#Specification">Specification</a></li><li><a href="#Sessions">Sessions</a></li><li><a href="#Logging">Logging</a></li><li><a href="#Other">Other</a></li></ul>
8</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote>
9 <p>The following sections list the system properties that may be set to modify
10 the default Tomcat behaviour.</p>
11</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Clustering"><strong>Clustering</strong></a></font></td></tr><tr><td><blockquote>
12 <table border="1" cellpadding="5"><tr><th width="15%" bgcolor="#023264"><font color="#ffffff">Property</font></th><th width="85%" bgcolor="#023264"><font color="#ffffff">Description</font></th></tr><tr><td align="left" valign="center"><code>org.apache.catalina. tribes.dns_lookups</code></td><td align="left" valign="center">
13 <p>If <code>true</code>, the clustering module will attempt to use DNS to
14 resolve any host names provided in the cluster configuration.</p>
15 <p>If not specified, the default value of <code>false</code> will be used.</p>
16 </td></tr></table>
17
18</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Expression Language"><!--()--></a><a name="Expression_Language"><strong>Expression Language</strong></a></font></td></tr><tr><td><blockquote>
19 <table border="1" cellpadding="5"><tr><th width="15%" bgcolor="#023264"><font color="#ffffff">Property</font></th><th width="85%" bgcolor="#023264"><font color="#ffffff">Description</font></th></tr><tr><td align="left" valign="center"><code>org.apache.el.BeanELResolver. CACHE_SIZE</code></td><td align="left" valign="center">
20 <p>The number of javax.el.BeanELResolver.BeanProperties objects that will
21 be cached by the EL Parser.</p>
22 <p>If not specified, the default of <code>1000</code> will be used.</p>
23 </td></tr><tr><td align="left" valign="center"><code>org.apache.el.ExpressionBuilder. CACHE_SIZE</code></td><td align="left" valign="center">
24 <p>The number of parsed EL expressions that will be cached by the EL
25 Parser.</p>
26 <p>If not specified, the default of <code>5000</code> will be used.</p>
27 </td></tr><tr><td align="left" valign="center"><code>org.apache.el.parser. COERCE_TO_ZERO</code></td><td align="left" valign="center">
28 <p>If <code>true</code>, when coercing EL expressions to numbers
29 <code>""</code> and <code>null</code> will be coerced to zero as required
30 by the specification.</p>
31 <p>If not specified, the default value of <code>true</code> will be used.</p>
32 </td></tr><tr><td align="left" valign="center"><code>org.apache.el.parser. SKIP_IDENTIFIER_CHECK</code></td><td align="left" valign="center">
33 <p>If <code>true</code>, when parsing EL expressions, identifiers will not be
34 checked to ensure that they conform to the Java Language Specification for
35 Java identifiers.</p>
36 <p>If not specified, the default value of <code>true</code> will be used.</p>
37 </td></tr></table>
38</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Jasper"><strong>Jasper</strong></a></font></td></tr><tr><td><blockquote>
39 <table border="1" cellpadding="5"><tr><th width="15%" bgcolor="#023264"><font color="#ffffff">Property</font></th><th width="85%" bgcolor="#023264"><font color="#ffffff">Description</font></th></tr><tr><td align="left" valign="center"><code>org.apache.jasper.compiler. Generator.POOL_TAGS_WITH_EXTENDS</code></td><td align="left" valign="center">
40 <p>By default, JSPs that use their own base class via the extends
41 attribute of the page directive, will have Tag pooling disabled since
42 Jasper cannot guarantee that the necessary initialisation will have taken
43 place. This can have a negative impact on performance. Providing the
44 alternative base class calls _jspInit() from Servlet.init(), setting this
45 property to <code>true</code> will enable pooling with an alternative base
46 class. If the alternative base class does not call _jspInit() and this
47 property is <code>true</code>, NPEs will occur when attempting to use
48 tags.</p>
49 <p>If not specified, the default value of <code>false</code> will be used.
50 </p>
51 </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.compiler. Generator.VAR_EXPRESSIONFACTORY</code></td><td align="left" valign="center">
52 <p>The name of the variable to use for the expression language expression
53 factory.</p>
54 <p>If not specified, the default value of <code>_el_expressionfactory</code>
55 will be used.</p>
56 </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.compiler. Generator.VAR_INSTANCEMANAGER</code></td><td align="left" valign="center">
57 <p>The name of the variable to use for the instance manager factory.</p>
58 <p>If not specified, the default value of <code>_jsp_instancemanager</code>
59 will be used.</p>
60 </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.compiler. Generator.STRICT_GET_PROPERTY</code></td><td align="left" valign="center">
61 <p>If <code>true</code>, the requirement to have the object referenced in
62 <code>jsp:getProperty</code> action to be previously "introduced"
63 to the JSP processor, as specified in the chapter JSP.5.3 of JSP 2.0 and
64 later specifications, is enforced.</p>
65 <p>If not specified, the specification compliant default of <code>true</code>
66 will be used.</p>
67 </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.compiler. Parser.STRICT_QUOTE_ESCAPING</code></td><td align="left" valign="center">
68 <p>If <code>false</code> the requirements for escaping quotes in JSP
69 attributes will be relaxed so that an unescaped quote will not
70 cause an error.</p>
71 <p>If not specified, the specification compliant default of
72 <code>true</code> will be used.</p>
73 </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.runtime. BodyContentImpl.LIMIT_BUFFER</code></td><td align="left" valign="center">
74 <p>If <code>true</code>, any tag buffer that expands beyond
75 <code>org.apache.jasper.Constants.DEFAULT_TAG_BUFFER_SIZE</code> will be
76 destroyed and a new buffer created of the default size.</p>
77 <p>If not specified, the default value of <code>false</code> will be used.</p>
78 </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.runtime. JspFactoryImpl.USE_POOL</code></td><td align="left" valign="center">
79 <p>If <code>true</code>, a ThreadLocal <code>PageContext</code> pool will
80 be used.</p>
81 <p>If not specified, the default value of <code>true</code> will be used.</p>
82 </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.runtime. JspFactoryImpl.POOL_SIZE</code></td><td align="left" valign="center">
83 <p>The size of the ThreadLocal <code>PageContext</code>.</p>
84 <p>If not specified, the default value of <code>8</code> will be used.</p>
85 </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.Constants. JSP_SERVLET_BASE</code></td><td align="left" valign="center">
86 <p>The base class of the Servlets generated from the JSPs.</p>
87 <p>If not specified, the default value of
88 <code>org.apache.jasper.runtime.HttpJspBase</code> will be used.</p>
89 </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.Constants. SERVICE_METHOD_NAME</code></td><td align="left" valign="center">
90 <p>The name of the service method called by the base class.</p>
91 <p>If not specified, the default value of <code>_jspService</code>
92 will be used.</p>
93 </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.Constants. SERVLET_CLASSPATH</code></td><td align="left" valign="center">
94 <p>The name of the ServletContext attribute that provides the classpath
95 for the JSP.</p>
96 <p>If not specified, the default value of
97 <code>org.apache.catalina.jsp_classpath</code> will be used.</p>
98 </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.Constants. JSP_FILE</code></td><td align="left" valign="center">
99 <p>The name of the request attribute for <code>&lt;jsp-file&gt;</code>
100 element of a servlet definition. If present on a request, this overrides
101 the value returned by <code>request.getServletPath()</code> to select the
102 JSP page to be executed.</p>
103 <p>If not specified, the default value of
104 <code>org.apache.catalina.jsp_file</code> will be used.</p>
105 </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.Constants. PRECOMPILE</code></td><td align="left" valign="center">
106 <p>The name of the query parameter that causes the JSP engine to just
107 pregenerate the servlet but not invoke it.</p>
108 <p>If not specified, the default value of <code>jsp_precompile</code>
109 will be used, as defined by JSP specification (JSP.11.4.2).</p>
110 </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.Constants. JSP_PACKAGE_NAME</code></td><td align="left" valign="center">
111 <p>The default package name for compiled jsp pages.</p>
112 <p>If not specified, the default value of <code>org.apache.jsp</code>
113 will be used.</p>
114 </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.Constants. TAG_FILE_PACKAGE_NAME</code></td><td align="left" valign="center">
115 <p>The default package name for tag handlers generated from tag files.</p>
116 <p>If not specified, the default value of <code>org.apache.jsp.tag</code>
117 will be used.</p>
118 </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.Constants. ALT_DD_ATTR</code></td><td align="left" valign="center">
119 <p>The servlet context attribute under which the alternate deployment
120 descriptor for this web application is stored.</p>
121 <p>If not specified, the
122 default value of <code>org.apache.catalina.deploy.alt_dd</code> will
123 be used.</p>
124 </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.Constants. TEMP_VARIABLE_NAME_PREFIX</code></td><td align="left" valign="center">
125 <p>Prefix to use for generated temporary variable names.</p>
126 <p>If not specified,
127 the default value of <code>_jspx_temp</code> will be used.</p>
128 </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.Constants. USE_INSTANCE_MANAGER_FOR_TAGS</code></td><td align="left" valign="center">
129 <p>If <code>true</code>, the instance manager is used to obtain tag
130 handler instances.</p>
131 <p>If not specified, the default value of <code>false</code> will be used.</p>
132 </td></tr></table>
133
134</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Security"><strong>Security</strong></a></font></td></tr><tr><td><blockquote>
135
136 <table border="1" cellpadding="5"><tr><th width="15%" bgcolor="#023264"><font color="#ffffff">Property</font></th><th width="85%" bgcolor="#023264"><font color="#ffffff">Description</font></th></tr><tr><td align="left" valign="center"><code>org.apache.catalina.connector. RECYCLE_FACADES</code></td><td align="left" valign="center">
137 <p>If this is <code>true</code> or if a security manager is in use a new
138 facade object will be created for each request.</p>
139 <p>If not specified, the
140 default value of <code>false</code> will be used.</p>
141 </td></tr><tr><td align="left" valign="center"><code>org.apache.catalina.connector. CoyoteAdapter.ALLOW_BACKSLASH</code></td><td align="left" valign="center">
142 <p>If this is <code>true</code> the '\' character will be permitted as a
143 path delimiter.</p>
144 <p>If not specified, the default value of <code>false</code>
145 will be used.</p>
146 </td></tr><tr><td align="left" valign="center"><code>org.apache.tomcat.util.buf. UDecoder.ALLOW_ENCODED_SLASH</code></td><td align="left" valign="center">
147 <p>If this is <code>true</code> '%2F' and '%5C' will be permitted as path
148 delimiters.</p>
149 <p>If not specified, the default value of <code>false</code> will
150 be used.</p>
151 </td></tr><tr><td align="left" valign="center"><code>org.apache.coyote. USE_CUSTOM_STATUS_MSG_IN_HEADER</code></td><td align="left" valign="center"><p>If this is
152 <code>true</code>, custom HTTP status messages will be used within HTTP
153 headers. If a custom message is specified that is not valid for use in an
154 HTTP header (as defined by RFC2616) then the custom message will be
155 ignored and the default message used.</p>
156 <p>If not specified, the default value of <code>false</code> will be used.</p>
157 </td></tr></table>
158
159</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Specification"><strong>Specification</strong></a></font></td></tr><tr><td><blockquote>
160
161 <table border="1" cellpadding="5"><tr><th width="15%" bgcolor="#023264"><font color="#ffffff">Property</font></th><th width="85%" bgcolor="#023264"><font color="#ffffff">Description</font></th></tr><tr><td align="left" valign="center"><code>org.apache.catalina. STRICT_SERVLET_COMPLIANCE</code></td><td align="left" valign="center">
162 <p>If this is <code>true</code> the following actions will occur:
163 <ul>
164 <li>any wrapped request or response object passed to an application
165 dispatcher will be checked to ensure that it has wrapped the original
166 request or response. (SRV.8.2 / SRV.14.2.5.1)
167 </li>
168 <li>a call to <code>Response.getWriter()</code> if no character encoding
169 has been specified will result in subsequent calls to
170 <code>Response.getCharacterEncoding()</code> returning
171 <code>ISO-8859-1</code> and the <code>Content-Type</code> response header
172 will include a <code>charset=ISO-8859-1</code> component. (SRV.15.2.22.1)
173 </li>
174 <li>every request that is associated with a session will cause the
175 session's last accessed time to be updated regardless of whether or not
176 the request explicitly accesses the session. (SRV.7.6)
177 </li>
178 <li>
179 cookies will be parsed strictly, by default v0 cookies will not work with any invalid characters.
180 <br>If set to <code>false</code>, any v0 cookie with invalid character
181 will be switched to a v1 cookie and the value will be quoted.
182 </li>
183 <li>
184 the path in <code>ServletContext.getResource</code> /
185 <code>getResourceAsStream</code> calls must start with a "/".<br>
186 If set to <code>false</code>, code like <code>getResource("myfolder/myresource.txt")</code> will work.
187 </li>
188 </ul>
189 </p>
190 <p>If this is <code>true</code> the default value will be changed for:
191 <ul>
192 <li><code>org.apache.catalina.connector.Request. ALLOW_EMPTY_QUERY_STRING</code> property</li>
193 <li>The <code>webXmlValidation</code> attribute of any
194 <a href="context.html">Context</a> element.</li>
195 <li>The <code>webXmlNamespaceAware</code> attribute of any
196 <a href="context.html">Context</a> element.</li>
197 <li>The <code>tldValidation</code> attribute of any
198 <a href="context.html">Context</a> element.</li>
199 </ul>
200 </p>
201 <p>If not specified, the default value of <code>false</code> will be used.</p>
202 </td></tr><tr><td align="left" valign="center"><code>org.apache.catalina.connector. Request.ALLOW_EMPTY_QUERY_STRING</code></td><td align="left" valign="center">
203 <p>If this is <code>true</code> Tomcat will return an empty string rather
204 than <code>null</code> for empty query strings - i.e. query strings where
205 only <code>?</code> is present.</p>
206 <p>If not specified, the value of
207 <code>org.apache.catalina.STRICT_SERVLET_COMPLIANCE</code> will be used as
208 the default.</p>
209 </td></tr><tr><td align="left" valign="center"><code>org.apache.catalina.session. StandardSession.ACTIVITY_CHECK</code></td><td align="left" valign="center">
210 <p>If this is <code>true</code> or if
211 <code>org.apache.catalina.STRICT_SERVLET_COMPLIANCE</code> is
212 <code>true</code> Tomcat will track the number of active requests for each
213 session. When determining if a session is valid, any session with at least
214 one active request will always be considered valid.</p>
215 <p>If not specified, the default value of <code>false</code> will be used.</p>
216 </td></tr><tr><td align="left" valign="center"><code>org.apache.tomcat.util.http. ServerCookie.ALLOW_EQUALS_IN_VALUE</code></td><td align="left" valign="center">
217 <p>If this is <code>true</code> Tomcat will allow '<code>=</code>'
218 characters when parsing unquoted cookie values. If <code>false</code>,
219 cookie values containing '<code>=</code>' will be terminated when the
220 '<code>=</code>' is encountered and the remainder of the cookie value will
221 be dropped.</p>
222 <p>If not specified, the default specification compliant value of
223 <code>false</code> will be used.</p>
224 </td></tr><tr><td align="left" valign="center"><code>org.apache.tomcat.util.http. ServerCookie.ALWAYS_ADD_EXPIRES</code></td><td align="left" valign="center">
225 <p>If this is <code>true</code> Tomcat will always add an expires
226 parameter to a SetCookie header even for cookies with version greater than
227 zero. This is to work around a known IE6 and IE7 bug that causes IE to
228 ignore the Max-Age parameter in a SetCookie header.</p>
229 <p>If not specified, the default value of <code>true</code> will be used.</p>
230 </td></tr></table>
231
232</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Sessions"><strong>Sessions</strong></a></font></td></tr><tr><td><blockquote>
233
234 <table border="1" cellpadding="5"><tr><th width="15%" bgcolor="#023264"><font color="#ffffff">Property</font></th><th width="85%" bgcolor="#023264"><font color="#ffffff">Description</font></th></tr><tr><td align="left" valign="center"><code>org.apache.catalina.SESSION_COOKIE_NAME</code></td><td align="left" valign="center">
235 <p>An alternative name for the session cookie. Defaults to
236 <code>JSESSIONID</code>. Note that the Servlet specification requires
237 this to be <code>JSESSIONID</code>. You should not rely on being able to
238 change this.</p>
239 </td></tr><tr><td align="left" valign="center"><code>org.apache.catalina.SESSION_PARAMETER_NAME</code></td><td align="left" valign="center">
240 <p>An alternative name for the session path parameter. Defaults to
241 <code>jsessionid</code>. Note that the Servlet specification requires
242 this to be <code>jsessionid</code>. You should not rely on being able to
243 change this.</p>
244 </td></tr><tr><td align="left" valign="center"><code>org.apache.catalina.authenticator. Constants.SSO_SESSION_COOKIE_NAME</code></td><td align="left" valign="center">
245 <p>An alternative name for the single sign on session cookie. Defaults to
246 <code>JSESSIONIDSSO</code>.</p>
247 </td></tr></table>
248
249</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Logging"><strong>Logging</strong></a></font></td></tr><tr><td><blockquote>
250
251 <table border="1" cellpadding="5"><tr><th width="15%" bgcolor="#023264"><font color="#ffffff">Property</font></th><th width="85%" bgcolor="#023264"><font color="#ffffff">Description</font></th></tr><tr><td align="left" valign="center"><code>org.apache.juli.logging. UserDataHelper.CONFIG</code></td><td align="left" valign="center">
252 <p>The type of logging to use for errors generated by invalid input data.
253 The options are: <code>DEBUG_ALL</code>, <code>INFO_THEN_DEBUG</code>,
254 <code>INFO_ALL</code> and <code>NONE</code>. When
255 <code>INFO_THEN_DEBUG</code> is used, the period for which errors are
256 logged at DEBUG rather than INFO is controlled by the system property
257 <code>org.apache.juli.logging.UserDataHelper.SUPPRESSION_TIME</code>.
258 </p>
259 <p>The default value is <code>INFO_THEN_DEBUG</code>.</p>
260 <p>The errors currently logged using this system are:
261 <ul>
262 <li>invalid parameters.</li>
263 </ul>
264 Other errors triggered by invalid input data may be added to this
265 system in later versions.</p>
266 </td></tr><tr><td align="left" valign="center"><code>org.apache.juli.logging. UserDataHelper.SUPPRESSION_TIME</code></td><td align="left" valign="center">
267 <p>When using <code>INFO_THEN_DEBUG</code> for
268 <code>org.apache.juli.logging.UserDataHelper.CONFIG</code> this system
269 property controls how long messages are logged at DEBUG after a message
270 has been logged at INFO. Once this period has elapsed, the next message
271 will be logged at INFO followed by a new suppression period where
272 messages are logged at DEBUG and so on. The value is measured
273 in seconds.</p>
274 <p>A value of <code>0</code> is equivalent to using <code>INFO_ALL</code>
275 for <code>org.apache.juli.logging.UserDataHelper.CONFIG</code>.</p>
276 <p>A negative value means an infinite suppression period.</p>
277 <p>The default value is <code>86400</code> (24 hours).</p>
278 </td></tr></table>
279
280</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Other"><strong>Other</strong></a></font></td></tr><tr><td><blockquote>
281
282 <table border="1" cellpadding="5"><tr><th width="15%" bgcolor="#023264"><font color="#ffffff">Property</font></th><th width="85%" bgcolor="#023264"><font color="#ffffff">Description</font></th></tr><tr><td align="left" valign="center"><code>org.apache.coyote.MAX_EXTENSION_SIZE</code></td><td align="left" valign="center">
283 <p>Limits the total length of extension data when using chunked encoding.
284 If the value is <code>-1</code>, no limit will be imposed.</p>
285 <p>If not specified, the default value of <code>8192</code> will be
286 used.</p>
287 </td></tr><tr><td align="left" valign="center"><code>org.apache.coyote.MAX_TRAILER_SIZE</code></td><td align="left" valign="center">
288 <p>Limits the total length of trailing headers in the last chunk of
289 a chunked HTTP request.
290 If the value is <code>-1</code>, no limit will be imposed.</p>
291 <p>If not specified, the default value of <code>8192</code> will be used.</p>
292 </td></tr><tr><td align="left" valign="center"><code>catalina.useNaming</code></td><td align="left" valign="center">
293 <p>If this is <code>false</code> it will override the
294 <code>useNaming</code> attribute for all <a href="context.html">
295 Context</a> elements.</p>
296 </td></tr><tr><td align="left" valign="center"><code>jvmRoute</code></td><td align="left" valign="center">
297 <p>Provides a default value for the <code>jvmRoute</code> attribute of the
298 <a href="engine.html">Engine</a> element. It does not override the value
299 configured on the <a href="engine.html">Engine</a> element.</p>
300 </td></tr><tr><td align="left" valign="center"><code>org.apache.catalina.loader. WebappClassLoader.ENABLE_CLEAR_REFERENCES</code></td><td align="left" valign="center">
301 <p>If <code>true</code>, Tomcat attempts to null out any static or final
302 fields from loaded classes when a web application is stopped as a work
303 around for apparent garbage collection bugs and application coding errors.
304 </p>
305 <p>There have been some issues reported with log4j when this option is
306 <code>true</code>.</p>
307 <p>Applications without memory leaks using recent JVMs should operate
308 correctly with this option set to <code>false</code>.</p>
309 <p>If not specified, the default value of <code>true</code> will be used.
310 </p>
311 </td></tr><tr><td align="left" valign="center"><code>catalina.config</code></td><td align="left" valign="center">
312 <p>The URL for the catalina.properties configuration file.</p>
313 </td></tr><tr><td align="left" valign="center"><code>tomcat.util.buf.StringCache.byte.enabled</code></td><td align="left" valign="center">
314 <p>If <code>true</code>, the String cache is enabled for
315 <code>ByteChunk</code>.</p>
316 <p>If not specified, the default value of <code>false</code> will be used.</p>
317 </td></tr><tr><td align="left" valign="center"><code>tomcat.util.buf.StringCache.char.enabled</code></td><td align="left" valign="center">
318 <p>If <code>true</code>, the String cache is enabled for
319 <code>CharChunk</code>.</p>
320 <p>If not specified, the default value of <code>false</code> will be used.</p>
321 </td></tr><tr><td align="left" valign="center"><code>tomcat.util.buf.StringCache.trainThreshold</code></td><td align="left" valign="center">
322 <p>The number of times <code>toString()</code> must be called before the
323 cache is activated.</p>
324 <p>If not specified, the default value of <code>20000</code> will be used.</p>
325 </td></tr><tr><td align="left" valign="center"><code>tomcat.util.buf.StringCache.cacheSize</code></td><td align="left" valign="center">
326 <p>The size of the String cache.</p>
327 <p>If not specified, the default value of <code>200</code> will be used.</p>
328 </td></tr><tr><td align="left" valign="center"><code>tomcat.util.buf.StringCache.maxStringSize</code></td><td align="left" valign="center">
329 <p>The maximum length of String that will be cached.</p>
330 <p>If not specified, the default value of <code>128</code> will be used.</p>
331 </td></tr><tr><td align="left" valign="center"><code>org.apache.tomcat.util. http.FastHttpDateFormat.CACHE_SIZE</code></td><td align="left" valign="center">
332 <p>The size of the cache to use parsed and formatted date value.</p>
333 <p>If not specified, the default value of <code>1000</code> will be used.</p>
334 </td></tr><tr><td align="left" valign="center"><code>org.apache.tomcat.util. net.NioSelectorShared</code></td><td align="left" valign="center">
335 <p>If <code>true</code>, use a shared selector for servlet write/read.</p>
336 <p>If not specified, the default value of <code>true</code> will be used.</p>
337 </td></tr><tr><td align="left" valign="center"><code>org.apache.catalina.startup. EXIT_ON_INIT_FAILURE</code></td><td align="left" valign="center">
338 <p>If <code>true</code>, the server will exit if an exception happens
339 during the server initialization phase.</p>
340 <p>If not specified, the default value of <code>false</code> will be used.</p>
341 </td></tr></table>
342
343</blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr noshade="noshade" size="1"></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font color="#525D76" size="-1"><em>
344 Copyright &copy; 1999-2014, Apache Software Foundation
345 </em></font></div></td></tr></table></body></html>