BD4NRG DAPB Deployment guide

Prerequisites and Installation

The hardware and operating system prerequisites are:

• A 2-core processor
• 4GB RAM Memory
• 50GB of disk space or more

The software prerequisites include:

• Centos 7 or Windows Server Operative System (OS);
• docker and docker-compose;

BD4NRG DAPB software and its components will be delivered utilizing the Docker containers functionalities. Firstly, the Docker platform has to be downloaded and installed accordingly to the OS of the server to host the deployment.

For Windows server

1. Install Docker from https://hub.docker.com/?overlay=onboarding (First you will need to create an account on the same page)
2. After the installation if Docker has not started automatically open start Menu, type Docker and select the Docker icon that appears.

Figure 1. Launching Docker (Windows Server)

3. Docker may take some time to start. When it has successfully started you should able to see the icon on the bottom right of your screen

Figure 2. Docker Successfully Started (Windows Server)

Troubleshooting:

• Docker in order to run requires specific support from the CPU but most recent PCs should support it.
• Hyper-V should be installed and enabled in windows and Virtualization should be enabled in your BIOS. Please also consult the following page https://docs.docker.com/docker-for-windows/troubleshoot/#virtualization/ .

For Linux server

1. Update the apt package index and install packages to allow apt to use a repository over HTTPS.

For 64-bit version of CentOS type:

$ sudo yum update

$ sudo yum install \
 apt-transport-https \
 ca-certificates \
 curl \
 gnupg-agent \
 software-properties-common

For 64-bit version of one of Ubuntu versions (Groovy 20.10, Focal 20.04 (LTS), Bionic 18.04 (LTS), Xenial 16.04 (LTS)) type:

$ sudo apt-get update

$ sudo apt-get install \
apt-transport-https \
ca-certificates \
curl \
gnupg-agent \
software-properties-common

2. Add Docker’s official GPG key

$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

3. Verify the key by searching for the last 8 characters of the fingerprint.

sudo apt-key fingerprint <last 8 characters of the fingerprint >

4. Install Docker. According to the Docker installation[^1] we should:

• Set up the Docker repository.

For 64-bit version of CentOS type:

$sudo yum install -y yum-utils
$sudo yum-config-manager \
  --add-repo \
  https://download.docker.com/linux/centos/docker-ce.repo

For 64-bit version of Ubuntu use the following command to set up the stable repository:

$ sudo add-apt-repository \
   "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) \
   stable"

• Install the latest version of Docker Engine and containerd.

For 64-bit version of CentOS type:

$sudo yum install docker-ce docker-ce-cli containerd.io

For 64-bit versions of Ubuntu type:

$ sudo apt-get install docker-ce docker-ce-cli containerd.io

• Start and enable docker by typing:

$sudo systemctl start docker
$sudo systemctl enable docker

• Verify that Docker Engine is installed correctly by running the hello-world image:

$ sudo docker run hello-world

This command downloads a test image and runs it in a container. When the container runs, it prints an informational message and exits

5. Install Docker compose. Docker Compose is a tool for defining and running multi-container Docker applications. With Compose, we use a YAML Ain't Markup Language (YAML) file to configure our application’s services. Then, with a single command, we create and start all the services from our configuration. According to the docker compose installation we should:

• Download the current stable release of Docker Compose, by typing:

$ curl -L "https://github.com/docker/compose/releases/download/1.28.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

• Apply executable permissions to the binary, by typing:

$sudo chmod +x /usr/local/bin/docker-compose

BD4NRG DAPB Containers Installation on Docker

To proceed with the installation of BD4NRG DAPB, the user must use the docker folder of this repository that contains all the necessary configuration.

1. The first step is to clone this repository https://github.com/european-dynamics-rnd/bd4nrg-dapb-files , by typing:

cd /opt/bd4nrg-dapb/
git clone https://github.com/european-dynamics-rnd/bd4nrg-dapb-files.git

2. There is the docker-compose.yml file located under /opt/bd4nrg-dapb/docker that contains all the configuration of the BD4NRG DAPB containers. Go to that file by typing the command

cd /opt/bd4nrg-dapb/docker

3. ⚠️ At this step you must request from us a file with ".env" name and put it on the same folder /opt/bd4nrg-dapb/docker. Email us on the helias.karagozidis@eurodyn.com to get the ".env" file.

4. After puting the ".env" file in position you can start the containers with the below commands

$docker-compose up –d
$docker-compose logs -f

5. BD4NRG DAPB was successfully deployed.