Reading time: 20 minutes

0. Please make sure your system matches the prerequisites.

Please go through Installation Prerequisites before performing the installation.

1. Install Management Software

Update yum installer

sudo yum -y update

Install vim to be able to change configuration files.

sudo yum -y install vim

Install postgresql client to be able to work with database tables if necessary.

sudo yum -y install postgresql

2. Disable SELINUX

Open /etc/sysconfig/selinux file for edit.

sudo vim /etc/sysconfig/selinux

set: SELINUX=disabled

To edit file in VIM press "a", to stop edditing press "esc". To save file finish edditing by pressing "ESC", write ":wq" and hit "ENTER".

Reboot server

sudo reboot now

Check the status of SELINUX

sestatus

3. Install Docker

Please follow the official Docker documentation (based on your host systems these may differ):

Below you can find steps for the Officialy supported CentOS system (https://docs.docker.com/install/linux/docker-ce/centos/).

The centos-extras repository must be enabled. This repository is enabled by default, but if you have disabled it, you need to re-enable it. Check that it is enabled by running:

sudo yum repolist enabled

Make sure the Centos Extras is in the result:

Add following packages: yum-utils, device-mapper-persistent-data, lvm2

sudo yum install -y yum-utils device-mapper-persistent-data lvm2

Add the official Docker repository.

sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

Install Docker-CE verison

sudo yum install -y docker-ce

Enable Docker at server start-up

sudo systemctl enable docker

Reboot

sudo reboot

4. Configure Docker logging

To limit amount of storage that Docker log file can occupy, we need to modify Docker settings.

Open Docker logging setting file by following command. Don't worry if file is empty or does not exist.

sudo vim /etc/docker/daemon.json

Modify the content to fit your requirements. We recommend following content:

To edit file in VIM press "a", to stop edditing press "esc". To save file finish edditing by pressing "ESC", write ":wq" and hit "ENTER".

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "200m",
    "max-file": "3"
  }
}

5. Install Docker Compose

sudo curl -L https://github.com/docker/compose/releases/download/1.23.2/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose

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

sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

Add your current user to docker group so your user can work with docker containers:

sudo usermod -aG docker ${USER}

6. Make Necessary Configurations

Datastorage modul requires setting vm.max_map_count=262144.

sudo sysctl -w vm.max_map_count=262144

7. Download Cogniware GDPR Explorer Images and docker-compose

We suggest creating a separate directory for the images and for the docker-compose.yml file.

mkdir ~/GDPRExplorer && mkdir ~/GDPRExplorer/Images

Download the docker-compose file.

curl -L -o ~/GDPRExplorer URL_DELIVERED_FROM_COGNIWARE

Download the images.tar files.

curl -L -o ~/GDPRExplorer/Images/GDPR_Explorer.tar URL_DELIVERED_FROM_COGNIWARE

Optionally you can download them to your client and upload them with WINSCP or SSH SCP.

8. Load Docker Images

sudo docker load -i ~/GDPRExplorer/Images/GDPR_Explorer.tar

You will see the individual images being loaded.

After the command finishes, check that all images have been loaded.

sudo docker images

9. Customize Docker Compose .yml file

Please be sure to follow information in the comments inside the file when doing customizations.

10. Start GDPR Explorer for the first time

You need to be at the directory where docker-compose.yml is located.

cd ~/GDPRExplorer/

Execute:

sudo docker-compose up -d

Check that all services are UP.

sudo docker-compose ps

Wait for all containers to finish their starting procedure (wait for CPU load to drop below 1%)

sudo docker stats

Get me there:

Installation