Author: jfrederic.clere(a)jboss.com
Date: 2011-07-05 10:50:31 -0400 (Tue, 05 Jul 2011)
New Revision: 1767
Modified:
trunk/webapps/docs/sysprops.xml
Log:
Arrange it and remove the properties we don't support.
Modified: trunk/webapps/docs/sysprops.xml
===================================================================
--- trunk/webapps/docs/sysprops.xml 2011-07-05 09:26:09 UTC (rev 1766)
+++ trunk/webapps/docs/sysprops.xml 2011-07-05 14:50:31 UTC (rev 1767)
@@ -30,67 +30,65 @@
<section name="Introduction">
<p>The follow sections list the system properties that may be set to modify
- the default Tomcat behaviour.</p>
+ the default JBossWeb behaviour.</p>
+ <p>The <code>system-properties</code>can be set in the AS7
configuration (you need to
+ restart it to get them applied to the web sub system, for example:
+<source>
+standalone@localhost:9999 /]
./system-property=org.apache.catalina.JSESSIONID:add(value="MYID")
+{"outcome" => "success"}
+standalone@localhost:9999 /] :shutdown
+Communication error: Channel closed
+Closed connection to localhost:9999
+</source>
+ then restart it for some properties a reload command is enough:
+<source>
+[standalone@localhost:9999 /] :reload
+{
+ "outcome" => "success",
+ "response-headers" => {
+ "operation-requires-reload" => true,
+ "process-state" => "reload-required"
+ }
+}
+</source>
+ </p>
</section>
<section name="Servlet container and connectors">
<properties>
- <property name="catalina.useNaming">
- <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>
- </property>
-
<property name="jvmRoute">
<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 a value
- configured on the <a href="engine.html">Engine</a>
element.</p>
+ <a href="engine.html">Engine</a> element. It does not
override the automaticaly
+ generated value used when using ha read with using configuration like
<code>standalone-ha.xml</code></p>
+ <p>It supports <code>:reload</code>.</p>
</property>
- <property
- name="org.apache.catalina.loader.
WebappClassLoader.ENABLE_CLEAR_REFERENCES">
- <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>
- </property>
-
- <property name="catalina.config">
- <p>The URL for the catalina.properties configuration file.</p>
- </property>
-
- <property
name="org.apache.tomcat.tomcat.util.buf.StringCache.byte.enabled">
+ <property
name="org.apache.tomcat.util.buf.StringCache.byte.enabled">
<p>If <code>true</code>, the String cache is enabled for
<code>ByteChunk</code>. If not specified, the default value of
<code>false</code> will be used.</p>
</property>
- <property
name="org.apache.tomcat.tomcat.util.buf.StringCache.char.enabled">
+ <property
name="org.apache.tomcat.util.buf.StringCache.char.enabled">
<p>If <code>true</code>, the String cache is enabled for
<code>CharChunk</code>. If not specified, the default value of
<code>false</code> will be used.</p>
</property>
- <property
name="org.apache.tomcat.tomcat.util.buf.StringCache.trainThreshold">
+ <property
name="org.apache.tomcat.util.buf.StringCache.trainThreshold">
<p>The number of times <code>toString()</code> must be called
before the
cache is activated. If not specified, the default value of
<code>20000</code> will be used.</p>
</property>
- <property
name="org.apache.tomcat.tomcat.util.buf.StringCache.cacheSize">
+ <property name="org.apache.tomcat.util.buf.StringCache.cacheSize">
<p>The size of the String cache. If not specified, the default value of
<code>200</code> will be used.</p>
</property>
- <property
name="org.apache.tomcat.tomcat.util.buf.StringCache.maxStringSize">
+ <property
name="org.apache.tomcat.util.buf.StringCache.maxStringSize">
<p>The maximum length of String that will be cached. If not specified, the
default value of <code>128</code> will be used.</p>
</property>
@@ -112,7 +110,7 @@
</property>
<property
- name="org.apache.coyote. USE_CUSTOM_STATUS_MSG_IN_HEADER">
+ name="org.apache.coyote.Constants.USE_CUSTOM_STATUS_MSG_IN_HEADER">
<p>If this is <code>true</code> custom HTTP status messages will
be used
within HTTP headers. Users must ensure that any such message is
ISO-8859-1 encoded, particularly if user provided input is included in
@@ -120,12 +118,6 @@
the default value of <code>false</code> will be used.</p>
</property>
- <property name="org.apache.tomcat.util.
http.ServerCookie.VERSION_SWITCH">
- <p>If using cookie values which have to be quoted to be valid and v0
cookies,
- this will cause an automatic switch to v1 cookies. If not
- specified, the default value of <code>true</code> will be
used.</p>
- </property>
-
</properties>
</section>
@@ -148,63 +140,61 @@
<section name="JSP">
<properties>
- <property name="org.apache.jasper.compiler.
Generator.VAR_EXPRESSIONFACTORY">
+ <property
name="org.apache.jasper.compiler.Generator.VAR_EXPRESSIONFACTORY">
<p>The name of the variable to use for the expression language expression
factory. If not specified, the default value of
<code>_el_expressionfactory</code> will be used.</p>
</property>
- <property name="org.apache.jasper.compiler.
Generator.VAR_INSTANCEMANAGER">
+ <property
name="org.apache.jasper.compiler.Generator.VAR_INSTANCEMANAGER">
<p>The name of the variable to use for the instance manager factory. If
not specified, the default value of <code>_jsp_instancemanager</code>
will
be used.</p>
</property>
- <property name="org.apache.jasper.compiler.
Parser.STRICT_QUOTE_ESCAPING">
+ <property
name="org.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING">
<p>If <code>false</code> the requirements for escpaing quotes in
JSP
attributes will be relaxed so that a missing required quote will not
cause an error. If not specified, the specification compliant default of
<code>true</code> will be used.</p>
</property>
-<!--
- <property name="org.apache.jasper.runtime.
BodyContentImpl.LIMIT_BUFFER">
- <p>If <code>true</code>, any tag buffer that expands beyond
+ <property
name="org.apache.jasper.Constants.DEFAULT_TAG_BUFFER_SIZE">
+ <p>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. If not specified,
- the default value of <code>false</code> will be used.</p>
+ the default value of <code>512</code> will be used.</p>
</property>
- -->
- <property name="org.apache.jasper.runtime. JspFactoryImpl.USE_POOL">
+ <property name="org.apache.jasper.runtime.JspFactoryImpl.USE_POOL">
<p>If <code>true</code>, a ThreadLocal
<code>PageContext</code> pool will
be used. If not specified, the default value of <code>true</code> will
be
used.</p>
</property>
- <property name="org.apache.jasper.runtime.
JspFactoryImpl.POOL_SIZE">
+ <property name="org.apache.jasper.runtime.JspFactoryImpl.POOL_SIZE">
<p>The size of the ThreadLocal <code>PageContext</code>. If not
specified,
the default value of <code>8</code> will be used.</p>
</property>
- <property name="org.apache.jasper.Constants. JSP_SERVLET_BASE">
+ <property name="org.apache.jasper.Constants.JSP_SERVLET_BASE">
<p>The base class of the Servlets generated from the JSPs. If not
specified, the default value of
<code>org.apache.jasper.runtime.HttpJspBase</code> will be
used.</p>
</property>
- <property name="org.apache.jasper.Constants. SERVICE_METHOD_NAME">
+ <property name="org.apache.jasper.Constants.SERVICE_METHOD_NAME">
<p>The name of the service method called by the base class. If not
specified, the default value of <code>_jspService</code> will be
used.</p>
</property>
- <property name="org.apache.jasper.Constants. SERVLET_CLASSPATH">
+ <property name="org.apache.jasper.Constants.SERVLET_CLASSPATH">
<p>The name of the ServletContext attribute that provides the classpath
for the JSP. If not specified, the default value of
<code>org.apache.catalina.jsp_classpath</code> will be used.</p>
</property>
- <property name="org.apache.jasper.Constants. JSP_FILE">
+ <property name="org.apache.jasper.Constants.JSP_FILE">
<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
@@ -212,41 +202,34 @@
<code>org.apache.catalina.jsp_file</code> will be used.</p>
</property>
- <property name="org.apache.jasper.Constants. PRECOMPILE">
+ <property name="org.apache.jasper.Constants.PRECOMPILE">
<p>The name of the query parameter that causes the JSP engine to just
pregenerate the servlet but not invoke it. If not specified, the default
value of <code>org.apache.catalina.jsp_precompile</code> will be
used.</p>
</property>
- <property name="org.apache.jasper.Constants. JSP_PACKAGE_NAME">
+ <property name="org.apache.jasper.Constants.JSP_PACKAGE_NAME">
<p>The default package name for compiled jsp pages. If not specified, the
default value of <code>org.apache.jsp</code> will be used.</p>
</property>
- <property name="org.apache.jasper.Constants. TAG_FILE_PACKAGE_NAME">
+ <property name="org.apache.jasper.Constants.TAG_FILE_PACKAGE_NAME">
<p>The default package name for tag handlers generated from tag files. If
not specified, the default value of <code>org.apache.jsp.tag</code>
will
be used.</p>
</property>
- <property name="org.apache.jasper.Constants. ALT_DD_ATTR">
- <p>The servlet context attribute under which the alternate deployment
- descriptor for this web application is stored. If not specified, the
- default value of <code>org.apache.catalina.deploy.alt_dd</code> will
- be used.</p>
- </property>
-
- <property name="org.apache.jasper.Constants.
TEMP_VARIABLE_NAME_PREFIX">
+ <property
name="org.apache.jasper.Constants.TEMP_VARIABLE_NAME_PREFIX">
<p>Prefix to use for generated temporary variable names. If not specified,
the default value of <code>_jspx_temp</code> will be used.</p>
</property>
- <property name="org.apache.jasper.Constants.
USE_INSTANCE_MANAGER_FOR_TAGS">
+ <property
name="org.apache.jasper.Constants.USE_INSTANCE_MANAGER_FOR_TAGS">
<p>If <code>true</code>, the instance manager is used to obtain
tag
handler instances. If not specified, <code>false</code> will be
used.</p>
</property>
- <property name="org.apache.jasper.Constants.
USE_INSTANCE_MANAGER_FOR_TAGS">
+ <property name="org.apache.jasper.Constants.INJECT_TAGS">
<p>If <code>true</code>, annotations specified in tags will be
processed and
injected. This can have a performance impact when using simple tags, or if tag
pooling is disabled. If not specified, <code>true</code> will be
used.</p>
@@ -261,21 +244,21 @@
<properties>
- <property name="org.apache.catalina.connector. RECYCLE_FACADES">
+ <property name="org.apache.catalina.connector.RECYCLE_FACADES">
<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. If not specified, the
default value of <code>false</code> will be used.</p>
</property>
<property
- name="org.apache.catalina.connector. CoyoteAdapter.ALLOW_BACKSLASH">
+ name="org.apache.catalina.connector.CoyoteAdapter.ALLOW_BACKSLASH">
<p>If this is <code>true</code> the '\' character will be
permitted as a
path delimiter. If not specified, the default value of
<code>false</code>
will be used.</p>
</property>
<property
- name="org.apache.tomcat.util.buf. UDecoder.ALLOW_ENCODED_SLASH">
+ name="org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH">
<p>If this is <code>true</code> '%2F' and '%5C'
will be permitted as path
delimiters. If not specified, the default value of <code>false</code>
will
be used.</p>
@@ -290,7 +273,7 @@
<properties>
- <property name="org.apache.catalina. STRICT_SERVLET_COMPLIANCE">
+ <property name="org.apache.catalina.STRICT_SERVLET_COMPLIANCE">
<p>If this is <code>true</code> the following actions will
occur:
<ul>
<li>any wrapped request or response object passed to an application
@@ -311,7 +294,7 @@
</p>
</property>
- <property name="org.apache.catalina.core.
StandardWrapperValve.SERVLET_STATS">
+ <property
name="org.apache.catalina.core.StandardWrapperValve.SERVLET_STATS">
<p>If <code>true</code> or if
<code>org.apache.catalina.STRICT_SERVLET_COMPLIANCE</code> is
<code>true</code>, the wrapper will collect the JSR-77 statistics for
@@ -320,7 +303,7 @@
</property>
<property
- name="org.apache.catalina.session. StandardSession.ACTIVITY_CHECK">
+ name="org.apache.catalina.session.StandardSession.ACTIVITY_CHECK">
<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
@@ -335,4 +318,4 @@
</body>
-</document>
\ No newline at end of file
+</document>