Администратору DCImanager

Установка

ISPSystem

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

Подготовка сервера


Рекомендуем отключить службу SELinux, так как она замедляет работу платформы и может помешать её корректной установке.

Сервер с типом виртуализации XEN

Создайте файл /etc/docker/daemon.json со следующим содержимым:

Файл daemon.json
{
"storage-driver": "vfs",
"live-restore": true
}

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

Сервер с такой настройкой не может быть использован в качестве локации.

Сервер с ОС Astra Linux Special Edition 1.7.1

Установите ПО Docker из репозитория Debian 10:

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

    sudo apt install apt-transport-https ca-certificates curl gnupg2 software-properties-common
    curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -
    echo "deb [arch=amd64] https://download.docker.com/linux/debian buster stable" >> /etc/apt/sources.list
    apt update
    apt install -y docker-ce
    systemctl enable docker
    systemctl start docker

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


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

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

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

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

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

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

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

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

      • -s — версия релизов платформы. Значение по умолчанию — stable. Возможные значения:
        • stable — стабильная версия ПО;
        • regular — регулярная версия ПО, включающая все обновления функциональности;

          Пример команды
          ./dci install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -s=regular

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

          Обновление стабильной версии возможно только до актуальной стабильной версии, регулярной версии — только до актуальной регулярной.

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

        Пример команды
        ./dci install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -n="dcimanager.example.com"
      • --registry-port — TCP-порт для загрузки образов docker-контейнеров. Используйте параметр, если на сервере запрещены входящие подключения на порты 5000/tcp и 443/tcp; 

        Пример команды
        ./dci install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" --registry-port=5001
      • -f — не проверять версию Docker;
      • --ssl-crt-file, --ssl-key-file  — путь к файлам с открытым и приватным ключом SSL-сертификата. Данные будут добавлен в настройки веб-сервера; 

        Пример команды
        ./dci install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" --ssl-crt-file="/root/example.crt" --ssl-key-file="/root/example.key"
      • --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"
          Пример команды для прокси без авторизации
          ./dci install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" --proxy="http://192.168.57.1:3128"
  5. Установщик проверит версию ПО Docker на сервере. Если версия ниже 20.10.10, установка завершится с ошибкой. Чтобы установить платформу на сервер с более старой версией Docker, добавьте в команду установки параметр -f:

    Пример команды
    ./dci install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -f
  6. Дождитесь окончания установки. Если установка завершилась успешно, то в терминале будет выведена ссылка для перехода в DCImanager:

    Терминал после успешной установки
    Link to administrator registration page: https://127.0.0.1/auth/setup?token=C50A0BFA55DEDE3343AABE713022A15F

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

    При открытии ссылки браузер выдаст предупреждение о вероятной угрозе безопасности. Это происходит, если сервер использует самоподписанный 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
  3. Удалите директории /opt/ispsystem/dci и /var/lib/mysql

    rm /opt/ispsystem/dci /var/lib/mysql -rf
  4. Перезапустите сервис dci:

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

    dci install -l="<new_token>"

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

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

Логирование


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

Спасибо за ваш отзыв!
Была ли полезна статья?
Уточните, почему:

статья не соответствует названию

статью сложно понять

в статье нет ответа на мой вопрос

рекомендации из статьи не помогли

другая причина

Расскажите, что вам не понравилось в статье: