Установка
Online-установка с использованием Docker-образа
ПРИМЕЧАНИЕ
|
Для установки ADCM необходимо выполнить следующие команды:
-
Скачайте Docker-образ из Arenadata Docker Registry.
$ sudo docker pull hub.arenadata.io/adcm/adcm:<version>
где
<version>
— это версия Docker-образа в одном из следующих форматов:-
<major>.<minor>.<patch>
— если необходим конкретный патч ADCM. Пример:2.0.0
. -
<major>.<minor>
— если необходим последний патч в рамках выбранной версии ADCM. Пример:2.0
.
Обратите внимание, что до выпуска ADCM 2.0.0 для версионирования использовался следующий формат:
YYYY.MM.DD.HH
. -
-
Создайте Docker-контейнер на основе загруженного образа. Приведенная ниже команда создает контейнер с ADCM на порте
8000
. Все данные контейнера будут храниться в директории /opt/adcm/.$ sudo docker create --name adcm -p 8000:8000 -v /opt/adcm:/adcm/data hub.arenadata.io/adcm/adcm:<version>
Если требуется запустить ADCM с включенным SELinux, при создании Docker-контейнера необходимо указать опцию
:Z
в параметре, содержащем имя каталога данных:$ sudo docker create --name adcm -p 8000:8000 -v /opt/adcm:/adcm/data:Z hub.arenadata.io/adcm/adcm:<version>
Опционально при создании контейнера можно указать переменные окружения, перечисленные ниже. Каждая переменная указывается в формате
-e <name>="<value>"
. Пример:
$ sudo docker create --name adcm -p 8000:8000 -v /opt/adcm:/adcm/data hub.arenadata.io/adcm/adcm:<version> -e LOG_LEVEL="INFO" -e DEFAULT_ADCM_URL="http://10.92.40.40:8000/"
Имя | Описание |
---|---|
DEFAULT_ADCM_URL |
URL хоста, на котором разворачивается контейнер ADCM. Указывается в формате: |
LOG_LEVEL |
Уровень логирования. Возможные значения:
|
DB_HOST |
Имя или IP-адрес хоста, на котором развернута внешняя БД PostgreSQL. Дополнительную информацию по переменным |
DB_PORT |
Номер TCP-порта для подключения к PostgreSQL |
DB_USER |
Имя пользователя для подключения к PostgreSQL |
DB_NAME |
Название базы данных PostgreSQL |
DB_PASS |
Пароль пользователя для подключения PostgreSQL |
MIGRATION_MODE |
Флаг, указывающий на использование режима миграции — переноса базы данных ADCM с SQLite на PostgreSQL. Дополнительную информацию можно получить в статье Миграция ADCM. Возможные значения:
|
Offline-установка (доступно в Enterprise Edition)
При использовании версии Enterprise дополнительно доступна offline-установка ADCM. Она подходит для развертывании системы на хостах без доступа к Интернету. Offline-установка ADCM включает следующие шаги:
-
Запросите специальный установочный shell-скрипт у команды поддержки Arenadata.
-
Создайте директорию на хосте, где должен быть развернут ADCM, и разместите в ней полученный скрипт.
-
Запустите скрипт из созданной директории, используя следующую команду:
$ sudo bash <script_name> master_adcm
где
<script_name>
означает полное имя скрипта с расширением (например, pack.sh).
ПРИМЕЧАНИЕ
|
Запуск и остановка
Поскольку ADCM представляет собой контейнер под управлением Docker, за его запуск и установку отвечают стандартные Docker-команды:
-
Запуск ADCM.
$ sudo docker start adcm
-
Остановка ADCM.
$ sudo docker stop adcm
-
Автозапуск ADCM. Чтобы настроить автоматический запуск Docker-контейнера в случае непредвиденных ошибок, используйте следующую команду.
$ sudo docker update --restart=on-failure adcm
ПРИМЕЧАНИЕ
|
Проверка установки
Проверка статуса Docker-контейнера
Чтобы убедиться в успешной установке Docker-контейнера adcm
, выполните следующую команду.
$ sudo docker container ls
Результат команды приведен ниже. Убедитесь, что в столбце STATUS
выводится значение Up
:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 74b5628146e5 hub.arenadata.io/adcm/adcm:2.0 "/etc/startup.sh" 4 days ago Up 21 minutes 0.0.0.0:8000->8000/tcp adcm
Проверка доступности порта 8000
После установки и запуска ADCM его web-интерфейс должен стать доступным на 8000
порте развернутого контейнера. Для проверки этого выполните команды:
-
netstat
— для вывода информации о состоянии порта.$ sudo netstat -ntpl | grep 8000
Результат команды:
tcp6 0 0 :::8000 :::* LISTEN 1514/docker-proxy-c
-
curl
— для проверки URL-соединения.$ curl http://localhost:8000
Результат команды:
<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>Arenadata Cluster Manager</title> <base href="/"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="icon" type="image/x-icon" href="assets/favicon.ico"> <link rel="stylesheet" href="styles.10db6328264e0907c52f.css"></head> <body> <app-root></app-root> <script src="runtime-es2015.7eb406ed18bf0258cd35.js" type="module"></script><script src="runtime-es5.7eb406ed18bf0258cd35.js" nomodule defer></script><script src="polyfills-es5.2e224d70daec4412d3c2.js" nomodule defer></script><script src="polyfills-es2015.37e0553ac06970d6a5b5.js" type="module"></script><script src="main-es2015.39851da0ebf9ed6fec45.js" type="module"></script><script src="main-es5.39851da0ebf9ed6fec45.js" nomodule defer></script></body> </html>
Проверка web-интерфейса ADCM
При установке ADCM автоматически создается пользователь с административными правами. Чтобы зайти в ADCM, используйте следующие учетные данные:
-
User: admin
-
Password: admin
Для изменения пароля требуется выполнить следующие действия:
-
Откройте профиль текущего пользователя в левом навигационном меню.
-
Введите текущий пароль в поле Current password.
-
Укажите новый пароль в поле New password.
-
Подтвердите новый пароль в поле Confirm password.
-
Нажмите Save.
Изменение пароля пользователя admin
Установка URL ADCM
Для успешного обмена данными между ADCM и развернутыми с его помощью кластерами важно корректное определение внешнего адреса ADCM. В дальнейшем этот адрес будет использоваться для отправки в ADCM статусов кластерных компонентов. Для указания URL ADCM используется переменная окружения DEFAULT_ADCM_URL
при создании контейнера ADCM. Если переменная не была указана, необходимо установить URL вручную в web-интерфейсе ADCM. Для этого выполните шаги:
-
Выберите пункт Settings в левом навигационном меню.
-
Раскройте узел Global Options в дереве конфигурационных настроек.
-
Нажмите на значение поля ADCM’s URL.
Страница Settings -
В открывшемся окне измените значение ADCM’s URL и нажмите Apply.
Редактирование URL ADCM -
Нажмите Save для сохранения внесенных изменений.
Сохранение URL ADCM