<
From version < 1.18 >
edited by Sorin Burjan
on 2010/12/21
To version < 1.20 >
edited by Sorin Burjan
on 2010/12/21
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -195,8 +195,50 @@
195 195  
196 196  Find more details about the template creation and administration on the [[documentation page>>extensions:Extension.Administration Application#HEasyTemplatesCreationandAdministration28StartingwithXWikiEnterprise2.4M229]].
197 197  
198 -== Easier development of configurable applications using [[XWiki.ConfigurableClass>>extensions:Extension.Administration Application#HMaking20your20application20easily20configurable20with203Ctt3EConfigurableClass3C2Ftt3E20Since2023M1]] ==
199 199  
199 +== 7.Clustering ==
200 +XWiki provides an easy way to setup clustered instances of XWiki based on network events distribution.
201 +
202 +=== Features ===
203 +
204 +* events synchronization between XWiki instances
205 +* multiple clustering channels
206 +* possibility to start stop clustering channel at runtime
207 +
208 +=== Setup ===
209 +
210 +==== Enable event distribution ====
211 +
212 +To enable event distribution in an XWiki instance go to ##xwiki.properties## file and set the property ##observation.remote.enabled## to ##true##.
213 +
214 +==== Setup communication channels ====
215 +
216 +Then you need to create a JGroups configuration file for each different cluster group you want to setup.
217 +
218 +For this go to the ##/WEB-INF/observation/remote/jgroups## folder and add one xml file by clustering group. Generally there is only one for a simple cluster.
219 +
220 +You can look at http://www.jboss.org/community/wiki/JGroups for a good documentation on how to setup JGroups configuration files.
221 +
222 +If you have IPv6 on your server, you are also advised to read http://community.jboss.org/wiki/IPv6. Defining -Djava.net.preferIPv4Stack=true when launching the JVM is probably your best bet in most cases. If your really want to use IPv6 for your channels, you should probably upgrade JGroup to version 2.10.0.GA and use a JVM 6 at least.
223 +
224 +==== Start communication channels ====
225 +
226 +The name of the xml file matches the identifier of the channel.
227 +
228 +To indicate which channels to start when XWiki starts list the in the property ##observation.remote.channels## of the file ##xwiki.properties##.
229 +
230 +==== Choose network adaptor implementation to use ====
231 +
232 +By default only jgroups implementation is provided, but it's possible to add more. See the [[Remote Observation Module>>extensions:Extension.Observation Module Remote#HAddcustomnetworkadaptor]] for more details.
233 +
234 +=== More ===
235 +
236 +See the [[Remote Observation Module>>extensions:Extension.Observation Module Remote]] for more details of the event distribution features and extension capabilities.
237 +
238 +Follow [[Test clustering tutorial>>AdminGuide.DistributedEventClusterSetup]] for a complete tutorial on how to setup a simple cluster between two instances of XWiki on the same server.
239 +
240 +== 8.Easier development of configurable applications using [[XWiki.ConfigurableClass>>extensions:Extension.Administration Application#HMaking20your20application20easily20configurable20with203Ctt3EConfigurableClass3C2Ftt3E20Since2023M1]] ==
241 +
200 200  If you are developing an application and you need to provide your users with a way to configure it from the [[Administration Application>>extensions:Extension.Administration Application]] you are in luck. All you need to do is create a custom class holding all of the configuration for your application, then add an object of your custom configuration class and an object of ##XWiki.Configurable## class. You will be able to configure your application from the administration interface.
201 201  The following is an image of the administration interface with additional applications to be configured (you can customize the icon used).
202 202  
... ... @@ -203,3 +203,4 @@
203 203  [[image:ReleaseNotes.ReleaseNotesXWikiEnterprise23M1@AdministrationPanelExtraIcons.png||style="border: 1px solid black;" width="550px;"]]
204 204  
205 205  Note the current user does not have permission to edit one of the configurable applications.
248 +

Get Connected