VMmanager
Документация
/
VMmanager
/
Установка и обновление
/
Установка

Установка

Для активации VMmanager потребуется информация о лицензии: 

  • если вы приобрели VMmanager в ISPsystem, вы можете посмотреть эту информацию в личном кабинете  my.ispsystem.com в разделе "Лицензии". После установки потребуется ввести значение из поля Токен;
  • если вы приобрели VMmanager у компании-реселлера, после установки понадобится ввести код активации лицензии из лицензионного сертификата.

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

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

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

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

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

Если вы устанавливаете платформу на сервер с ОС Astra Linux, выполните инструкции из статьи Подготовка сервера с ОС Astra Linux.

Файл /etc/hosts

Убедитесь, что в файле /etc/hosts есть запись для сервера в формате:

<IP-адрес сервера> <hostname сервера>

Файл /etc/resolv.conf

Убедитесь, что в файле /etc/resolv.conf есть записи вида:

nameserver <IP-адрес DNS-сервера>

Если в качестве DNS-сервера указан IP-адрес локальной службы systemd-resolved — 127.0.0.53, то проверьте, что в файле /etc/systemd/resolved.conf указаны адреса DNS-серверов:

DNS=<список_серверов>

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

Чтобы установить платформу на сервер без доступа к сети Интернет, выполните инструкции из статьи Установка в закрытом информационном контуре.
  1. Подключитесь к серверу по SSH с правами суперпользователя (по умолчанию root). 

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

    curl -O https://download.ispsystem.com/6/installer/vm/vm

  3. Сделайте файл установщика исполняемым: 

    chmod +x vm

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

    ./vm install
    Дополнительные параметры

  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

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

    Пример команды
    ./vm install -f

  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. Активируйте лицензию:
    1. Нажмите кнопку Настройки в окне Лицензия не активирована.
    2. Введите Ключ лицензии:
      • если вы приобрели VMmanager в ISPsystem, вы можете посмотреть эту информацию в личном кабинете my.ispsystem.com в разделе "Лицензии". Введите значение из поля Токен;
      • если вы приобрели VMmanager у компании-реселлера, введите код активации лицензии из лицензионного сертификата.
    3. Нажмите кнопку Активировать.
  9. Если у вас есть сертификат на дополнительный пакет ресурсов, активируйте его:
    1. Перейдите в → Обзор системы → Активировать пакет.
    2. Введите код из сертификата на пакет ресурсов.
    3. Нажмите кнопку Активировать.

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

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

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

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

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

    vm down

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

    rm /opt/ispsystem/vm -rf

  4. Перезапустите сервис vm: 

    systemctl restart vm

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

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

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

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

  1. Подключитесь по SSH к серверу с установленным VMmanager. 

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

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

Логирование

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