> 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/update-guide.md).
# Обновление компонентов VDI
## HOSTVM VDI брокер
### Замена виртуальной машины
> Данный способ является универсальным для всех версий 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"](/hostvm-vdi/hostvm-vdi-installation-guide/hostvm-vdi-ova-install.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 сертификатов](/hostvm-vdi/hostvm-vdi-installation-guide/hostvm-vdi-ova-install.md#ssl-certificates) брокера.
### Обновление виртуальной машины
> Данный способ поддерживается только для версии 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
```
### Обновление брокера VDI на РЕД ОС
> Данный способ поддерживается только для версии 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
```
### Обновление брокера VDI на ALT Linux
> Данный способ поддерживается только для версии 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
```
## HOSTVM VDI туннелер
### Замена виртуальной машины
> Данный способ является универсальным для всех версий HOSTVM VDI Tunneler.
Обновление осуществляется путем разворачивания новой версии виртуальной машины туннелера и подключения к брокеру HOSTVM VDI согласно статье ["Установка HOSTVM VDI Tunneler"](/hostvm-vdi/hostvm-vdi-installation-guide/tunneler-appliance-deploy.md).
При задании сетевых настроек, идентичных старой версии туннелера, дополнительной конфигурации со стороны брокера не требуется.
Если будет использоваться другой IP адрес, необходимо создать соответствующие транспорты для туннельных подключений в панели управления брокера, с использованием нового адреса.
### Обновление виртуальной машины
> Данный способ поддерживается только для версии 3.6.
Обновите виртуальную машину:
```shell-session
# apt update
# apt upgrade
```
При необходимости перезапустите ее.
> DEB пакеты доступны для загрузки в личном кабинете HOSTVM.
Загрузите пакет `hostvm-gw_3.6-<номер сборки>.deb` на ВМ и установите обновление:
```shell-session
# apt install /tmp/hostvm-gw_3.6-20241004.deb
```
> Если конфигурация туннелера еще не была выполнена, запустите мастер настройки `hostvm-setup`.
Перезапустите службы:
```shell-session
# systemctl restart vditunnel.service guacd.service tomcat9.service
```
### Установка обновления на РЕД ОС
> Данный способ поддерживается только для версии 3.6.
Обновление осуществляется путём установки пакета hostvm-gw новой версии.
Скачайте новую версию пакета из личного кабинета, затем выполните установку:
```shell-session
$ sudo yum install ./hostvm-gw-3.6-4.el7.x86_64.rpm
```
### Установка обновления на ALT Linux
> Данный способ поддерживается только для версии 3.6.
Обновление осуществляется путём установки пакета hostvm-gw новой версии.
Скачайте новую версию пакета из личного кабинета, затем выполните установку:
```shell-session
# apt-get install ./hostvm-gw-3.6-alt4.x86_64.rpm
```
---
# 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/update-guide.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.