# Брокер HOSTVM VDI

Способы установки минорных обновлений на Брокер HOSTVM VDI.\
При обновлении на новую мажорную версию обратитесь к соответствующему разделу документации, либо в техническую поддержку.

## Замена виртуальной машины <a href="#broker-replace" id="broker-replace"></a>

> Данный способ является универсальным для всех версий HOSTVM VDI Broker.

> В примере описана процедура обновления в рамках мажорной версии 3.6, для конфигурации "один брокер со встроенной БД MariaDB". В случае обновления других конфигураций обратитесь в техническую поддержку.

Обновление осуществляется путем переноса базы и настроек на новую ВМ брокера. В момент переноса портал и сервисы пользователей будут недоступны.

Создайте резервную копию БД:

```shell-session
# mysqldump -u root --single-transaction udsdb > backup.sql
```

Скопируйте файл резервной копии на внешний ресурс.

Сохраните файл конфигурации брокера `/var/server/server/settings.py`

Сохранить сетевые настройки из файла `/etc/network/interfaces` и имя машины, если их планируется переносить на новую ВМ.

Выключите ВМ.

Импортируйте новую версию ВМ брокера согласно статье ["Установка HOSTVM VDI Broker"](/url/kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-installation-guide/broker/virtual-appliance.md), до момента авторизации в веб-интерфейсе управления.

Настройки сети и имя машины задайте от старой версии ВМ брокера, если применимо.

Скопируйте с внешнего ресурса и разверните резервную копию БД:

```shell-session
# systemctl stop vdi.service
# cat backup.sql | /usr/bin/mysql -u root udsdb
```

Перенесите сохраненный файл конфигурации брокера `/var/server/server/settings.py` на ВМ.

Перезапустите службы:

```shell-session
# systemctl restart vdi.service vdiweb.service
```

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

*Дополнительно*: выполните [настройку SSL сертификатов](/url/kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-installation-guide/broker/virtual-appliance.md#ssl-certificates) брокера.

## Обновление виртуальной машины <a href="#broker-update" id="broker-update"></a>

> Данный способ поддерживается начиная с версии 3.6.

Обновите виртуальную машину:

```shell-session
# apt update
# apt upgrade
```

При необходимости перезапустите ее.

> DEB пакеты доступны для загрузки в личном кабинете HOSTVM.

Загрузите пакет `hostvm-vdi_3.6-<номер сборки>.deb` на ВМ и установите обновление:

```shell-session
# apt install /tmp/hostvm-vdi_3.6-20241015.deb
```

{% hint style="warning" %}
При установке обновления версии **3.6-20250314** дополнительно выполните следующие команды:

```shell-session
# cd /var/server
# python3 manage.py migrate
```

{% endhint %}

После завершения установки обновления перезапустите службы:

```shell-session
# systemctl restart vdi.service vdiweb.service
```

## Установка обновления на РЕД ОС <a href="#broker-redos-update" id="broker-redos-update"></a>

> Данный способ поддерживается начиная с версии 3.6.

Обновление осуществляется путём установки пакета hostvm-vdi новой версии.

Скачайте и разархивируйте пакет из личного кабинета:

```shell-session
$ tar -xvf ./hostvm-vdi<номер версии>-<номер сборки>.rpm.tar.bz2
```

Установите скачанный пакет:

```shell-session
$ sudo yum install ./hostvm-vdi-3.6-4.el7.x86_64.rpm --allowerasing
```

{% hint style="warning" %}
При установке обновления версии **3.6-4** (номер сборки **20250314**) дополнительно выполните следующие команды:

```shell-session
# cd /var/server
# python3 manage.py migrate
```

{% endhint %}

После завершения установки обновления перезапустите службы:

```shell-session
# systemctl restart vdi.service vdiweb.service
```

## Установка обновления на ALT Linux <a href="#broker-alt-update" id="broker-alt-update"></a>

> Данный способ поддерживается начиная с версии 3.6.

Обновление осуществляется путём установки пакета hostvm-vdi новой версии.

Скачайте новую версию пакета из личного кабинета, установите:

```shell-session
# apt-get install ./hostvm-vdi-3.6-alt4.x86_64.rpm
```

{% hint style="warning" %}
При установке обновления версии **3.6-4** (номер сборки **20250314**) дополнительно выполните следующие команды:

```shell-session
# cd /var/server
# python3 manage.py migrate
```

{% endhint %}

После завершения установки обновления перезапустите службы:

```shell-session
# systemctl restart vdi.service vdiweb.service
```


---

# Agent Instructions: 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 http://localhost:3000/url/kb.pvhostvm.ru/hostvm-vdi/upgrade-guide/updates-between-minor-releases/broker.md?ask=<question>
```

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.