Instance configuration

The instance configuration supports five different configuration types:

The following table gives an overview of the supported configuration types, their location, and which configuration aspects they cover.

Configuration type

Configuration instance

Location

Description

General Properties

Event Service Core Properties

<EventService_ROOT>/conf/rtbs.properties

EDA Configuration

  • EventTypeStore location (com.softwareag.event.routing. eventtypestore.location)

General Properties

HA-Store

<EventService_ROOT>/ha-store/conf/server.properties

Persistence settings for high availability

  • Retention time (log.retention.hours, time in hours before buffered data becomes eligible for deletion). Defaults to 168 hours (7 days)
  • Retention size (log.retention.bytes, maximum size of buffered data, per buffer). Defaults to infinity, i.e., the size is only bound by retention time)

It is not recommended making other changes to the configuration file. Especially broker.id should only be changed using the Other configuration type (cluster configuration, see below). Port settings should be changed using the ports configuration type (see below).

General Properties

Zookeeper

 

Apache Zookeeper configuration. It is not recommended making any manual changes to the file. All relevant aspects can be configured using the configuration types listed in this table.

Keystores

 

<EventService_ROOT>/conf/rtbs.properties

Keystore location, alias, type, location, password

Other

 

 

Cluster configuration:

  • Replication Factor: determines how many replicas of persisted data (for high availability) will be created. The number must be >= 1 and <= the number of Event Service 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 Event Service node failures can be tolerated. However, the amount of storage required on the Event Service machines increases linearly with the number of replicas.

Note: The replication factor setting only affects buffers that are created after the replication factor was changed, that is, changing the replication factor does not affect existing buffers.

  • Zookeeper-URLs
  • Format: hostname:port, for example, machine1.mycompany.com: 12181
  • To form a cluster, Zookeeper URLs must contain a comma-separated list of all machines that should be part of the cluster. To form a cluster of the machines machine1, machine2, and machine3, enter: machine1: 12181,machine2:12181, machine3:12181
  • Instance ID
  • The instance ID must be a number between 1 and 255 and must be unique among all cluster members. It is used to identify cluster members. The ID is internally used to configure Event Service Core's rtbs.id, Zookeeper's ID (myid), and HA-Store's broker.id.

Ports

 

 

Port configuration for Event Service (non-TLS/TLS), Zookeeper, HA-Store

Truststores

 

<EventService_ROOT>/conf/rtbs.properties

Truststore location, alias, type, location, password, and period. The truststore is required to validate (JWT) tokens that MashZone NextGenMashZone NextGen uses to authenticate against MashZone NextGen Event Service. Make sure to use a truststore that contains a public key matching the private key used in MashZone NextGen (see section Protect MashZone NextGen Event Service access).

<EventService_ROOT> usually is <INSTALL_ROOT>/MashZoneNG/rtbs