Clustering

Version 15.1 by Thomas Mortagne on 2021/09/27

XWiki provides an easy way to setup clustered instances of XWiki based on network events distribution.

Features

  • events synchronization between XWiki instances
  • multiple clustering channels
  • possibility to start/stop the clustering channel at runtime

Setup

Use a remote Solr instance

XWiki store a lot of information in Solr cores so like with the database you will need to make sure that all cluster members use the same Solr instance remotely instead of each having its own embedded instance.

See https://extensions.xwiki.org/xwiki/bin/view/Extension/Solr%20Search%20API#HSetuparemoteSolrserver for more details about the remote solr setup.

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.

See JGroups documentation for more details on how to setup JGroups configuration files.

If you have IPv6 on your server, you are also advised to read this IPv6 article. 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 the Remote Observation Module for more details.

Limitations

The following limitations currently exist when you use clustering:

  • XWIKI-6235: The Scheduler feature is not cluster-aware and thus each node of XWiki runs its own scheduler and thus the same scheduler jobs will execute on all nodes. The workaround is to disable the Scheduler plugin on all nodes except on one. Note that this creates a SPOF
  • Attachments and deleted documents located on the file system (located inside the Permanent Directory) are currently not clustered and in order for all XWiki instance to access and display them properly in the UI, you'll need to set up shared filesystem and share the store/file directory. Note that you must not share the whole Permanent Directory or this will lead to problems (such as causing file contentions when several instances try to read/write to some of them which have locks on).
  • XWIKI-11441 If a node is down and events happen, these events won't be propagated to the node when it comes back up. For example, imagine you install an extension on a node of the cluster while another node is down. When that node is restarted, the extension won't be installed on it.

Performances

More

See the Remote Observation Module for more details of the event distribution features and extension capabilities.

Follow the test clustering tutorial for a complete tutorial on how to setup a simple cluster between two instances of XWiki on the same server.

Tags:
   

Get Connected