Установка

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

Для установки DCImanager потребуется информация о лицензии. Если вы приобрели DCImanager в ISPsystem, вы можете посмотреть эту информацию в личном кабинете на my.ispsystem.com в разделе "Платформы". Для установки потребуется значение из поля Token.

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

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

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

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

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

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

   CODE

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

   chmod +x dci

   CODE

4. Запустите установку, используя ключ активации (токен) лицензии:

   ./dci install -l="<token>"

   CODE

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

   • <token> — значение параметра Token для вашей лицензии. Отображается в личном кабинете my.ispsystem.com на странице подробной информации о лицензии.

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

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

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

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

       ./dci install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -n="dcimanager.example.com"

       CODE

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

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

       ./dci install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" --registry-port=5001

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

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

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

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

         CODE

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

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

         CODE

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

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

   ./dci install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -f

   CODE

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

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

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

   BASH
   

   Обратите внимание!

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

7. Перейдите в интерфейс DCImanager по полученной ссылке и создайте первого пользователя:
   1. Введите E-Mail пользователя.
   2. Придумайте Пароль или нажмите генерировать для автоматической генерации пароля.
   3. Нажмите Готово.
8. Выполните начальную настройку платформы.
9. Если у вас есть сертификат на дополнительный пакет ресурсов, активируйте его:
   1. Перейдите в → Обзор системы → Активировать пакет.
   2. Введите код из сертификата на пакет ресурсов.
   3. Нажмите Активировать.
      
      Подробнее о пакетах ресурсов см. в статье Лицензирование.

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

Обратите внимание!

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

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

1. Создайте новое значение Token для вашей лицензии. Вы можете сделать это в личном кабинете на 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 -l="<new_token>"

   CODE

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

   • <new_token> — новое значение параметра Token для вашей лицензии.

Логирование

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