| <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"> | |
| .noPrint {display: none;} | |
| td#mainBody {width: 100%;} | |
| </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=" | |
| The Apache Tomcat Servlet/JSP Container | |
| " 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> | |
| <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> | |
| </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> | |
| <p>The following sections list the system properties that may be set to modify | |
| the default Tomcat behaviour.</p> | |
| </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> | |
| <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"> | |
| <p>If <code>true</code>, the clustering module will attempt to use DNS to | |
| resolve any host names provided in the cluster configuration.</p> | |
| <p>If not specified, the default value of <code>false</code> will be used.</p> | |
| </td></tr></table> | |
| </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> | |
| <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"> | |
| <p>The number of javax.el.BeanELResolver.BeanProperties objects that will | |
| be cached by the EL Parser.</p> | |
| <p>If not specified, the default of <code>1000</code> will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.el.ExpressionBuilder. CACHE_SIZE</code></td><td align="left" valign="center"> | |
| <p>The number of parsed EL expressions that will be cached by the EL | |
| Parser.</p> | |
| <p>If not specified, the default of <code>5000</code> will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.el.parser. COERCE_TO_ZERO</code></td><td align="left" valign="center"> | |
| <p>If <code>true</code>, when coercing EL expressions to numbers | |
| <code>""</code> and <code>null</code> will be coerced to zero as required | |
| by the specification.</p> | |
| <p>If not specified, the default value of <code>true</code> will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.el.parser. SKIP_IDENTIFIER_CHECK</code></td><td align="left" valign="center"> | |
| <p>If <code>true</code>, when parsing EL expressions, identifiers will not be | |
| checked to ensure that they conform to the Java Language Specification for | |
| Java identifiers.</p> | |
| <p>If not specified, the default value of <code>true</code> will be used.</p> | |
| </td></tr></table> | |
| </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> | |
| <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"> | |
| <p>By default, JSPs that use their own base class via the extends | |
| attribute of the page directive, will have Tag pooling disabled since | |
| Jasper cannot guarantee that the necessary initialisation will have taken | |
| place. This can have a negative impact on performance. Providing the | |
| alternative base class calls _jspInit() from Servlet.init(), setting this | |
| property to <code>true</code> will enable pooling with an alternative base | |
| class. If the alternative base class does not call _jspInit() and this | |
| property is <code>true</code>, NPEs will occur when attempting to use | |
| tags.</p> | |
| <p>If not specified, the default value of <code>false</code> will be used. | |
| </p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.compiler. Generator.VAR_EXPRESSIONFACTORY</code></td><td align="left" valign="center"> | |
| <p>The name of the variable to use for the expression language expression | |
| factory.</p> | |
| <p>If not specified, the default value of <code>_el_expressionfactory</code> | |
| will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.compiler. Generator.VAR_INSTANCEMANAGER</code></td><td align="left" valign="center"> | |
| <p>The name of the variable to use for the instance manager factory.</p> | |
| <p>If not specified, the default value of <code>_jsp_instancemanager</code> | |
| will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.compiler. Generator.STRICT_GET_PROPERTY</code></td><td align="left" valign="center"> | |
| <p>If <code>true</code>, the requirement to have the object referenced in | |
| <code>jsp:getProperty</code> action to be previously "introduced" | |
| to the JSP processor, as specified in the chapter JSP.5.3 of JSP 2.0 and | |
| later specifications, is enforced.</p> | |
| <p>If not specified, the specification compliant default of <code>true</code> | |
| will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.compiler. Parser.STRICT_QUOTE_ESCAPING</code></td><td align="left" valign="center"> | |
| <p>If <code>false</code> the requirements for escaping quotes in JSP | |
| attributes will be relaxed so that an unescaped quote will not | |
| cause an error.</p> | |
| <p>If not specified, the specification compliant default of | |
| <code>true</code> will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.runtime. BodyContentImpl.LIMIT_BUFFER</code></td><td align="left" valign="center"> | |
| <p>If <code>true</code>, any tag buffer that expands beyond | |
| <code>org.apache.jasper.Constants.DEFAULT_TAG_BUFFER_SIZE</code> will be | |
| destroyed and a new buffer created of the default size.</p> | |
| <p>If not specified, the default value of <code>false</code> will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.runtime. JspFactoryImpl.USE_POOL</code></td><td align="left" valign="center"> | |
| <p>If <code>true</code>, a ThreadLocal <code>PageContext</code> pool will | |
| be used.</p> | |
| <p>If not specified, the default value of <code>true</code> will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.runtime. JspFactoryImpl.POOL_SIZE</code></td><td align="left" valign="center"> | |
| <p>The size of the ThreadLocal <code>PageContext</code>.</p> | |
| <p>If not specified, the default value of <code>8</code> will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.Constants. JSP_SERVLET_BASE</code></td><td align="left" valign="center"> | |
| <p>The base class of the Servlets generated from the JSPs.</p> | |
| <p>If not specified, the default value of | |
| <code>org.apache.jasper.runtime.HttpJspBase</code> will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.Constants. SERVICE_METHOD_NAME</code></td><td align="left" valign="center"> | |
| <p>The name of the service method called by the base class.</p> | |
| <p>If not specified, the default value of <code>_jspService</code> | |
| will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.Constants. SERVLET_CLASSPATH</code></td><td align="left" valign="center"> | |
| <p>The name of the ServletContext attribute that provides the classpath | |
| for the JSP.</p> | |
| <p>If not specified, the default value of | |
| <code>org.apache.catalina.jsp_classpath</code> will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.Constants. JSP_FILE</code></td><td align="left" valign="center"> | |
| <p>The name of the request attribute for <code><jsp-file></code> | |
| element of a servlet definition. If present on a request, this overrides | |
| the value returned by <code>request.getServletPath()</code> to select the | |
| JSP page to be executed.</p> | |
| <p>If not specified, the default value of | |
| <code>org.apache.catalina.jsp_file</code> will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.Constants. PRECOMPILE</code></td><td align="left" valign="center"> | |
| <p>The name of the query parameter that causes the JSP engine to just | |
| pregenerate the servlet but not invoke it.</p> | |
| <p>If not specified, the default value of <code>jsp_precompile</code> | |
| will be used, as defined by JSP specification (JSP.11.4.2).</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.Constants. JSP_PACKAGE_NAME</code></td><td align="left" valign="center"> | |
| <p>The default package name for compiled jsp pages.</p> | |
| <p>If not specified, the default value of <code>org.apache.jsp</code> | |
| will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.Constants. TAG_FILE_PACKAGE_NAME</code></td><td align="left" valign="center"> | |
| <p>The default package name for tag handlers generated from tag files.</p> | |
| <p>If not specified, the default value of <code>org.apache.jsp.tag</code> | |
| will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.Constants. ALT_DD_ATTR</code></td><td align="left" valign="center"> | |
| <p>The servlet context attribute under which the alternate deployment | |
| descriptor for this web application is stored.</p> | |
| <p>If not specified, the | |
| default value of <code>org.apache.catalina.deploy.alt_dd</code> will | |
| be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.jasper.Constants. TEMP_VARIABLE_NAME_PREFIX</code></td><td align="left" valign="center"> | |
| <p>Prefix to use for generated temporary variable names.</p> | |
| <p>If not specified, | |
| the default value of <code>_jspx_temp</code> will be used.</p> | |
| </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"> | |
| <p>If <code>true</code>, the instance manager is used to obtain tag | |
| handler instances.</p> | |
| <p>If not specified, the default value of <code>false</code> will be used.</p> | |
| </td></tr></table> | |
| </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> | |
| <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"> | |
| <p>If this is <code>true</code> or if a security manager is in use a new | |
| facade object will be created for each request.</p> | |
| <p>If not specified, the | |
| default value of <code>false</code> will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.catalina.connector. CoyoteAdapter.ALLOW_BACKSLASH</code></td><td align="left" valign="center"> | |
| <p>If this is <code>true</code> the '\' character will be permitted as a | |
| path delimiter.</p> | |
| <p>If not specified, the default value of <code>false</code> | |
| will be used.</p> | |
| </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"> | |
| <p>If this is <code>true</code> '%2F' and '%5C' will be permitted as path | |
| delimiters.</p> | |
| <p>If not specified, the default value of <code>false</code> will | |
| be used.</p> | |
| </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 | |
| <code>true</code>, custom HTTP status messages will be used within HTTP | |
| headers. If a custom message is specified that is not valid for use in an | |
| HTTP header (as defined by RFC2616) then the custom message will be | |
| ignored and the default message used.</p> | |
| <p>If not specified, the default value of <code>false</code> will be used.</p> | |
| </td></tr></table> | |
| </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> | |
| <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"> | |
| <p>If this is <code>true</code> the following actions will occur: | |
| <ul> | |
| <li>any wrapped request or response object passed to an application | |
| dispatcher will be checked to ensure that it has wrapped the original | |
| request or response. (SRV.8.2 / SRV.14.2.5.1) | |
| </li> | |
| <li>a call to <code>Response.getWriter()</code> if no character encoding | |
| has been specified will result in subsequent calls to | |
| <code>Response.getCharacterEncoding()</code> returning | |
| <code>ISO-8859-1</code> and the <code>Content-Type</code> response header | |
| will include a <code>charset=ISO-8859-1</code> component. (SRV.15.2.22.1) | |
| </li> | |
| <li>every request that is associated with a session will cause the | |
| session's last accessed time to be updated regardless of whether or not | |
| the request explicitly accesses the session. (SRV.7.6) | |
| </li> | |
| <li> | |
| cookies will be parsed strictly, by default v0 cookies will not work with any invalid characters. | |
| <br>If set to <code>false</code>, any v0 cookie with invalid character | |
| will be switched to a v1 cookie and the value will be quoted. | |
| </li> | |
| <li> | |
| the path in <code>ServletContext.getResource</code> / | |
| <code>getResourceAsStream</code> calls must start with a "/".<br> | |
| If set to <code>false</code>, code like <code>getResource("myfolder/myresource.txt")</code> will work. | |
| </li> | |
| </ul> | |
| </p> | |
| <p>If this is <code>true</code> the default value will be changed for: | |
| <ul> | |
| <li><code>org.apache.catalina.connector.Request. ALLOW_EMPTY_QUERY_STRING</code> property</li> | |
| <li>The <code>webXmlValidation</code> attribute of any | |
| <a href="context.html">Context</a> element.</li> | |
| <li>The <code>webXmlNamespaceAware</code> attribute of any | |
| <a href="context.html">Context</a> element.</li> | |
| <li>The <code>tldValidation</code> attribute of any | |
| <a href="context.html">Context</a> element.</li> | |
| </ul> | |
| </p> | |
| <p>If not specified, the default value of <code>false</code> will be used.</p> | |
| </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"> | |
| <p>If this is <code>true</code> Tomcat will return an empty string rather | |
| than <code>null</code> for empty query strings - i.e. query strings where | |
| only <code>?</code> is present.</p> | |
| <p>If not specified, the value of | |
| <code>org.apache.catalina.STRICT_SERVLET_COMPLIANCE</code> will be used as | |
| the default.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.catalina.session. StandardSession.ACTIVITY_CHECK</code></td><td align="left" valign="center"> | |
| <p>If this is <code>true</code> or if | |
| <code>org.apache.catalina.STRICT_SERVLET_COMPLIANCE</code> is | |
| <code>true</code> Tomcat will track the number of active requests for each | |
| session. When determining if a session is valid, any session with at least | |
| one active request will always be considered valid.</p> | |
| <p>If not specified, the default value of <code>false</code> will be used.</p> | |
| </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"> | |
| <p>If this is <code>true</code> Tomcat will allow '<code>=</code>' | |
| characters when parsing unquoted cookie values. If <code>false</code>, | |
| cookie values containing '<code>=</code>' will be terminated when the | |
| '<code>=</code>' is encountered and the remainder of the cookie value will | |
| be dropped.</p> | |
| <p>If not specified, the default specification compliant value of | |
| <code>false</code> will be used.</p> | |
| </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"> | |
| <p>If this is <code>true</code> Tomcat will always add an expires | |
| parameter to a SetCookie header even for cookies with version greater than | |
| zero. This is to work around a known IE6 and IE7 bug that causes IE to | |
| ignore the Max-Age parameter in a SetCookie header.</p> | |
| <p>If not specified, the default value of <code>true</code> will be used.</p> | |
| </td></tr></table> | |
| </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> | |
| <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"> | |
| <p>An alternative name for the session cookie. Defaults to | |
| <code>JSESSIONID</code>. Note that the Servlet specification requires | |
| this to be <code>JSESSIONID</code>. You should not rely on being able to | |
| change this.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.catalina.SESSION_PARAMETER_NAME</code></td><td align="left" valign="center"> | |
| <p>An alternative name for the session path parameter. Defaults to | |
| <code>jsessionid</code>. Note that the Servlet specification requires | |
| this to be <code>jsessionid</code>. You should not rely on being able to | |
| change this.</p> | |
| </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"> | |
| <p>An alternative name for the single sign on session cookie. Defaults to | |
| <code>JSESSIONIDSSO</code>.</p> | |
| </td></tr></table> | |
| </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> | |
| <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"> | |
| <p>The type of logging to use for errors generated by invalid input data. | |
| The options are: <code>DEBUG_ALL</code>, <code>INFO_THEN_DEBUG</code>, | |
| <code>INFO_ALL</code> and <code>NONE</code>. When | |
| <code>INFO_THEN_DEBUG</code> is used, the period for which errors are | |
| logged at DEBUG rather than INFO is controlled by the system property | |
| <code>org.apache.juli.logging.UserDataHelper.SUPPRESSION_TIME</code>. | |
| </p> | |
| <p>The default value is <code>INFO_THEN_DEBUG</code>.</p> | |
| <p>The errors currently logged using this system are: | |
| <ul> | |
| <li>invalid parameters.</li> | |
| </ul> | |
| Other errors triggered by invalid input data may be added to this | |
| system in later versions.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.juli.logging. UserDataHelper.SUPPRESSION_TIME</code></td><td align="left" valign="center"> | |
| <p>When using <code>INFO_THEN_DEBUG</code> for | |
| <code>org.apache.juli.logging.UserDataHelper.CONFIG</code> this system | |
| property controls how long messages are logged at DEBUG after a message | |
| has been logged at INFO. Once this period has elapsed, the next message | |
| will be logged at INFO followed by a new suppression period where | |
| messages are logged at DEBUG and so on. The value is measured | |
| in seconds.</p> | |
| <p>A value of <code>0</code> is equivalent to using <code>INFO_ALL</code> | |
| for <code>org.apache.juli.logging.UserDataHelper.CONFIG</code>.</p> | |
| <p>A negative value means an infinite suppression period.</p> | |
| <p>The default value is <code>86400</code> (24 hours).</p> | |
| </td></tr></table> | |
| </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> | |
| <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"> | |
| <p>Limits the total length of extension data when using chunked encoding. | |
| If the value is <code>-1</code>, no limit will be imposed.</p> | |
| <p>If not specified, the default value of <code>8192</code> will be | |
| used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.coyote.MAX_TRAILER_SIZE</code></td><td align="left" valign="center"> | |
| <p>Limits the total length of trailing headers in the last chunk of | |
| a chunked HTTP request. | |
| If the value is <code>-1</code>, no limit will be imposed.</p> | |
| <p>If not specified, the default value of <code>8192</code> will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>catalina.useNaming</code></td><td align="left" valign="center"> | |
| <p>If this is <code>false</code> it will override the | |
| <code>useNaming</code> attribute for all <a href="context.html"> | |
| Context</a> elements.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>jvmRoute</code></td><td align="left" valign="center"> | |
| <p>Provides a default value for the <code>jvmRoute</code> attribute of the | |
| <a href="engine.html">Engine</a> element. It does not override the value | |
| configured on the <a href="engine.html">Engine</a> element.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.catalina.loader. WebappClassLoader.ENABLE_CLEAR_REFERENCES</code></td><td align="left" valign="center"> | |
| <p>If <code>true</code>, Tomcat attempts to null out any static or final | |
| fields from loaded classes when a web application is stopped as a work | |
| around for apparent garbage collection bugs and application coding errors. | |
| </p> | |
| <p>There have been some issues reported with log4j when this option is | |
| <code>true</code>.</p> | |
| <p>Applications without memory leaks using recent JVMs should operate | |
| correctly with this option set to <code>false</code>.</p> | |
| <p>If not specified, the default value of <code>true</code> will be used. | |
| </p> | |
| </td></tr><tr><td align="left" valign="center"><code>catalina.config</code></td><td align="left" valign="center"> | |
| <p>The URL for the catalina.properties configuration file.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>tomcat.util.buf.StringCache.byte.enabled</code></td><td align="left" valign="center"> | |
| <p>If <code>true</code>, the String cache is enabled for | |
| <code>ByteChunk</code>.</p> | |
| <p>If not specified, the default value of <code>false</code> will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>tomcat.util.buf.StringCache.char.enabled</code></td><td align="left" valign="center"> | |
| <p>If <code>true</code>, the String cache is enabled for | |
| <code>CharChunk</code>.</p> | |
| <p>If not specified, the default value of <code>false</code> will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>tomcat.util.buf.StringCache.trainThreshold</code></td><td align="left" valign="center"> | |
| <p>The number of times <code>toString()</code> must be called before the | |
| cache is activated.</p> | |
| <p>If not specified, the default value of <code>20000</code> will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>tomcat.util.buf.StringCache.cacheSize</code></td><td align="left" valign="center"> | |
| <p>The size of the String cache.</p> | |
| <p>If not specified, the default value of <code>200</code> will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>tomcat.util.buf.StringCache.maxStringSize</code></td><td align="left" valign="center"> | |
| <p>The maximum length of String that will be cached.</p> | |
| <p>If not specified, the default value of <code>128</code> will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.tomcat.util. http.FastHttpDateFormat.CACHE_SIZE</code></td><td align="left" valign="center"> | |
| <p>The size of the cache to use parsed and formatted date value.</p> | |
| <p>If not specified, the default value of <code>1000</code> will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.tomcat.util. net.NioSelectorShared</code></td><td align="left" valign="center"> | |
| <p>If <code>true</code>, use a shared selector for servlet write/read.</p> | |
| <p>If not specified, the default value of <code>true</code> will be used.</p> | |
| </td></tr><tr><td align="left" valign="center"><code>org.apache.catalina.startup. EXIT_ON_INIT_FAILURE</code></td><td align="left" valign="center"> | |
| <p>If <code>true</code>, the server will exit if an exception happens | |
| during the server initialization phase.</p> | |
| <p>If not specified, the default value of <code>false</code> will be used.</p> | |
| </td></tr></table> | |
| </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> | |
| Copyright © 1999-2014, Apache Software Foundation | |
| </em></font></div></td></tr></table></body></html> |