| Hongqing Liu | fd5ee81 | 2014-05-10 16:32:51 +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.39) - System Properties</title><style type="text/css" media="print">
|
| 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
|
| 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.39, Jan 27 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>Other</strong></p><ul><li><a href="filter.html">Filter</a></li><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>
|
| 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><jsp-file></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 © 1999-2014, Apache Software Foundation
|
| 345 | </em></font></div></td></tr></table></body></html> |