Документация VMmanager 6 (администратор)

Установка

ISPSystem

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

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

 В процессе установки будет отключена служба SELinux. Она мешает корректной работе платформы.

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

Порядок установки VMmanager на ОС Astra Linux SE 1.6 описан в статье Установка VMmanager на ОС Astra SE 1.6 "Смоленск".

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


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

    curl -O https://download.ispsystem.com/6/installer/vm/vm
  3. Сделайте файл установщика исполняемым: 

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

    ./vm install -l <token>

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

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

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

      В процессе установки на сервер будут загружены образы docker-контейнеров. По умолчанию установщик платформы использует для загрузки порты 5000/tcp и 443/tcp. Если входящие подключения на эти порты запрещены, используйте для установки параметр --registry-port:

      ./vm install -l="<token>" --registry-port <port>

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


      <port> — TCP-порт для загрузки образов

    Выполните для установки команду

    ./vm install -l="<token>" --proxy http://<user>:<password>@<address>:<port>

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

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

    • <user> — имя пользователя для авторизации. Необязательный параметр;
    • <password> — пароль для авторизации. Необязательный параметр;
    • <address> — IP-адрес HTTP-прокси;
    • <port> — порт HTTP-прокси.
    Пример команды для прокси с авторизацией
    ./vm install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" --proxy http://admin:pass123@192.168.57.1:3128
    Пример команды для прокси без авторизации
    ./vm install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" --proxy http://192.168.57.1:3128
  5. Установщик проверит сервер на соответствие минимальным системным требованиям. Если сервер не удовлетворяет требованиям, в окне терминала появится предупреждение вида:

    Пример предупреждения
    Checking available resources of the machine ... fail
    Resources of the machine don't match with minimal requirements
    
      RESOURCE  | MACHINE  | REQUIRED  
    ------------+----------+-----------
      CPU Speed | 3.60 GHz |  2 GHz    
      CPU Cores |    1     |    2      
      RAM       | 0.47 Gb  |   2 Gb    
      Storage   | 6.94 Gb  |  40 Gb

    Чтобы установить платформу на сервер с характеристиками ниже требуемых, выполните команду:

    ./vm install -l <token> -f

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

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

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

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

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

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

      Подробнее о пакетах ресурсов см. в статье Лицензирование.

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

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

Чтобы повысить отказоустойчивость платформы, вы можете перенести её в HA-кластер. Подробнее см. в статье Как перенести сервер с платформой на ВМ в HA-кластере?

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


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

    vm down
  3. Удалите директорию /opt/ispsystem/vm

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

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

    vm install -l <new_token>

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

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

Если утеряна ссылка для авторизации


Если VMmanager установлен на сервер, но первый пользователь не создан, вы можете получить уникальную ссылку для перехода в веб-интерфейс: 

  1. Подключитесь по SSH к серверу с установленным VMmanager. 
  2. Выполните команду установки через systemd-сервис vm: 

    vm install -l <token>

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

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

  3. Перейдите в интерфейс по полученной ссылке и укажите данные первого пользователя. 

Логирование


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

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

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

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

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

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

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

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