You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by yo...@apache.org on 2004/10/07 15:09:17 UTC

cvs commit: jakarta-tomcat-catalina/webapps/docs/config manager.xml

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="craigmcc@apache.org">Craig R. McClanahan</author>
  +    <author email="yoavs@apache.org">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: tomcat-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: tomcat-dev-help@jakarta.apache.org