yoavs 2004/10/07 06:09:17
Modified: webapps/docs changelog.xml
webapps/docs/config manager.xml
Log:
Bugzilla 31578: update Manager configuration reference.
Revision Changes Path
1.144 +3 -0 jakarta-tomcat-catalina/webapps/docs/changelog.xml
Index: changelog.xml
===================================================================
RCS file: /home/cvs/jakarta-tomcat-catalina/webapps/docs/changelog.xml,v
retrieving revision 1.143
retrieving revision 1.144
diff -u -r1.143 -r1.144
--- changelog.xml 6 Oct 2004 18:48:05 -0000 1.143
+++ changelog.xml 7 Oct 2004 13:09:17 -0000 1.144
@@ -37,6 +37,9 @@
<fix>
Register JSP monitoring mbean for each servlet that declares a jsp-file in
web.xml. (luehe)
</fix>
+ <fix>
+ <bug>31578</bug>: Update Manager configuration documentation. (yoavs)
+ </fix>
</changelog>
</subsection>
1.10 +45 -18 jakarta-tomcat-catalina/webapps/docs/config/manager.xml
Index: manager.xml
===================================================================
RCS file: /home/cvs/jakarta-tomcat-catalina/webapps/docs/config/manager.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- manager.xml 5 Oct 2004 17:12:52 -0000 1.9
+++ manager.xml 7 Oct 2004 13:09:17 -0000 1.10
@@ -8,6 +8,7 @@
<properties>
<author email="[EMAIL PROTECTED]">Craig R. McClanahan</author>
+ <author email="[EMAIL PROTECTED]">Yoav Shapira</author>
<title>The Manager Component</title>
</properties>
@@ -86,11 +87,6 @@
If not specified, the default value is "MD5".</p>
</attribute>
- <attribute name="checkInterval" required="false">
- <p>The number of seconds between checks for expired sessions
- for this manager. The default value is 60 seconds.</p>
- </attribute>
-
<attribute name="entropy" required="false">
<p>A String value that is utilized when seeding the random number
generator used to create session identifiers for this Manager.
@@ -104,6 +100,18 @@
this Manager, or -1 (the default) for no limit.</p>
</attribute>
+ <attribute name="maxInactiveInterval" required="false">
+ <p>The initial maximum time interval, in seconds,
+ between client requests before a session is invalidated. A negative value
+ will result in sessions never timing out. If the attribute is not provided,
+ a default of 60 seconds is used.</p>
+
+ <p>This attribute provides the initial value whenever a
+ new session is created, but the interval may be dynamically
+ varied by a servlet via the
+ <code>setMaxInactiveInterval</code> method of the <code>HttpSession</code>
object.</p>
+ </attribute>
+
<attribute name="pathname" required="false">
<p>Absolute or relative (to the work directory for this Context)
pathname of the file in which session state will be preserved
@@ -113,12 +121,26 @@
disabled by setting this attribute to an empty string.</p>
</attribute>
+ <attribute name="processExpiresFrequency" required="false">
+ <p>Frequency of the session expiration, and related manager operations.
+ Manager operations will be done once for the specified amount of
+ backgrondProcess calls (ie, the lower the amount, the more often the
+ checks will occur). The minimum value is 1, and the default value is 6.
+ </p>
+ </attribute>
+
<attribute name="randomClass" required="false">
<p>Java class name of the <code>java.util.Random</code>
implementation class to use. If not specified, the default value is
<code>java.security.SecureRandom</code>.</p>
</attribute>
+ <attribute name="sessionIdLength" required="false">
+ <p>The length of session ids created by this Manager, excluding any
+ JVM route information used for load balancing.
+ The default is 16.</p>
+ </attribute>
+
</attributes>
<h3>Persistent Manager Implementation</h3>
@@ -150,11 +172,6 @@
If not specified, the default value is "MD5".</p>
</attribute>
- <attribute name="checkInterval" required="false">
- <p>The number of seconds between checks for expired sessions
- for this Manager. The default value is 60 seconds.</p>
- </attribute>
-
<attribute name="className" required="false">
<p>Java class name of the implementation to use. This class must
implement the <code>org.apache.catalina.Manager</code> interface.
@@ -171,14 +188,6 @@
environments.</p>
</attribute>
- <attribute name="processExpiresFrequency" required="false">
- <p>Frequency of the session expiration, and related manager operations.
- Manager operations will be done once for the specified amount of
- backgrondProcess calls (ie, the lower the amount, the most often the
- checks will occur). The minimum value is 1, and the default value is 6.
- </p>
- </attribute>
-
<attribute name="maxActiveSessions" required="false">
<p>The maximum number of active sessions that will be created by
this Manager, or -1 (the default) for no limit.</p>
@@ -209,6 +218,18 @@
this value is set to <code>-1</code>.</p>
</attribute>
+ <attribute name="maxInactiveInterval" required="false">
+ <p>The initial maximum time interval, in seconds,
+ between client requests before a session is invalidated. A negative value
+ will result in sessions never timing out. If the attribute is not provided,
+ a default of 60 seconds is used.</p>
+
+ <p>This attribute provides the initial value whenever a
+ new session is created, but the interval may be dynamically
+ varied by a servlet via the
+ <code>setMaxInactiveInterval</code>method of the <code>HttpSession</code>
object.</p>
+ </attribute>
+
<attribute name="randomClass" required="false">
<p>Java class name of the <code>java.util.Random</code>
implementation class to use. If not specified, the default value is
@@ -219,6 +240,12 @@
<p>Should all sessions be persisted and reloaded when Tomcat is shut
down and restarted (or when this application is reloaded)? By default,
this attribute is set to <code>true</code>.</p>
+ </attribute>
+
+ <attribute name="sessionIdLength" required="false">
+ <p>The length of session ids created by this Manager, excluding any
+ JVM route information used for load balancing.
+ The default is 16.</p>
</attribute>
</attributes>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
