Установка

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

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

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

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

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

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

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

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

CODE

Сделайте файл установщика исполняемым:
```
chmod +x vm
```
CODE
Запустите установку, используя ключ активации (токен) лицензии:
```
./vm install -l="<token>"
```
CODE
Пояснения к команде:
- <token> — значение параметра Token для вашей лицензии. Отображается в личном кабинете my.ispsystem.com на странице подробной информации о лицензии в разделе "Платформы";
  Дополнительные параметры
  Дополнительные параметры команды:
  - -n — доменное имя сервера. Будет использовано в URL платформы;
    
    Пример команды
    
    ./vm install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -n="vmmanager.example.com"
    
    CODE
  - --registry-port — TCP-порт для загрузки образов docker-контейнеров. Используйте параметр, если на сервере запрещены входящие подключения на порты 5000/tcp и 443/tcp;
    
    Пример команды
    
    ./vm install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" --registry-port=5001
    
    CODE
  - -f — установка на сервер с характеристиками ниже требуемых;
  - --ssl-crt-file, --ssl-key-file — путь к файлам с открытым и приватным ключом SSL-сертификата. Данные будут добавлен в настройки веб-сервера;
    
    Пример команды
    
    ./vm install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" --ssl-crt-file="/root/example.crt" --ssl-key-file="/root/example.key"
    
    CODE
  - --proxy — настройки HTTP-прокси в формате http://<user>:<password>@<address>:<port>:
    <user> — имя пользователя для авторизации. Необязательный параметр;
    <password> — пароль для авторизации. Необязательный параметр;
    <address> — IP-адрес HTTP-прокси;
    <port> — порт HTTP-прокси.
    
    Пример команды для прокси с авторизацией
    
    ./vm install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" --proxy="http://admin:pass123@192.168.57.1:3128"
    
    CODE
    
    Пример команды для прокси без авторизации
    
    ./vm install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" --proxy="http://192.168.57.1:3128"
    
    CODE
Установщик проверит сервер на соответствие минимальным системным требованиям. Если сервер не удовлетворяет требованиям, в окне терминала появится предупреждение вида:
Пример предупреждения
```
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
```
CODE
Чтобы установить платформу на сервер с характеристиками ниже требуемых, добавьте в команду установки параметр -f:
Пример команды
```
./vm install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -f
```
CODE
Дождитесь окончания установки. Если установка завершилась успешно, то в терминале будет выведена ссылка для перехода в VMmanager:
Пример терминала после успешной установки
```
Link to administrator registration page: https://1.2.3.4/auth/setup?token=C50A0BFA55DEDE3343AABE713022A15F
```
BASH
При открытии ссылки браузер выдаст предупреждение о вероятной угрозе безопасности. Это происходит, если сервер использует самоподписанный SSL-сертификат. Вы можете подключить валидный SSL-сертификат к платформе по инструкции.
Перейдите в интерфейс VMmanager по полученной ссылке и создайте первого пользователя:
1. Введите E-Mail пользователя.
2. Придумайте Пароль или нажмите генерировать для автоматической генерации пароля.
3. Нажмите Готово.
Выполните начальную настройку платформы.
Если у вас есть сертификат на дополнительный пакет ресурсов, активируйте его:
1. Перейдите в → Обзор системы → Активировать пакет.
2. Введите код из сертификата на пакет ресурсов.
3. Нажмите Активировать.
  
  Подробнее о пакетах ресурсов см. в статье Лицензирование.

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

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

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

Создайте новое значение Token для вашей лицензии. Вы можете сделать это в личном кабинете на my.ispsystem.com или обратиться в техническую поддержку.
Остановите платформу:
```
vm down
```
CODE
Удалите директорию /opt/ispsystem/vm:
```
rm /opt/ispsystem/vm -rf
```
CODE
Перезапустите сервис vm:
```
systemctl restart vm
```
CODE
Установите платформу:
```
vm install -l="<new_token>"
```
CODE
Пояснения к команде:
- <new_token> — новое значение параметра Token для вашей лицензии.

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

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

Подключитесь по SSH к серверу с установленным VMmanager.
Выполните команду установки через systemd-сервис vm:
```
vm install -l="<token>"
```
CODE
Пояснения к команде:
- <token> — значение параметра Token для вашей лицензии. Отображается в личном кабинете my.ispsystem.com на странице подробной информации о лицензии.
Перейдите в интерфейс по полученной ссылке и укажите данные первого пользователя.

Логирование

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

Установка