Author: kkolinko Date: Tue Oct 18 12:11:33 2011 New Revision: 1185609 URL: http://svn.apache.org/viewvc?rev=1185609&view=rev Log: Merged revision 1185588 from tomcat/trunk: Fix https://issues.apache.org/bugzilla/show_bug.cgi?id=52045 Better document what "default" Manager implementation is. Also added a separate section about the pathname="" trick that is used to disable session persistence.
Modified: tomcat/tc5.5.x/trunk/container/webapps/docs/config/manager.xml Modified: tomcat/tc5.5.x/trunk/container/webapps/docs/config/manager.xml URL: http://svn.apache.org/viewvc/tomcat/tc5.5.x/trunk/container/webapps/docs/config/manager.xml?rev=1185609&r1=1185608&r2=1185609&view=diff ============================================================================== --- tomcat/tc5.5.x/trunk/container/webapps/docs/config/manager.xml (original) +++ tomcat/tc5.5.x/trunk/container/webapps/docs/config/manager.xml Tue Oct 18 12:11:33 2011 @@ -43,7 +43,9 @@ <p>A Manager element MAY be nested inside a <a href="context.html">Context</a> component. If it is not included, a default Manager configuration will be created automatically, which - is sufficient for most requirements.</p> + is sufficient for most requirements, — see + <em>Standard Manager Implementation</em> below for the details + of this configuration.</p> </section> @@ -85,7 +87,7 @@ <subsection name="Standard Implementation"> <p>Tomcat provides two standard implementations of <strong>Manager</strong> - for use - the default one stores active sessions, while the optional one + for use — the default one stores active sessions, while the optional one stores active sessions that have been swapped out (in addition to saving sessions across a restart of Tomcat) in a storage location that is selected via the use of an appropriate <strong>Store</strong> nested element.</p> @@ -135,8 +137,9 @@ <p>Absolute or relative (to the work directory for this Context) pathname of the file in which session state will be preserved across application restarts, if possible. The default is - "SESSIONS.ser". See <a href="#Restart Persistence">Restart - Persistence</a> for more information. Restart persistence may be + "SESSIONS.ser".<br />See + <a href="#Persistence_Across_Restarts">Persistence Across Restarts</a> + for more information. This persistence may be disabled by setting this attribute to an empty string.</p> </attribute> @@ -457,9 +460,9 @@ create table tomcat_sessions ( <section name="Special Features"> - <subsection name="Restart Persistence"> + <subsection name="Persistence Across Restarts"> - <p>Whenever Catalina is shut down normally and restarted, or when an + <p>Whenever Apache Tomcat is shut down normally and restarted, or when an application reload is triggered, the standard Manager implementation will attempt to serialize all currently active sessions to a disk file located via the <code>pathname</code> attribute. All such saved @@ -474,6 +477,17 @@ create table tomcat_sessions ( </subsection> + <subsection name="Disable Session Persistence"> + + <p>As documented above, every web application by default has + standard manager implementation configured, and it performs session + persistence across restarts. To disable this persistence feature, create + a <a href="context.html">Context</a> configuration file for your web + application and add the following element there:</p> + + <source><Manager pathname="" /></source> + </subsection> + </section> --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org