mromy 2005/11/02 17:44:55 CET
Modified files:
core/src/webapp/html/startup howto_cluster.html
Log:
- updated HowTo cluster for Jahia 5.0
Revision Changes Path
1.4 +39 -3 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.3&r2=1.4&f=h
Index: howto_cluster.html
===================================================================
RCS file: /cvs/jahia/core/src/webapp/html/startup/howto_cluster.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- howto_cluster.html 25 Oct 2005 09:50:27 -0000 1.3
+++ howto_cluster.html 2 Nov 2005 16:44:55 -0000 1.4
@@ -133,8 +133,44 @@
<br/><br/>
</p>
<p>
- <h2>II - To activate the clustering
feature</h2>
+ <h2>II - To setup and activate the
clustering feature</h2>
+ This howto describe the procedure when
2 Jahia nodes are setup in cluster; if more nodes are used, follow the same
+ procedure for all nodes.<br/>
<ol>
+ <li>Install the first instance
as for a stand-alone configuration.<br/>
+ During the
configuration wizard, select "in base content storing" if you prefer to store
all
+ data in the
database. After configuration wizard is completed and installaton successful,
shutdown this instance of
+ Jahia.</li><br/>
+ <li>Delete all the tables
created during the installation of the first instance of Jahia. Depending on
the database
+ used and if more
convenient, you may drop the database used and re-create an empty database with
the same name. When
+ doing this, make
sure that the database login used during the installation of the first instance
has the same rights to the
+ newly created
database.</li><br/>
+ <li>Install the second
instance as for a stand-alone configuration, using the SAME database as for the
first
+ instance. If you
chosed "in base content storage" during the installation of the first instance,
select it also for this
+ instance.<br/>If you
are installing this second instance on the same server as the first, you will
need to change the port used
+ by tomcat as well as
the shutdown port. This should be changed in the <i>tomcat/conf/server.xml</i>
file.<br/>
+ After configuration
wizard is completed and installaton successful, shutdown this second instance of
+ Jahia.</li><br/>
+ <li>If you have not selected
in base content storage, you will need to have the directories containing the
large text files and
+ the files uploaded
through Jahia on a shared disk space. At least the following directories will
need to be shared amongst
+ all Jahia instances:
<br/>
+ <br/>
+
<i>jahia/WEB-INF/var/content/bigtext/</i><br/>
+
<i>jahia/WEB-INF/var/content/slide/</i><br/>
+ <br/>
+ You should either
create some kind of aliases from one instance to the others, or you can move
these 2 directories to another server
+ or a SAN and modify
the <i>jahia.properties</i> file to replace<br/><br/>
+
<i>jahia/WEB-INF/var/content/bigtext/</i><br/>
+
<i>jahia/WEB-INF/var/content/slide/</i><br/>
+ <br/>by something
like<br/><br/>
+
<i>//server_storage_address/partition/content/bigtext/</i><br/>
+
<i>//server_storage_address/partition/content/slide/</i><br/><br/>
+ or by<br/><br/>
+
<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/><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>
<p>with the line </p>
@@ -149,7 +185,7 @@
<bean id="ClusterNodeSettings"
class="org.springframework.beans.factory.config.PropertiesFactoryBean">
<property name="properties">
<props>
- <prop key="serverId"><span
class="red">jahiaServer</span></prop>
+ <prop key="serverId"><span
class="red">jahiaServer1</span></prop>
</props>
</property>
</bean>
@@ -179,7 +215,7 @@
</ol>
If the clustering feature has been
activated, you should see the following line displayed twice with 2 different
ports in
the output console when starting each
jahia node :<br/><br/>
- <p class="code">GMS:
ip_address:port</p>
+ <p class="code">GMS: address is
ip_address:port</p>
where <i>ip_address</i> is the local
IP address of the node, and <i>port</i> the port used to communicate
with other Jahia nodes.
</p><br/><br/><br/><br/>
