Установка
Для установки 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 по полученной ссылке и создайте первого пользователя:
- Введите E-Mail пользователя.
- Придумайте Пароль или нажмите генерировать для автоматической генерации пароля.
- Нажмите Готово.
- Выполните начальную настройку платформы.
- Если у вас есть сертификат на дополнительный пакет ресурсов, активируйте его:
- Перейдите в
→ Обзор системы → Активировать пакет.
- Введите код из сертификата на пакет ресурсов.
- Нажмите Активировать.
Подробнее о пакетах ресурсов см. в статье Лицензирование.
- Перейдите в
После установки платформа будет доступна по 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.