Advanced: JGroups Cluster Configuration

Overview

By default Orbit leverages JGroups and Infinispan to cluster servers together. The default Orbit configuration uses UDP Multicast based on the cluster name but can be customized where required.

Configuring JGroups

Cloud providers (such as AWS) often do not provide UDP multicast support. In these scenarios TCPPing is one possible alternative if the server addresses (IP or hostname) are known ahead of time, see example below.

Stage.Builder builder = new Stage.Builder();
JGroupsClusterPeer clusterPeer = new JGroupsClusterPeer();
clusterPeer.setJgroupsConfig("classpath:/conf/jgroups-ec2.xml");
builder.clusterPeer(clusterPeer);

When using Maven the default config can be found here: src/main/resources/conf/udp-jgroups.xml