source: nutchez-0.1/tomcat/webapps/docs/config/cluster-manager.html @ 179

Last change on this file since 179 was 66, checked in by waue, 15 years ago

NutchEz - an easy way to nutch

File size: 10.1 KB
Line 
1<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>Apache Tomcat Configuration Reference - The ClusterManager object</title><meta value="Filip Hanik" name="author"><meta value="fhanik@apache.org" name="email"></head><body vlink="#525D76" alink="#525D76" link="#525D76" text="#000000" bgcolor="#ffffff"><table cellspacing="0" width="100%" border="0"><!--PAGE HEADER--><tr><td><!--PROJECT LOGO--><a href="http://tomcat.apache.org/"><img border="0" alt="
2    The Apache Tomcat Servlet/JSP Container
3  " align="right" src="../images/tomcat.gif"></a></td><td><font face="arial,helvetica,sanserif"><h1>Apache Tomcat 6.0</h1></font></td><td><!--APACHE LOGO--><a href="http://www.apache.org/"><img border="0" alt="Apache Logo" align="right" src="../images/asf-logo.gif"></a></td></tr></table><table cellspacing="4" width="100%" border="0"><!--HEADER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade></td></tr><tr><!--LEFT SIDE NAVIGATION--><td nowrap="true" valign="top" width="20%"><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="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>Global Settings</strong></p><ul><li><a href="systemprops.html">System properties</a></li></ul></td><!--RIGHT SIDE MAIN BODY--><td align="left" valign="top" width="80%"><table cellspacing="4" width="100%" border="0"><tr><td valign="top" align="left"><h1>Apache Tomcat Configuration Reference</h1><h2>The ClusterManager object</h2></td><td nowrap="true" valign="top" align="right"><small><a href="printer/cluster-manager.html"><img alt="Printer Friendly Version" border="0" src="../images/printer.gif"><br>print-friendly<br>version
4                    </a></small></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote>
5  <p>
6  A cluster manager is an extension to Tomcat's session manager interface,
7  <code>org.apache.catalina.Manager</code>
8  A cluster manager must implement the <code>org.apache.catalina.ha.ClusterManager</code> and is solely
9  responsible for how the session is replicated.<br>
10  There are currently two different managers, the <code>org.apache.catalina.ha.session.DeltaManager</code> replicates deltas
11  of session data to all members in the cluster. This implementation is proven and works very well, but has a limitation
12  as it requires the cluster members to be homogeneous, all nodes must deploy the same applications and be exact replicas.
13  The <code>org.apache.catalina.ha.session.BackupManager</code> also replicates deltas but only to one backup node.
14  The location of the backup node is known to all nodes in the cluster. It also supports heterogeneous deployments,
15  so the manager knows at what locations the webapp is deployed.<br>
16  We are planning to add more managers with even more sophisticated backup mechanism to support even larger clusters.
17  Check back soon!
18  </p>
19</blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="The <Manager>"><strong>The &lt;Manager&gt;</strong></a></font></td></tr><tr><td><blockquote>
20  <p>
21   The <code>&lt;Manager&gt;</code> element defined inside the <code>&lt;Cluster&gt;</code> element
22   is the template defined for all web applications that are marked <code>&lt;distributable/&gt;</code>
23   in their <code>web.xml</code> file.
24   However, you can still override the manager implementation on a per web application basis,
25   by putting the <code>&lt;Manager&gt;</code> inside the <code>&lt;Context&gt;</code> element either in the
26   <code><a href="context.html">context.xml</a></code> file or the <code><a href="index.html">server.xml</a></code> file.
27  </p> 
28</blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Attributes"><strong>Attributes</strong></a></font></td></tr><tr><td><blockquote>
29  <table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Common Attributes"><strong>Common Attributes</strong></a></font></td></tr><tr><td><blockquote>
30    <table cellpadding="5" border="1"><tr><th bgcolor="#023264" width="15%"><font color="#ffffff">Attribute</font></th><th bgcolor="#023264" width="85%"><font color="#ffffff">Description</font></th></tr><tr><td valign="center" align="left"><strong><code>className</code></strong></td><td valign="center" align="left">
31     </td></tr><tr><td valign="center" align="left"><code>name</code></td><td valign="center" align="left">
32      <b>The name of this cluster manager, the name is used to identify a session manager on a node.
33      The name might get modified by the <code>Cluster</code> element to make it unique in the container.</b>
34     </td></tr><tr><td valign="center" align="left"><code>defaultMode</code></td><td valign="center" align="left">
35      <b>Deprecated since 6.0.0</b>
36     </td></tr><tr><td valign="center" align="left"><code>notifyListenersOnReplication</code></td><td valign="center" align="left">
37       Set to <code>true</code> if you wish to have session listeners notified when
38       session attributes are being replicated or removed across Tomcat nodes in the cluster.
39     </td></tr><tr><td valign="center" align="left"><code>expireSessionsOnShutdown</code></td><td valign="center" align="left">
40       When a webapplication is being shutdown, Tomcat issues an expire call to each session to
41       notify all the listeners. If you wish for all sessions to expire on all nodes when
42       a shutdown occurs on one node, set this value to <code>true</code>.
43       Default value is <code>false</code>.
44     </td></tr></table>
45  </blockquote></td></tr></table> 
46  <table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="org.apache.catalina.ha.session.DeltaManager Attributes"><strong>org.apache.catalina.ha.session.DeltaManager Attributes</strong></a></font></td></tr><tr><td><blockquote>
47    <table cellpadding="5" border="1"><tr><th bgcolor="#023264" width="15%"><font color="#ffffff">Attribute</font></th><th bgcolor="#023264" width="85%"><font color="#ffffff">Description</font></th></tr><tr><td valign="center" align="left"><code>domainReplication</code></td><td valign="center" align="left">
48      Set to true if you wish sessions to be replicated only to members that have the same logical
49      domain set. If set to false, session replication will ignore the domain setting the
50      <code><a href="cluster-membership.html">&lt;Membership&gt;</a></code>
51      element.
52     </td></tr><tr><td valign="center" align="left"><code>expireSessionsOnShutdown</code></td><td valign="center" align="left">
53       When a webapplication is being shutdown, Tomcat issues an expire call to each session to
54       notify all the listeners. If you wish for all sessions to expire on all nodes when
55       a shutdown occurs on one node, set this value to <code>true</code>.
56       Default value is <code>false</code>.
57     </td></tr><tr><td valign="center" align="left"><code>stateTransferTimeout</code></td><td valign="center" align="left">
58       The time in seconds to wait for a session state transfer to complete from another node
59       when a node is starting up.
60       Default value is <code>60</code> seconds.
61     </td></tr></table>
62  </blockquote></td></tr></table>
63  <table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="org.apache.catalina.ha.session.BackupManager Attributes"><strong>org.apache.catalina.ha.session.BackupManager Attributes</strong></a></font></td></tr><tr><td><blockquote>
64    <table cellpadding="5" border="1"><tr><th bgcolor="#023264" width="15%"><font color="#ffffff">Attribute</font></th><th bgcolor="#023264" width="85%"><font color="#ffffff">Description</font></th></tr><tr><td valign="center" align="left"><code>mapSendOptions</code></td><td valign="center" align="left">
65       The backup manager uses a replicated map, this map is sending and receiving messages.
66       You can setup the flag for how this map is sending messages, the default value is <code>6</code>(asynchronous).
67     </td></tr></table>
68  </blockquote></td></tr></table>
69</blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font size="-1" color="#525D76"><em>
70        Copyright &copy; 1999-2008, Apache Software Foundation
71        </em></font></div></td></tr></table></body></html>
Note: See TracBrowser for help on using the repository browser.