Author: rjung
Date: Sun Aug 27 09:03:01 2006
New Revision: 437390
URL: http://svn.apache.org/viewvc?rev=437390&view=rev
Log:
Add docs for worker atribute "reference".
Update changelog.
Modified:
tomcat/connectors/trunk/jk/xdocs/changelog.xml
tomcat/connectors/trunk/jk/xdocs/config/workers.xml
tomcat/connectors/trunk/jk/xdocs/howto/workers.xml
Modified: tomcat/connectors/trunk/jk/xdocs/changelog.xml
URL:
http://svn.apache.org/viewvc/tomcat/connectors/trunk/jk/xdocs/changelog.xml?rev=437390&r1=437389&r2=437390&view=diff
==============================================================================
--- tomcat/connectors/trunk/jk/xdocs/changelog.xml (original)
+++ tomcat/connectors/trunk/jk/xdocs/changelog.xml Sun Aug 27 09:03:01 2006
@@ -25,6 +25,12 @@
<br />
<subsection name="Native">
<changelog>
+ <update>
+ Implement hierarchical worker configuration via attribute "reference".
(rjung)
+ </update>
+ <update>
+ Log deprecated properties. (rjung)
+ </update>
<fix>
IIS: Fix simple_rewrite for the cases where the
rewritten url is larger then the original one. (mturk)
@@ -65,6 +71,10 @@
<update>
Allow building with VS2005 without too many warnings. (mturk)
</update>
+ <fix>
+ Decide by MMN, which piped log API we should use.
+ mod_jk 1.2.18 broke compilation with Apache 1.3 pre 1.3.28. (rjung)
+ </fix>
</changelog>
</subsection>
</section>
Modified: tomcat/connectors/trunk/jk/xdocs/config/workers.xml
URL:
http://svn.apache.org/viewvc/tomcat/connectors/trunk/jk/xdocs/config/workers.xml?rev=437390&r1=437389&r2=437390&view=diff
==============================================================================
--- tomcat/connectors/trunk/jk/xdocs/config/workers.xml (original)
+++ tomcat/connectors/trunk/jk/xdocs/config/workers.xml Sun Aug 27 09:03:01 2006
@@ -521,6 +521,26 @@
</p>
</directive>
+<directive name="reference" default="" required="false">
+This directive allows to copy configurations between workers
+in a hierarchical way. If worker castor sets
<b>worker.castor.reference=worker.pollux</b>
+then it inherits all properties of <b>pollux</b>, except for the ones that
+are explicitely set for <b>castor</b>.
+<p>
+Please note, that the value of the directive is not only the name of the
referred worker,
+but the complete prefix including "worker.".
+</p>
+<p>
+This directive is especially useful, if one has a lot of balanced workers in a
load balancer
+and these workers share most of their properties. You can set all of these
properties
+in a phantom worker, e.g. using the prefix "worker.template1", and then simply
+reference those common properties in all balanced workers.
+</p>
+<p>
+This feature has been added in <b>jk 1.2.19</b>.
+</p>
+</directive>
+
<directive name="secret" default="" required="false">
If set to AJP Connector secret keyword, only request with this keyword are
successfull responding.
Use <b>request.useSecret="true"</b> and <b>request.secret="secret key
word"</b> at your tomcat ajp
Modified: tomcat/connectors/trunk/jk/xdocs/howto/workers.xml
URL:
http://svn.apache.org/viewvc/tomcat/connectors/trunk/jk/xdocs/howto/workers.xml?rev=437390&r1=437389&r2=437390&view=diff
==============================================================================
--- tomcat/connectors/trunk/jk/xdocs/howto/workers.xml (original)
+++ tomcat/connectors/trunk/jk/xdocs/howto/workers.xml Sun Aug 27 09:03:01 2006
@@ -376,6 +376,70 @@
</subsection>
+<subsection name="Hierarchical property configuration">
+<p>
+Workers can reference configurations of other workers.
+If worker "x" references worker "y", then it inherits all
+configuration parameters from "y", except for the ones
+that have explicitely been set for "x".
+</p>
+
+<source>
+ # worker toe defines some default settings
+ worker.toe.type=ajp13
+ worker.toe.socket_keepalive=true
+ worker.toe.connect_timeout=10000
+ worker.toe.recovery_options=7
+ # workers tic and tac inherit those values
+ worker.tic.reference=worker.toe
+ worker.tac.reference=worker.toe
+</source>
+
+<p>
+Please note, that the reference contains
+the full prefix to the referenced configuration attributes,
+not only the name of the referenced worker.
+</p>
+
+<p>
+References can be nested. Be careful to avoid loops!
+</p>
+References are especially useful, when configuring load balancers.
+Try to understand the following two stage references:
+</p>
+
+<source>
+ # We only use one load balancer
+ worker.list=lb
+ # Let's define some defaults
+ worker.basic.port=8009
+ worker.basic.type=ajp13
+ worker.basic.socket_keepalive=true
+ worker.basic.connect_timeout=10000
+ worker.basic.recovery_options=7
+ # And we use them in two groups
+ worker.lb1.domain=dom1
+ worker.lb1.distance=0
+ worker.lb1.reference=worker.basic
+ worker.lb2.domain=dom2
+ worker.lb2.distance=1
+ worker.lb2.reference=worker.basic
+ # Now we configure the load balancer
+ worker.lb.type=lb
+ worker.lb.method=B
+ worker.lb.balanced_workers=w11,w12,w21,w22
+ worker.w11.host=myhost11
+ worker.w11.reference=worker.lb1
+ worker.w12.host=myhost12
+ worker.w12.reference=worker.lb1
+ worker.w21.host=myhost21
+ worker.w21.reference=worker.lb2
+ worker.w22.host=myhost22
+ worker.w22.reference=worker.lb2
+</source>
+
+</subsection>
+
</section>
<section name="A sample worker.properties">
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
