source: nutchez-0.1/tomcat/webapps/docs/config/printer/cluster-interceptor.html @ 245

Last change on this file since 245 was 66, checked in by waue, 16 years ago

NutchEz - an easy way to nutch
File size: 14.3 KB
Line 
1<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>Apache Tomcat Configuration Reference - The Channel Interceptor 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><!--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 Channel Interceptor object</h2></td><td nowrap="true" valign="top" align="right"><img border="0" hspace="0" vspace="0" height="1" width="1" src="../../images/void.gif"></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>
4  <p>
5  Apache Tribes supports an interceptor architecture to intercept both messages and membership notifications.
6  This architecture allows decoupling of logic and opens the way for some very kewl feature add ons.
7  </p>
8</blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Available Interceptors"><strong>Available Interceptors</strong></a></font></td></tr><tr><td><blockquote>
9 <p>
10   <ul>
11    <li><code>org.apache.catalina.tribes.group.interceptors.TcpFailureDetector</code></li>
12    <li><code>org.apache.catalina.tribes.group.interceptors.ThroughputInterceptor</code></li>
13    <li><code>org.apache.catalina.tribes.group.interceptors.MessageDispatch15Interceptor</code></li>
14    <li><code>org.apache.catalina.tribes.group.interceptors.MessageDispatchInterceptor</code></li>
15    <li><code>org.apache.catalina.tribes.group.interceptors.NonBlockingCoordinator</code></li>
16    <li><code>org.apache.catalina.tribes.group.interceptors.OrderInterceptor</code></li>
17    <li><code>org.apache.catalina.tribes.group.interceptors.StaticMembershipInterceptor</code></li>
18    <li><code>org.apache.catalina.tribes.group.interceptors.TwoPhaseCommitInterceptor</code></li>
19    <li><code>org.apache.catalina.tribes.group.interceptors.DomainFilterInterceptor</code></li>
20    <li><code>org.apache.catalina.tribes.group.interceptors.FragmentationInterceptor</code></li>
21    <li><code>org.apache.catalina.tribes.group.interceptors.GzipInterceptor</code></li>
22   </ul>
23 </p>
24</blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Static Membership"><strong>Static Membership</strong></a></font></td></tr><tr><td><blockquote>
25  <p>
26   In addition to dynamic discovery, Apache Tribes also supports static membership, with membership verification.
27   To achieve this add the <code>org.apache.catalina.tribes.group.interceptors.StaticMembershipInterceptor</code>
28   underneath the <code>org.apache.catalina.tribes.group.interceptors.TcpFailureDetector</code> interceptor.
29   Inside the <code>StaticMembershipInterceptor</code> you can add the static members you wish to have.
30   The <code>TcpFailureDetector</code> will do a health check on the static members,and also monitor them for crashes
31   so they will have the same level of notification mechanism as the members that are automatically discovered.
32   <div align="left"><table border="0" cellpadding="0" cellspacing="4"><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="../../images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="../../images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="../../images/void.gif"></td></tr><tr><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="../../images/void.gif"></td><td height="1" bgcolor="#ffffff"><pre>
33     &lt;Interceptor className="org.apache.catalina.tribes.group.interceptors.StaticMembershipInterceptor"&gt;
34       &lt;Member className="org.apache.catalina.tribes.membership.StaticMember"
35                  port="5678"
36                  securePort="-1"
37                  host="tomcat01.mydomain.com"
38                  domain="staging-cluster"
39                  uniqueId="{0,1,2,3,4,5,6,7,8,9}"/&gt;
40     &lt;/Interceptor&gt;
41   
42   </pre></td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="../../images/void.gif"></td></tr><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="../../images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="../../images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="../../images/void.gif"></td></tr></table></div>
43  </p>
44</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>
45
46  <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>
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"><strong><code>className</code></strong></td><td valign="center" align="left">
48       Required, as there is no default
49     </td></tr><tr><td valign="center" align="left"><code>optionFlag</code></td><td valign="center" align="left">
50       If you want the interceptor to trigger on certain message depending on the message's option flag,
51       you can setup the interceptors flag here.
52       The default value is <code>0</code>, meaning this interceptor will trigger on all messages.
53     </td></tr></table>
54  </blockquote></td></tr></table>
55
56  <table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="org.apache.catalina.tribes.group.interceptors.MessageDispatch15Interceptor Attributes"><strong>org.apache.catalina.tribes.group.interceptors.MessageDispatch15Interceptor Attributes</strong></a></font></td></tr><tr><td><blockquote>
57   <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">
58       Required, This dispatcher uses JDK 1.5 java.util.concurrent package
59     </td></tr><tr><td valign="center" align="left"><code>optionFlag</code></td><td valign="center" align="left">
60       The default and hard coded value is <code>8 (org.apache.catalina.tribes.Channel.SEND_OPTIONS_ASYNCHRONOUS)</code>.
61       The dispatcher will trigger on this value only, as it is predefined by Tribes.
62     </td></tr></table>
63  </blockquote></td></tr></table>
64  <table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="org.apache.catalina.tribes.group.interceptors.MessageDispatchInterceptor Attributes"><strong>org.apache.catalina.tribes.group.interceptors.MessageDispatchInterceptor Attributes</strong></a></font></td></tr><tr><td><blockquote>
65   <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">
66       Required, Same implementation as <code>MessageDispatch15Interceptor</code>, but with JDK 1.4 compliance.
67     </td></tr><tr><td valign="center" align="left"><code>optionFlag</code></td><td valign="center" align="left">
68       The default and hard coded value is <code>8 (org.apache.catalina.tribes.Channel.SEND_OPTIONS_ASYNCHRONOUS)</code>.
69       The dispatcher will trigger on this value only, as it is predefined by Tribes.
70     </td></tr><tr><td valign="center" align="left"><code>alwaysSend</code></td><td valign="center" align="left">
71       What behavior should be executed when the dispatch queue is full. If <code>true</code> (default), then the message is
72       is sent synchronously, if <code>false</code> an error is thrown.   
73     </td></tr><tr><td valign="center" align="left"><code>maxQueueSize</code></td><td valign="center" align="left">
74       Size in bytes of the dispatch queue, the default value is <code> 1024*1024*64 (64MB)</code> sets the maximum queue size for the dispatch queue
75       if the queue fills up, one can trigger the behavior, if <code>alwaysSend</code> is set to true, the mesage will be sent synchronously
76       if the flag is false, an error is thrown 
77     </td></tr></table>
78  </blockquote></td></tr></table>
79  <table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="org.apache.catalina.tribes.group.interceptors.TcpFailureDetector Attributes"><strong>org.apache.catalina.tribes.group.interceptors.TcpFailureDetector Attributes</strong></a></font></td></tr><tr><td><blockquote>
80   <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></table>
81  </blockquote></td></tr></table>
82  <table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="org.apache.catalina.tribes.group.interceptors.ThroughputInterceptor Attributes"><strong>org.apache.catalina.tribes.group.interceptors.ThroughputInterceptor Attributes</strong></a></font></td></tr><tr><td><blockquote>
83   <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>interval</code></td><td valign="center" align="left">
84       Defines the interval in number of messages when we are to report the throughput statistics.
85       The report is logged to the <code>org.apache.juli.logging.LogFactory.getLog(ThroughputInterceptor.class)</code>
86       logger under the <code>INFO</code> level.
87       Default value is to report every <code>10000</code> messages.
88     </td></tr></table>
89  </blockquote></td></tr></table>
90 
91  <table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Nested element StaticMember Attributes"><strong>Nested element StaticMember Attributes</strong></a></font></td></tr><tr><td><blockquote>
92   <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">
93       Only one implementation available:<code>org.apache.catalina.tribes.membership.StaticMember</code>
94     </td></tr><tr><td valign="center" align="left"><strong><code>port</code></strong></td><td valign="center" align="left">
95       The port that this static member listens to for cluster messages
96     </td></tr><tr><td valign="center" align="left"><code>securePort</code></td><td valign="center" align="left">
97       The secure port this static member listens to for encrypted cluster messages
98       default value is <code>-1</code>, this value means the member is not listening on a secure port
99     </td></tr><tr><td valign="center" align="left"><strong><code>host</code></strong></td><td valign="center" align="left">
100       The host (or network interface) that this static member listens for cluster messages.
101       Three different type of values are possible:<br>
102       1. IP address in the form of "216.123.1.23"<br>
103       2. Hostnames like "tomcat01.mydomain.com" or "tomcat01" as long as they resolve correctly<br>
104       3. byte array in string form, for example {216,123,12,3}<br>
105     </td></tr><tr><td valign="center" align="left"><strong><code>domain</code></strong></td><td valign="center" align="left">
106       The logical cluster domain for this this static member listens for cluster messages.
107       Two different type of values are possible:<br>
108       1. Regular string values like "staging-domain" or "tomcat-cluster" will be converted into bytes
109       using ISO-8859-1 encoding.
110       2. byte array in string form, for example {216,123,12,3}<br>
111     </td></tr><tr><td valign="center" align="left"><strong><code>uniqueId</code></strong></td><td valign="center" align="left">
112       A universally uniqueId for this static member.
113       The values must be 16 bytes in the following form:<br>
114       1. byte array in string form, for example {0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15}<br>
115     </td></tr></table>
116  </blockquote></td></tr></table>
117 
118 
119</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>
120        Copyright &copy; 1999-2008, Apache Software Foundation
121        </em></font></div></td></tr></table></body></html>
Note: See TracBrowser for help on using the repository browser.