Prerequisites

Software and hardware requirements

ADCM is a software that is distributed in the form of a Docker Image. To install it, you need:

  • A maintained version of the CentOS 7/RHEL 7/Alt Linux SP 8/Astra Linux SE 1.7 Orel operating system. Archived versions are not supported or tested.

  • A user account with sudo privileges.

  • An access to the official repository of CentOS Extras and CentOS Base. This repository is enabled by default, but if you have disabled it — you need to re-enable it (e.g. via editing the repository configuration file in the /etc/yum.repos.d/ directory).

  • The software package installer YUM/APT.

  • The hardware that meets the following conditions.

    IMPORTANT

    The following system requirements are minimal. The target sizing should be calculated based on the customer requirements.

    • CPU: 4 CPU cores;

    • RAM: 16 GB;

    • HDD: 50 GB.

Also before starting the installation, you need to edit the /etc/sudoers file so that the user who deploys ADCM will have the necessary rights afterwards. To do this, run the command:

$ sudo vi /etc/sudoers

In this file you need to remove the # character at the beginning of the line WHEEL_USERS ALL=(ALL) ALL. To save this change and return to the terminal, press Esc, then type :wq, or :wq!.

Install Docker

CAUTION

Do not install Docker from the official Docker site. Instead of it, use the official repositories of your Linux distribution. The repositories provided by operating system developers tend to be more stable and secure.

Depending on the operating system and package manager you use, the installation sequence includes the following steps.

  • YUM

  • APT

  1. Using root privileges, update all packages that are currently installed in your system:

    $ sudo yum update -y
  2. Install the packages required for Docker installation and using:

    $ sudo yum install -y yum-utils docker device-mapper-persistent-data lvm2
  3. Start Docker:

    $ sudo systemctl start docker
  4. Enable Docker as a system service:

    $ sudo systemctl enable docker
  1. Using root privileges, update all packages that are currently installed in your system:

    $ sudo apt-get update
    $ sudo apt-get dist-upgrade
  2. Install the packages required for Docker installation and using:

    $ sudo apt-get install docker-engine
  3. Start Docker:

    $ sudo systemctl start docker
  4. Enable Docker as a system service:

    $ sudo systemctl enable docker

Disable SELinux (optionally)

To disable SELinux permanently, set SELINUX=disabled in the /etc/selinux/config file and reboot your system.

You can edit the file via the vi or vim command:

$ sudo vi /etc/selinux/config

The content of the changed file should look like this:

# This file controls the state of SELinux on the system.
# SELINUX= can take one of these three values:
#       enforcing - SELinux security policy is enforced.
#       permissive - SELinux prints warnings instead of enforcing.
#       disabled - SELinux is fully disabled.
SELINUX=disabled
# SELINUXTYPE= type of policy in use. Possible values are:
#       targeted - Only targeted network daemons are protected.
#       strict - Full SELinux protection.
SELINUXTYPE=targeted

You can also disable SELinux temporarily via the following command:

$ sudo setenforce 0

Still, it is strongly recommended to disable SELinux permanently, so that it does not restart on each system reboot.

CAUTION

Do not forget to reboot your host after SELinux is disabled.

Stop firewall

If you use the firewalld service, stop it before installing ADCM. You can use this command:

$ sudo systemctl stop firewalld

As an alternative, you can disable the firewalld service, so that it will not apply rules to network packets:

$ sudo systemctl disable firewalld

Allow access to the Docker CLI without root privileges

If in the future you want to access the Docker CLI without using root privileges, you should create a docker user group (if it does not exist) and add the current user to this group with the certain rights:

$ sudo groupadd docker
$ sudo usermod -a -G docker $USER

After running these commands, you should re-login under the current user.

Found a mistake? Seleсt text and press Ctrl+Enter to report it