Cluster

Server cluster configuration. Clustering only applies to HTTP sessions, internal calls are never routed outside of the issuing node.

Clustering should be used in combination with sticky sessions to avoid issues cased by lagging cluster state synchronisation.

Clustering is not enabled by default.

NameDescriptionDefault

enabled

Flag to enable cluster

false

config_path

Path to cluster configuration file

"config/cluster.xml"

Cluster configuration

Clustering is provided by Hazelcast and is configured in a separate configuration file (by default: "config/cluster.xml").

In this file you can:

  • Change the port used for cluster communication

  • Add members

We recommend that cluster members are defined statically using their ip-address instead of using multicast.

<?xml version="1.0" encoding="UTF-8"?>
<hazelcast xmlns="http://www.hazelcast.com/schema/config"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://www.hazelcast.com/schema/config
           http://www.hazelcast.com/schema/config/hazelcast-config-4.2.xsd">
    <cluster-name>fortified</cluster-name>
    <network>
        <port auto-increment="false">5701</port>
        <join>
            <!-- static ip -->
            <multicast enabled="false"/>
            <tcp-ip enabled="true">
                <!-- cluster members -->
                <member>127.0.0.1</member>
            </tcp-ip>
            <!-- multicast -->
            <!--
            <multicast enabled="true">
                <multicast-group>224.2.2.3</multicast-group>
                <multicast-port>54327</multicast-port>
            </multicast>
            <tcp-ip enabled="false"/>
            -->
        </join>
    </network>
</hazelcast>

More information

https://vertx.io/docs/vertx-hazelcast/java/

Last updated