Docker compose

If you plan to upgrade your Akamas instance, please verify the upgrade path with the Akamas support team. To ensure rollback in case of upgrade failure, it is recommended to back up your studies (see the section User data backup).

Before proceeding with the upgrade, check theMigration procedures section to verify whether your current upgrade requires any custom steps.

Docker compose Configuration

To start with the upgrade, on the Akamas server navigate to the same folder where the docker-compose.yml and .env files are stored (see section Get Akamas Docker artifacts). Now you can download the latest version compose file:

mv docker-compose.yml docker-compose.yml.bak
curl -O https://s3.us-east-2.amazonaws.com/akamas/compose/3.7.0/docker-compose.yml

You can point to a specific version. As an example, to download the artifact for version 3.7.0:

curl -O https://s3.us-east-2.amazonaws.com/akamas/compose/3.7.0/docker-compose.yml

If the old docker-compose has been changed, and it is still needed in the newer Akamas version, make sure to migrate such changes from docker-compose.yml.bak to the docker-compose.yml .

Ensure your .env file is up to date with the required variables, by comparing your version with the one at Configure Akamas environment variables.

Then log in to AWS with the following command:

aws ecr get-login-password --region us-east-2 | docker login --username AWS --password-stdin 485790562880.dkr.ecr.us-east-2.amazonaws.com

If the login succeeds, then you can start the upgrade by running:

docker compose up -d

Wait for a few minutes and check if the Akamas services are running the command:

akamas status

The expected output should be like the following (repeat the command after a minute or two if the last line is not "OK" as expected):

Checking Akamas services on http://localhost:8000
service       status
=========================
analyzer      UP
campaign      UP
metrics       UP
optimizer     UP
orchestrator  UP
system        UP
telemetry     UP
license       UP
log           UP
users         UP
OK