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


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

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

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

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

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

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

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

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


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

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

    curl -O https://download.ispsystem.com/6/dci/dcibox/dci
    CODE
  3. Сделайте его исполняемым:

    chmod +x dci
    CODE
  4. Запустите установку:

    ./dci install
    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:

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

    ./dci install -f
    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.


Подробнее см. в статье базы знаний Изменение сети, используемой Docker.

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


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

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

    rm /opt/ispsystem/dci /var/lib/mysql -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.