Установка ADCM
===============

.. important:: Полная документация по продукту **Arenadata Cluster Manager** (**ADCM**) приведена по `ссылке <https://docs.arenadata.io/adcm/index.html>`_.

Предварительные шаги
---------------------

**ADCM** -- это программное обеспечение, распространяемое в форме Docker-образа. Поэтому для **ADCM** должен быть установлен Docker-пакет в системе, для этого требуется поддерживаемая версия **CentOS 7** (архивные версии не поддерживаются и не тестируются).

Хранилище *centos-extras* должно быть включено. Драйвер хранилища должен быть *overlay2*. **SELinux** должен быть отключен.

Установка Docker
^^^^^^^^^^^^^^^^^

Docker можно установить различными способами в зависимости от потребностей. Большинство пользователей настраивают Docker через репозитории, чтобы облегчить задачу установки и обновления -- это рекомендуемый подход. Для этого перед первой установкой Docker на новой хост-машине необходимо настроить Docker-репозиторий, после чего можно установить и обновить Docker из репозитория.

Некоторые пользователи устанавливают Docker вручную через RPM-пакет, но при этом и управляют обновлениями вручную. Это полезно, когда установка производится без доступа к интернету.

В средах тестирования и разработки некоторые пользователи предпочитают использовать автоматизированные скрипты для установки Docker.

Пакет *Yum-utils* предоставляет утилиты **yum-config-manager**, **device-mapper-persistent-data** и **lvm2**, необходимые для драйвера *devicemapper storage*:

::

 sudo yum install -y yum-utils docker device-mapper-persistent-data lvm2
 
Запуск Docker:

::

 sudo systemctl start docker

Чтобы включить Docker как системный сервис, необходимо:

::

 sudo systemctl enable docker

Отключение Selinux
^^^^^^^^^^^^^^^^^^^^

**SELinux** должен быть отключен для **ADCM**. Чтобы временно отключить его, необходимо выполнить следующую команду на каждом хосте в кластере:

::

 setenforce 0


Настоятельно рекомендуется окончательно отключить **SELinux**, чтобы он не перезагружался при перезагрузке системы. Для этого:

::

 vi /etc/selinux/config
 
 # 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


Инсталляция ADCM
-----------------

Для инсталляции **ADCM** необходимо выполнить команду:

::

 docker pull arenadata/adcm:latest


Затем необходимо создать container base на этом изображении. **ADCM** имеет обязательную постоянную информацию, которая хранится в */adcm/data dir* внутри контейнера. Это означает, что необходимо сопоставить том с данным dir и обеспечить резервное копирование этого тома:

::

 docker create --name adcm -p 8000:8000 -v /opt/adcm:/adcm/data arenadata/adcm:latest

В приведенной команде создается контейнер с **ADCM** на порту *8000*, и все данные будут храниться на хост-машине в каталоге */opt/adcm/*.


Start and Stop
---------------

**ADCM** -- это просто контейнер, управляемый Docker. Таким образом, для запуска и остановки **ADCM** используются простые Docker-команды.

Запуск:

::

 docker start adcm
 
После запуска вход в WebUI осуществляется через браузер с помощью URL *http://<ip_adress_of_server>:8000*.
 
Остановка:

::
 
 docker stop adcm


Быстрый старт
--------------

По умолчанию **ADCM** запускается на порту *8000*, поэтому просто необходимо знать ip-адрес сервера с установленным **ADCM**, чтобы начать его использовать.

Следует открыть браузер и перейти по адресу *http://<ip_of_your_server>:8000*, задав пользователя по умолчанию -- *admin*, и пароль -- *admin* (:numref:`Рис.%s.<login>`).

.. _login:

.. figure:: imgs/login.png
   :align: center

   Авторизация

Для продолжения предлагается рассмотреть возможность загрузки некоторых пакетов инфраструктуры на *store.arenadata.io*. После загрузки некоторых из них необходимо нажать «BUNDLES» в главном меню **ADCM** и загрузить пакеты с помощью кнопки «Upload bundle» (:numref:`Рис.%s.<upload>`).

.. _upload:

.. figure:: imgs/upload.png
   :align: center

   Загрузка пакета