Установка

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

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

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-сервис.

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

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.