Skip to main content

​
Use the Atoti Starter

In a Spring application, the different components used in distribution like the messenger will be automatically created by Atoti starter for Spring Boot com.activeviam.springboot:atoti-server-starter. Import this dependency in your project to perform this injection.
In the context of tests, Atoti comes with the class com.activeviam.atoti.server.test.api.DistributionTestHelper handling this setup. See the specific section for details about its setup and usage.

​
Configure your application

The first step to define an application is to define a database. This is done like in a non-distributed application (see Database Overview) The second step is to define the data nodes and the query nodes. Here as an example of a data node definition:
The cluster can define its messenger with a protocol path or simply call the withLocalMessenger or the withNettyMessenger methods. This is the moment to conceal the hierarchies, the branches or the measures (from Atoti Server 6.2.3) if it applies here (see Recommendations and Concealed measures) And of a query node definition:
The query node will see all the data nodes belonging to the applications listed in its configurations. Once the nodes have been defined, they should be added to a manager:
The last step is to put the database and the manager together in an application:

​
Join/Leave a cluster

It is possible to join and leave the cluster programmatically like this:
If a data node leaves the cluster before sending all the expected query results to a query node, a ServiceUnavailableException is thrown.