mromy 2005/11/25 16:59:55 CET
Modified files:
core/src/webapp/html/startup howto_cluster.html
Log:
- updated for processing servers and sticky sessions
Revision Changes Path
1.9 +39 -4 jahia/core/src/webapp/html/startup/howto_cluster.html
http://jahia.mine.nu:8080/cgi-bin/cvsweb.cgi/jahia/core/src/webapp/html/startup/howto_cluster.html.diff?r1=1.8&r2=1.9&f=h
Index: howto_cluster.html
===================================================================
RCS file: /cvs/jahia/core/src/webapp/html/startup/howto_cluster.html,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- howto_cluster.html 24 Nov 2005 11:25:53 -0000 1.8
+++ howto_cluster.html 25 Nov 2005 15:59:55 -0000 1.9
@@ -13,7 +13,7 @@
font-family : Verdana, Arial, Helvetica,
sans-serif;
}
DIV.main { background-color : #FFFFFF;
- width : 768px;
+ width : 868px;
display : block;
}
A { text-decoration : none;
@@ -22,7 +22,7 @@
A:hover { text-decoration : underline;}
DIV.header { background-color : #FFFFFF;
border-bottom : 4px solid #E7E7E7;
- width : 768px;
+ width : 868px;
}
DIV.header SPAN { border-bottom : 15px solid #006699;
display : block;
@@ -72,7 +72,7 @@
font-size : 12px;
}
DIV.maincontent {
- width : 540px;
+ width : 640px;
pading : 0 10px 0 10px;
background-color : #FFFFFF;
float : left;
@@ -83,7 +83,7 @@
display : block;
text-align : center;
background-color : #FFFFFF;
- width : 768px;
+ width : 868px;
clear : both;
}
.code {
@@ -168,6 +168,28 @@
<i>F\:/directory/content/bigtext/</i><br/>
<i>F\:/directory/content/slide/</i><br/><br/>
if you
are doing a configuration under windows<br/><br/>
+ <br>
+ You
also need to share between all Jahia instances the directory where Lucene
stores its indexes. This can be configured in the
+
<i>jahia\WEB-INF\etc\spring\applicationcontext-basejahiaconfig.xml</i> file
:<br/><br/>
+
+ <i>
+
<prop
key="org.jahia.services.search.searchIndexRootDir">J:\SHARED_DIRECTORY\search_indexes</prop><br>
+
<prop key="org.jahia.services.search.localIndexing">0</prop><br/>
+ <!--
1: index, 0: do not index ,just read ( I.E when sharing a same index directory
in a clustered environment )--><br/>
+ </i>
+ <br/>
+ You can
also configure if a Jahia node should process or not some operations that may
require some heavy processing like
+
import/export, cut/paste or linked copy. To change the beahviour, you need to
mdoify the <i>processingServer</i> parameter
+ in
jahia.properties : </br><br/>
+<pre class="code">
+### Scheduler config ################
+# Path to scheduler configuration
+schedulerConfigFile = $context/WEB-INF/etc/config/quartz.properties
+ramSchedulerConfigFile =
$context/WEB-INF/etc/config/quartz-ram.properties
+processingServer = true
+</pre>
+ When set to
"true", the Jahia node WILL process these kinds of operations. If set to
"false", these operations will be handled
+ to another
Jahia node which has been configured as a processing server. By default this
parameter is set to "true".<br/><br/><br/>
Then, for each
instance of Jahia, you will need to make the following modifications in the
Jahia configuration files:<br/><br/>
<li>Modify the
<i>jahia/WEB-INF/classes/treecache.xml</i> file and replace the following line
:<br/>
<p class="code"><attribute
name="CacheMode">LOCAL</attribute></p>
@@ -227,6 +249,19 @@
<br/>
[org.jgroups.protocols.UDP] ERROR - exception=java.net.BindException: Cannot
assign requested address: Datagram send failed, msg=[ds
1.12.21.133:45000, src:
192.168.2.130:1664 (2 headers), size = 0 bytes], mcast_addr=231.12.21.133:45000
</span>
+ <br/><br>
+ <h4>Sticky sessions</h3>
+ If you are using an
hardware or software loadbalancer in front of Jahia to handle distribution of
load amongst all Jahia nodes in
+ the cluster, you will
need to activate "sticky sessions" on Tomcat and the load balancer. This is
required to force an open session to
+ make all requests on
the same server for the time of the session.<br/>
+ On Tomcat, This is done
by adding a unique jvmRoute in the <i>server.xml</i> file. Uncomment this part
:<br/><br/>
+<pre class="code">
+<!-- You should set jvmRoute to support load-balancing via AJP ie :
+<Engine name="Standalone" defaultHost="localhost" jvmRoute="jvm1">
+-->
+</pre>
+ <br/>
+ where <i>jvm1</i> is the name of the worker as
declared in the load-balancer.<br/>
</p>
</p>
<h2>III - To setup and activate
transactions</h2>
