For illustration purposes, we assume that the RTBS cluster should contain of three machines: machine1, machine2, and machine 3.

Configure the following parameters on your MashZone NextGen Event Service (RTBS) nodes.

Edit the rtbs.properties file and set rtbs.id, rtbs.zookeeper.urls, and rtbs.replication.factor as described below.

The rtbs.properties file is located in the <MashZone NextGen installation> /rtbs/conf/ directory

Replace the host names machine1, machine2, and machine3 by your real servers' host names and also set the right ports. You must enumerate all RTBS cluster members.

<number> in replication factor determines how many replicas of persisted data (for high availability) should exist. The number must be >= 1 and <= the number of RTBS instances in the cluster. The number must be >= 2 to achieve any fault tolerance. As a rule of thumb: the higher the number of replicas the more RTBS node failures can be tolerated. However, the amount of storage required on the RTBS machines increases linearly with the number of replicas.

Edit the zookeeper.properties file and add the parameters described below.

The zookeeper.properties file is located in the <MashZone NextGen installation> /rtbs/zookeeper/conf/ directory

Add the parameters:

The initLimit parameter is the time in seconds Zookeeper waits for other nodes to join the cluster (Zookeeper Ensemble). If the cluster initializations fails (especially relevant if nodes are not started in an automated and coordinated way), increase the value, for example, to 60.

For each RTBS server in the cluster, add a line as follows:

Here, <number> is a strictly monotonic increasing number starting at 1. It is not necessarily equivalent to rtbs.id, that is, if you decide to use rtbs.id=42 for machine1, the entry would still be server.1=machine1:2888:3888

For our example, this means that we need to add the following three lines:

Create the file <MashZone NextGen installation> /rtbs/zookeeper/data/myid.

Add the machine's rtbs.id to the file, that is, just the digit 1 for machine 1, digit 2 on machine 2, digit 3 for machine 3.

Edit the file server.properties and adjust broker.id to the machine's RTBS id.

The server.properties file is located in the <MashZone NextGen installation>/rtbs/ha-store/conf/ directory.

Configure the following parameters on your MashZone NextGen nodes.

Edit the mashzone.rtbs.url parameter in the mashzone.properties file and set host name and port accordingly.

Replace the host names machine1, machine2, and machine3 by your real servers' host names and also set the right ports. You must enumerate all RTBS cluster members.

Optionally, if MashZone NextGen and RTBS are co-located on the same machine (for example, machine i hosts both MashZone NextGen instance i and RTBS Instance i), you can add the parameter mashzone.rtbs.id=i to make the MashZone NextGen instance prefer RTBS instance i. If the preferred RTBS instance does not exist or is unavailable, MashZone NextGen will automatically choose another RTBS instance.