PLEASE NOTE -- Clustering Plugin Users:
Starting with Openfire 3.8.0, this Coherence-based clustering plugin
has been deprecated in favor of the new Hazelcast-based plugin (/plugins/hazelcast).
Refer to the Hazelcast plugin documentation or
this community post
for additional information.
This plugin has been updated and is expected to be compatible with Openfire 3.8.x. However,
please be advised that no functional testing has been performed on the latest version.
This plugin is no longer actively maintained.
The clustering plugin adds support for running multiple redundant Openfire servers together in a cluster. By running Openfire in a cluster, you can distribute the connection load among several servers, as well as having some form of failover in the event that one of your servers dies. This plugin requires a valid Oracle Coherence license.
In order to run Oracle Coherence in production mode, you will need to secure licensing for (at least) the Enterprise Edition (EE) of Coherence. Refer to the Oracle Fusion licensing docs for more information. Openfire uses the Compute Grid InvocationService to distribute tasks among the cluster members, but this feature is currently available only in EE or Grid Edition (GE).
Note that Coherence is configured to run as GE in development mode by default. You can change this setting by overriding the following Java system properties via /etc/sysconfig/openfire (RPM) or openfired.vmoptions (Windows):
-Dtangosol.coherence.edition=EE -Dtangosol.coherence.mode=prod
The current Coherence release is version 3.7.1.
After installing the clustering plugin (by copying clustering.jar into the Openfire plugins directory), follow steps 1 through 4 for adding Oracle Coherence libraries to Openfire. Step 5 explains how to add this plugin to your Openfire setup.
To upgrade from Enterprise, you will need to shut down your server, remove the enterprise.jar file and enterprise directory from the plugins directory in your Openfire install root, and then follow the steps outlined in the Installation section above.
To enable clustering or monitor the cluster go to: Server --> Server Manager --> Clustering
You can change a number of Coherence properties by overriding Java system properties via /etc/sysconfig/openfire (RPM) or openfired.vmoptions (Windows). For example, to change the default cluster multicast port number, use the following:
-Dtangosol.coherence.clusterport=32380
Other such settings may be found in the tangosol-coherence.xml file located in the coherence.jar file, identified via the "system-property" attribute.
If you want to modify or maintain this plugin you will need to get its source code and compile it. Source code of this plugin is now available in the list of plugins that you get when you download the Openfire's source code. Follow these steps to have a working environment: