Atoti Java

Compatible versions

This table lists the versions of Atoti Server compatible with each Atoti Limits version. If you are using a solution, please check the underlying version of Atoti Server to see if your version of the solution is compatible.

Overview

Atoti Limits utilizes Spring Auto-configuration to connect to an Atoti Server. We shall refer to this as the Connected Server.

The autoconfiguration resides in the limits-auto-config-* modules. These modules are responsible for bootstrapping the Connected Server with any services required by Atoti Limits and for sending a connection request to Atoti Limits with required information.

How it works

From a high-level view, the connection process works as follows:

1. Once Atoti Limits starts, it sits idle until it receives a connection request from the Connected Server.

2. When the Connected Server starts, it pings Atoti Limits to check if it is available to receive a connection request.

3. After both Atoti Limits and the Connected Server are started, the Connected Server will start some services and gather information to send a connection request to Atoti Limits.
   

   note

   the order in which the servers are started is irrelevant.

4. The connection request contains information about the Connected Server that Atoti Limits requires to connect.

5. Atoti Limits connects to the Connected Server and is now ready to manage limits.

6. During the lifetime of the application, Atoti Limits will manage all of the Connected Servers that it is connected to.

Steps

Follow these steps to integrate your Connected Server with Atoti Limits:

1. Import the Auto-configuration dependency

Import the limits-auto-config-* maven dependency into your project depending on which version of Atoti Server you are using:

<dependency>
  <groupId>com.activeviam.solutions.limits</groupId>
  <artifactId>limits-auto-config-{VERSION}</artifactId>
  <version>{ATOTI-LIMITS-MODULE-VERSION}</version>
</dependency>

The dependencies are as follows:

2. Configure the Auto-configuration properties

Configure the required auto-configuration properties in your application.yml file on your Connected Server. You do not need to configure any properties in Atoti Limits. The full properties are available in the Auto-configuration properties section.

3. Start your servers

The order of these steps does not matter.

Start the Limits server

Start the Limits server using the installation instructions. Limits will wait for a connection from the Atoti Server.

Start the Connected Server

Start the Connected Server as normal. This should trigger a connection request.

If your connection is unsuccessful you may enable debug logging for further investigation.