Install Akamas dependencies

This page will guide you through the installation of software components that are required to get the Akamas Server installed on a machine. Please read the Akamas dependencies for a detailed list of these software components for each specific OS.

While some links to official documentation and installation resources are provided here, please make sure to refer to your internal system engineering department to ensure that your company deployment processes and best practices are correctly matched.

Dependencies Setup

As a preliminary step before installing any dependency, it is strongly suggested to create a user named akamas on your machine hosting Akamas Server.

Ubuntu

References:

• Docker installation guide: https://docs.docker.com/engine/install/ubuntu/

• Docker-Compose installation guide: https://docs.docker.com/compose/install/

• AWS CLI v2: https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2-linux.html#cliv2-linux-install

It is recommended to add the akamas user to the docker group and to configure docker to start on boot: https://docs.docker.com/engine/install/linux-postinstall/

CentOS or RHEL 7

References:

• Docker installation guide: https://docs.docker.com/engine/install/centos/

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 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

References:

• Docker-compose installation guide: https://docs.docker.com/compose/install/

• AWS CLI v2: https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2-linux.html#cliv2-linux-install

• for further post-installation operations: https://docs.docker.com/engine/install/linux-postinstall/

Verify dependencies

As a quick check to verify that all dependencies have been correctly installed, please issue the following commands:

• Docker:

  docker run hello-world

• Docker-compose:

  docker-compose --version

• AWS CLI:

  aws --version