Установка

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

Чтобы установить версию платформы для закрытого контура, используйте инструкции из статьи Установка в закрытом информационном контуре.

Статья содержит инструкции по установке актуального (6-го) поколения ПО. Установка ПО 5-го и 4-го поколения не поддерживается.

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

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

При установке и обновлении платформа загружает ПО из интернет-ресурсов ISPsystem:

• docker-реестра docker-registry.ispsystem.com;
• репозитория download.ispsystem.com.

Эти ресурсы являются публичными сервисами, доступ к ним осуществляется без аутентификации.

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

Вы можете установить одну из двух версий релиза платформы: regular либо stable. Подробнее о версиях релизов см. в статье Версии релизов.

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

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

   Regular

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

   CODE

   Stable

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

   CODE

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

   chmod +x dci

   CODE

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

   Regular

   ./dci install

   CODE

   Stable

   ./dci install --stage=stable

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

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

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

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

     CODE

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

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

     ./dci install --registry-port=5001

     CODE
   • -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"

       CODE

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

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

       CODE

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

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

   ./dci install -f

   CODE

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

   ./dci install -f --stage=stable

   CODE

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

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

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

   BASH
   

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

7. Перейдите в интерфейс DCImanager 6 по полученной ссылке и создайте первого пользователя:
   1. Введите E-Mail пользователя.
   2. Придумайте Пароль или нажмите генерировать для автоматической генерации пароля.
   3. Нажмите Готово.
8. Выполните начальную настройку платформы.
9. Активируйте лицензию:
   1. В правом меню нажмите → Обзор системы.
   2. Введите Ключ лицензии:
      • если вы приобрели платформу в ISPsystem, вы можете посмотреть эту информацию в личном кабинете my.ispsystem.com в разделе "Лицензии". Введите значение из поля Токен;
      • если вы приобрели платформу у компании-реселлера, введите код активации лицензии из лицензионного сертификата.
   3. введите значение параметра Token для вашей лицензии.
   4. Нажмите кнопку Активировать.
10. Если у вас есть сертификат на дополнительный пакет ресурсов, активируйте его:
    1. Перейдите в → Обзор системы → Активировать пакет.
    2. Введите код из сертификата на пакет ресурсов.
    3. Нажмите Активировать.
       
       Подробнее о пакетах ресурсов см. в статье Лицензирование.

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

Для работы DCImanager 6 используется система виртуализации Docker. По умолчанию она использует сети 172.17.0.0/16. Если ваше оборудование использует адреса из этих сетей, вы можете изменить настройки Docker.

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

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

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

   dci down

   CODE

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

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

   CODE

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

   systemctl restart dci

   CODE

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

   dci install

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

Логирование

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

Может быть полезно

Связанные статьи:

• Подготовка сервера
• Начальная настройка
• Управление локациями

• Учётные записи

• Подключение SSL-сертификата
• Версии релизов