> For the complete documentation index, see [llms.txt](https://kb.pvhostvm.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-installation-guide/hostvm-vdi-ova-install.md).
# Установка HOSTVM VDI Broker
### Импорт виртуальной машины
* Скачайте файл `HOSTVM-VDI/Stable/<номер версии>/hostvm-vdi<номер версии>-<номер сборки>.tar.bz2` из каталога загрузок HOSTVM.
* Загрузите данный файл на один из хостов виртуализации HOSTVM с помощью scp или других средств.
* Распакуйте командой: `tar xjvf hostvm-vdi<номер версии>-<номер сборки>.tar.bz2`
* Откройте портал администрирования платформы виртуализации HOSTVM, перейдите в раздел **Compute - Virtual Machines.**
* Нажмите на иконку из трех вертикальных точек в правом верхнем углу интерфейса и выберите пункт **Import.**
* Выберите в качестве источника импорта **Source** файл OVA: "**Virtual Appliance(OVA)**". Укажите хост, на котором расположен файл ВМ и абсолютный путь директории с файлом, нажмите кнопку Load для поиска образа.
* Выберите нужный образ в результатах поиска, переместите его с помощью стрелки в список ВМ для импорта (справа) и нажмите кнопку **Next.**
* В появившемся окне задайте домен хранения и кластер для ВМ. Выделите ВМ в списке, перейдите на вкладку **Network Interfaces** и задайте логическую сеть для данной ВМ.
* После этого с помощью кнопки **OK** запустите импорт OVA и дождитесь его окончания.
* Запустите полученную ВМ, подключитесь к ней с помощью консоли. Авторизуйтесь с логином/паролем *root/engine.*
* Задайте новый пароль для учетной записи root с помощью команды `passwd`
### Настройка сети
В случае получения IP адреса по DHCP данный раздел настройки можно пропустить.
Если требуется настройка статического адреса, подключитесь к ВМ через консоль: `Compute > Virtual machines > выбрать машину > нажать кнопку Console`
После подключения внесите изменения в файл `/etc/network/interfaces`, задав параметры IP адреса, маски сети, и шлюза по умолчанию.
Пример настройки:
```
allow-hotplug eth0
iface eth0 inet static
address 10.1.1.2
netmask 24
gateway 10.1.1.1
```
Укажите адреса DNS в `/etc/resolv.conf`
Перезапустите виртуальную машину для применения настроек:
```bash
reboot
```
При необходимости, задайте новое имя ВМ командой `hostnamectl set-hostname <имя_машины>`.
### Мастер установки HOSTVM VDI
{% hint style="info" %}
Мастер установки доступен для версий 3.6-20250704 и выше. При установке предыдущих версий брокера пропустите этот шаг.
{% endhint %}
{% hint style="info" %}
При использовании внешнего сервера БД требуется его [предварительная настройка](/hostvm-vdi/hostvm-vdi-installation-guide/vdi-db.md).
{% endhint %}
Выполните команду `hostvm-vdi setup` для запуски мастера установки.
Задайте запрашиваемые мастером параметры конфигурации:
* Тип используемой СУБД (MariaDB или PostgreSQL), вариант развертывания (локальная или внешняя БД)
* Параметры подключения к БД: имя БД, пользователь, пароль; при подключении к внешней БД - адрес и порт.
В процессе установки будет сгенерирован самоподписанный сертификат для брокера. Вы сможете заменить его на следующем этапе "Настройка SSL сертификатов". При наличии сертификата в системе (например при настройке существующей инсталляции) вы сможете сохранить старый сертификат либо сгенерировать новый.
### Доступ к веб-интерфейсу управления
* Откройте веб-интерфейс HOSTVM VDI через браузер по адресу `https://`, выполните вход в систему с помощью пары логин/пароль: *root/udsmam0*
* Для перехода к администрированию системы выберите в меню пользователя пункт «Dashboard» ("Панель управления").
* Перейдите в раздел `Инструменты - Конфигурация - Security`, задайте новый пароль встроенной административной учетной записи в параметре `rootPass`, нажмите "Сохранить".
* Выполните настройку системы согласно [руководству администратора](/hostvm-vdi/hostvm-vdi-admin-guide.md).
### Настройка SSL сертификатов
По умолчанию брокер HOSTVM VDI поставляется с самоподписанным сертификатом, его использование предполагается для тестовых сред, в остальных случаях рекомендуется установка действительных сертификатов, используемых в конечной инфраструктуре.
Для замены сертификатов воспользуйтесь данной инструкцией.
#### Версия брокера 3.5 и выше
Скопируйте файлы сертификата на брокер в директорию `/etc/certs`.
Отредактируйте файл с настройками SSL `/etc/nginx/snippets/vdi-ssl-params.conf`, в директивах `ssl_certificate` и `ssl_certificate_key` укажите новые имена файлов сертификата:
```
ssl_certificate /etc/certs/server.pem; #открытая часть
ssl_certificate_key /etc/certs/key.pem; #приватный ключ
```
Чтобы проверить новую конфигурацию, выполните команду `nginx -t`, вывод команды в случае прохождения проверки:
```shell-session
# nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
```
Чтобы применить новые настройки, выполните команду:
```shell-session
# systemctl reload nginx
```
#### Версия брокера 3.0
Скопируйте файлы сертификата на брокер.
Отредактируйте конфигурационный файл `/etc/apache2/sites-available/default-ssl.conf`, в значения параметров `SSLCertificateFile` и `SSLCertificateKeyFile` запишите путь к открытой части сертификата и приватному ключу соответственно:
```
SSLCertificateFile /etc/ssl/certs/ssl-cert-snakeoil.pem
SSLCertificateKeyFile /etc/ssl/private/ssl-cert-snakeoil.key
```
Для применения изменений выполните команду:
```shell-session
# systemctl reload apache2
```
### Настройка для работы с СУБД PostgreSQL (версия 3.6)
{% hint style="info" %}
При установке версии брокера 3.6-20250704 и выше пропустите этот шаг. Для настройки используйте [мастер установки HOSTVM VDI](#setup-wizard).
{% endhint %}
По умолчанию для хранения данных брокера используется СУБД MariaDB (MySQL). Начиная с версии 3.6, дополнительно появилась поддержка СУБД PostgreSQL.
Данная инструкция предназначена для настройки локальной СУБД PostgreSQL в составе брокера. Для подключения к внешнему серверу БД, воспользуйтесь руководством [Установка и настройка выделенного сервера БД](/hostvm-vdi/hostvm-vdi-installation-guide/vdi-db.md).
Перед переключением рекомендуется сделать резервную копию файла настроек брокера `/var/server/server/settings.py`, для возможности отката конфигурации.
В консоли брокера VDI выполните команду `hostvm-vdi-pginit` для запуска мастера настройки.
Ответьте на вопросы мастера, задайте пароль пользователя БД для подключения:
```shell-session
# hostvm-vdi-pginit
Добро пожаловать в мастер настройки HOSTVM VDI Broker. Пожалуйста, заполните все поля корректными значениями. Для принятия значений по умолчанию нажимайте ENTER.
Настроить брокер на использование локальной базы данных PostgreSQL? [Y/n]: y
Внимание! Предыдущая конфигурация будет удалена, подтвердите операцию: [Y/n] y
Введите пароль пользователя БД:
Введите (еще раз) пароль пользователя БД:
Для применения новых параметров и перезапуска служб брокера нажмите ENTER []:
```
После завершения работы мастера брокер VDI будет запущен с новыми настройками БД.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-installation-guide/hostvm-vdi-ova-install.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.