Author: shuber
Date: Fri Sep 14 15:12:09 2007
New Revision: 18503
URL: https://svndev.jahia.net/websvn/listing.php?sc=3D1&rev=3D18503&repname=
=3Djahia
Log:
Updated cluster documentation to add EHCache specific steps & also improved=
Troubleshooting section.
Modified:
branches/JAHIA-5-0-SP-BRANCH/core/src/webapp/html/startup/howto_cluster=
.html
Modified: branches/JAHIA-5-0-SP-BRANCH/core/src/webapp/html/startup/howto_c=
luster.html
URL: https://svndev.jahia.net/websvn/diff.php?path=3D/branches/JAHIA-5-0-SP=
-BRANCH/core/src/webapp/html/startup/howto_cluster.html&rev=3D18503&repname=
=3Djahia
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D
--- branches/JAHIA-5-0-SP-BRANCH/core/src/webapp/html/startup/howto_cluster=
.html (original)
+++ branches/JAHIA-5-0-SP-BRANCH/core/src/webapp/html/startup/howto_cluster=
.html Fri Sep 14 15:12:09 2007
@@ -192,8 +192,7 @@
During the configuration
wizard, select "In base content storage=
" if you prefer to store all
data in the
database. That way you don't have to setup a share=
d space for bigtext files and files uploaded in Jahia.
After configuration
wizard is completed and installaton succes=
sful, make sure you access the home page at least once
- to finish creating
all necessary tables in the database. You c=
an now shutdown this instance of Jahia.
- </li>
+ to finish creating
all necessary tables in the database. You c=
an now shutdown this instance of Jahia. </li>
=
<li>Modify the
<i>jahia/WEB-INF/etc/config/jahia.properties</i> =
and set the following in the <i>Cluster settings</i> part :<br />
<p
class=3D"code">cluster.activated =3D true</p>
@@ -278,11 +277,23 @@
uncompress it on the server that will act as s=
econd Jahia node. On this server, you will only need to change the
<i><span class=3D"red">cluster.node.serverId</=
span></i> parameter (see point 3), the <i><span class=3D"red">processingSer=
ver</span></i> parameter
(see point 4), the <i><span class=3D"red">=
localIndexing</span></i> parameter (see point 6) and the <i><span class=3D"=
red">localIp</span></i>
- parameter in jahia.properties.
- </li>
- </ol>
+ parameter in jahia.properties.
</li>
+ <li>In the EHCache
configuration, you must activate clustering so =
that the caches may be properly invalidated on all
nodes. To do this, in th=
e jahia/WEB-INF/classes/ehcache-jahia.xml, uncomment the following lines :
+ <pre class=3D"code"> <defaultCache<br /> =
maxElementsInMemory=3D"3000"<br /> eternal=
=3D"false"<br /> timeToIdleSeconds=3D"3600"<=
br /> timeToLiveSeconds=3D"14400"<br /> ove=
rflowToDisk=3D"false"<br /> maxElementsOnDisk=3D"=
1000000"<br /> diskPersistent=3D"false"<br /> =
diskExpiryThreadIntervalSeconds=3D"600"<br /> =
memoryStoreEvictionPolicy=3D"LRU"<br /> ><br /> <!-- =
Uncomment this to activate clustering<br /> <cacheEventListenerFa=
ctory =
+ class=3D"net.sf.ehcache.distribution.RMICacheReplicatorFacto=
ry"<br /> properties=3D"replicateAsynchronously=3Dtrue,<b=
r /> replicatePuts=3Dfalse,<br /> replicateUpdates=3Dtrue,<=
br /> replicateUpdatesViaCopy=3Dfalse,<br /> replicateRemov=
als=3Dtrue<br /> asynchronousReplicationIntervalMillis=3D5000"=
/><br /> <bootstrapCacheLoaderFactory<br /> class=3D&qu=
ot;net.sf.ehcache.distribution.RMIBootstrapCacheLoaderFactory"<br /> =
properties=3D"bootstrapAsynchronously=3Dtrue, maximumChunkSizeBy=
tes=3D5000000"/><br /> --><br /> </defaultCache> =
<br />
+ </pre>
+ In the jahia/WEB-INF/classes/ehcache-hibernate.=
xml file, you must do the same. Be careful because there are two sections t=
o uncomment, the second one being at the end of the file : =
+ <pre class=3D"code"> <defaultCache<br /> =
maxElementsInMemory=3D"1000"<br /> eternal=
=3D"false"<br /> timeToIdleSeconds=3D"3600"<=
br /> timeToLiveSeconds=3D"14400"<br /> ove=
rflowToDisk=3D"false"<br /> maxElementsOnDisk=3D"=
1000000"<br /> diskPersistent=3D"false"<br /> =
diskExpiryThreadIntervalSeconds=3D"600"<br /> =
memoryStoreEvictionPolicy=3D"LRU"<br /> ><br /> <!-- =
Uncomment this to activate clustering<br /> <cacheEventListenerFa=
ctory =
+ class=3D"net.sf.ehcache.distribution.RMICacheReplicatorFacto=
ry"<br /> properties=3D"replicateAsynchronously=3Dtrue,<b=
r /> replicatePuts=3Dfalse,<br /> replicateUpdates=3Dtrue,<=
br /> replicateUpdatesViaCopy=3Dfalse,<br /> replicateRemov=
als=3Dtrue<br /> asynchronousReplicationIntervalMillis=3D5000"=
/><br /> <bootstrapCacheLoaderFactory<br /> class=3D&qu=
ot;net.sf.ehcache.distribution.RMIBootstrapCacheLoaderFactory"<br /> =
properties=3D"bootstrapAsynchronously=3Dtrue, maximumChunkSizeBy=
tes=3D5000000"/><br /> --><br /> </defaultCache><br=
/>
+ </pre>
+ and : =
+ <pre class=3D"code"><cache<br /> name=
=3D"org.hibernate.cache.UpdateTimestampsCache"<br /> maxEl=
ementsInMemory=3D"5000"<br /> eternal=3D"true"<b=
r /> overflowToDisk=3D"true"><br /> <!-- Uncommen=
t this to activate clustering<br /> <cacheEventListenerFactory =
+ class=3D"net.sf.ehcache.distribution.RMICacheReplicatorFacto=
ry"<br /> properties=3D"replicateAsynchronously=3Dtrue,<b=
r /> replicatePuts=3Dtrue,<br /> replicateUpdates=3Dtrue,<b=
r /> replicateUpdatesViaCopy=3Dtrue,<br /> replicateRemoval=
s=3Dtrue<br /> asynchronousReplicationIntervalMillis=3D5000"/&=
gt;<br /> <bootstrapCacheLoaderFactory<br /> class=3D"=
;net.sf.ehcache.distribution.RMIBootstrapCacheLoaderFactory"<br /> =
properties=3D"bootstrapAsynchronously=3Dtrue, maximumChunkSizeByte=
s=3D5000000"/><br /> --><br /> </cache><br /> =
=
+ </pre>
+ </li>
+ </ol>
If the clustering feature has been
activated, you should see the fol=
lowing line displayed four times with 4 different ports in
- the output console when starting each
jahia node :<br/>
+<br/>
<br/>
<p class=3D"code">GMS: address is
ip_address:port</p>
<p>where <i>ip_address</i> is the local IP address of the node, and <i=
>port</i> the port used to communicate
@@ -342,12 +353,14 @@
<Engine name=3D"Standalone" defaultHost=3D"localhost" jvmRoute=3D"jvm1"=
>
-->
</pre>
- where <i>jvm1</i> is the name of the worker as declared in the load-=
balancer.<br/>
- <br/><br/>
-
- </p>
- </p>
-
+ <p>where <i>jvm1</i> is the name of the worker as declared in the lo=
ad-balancer.</p>
+ <h2>Troubleshooting cluster configuration</h2>
+ <p>Most cluster configuration issues rise up from problems when usin=
g automatic UDP communication protocols, or multicast. For JGroups setup, t=
hey offer a <a href=3D"http://www.jgroups.org/javagroupsnew/docs/newuser/no=
de15.html">diagnosis setup</a>. You can also refer to their <a href=3D"http=
://www.jgroups.org/javagroupsnew/docs/newuser/index.html">documentation</a>=
for more information about how to setup JGroups.</p>
+ <p>Jahia offers the possibility to use TCP configuration instead of =
UDP for the JGroups communication. In order to change to the TCP configurat=
ion, you will have to comment the UDP configuration and uncomment the tcp o=
nes int the following files :<br />
+ jahia/WEB-INF/etc/spring/applicationcontext-dao.xml<br />
+ jahia/WEB-INF/etc/spring/applicationcontext-hibernate.xml,<br />
+ jahia/WEB-INF/etc/spring/applicationcontext-services.xml</p>
+ <p>The EHCache configuration must be modified also to use manual dis=
covery instead of automatic. Again the <a href=3D"http://ehcache.sourceforg=
e.net/EhcacheUserGuide.html#id.s20.2.2">documentation</a> is available on t=
he <a href=3D"http://ehcache.sourceforge.net/";>EHCache website</a>.</p>
</div>
<div class=3D"footer">
Copyright 2007, <a href=3D"http://www.jahia.org";>Jahia Ltd</a> - A=
ll rights reserved
_______________________________________________
cvs_list mailing list
[email protected]
http://lists.jahia.org/cgi-bin/mailman/listinfo/cvs_list
