XWiki provides an easy way to setup clustered instances of XWiki based on network events distribution.
- events synchronization between XWiki instances
- multiple clustering channels
- possibility to start/stop the clustering channel at runtime
Enable event distribution
To enable event distribution in an XWiki instance go to xwiki.properties file and set the property observation.remote.enabled to true.
Setup communication channels
Then you need to create a JGroups configuration file for each different cluster group you want to setup.
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.
Seefor more details on how to setup JGroups configuration files.
If you have IPv6 on your server, you are also advised to read. 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.
Start communication channels
The name of the xml file matches the identifier of the channel.
To indicate which channels to start when XWiki starts list them in the property observation.remote.channels of the xwiki.properties file.
Choose network adaptor implementation to use
By default only JGroups implementation is provided, but it's possible to add more. See thefor more details.
See thefor more details of the event distribution features and extension capabilities.
Follow thefor a complete tutorial on how to setup a simple cluster between two instances of XWiki on the same server.