Установка

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

При установке и обновлении платформа загружает ПО из интернет-ресурсов 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

   CODE

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

   chmod +x vm

   CODE

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

   ./vm install

   CODE
    Дополнительные параметры

   Дополнительные параметры команды:

   • -n — доменное имя сервера. Будет использовано в URL платформы; 

     Пример команды

     ./vm install -n="vmmanager.example.com"

     CODE

   • --registry-port — TCP-порт для загрузки образов docker-контейнеров. Используйте параметр, если на сервере запрещены входящие подключения на порты 5000/tcp и 443/tcp; 

     Пример команды

     ./vm install --registry-port=5001

     CODE

   • -f — установка на сервер с характеристиками ниже требуемых;

   • --ssl-crt-file, --ssl-key-file  — путь к файлам с открытым и приватным ключом SSL-сертификата. Данные будут добавлен в настройки веб-сервера; 

     Пример команды

     ./vm install --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 --proxy="http://admin:pass123@192.168.57.1:3128"

       CODE

       Пример команды для прокси без авторизации

       ./vm install --proxy="http://192.168.57.1:3128"

       CODE

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

   CODE

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

   Пример команды

   ./vm install -f

   CODE

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

   Пример терминала после успешной установки

   Link to administrator registration page: https://1.2.3.4/auth/setup?token=C50A0BFA55DEDE3343AABE713022A15F

   BASH
   

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

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

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

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

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

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

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

   vm down

   CODE

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

   rm /opt/ispsystem/vm -rf

   CODE

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

   systemctl restart vm

   CODE

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

   vm install

   CODE
6. Активируйте лицензию:
   1. В правом меню нажмите → Обзор системы.
   2. В поле Ключ лицензии введите значение параметра Token для вашей лицензии. Это значение отображается в личном кабинете my.ispsystem.com на странице подробной информации о лицензии.
   3. Нажмите кнопку Активировать.

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

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

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

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

   vm install

   CODE

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

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

3. Перейдите в интерфейс по полученной ссылке и укажите данные первого пользователя. 
4. Активируйте лицензию:
   1. В правом меню нажмите → Обзор системы.
   2. В поле Ключ лицензии введите значение параметра Token для вашей лицензии. Это значение отображается в личном кабинете my.ispsystem.com на странице подробной информации о лицензии.
   3. Нажмите кнопку Активировать.

Логирование

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

Связанные статьи:

• Начальная настройка
• Настройка аккаунта

• Подключение SSL-сертификата

• Перенос VMmanager на другой сервер
• Миграция с ОС CentOS 8 на AlmaLinux 8
• Перенос сервера с платформой на ВМ в HA-кластере