Установка

Статья описывает установку версии платформы для открытого контура.

Для активации DCImanager 6 потребуется информация о лицензии: 

• если вы приобрели платформу в ISPsystem, вы можете посмотреть эту информацию в личном кабинете my.ispsystem.com в разделе "Лицензии". После установки потребуется ввести значение из поля Токен;
• если вы приобрели платформу у компании-реселлера, после установки понадобится ввести код активации лицензии из лицензионного сертификата.

Перед установкой платформы:

1. Убедитесь, что сервер соответствует системным требованиям. Подробнее см. в статье Требования к серверу.
2. Если вы устанавливаете платформу на сервер с ОС Astra Linux, выполните инструкции из статьи Подготовка сервера с ОС Astra Linux.
3. Выполните инструкции из статьи Подготовка сервера.

Установка платформы

1. Подключитесь к серверу по SSH с правами суперпользователя (по умолчанию root).

2. Скачайте установщик:

   Regular

   curl -O https://download.ispsystem.com/6/dci/dcibox/dci

   Stable

   curl -O https://download.ispsystem.com/6/dci/stable/dci/dcibox/dci

3. Сделайте его исполняемым:

   chmod +x dci

4. Запустите установку:

   Regular

   ./dci install

   Stable

   ./dci install --stage=stable

   Дополнительные параметры команды:

   • -n — доменное имя сервера. Будет использовано в URL платформы; 

     Пример команды

     ./dci install -n="dcimanager.example.com"

   • --registry-port — TCP-порт для загрузки образов docker-контейнеров. Используйте параметр, если на сервере запрещены входящие подключения на порты 5000/tcp и 443/tcp; 

     Пример команды

     ./dci install --registry-port=5001

   • -f — не проверять версию Docker;
   • --proxy — настройки HTTP-прокси в формате http://<user>:<password>@<address>:<port>:
     
     • <user> — имя пользователя для авторизации. Необязательный параметр;
     • <password> — пароль для авторизации. Необязательный параметр;
     • <address> — IP-адрес HTTP-прокси;

     • <port> — порт HTTP-прокси.

       Пример команды для прокси с авторизацией

       ./dci install --proxy="http://admin:pass123@192.168.57.1:3128"

       Пример команды для прокси без авторизации

       ./dci install --proxy="http://192.168.57.1:3128"

   
   

5. Установщик проверит версию ПО Docker на сервере. Если версия ниже 20.10.10, установка завершится с ошибкой. Чтобы установить платформу на сервер с более старой версией Docker, добавьте в команду установки параметр -f:

   Пример команды для версии regular

   ./dci install -f

   Пример команды для версии stable

   ./dci install -f --stage=stable

6. Дождитесь окончания установки. Если установка завершилась успешно, то в терминале будет выведена ссылка для перехода в DCImanager 6:

   Терминал после успешной установки

   Link to administrator registration page: https://127.0.0.1/auth/setup?token=C50A0BFA55DEDE3343AABE713022A15F

   При открытии ссылки браузер выдаст предупреждение о вероятной угрозе безопасности. Это происходит, если сервер использует самоподписанный SSL-сертификат. Вы можете подключить валидный SSL-сертификат к платформе по инструкции.

7. Создайте учётную запись администратора платформы одним из способов:

   • через веб-интерфейс платформы:
     1. Перейдите в интерфейс DCImanager 6 по полученной ссылке.
     2. Введите E-Mail пользователя.
     3. Придумайте Пароль или нажмите генерировать для автоматической генерации пароля.
     4. Нажмите Готово.
   • командой в терминале:

   dci create-admin -u=<email> -p=<password>

   Пояснения к команде

   email — email пользователя

   password — пароль учётной записи пользователя

8. Выполните начальную настройку платформы.

9. Активируйте лицензию одним из способов:

   • в веб-интерфейсе платформы:
     1. В правом меню нажмите → Обзор системы.

     2. Введите Токен лицензии:

        • если вы приобрели платформу в ISPsystem, вы можете посмотреть эту информацию в личном кабинете my.ispsystem.com в разделе "Лицензии". Введите значение из поля Токен;
        • если вы приобрели платформу у компании-реселлера, введите код активации лицензии из лицензионного сертификата.
     3. Нажмите кнопку Активировать.
   • командой в терминале:

   dci license update -t=<token>

   Пояснения к команде

   token — токен лицензии

10. Если у вас есть сертификат на дополнительный пакет ресурсов, активируйте его:
    1. Перейдите в → Обзор системы → Активировать пакет.
    2. Введите код из сертификата на пакет ресурсов.
    3. Нажмите Активировать.
       
       Подробнее о пакетах ресурсов см. в статье Лицензирование.

После установки платформа будет доступна по IP-адресу или доменному имени вашего сервера. Установщик запустится как systemd-сервис.

Переустановка платформы

1. Создайте новое значение токена для вашей лицензии. Вы можете сделать это в личном кабинете на my.ispsystem.com или обратиться в техническую поддержку.

2. Остановите платформу: 

   dci down

3. Удалите директории /opt/ispsystem/dci и /var/lib/mysql и /var/lib/postgresql: 

   rm /opt/ispsystem/dci /var/lib/mysql /var/lib/postgresql -rf

4. Перезапустите службу dci:

   systemctl restart dci

5. Установите платформу: 

   dci install

6. Активируйте лицензию одним из способов:

   • в веб-интерфейсе платформы:
     1. В правом меню нажмите → Обзор системы.

     2. Введите Токен лицензии:

        • если вы приобрели платформу в ISPsystem, вы можете посмотреть эту информацию в личном кабинете my.ispsystem.com в разделе "Лицензии". Введите значение из поля Токен;
        • если вы приобрели платформу у компании-реселлера, введите код активации лицензии из лицензионного сертификата.
     3. Нажмите кнопку Активировать.
   • командой в терминале:

   dci license update -t=<token>

   Пояснения к команде

   token — токен лицензии

Логирование

Лог установки DCImanager 6 записывается в файл /opt/ispsystem/dci/install.log.