Comment on page
Troubleshoot Docker installation issues
This section describes some of the most common issues found during the Akamas installation.
Notice: this distro features a known issue since Docker default execution group is named
dockerroot
instead of docker
. To make docker work edit (or create) /etc/docker/daemon.json
to include the following fragment:{
"group": "dockerroot"
}
After editing or creating the file, please restart Docker and then check the group permission of the Docker socket (
/var/run/docker.sock
), which should show dockerroot
as a group:srw-rw----. 1 root dockerroot 0 Jul 4 09:57 /var/run/docker.sock
Then, add the newly created
akamas
user to the dockerroot
group so that it can run docker containers:sudo usermod -aG dockerroot <user_name>
and check the
akamas
user has been correctly added to dockerroot
group by running:lid -g dockerroot
In case of issues in logging in through AWS CLI, when executing the following command:
aws ecr get-login-password --region us-east-2
Please check that:
- Environment variables
AWS_ACCESS_KEY_ID
,AWS_SECRET_ACCESS_KEY
,AWS_DEFAULT_REGION
are correctly set - AWS CLI version is 2.0+
Please notice that the very first time Akamas is started, up to 30 minutes might be required to initialize the environment.
In case the issue persists you can run the following command to identify which service is not able to start up correctly
akamas status -d
In some systems, the Docker socket, usually located in
/var/run/docker.sock
can not be accessed within a container. This causes Akamas to signal this behavior by reporting the Access Denied error in the license service logs.To overcome this limitation edit the
docker-compose.yaml
file adding the line privileged: true
to the following services:- License
- Optimizer
- Telemetry
- Airflow
The following is a sample configuration where this change is applied to the license service:
license:
image: 485790562880.dkr.ecr.us-east-2.amazonaws.com/akamas/license_service:2.3.0
container_name: license
privileged: true
Finally, you can issue the following command to apply these changes
docker compose up -d
When installing Akamas it’s mandatory to provide the AKAMAS_CUSTOMER variable as illustrated in the installation guide. This variable must match the one provided by Akamas representatives when issuing a license. If the variable is not properly exported license installation will fail with an error message indicating that the name of the customer installation does not match the one provided in the license.
You can easily inspect which value of this variable has been used when starting Akamas by running the following command on the Akamas server:
docker inspect license | grep AKAMAS_CUSTOMER
If you find out that the value is not the one you expect, you can update the
.env
file and then start again the license service by running:docker compose up -d license
Once Akamas is up and running you can re-install your license.
Last modified 2mo ago