Инструкция по установке ADSS
=============================

Введение
---------

Для установки программного обеспечения **Arenadata Second Storage** сначала необходимо выполнить 
инсталляцию **Arenadata Cluster Manager** (**ADCM**).

Преимуществами установки **ADSS** через **ADCM** являются:

1.	Вся логика по установке и конфигурированию находится внутри бандла ADSS:

•	Пользователю нет необходимости конфигурировать многострочный JSON-файл топологии кластера;
•	Операции по реконфигурированию кластера производятся с помощью интерфейса пользователя;
•	Сконфигурированы все важные настройки ОС и базы данных;

2.	Существует возможность использования как облачной, так и физической инфраструктуры;

3.	Все пакеты скачиваются из репозитория Arenadata:

•	Все пакеты протестированы;
•	Заранее известные версии пакетов и номер сборки упрощают отладку и составление баг-репортов.

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

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

**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 и 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*.

.. figure:: img/autorization.png
      
      Авторизация

Для продолжения предлагается рассмотреть возможность загрузки некоторых пакетов инфраструктуры на *store.arenadata.io*. 
После загрузки некоторых из них необходимо нажать «BUNDLES» в главном меню **ADCM** и загрузить пакеты с помощью 
кнопки «Upload bundle».

.. figure:: img/load.png
      
      Загрузка пакета


Предварительные действия
-------------------------

Для установки кластера **ADSS** посредством **ADCM** необходимо выполнить следующие предварительные шаги:

1.	Установить ADCM.

2.	Получить бандл ADSS через обращение в службу технической поддержки на сайте support.arenadata.io. 


Загрузка бандла ADSS
---------------------

Цель бандла **ADSS** – описать прототип будущего кластера, из которого в дальнейшем возможна генерация одного 
или нескольких реальных кластеров.

Для загрузки бандла следует выполнить следующие действия:

1.	Открыть в ADCM вкладку «BUNDLES».

2.	Нажать «Upload bundle».

3.	Открыть в ADCM вкладку «Clusters».