# Подготовка базового образа для публикации ### Подготовка Windows ВМ в качестве рабочих станций Для управления жизненным циклом виртуальных рабочих столов на основе технологии копирования, в базовый (“золотой”) образ гостевой операционной системы Windows [устанавливается агент HOSTVM VDI](/hostvm-vdi/hostvm-vdi-installation-guide/actor.md) из дистрибутива `UDSActorSetup-3.*.*.exe`. **Примечание:** перед установкой необходимо получить IP-адрес или FQDN брокера HOSTVM VDI, учетные данные пользователя с правами администратора и как минимум один аутентификатор, зарегистрированный на этом брокере. После скачивания дистрибутива Actor для ОС Windows и его загрузки на машину-шаблон (базовый образ), запустите его для начала процесса установки. После этого: 1. Выберите язык установщика; 2. Укажите путь установки Actor; 3. Нажмите «Установить» («Install»), чтобы продолжить установку; 4. После завершения установки перейдите к настройке Actor. На вкладке «Сервер UDS» («UDS Server») необходимо зарегистрировать Actor в брокере HOSTVM VDI, указав следующие параметры: * проверка SSL (SSL Validation) – тип проверки безопасности при соединении с брокером HOSTVM VDI; * сервер UDS (UDS Server) – имя или IP-адрес брокера HOSTVM VDI; * аутентификатор (authenticator) – аутентификатор брокера, которому принадлежит указываемый ниже пользователь с правами администратора, для регистрации Actor. Для отображения перечня аутентификаторов должна быть связь с брокером HOSTVM VDI. Аутентификатор «Администрирование» («Administration») соответствует суперпользователю (root), создаваемому при первоначальной настройке брокера. Другие типы аутентификаторов будут присутствовать в списке, если они были настроены в брокере; * имя пользователя (username) – имя пользователя с правами администратора в среде HOSTVM VDI (должен принадлежать ранее выбранному аутентификатору); * пароль (password) – пароль пользователя. Как только параметры будут указаны, следует нажать кнопку «Зарегистрироваться в UDS» («Register with UDS»). Чтобы проверить правильность подключения к серверу HOSTVM VDI, необходимо нажать кнопку «Проверить конфигурацию» («Test configuration»). ![](/files/-ME1kHpu_P6s7BdYVNJy) На вкладке «Дополнительно» («Advanced») можно указать указать следующие дополнительные параметры: * Preconnect – сценарий, запускаемый непосредственно перед подключением пользователя к виртуальному рабочему столу. Брокер HOSTVM VDI автоматически передаст следующие параметры, которые можно использовать в сценарии: имя пользователя, протокол (rdp, nx, pcoip ...), IP адрес клиента (SRC IP), имя клиента (SRC Host); * Runonce – сценарий, который запускается только один раз до того, как Actor применит свои настройки. После выполнения он удаляется из конфигурации. Параметры могут быть переданы прямо в него. Выполняемый сценарий необходимо завершить, перезапустив виртуальный рабочий стол. В противном случае рабочий стол никогда не применит настройки Actor, не позволяя ему достичь состояния «Действительный» («Valid») в панели управления брокера HOSTVM VDI; * Postconfig – сценарий, который выполняется, когда Actor завершает базовую настройку. Параметры могут быть переданы прямо в него. Сценарий запускается только один раз, но, в отличие от «Runonce», перезапускать виртуальный рабочий стол не требуется. Этот сценарий полезен для добавления некоторых собственных элементов в конфигурацию, созданную Actor, например, копирование файлов из локальной сети, выполнение скриптов конфигурации и т.д.; * Log Level – уровень логирования для отображения в файлах журнала Actor. Эти файлы журналов (udsactor.log) расположены в следующих местах: `%temp%` (путь к временным файлам пользователя) и `C:\Windows\Temp` (путь к временным файлам ОС). После установки и настройки Actor машина-шаблон (“золотой” образ) должна быть выключена, и будет доступна для использования брокером HOSTVM VDI для развертывания виртуальных рабочих столов на основе технологии клонирования. **Примечание:** в дополнение к установке Actor на уровне ОС необходимо обеспечить возможность работы протокола подключения, который в дальнейшем будет использоваться для подключения к созданным рабочим столам (например, включить возможность удаленного доступа к рабочему столу (RDP), установить клиент PCoIP и т.д.). ### Подготовка Linux ВМ в качестве рабочих станций Для управления жизненным циклом виртуальных рабочих столов на основе технологии копирования, в базовый (“золотой”) образ гостевой операционной системы Linux [устанавливается агент HOSTVM VDI](/hostvm-vdi/hostvm-vdi-installation-guide/actor.md). #### Установка и настройка VDI Actor версии 2.2 **Примечание:** перед установкой необходимо получить IP-адрес или FQDN брокера HOSTVM VDI. После загрузки на машину-шаблон (“золотой” образ) требуемой версии дистрибутива Actor (в соответствии с типом используемой операционной системы) можно приступать к установке: 1. Перейдите в директорию, куда был загружен дистрибутив Actor и запустите установку (пример для машины с Debian): `dpkg -i udsactor_2.2.0_all.deb` Установка может завершиться с ошибками при наличии неразрешенных зависимостей. Для решения необходимо выполнить следующие команды: `apt-get update && apt-get install -f` 2. После процессе установки нужно сконфигурировать Actor (в дальнейшем эта возможно сделать также в графической оболочке, выбрав в списке приложений и запустив Uds Actor Configuration) внесением следующих далее параметров; 3. Ввести IP-адрес брокера HOSTVM VDI; 4. Выбрать тип подключения Actor к брокеру; 5. Также нужно указать «UDS Master Key», который был создан при установке брокера. Для того, чтобы получить этот ключ, нужно зайти в панель управления брокера HOSTVM VDI (с использованием учетной записи с правами администратора), перейти в меню в Tools -> Configuration на вкладку «Security» и скопировать ключ из поля «Master Key»; 6. Полученный ключ необходимо вставить в мастер настройки Actor; 7. После ввода всех необходимых данных выполните проверку подключения Actor к серверу HOSTVM VDI посредством нажатия кнопки «Test parameters»; ![п.3 Ввести IP-адрес брокера HOSTVM VDI](/files/-ME1kS14lcMrycDUg_ZX) ![п.4 Выбрать тип подключения Actor к брокеру](/files/-ME1jEQZjm-w9ZEloQNP) ![п.5 Получить Master Key](/files/gXFWaGXNC5gEh7RGoxf5) ![п.6 Вставить полученный ключ](/files/-ME1jmbUKL7fQAOKc0OO) ![п.7 Проверка подключения](/files/-ME1k8iZ8Bj8_rxm4cP9) После установки и настройки Actor машина-шаблон (“золотой” образ) должна быть выключена, и будет доступна для использования брокером HOSTVM VDI для развертывания виртуальных рабочих столов на основе технологии клонирования. #### Установка и настройка VDI Actor версии 3 **Примечание:** перед установкой необходимо получить IP-адрес или FQDN брокера HOSTVM VDI, учетные данные пользователя с правами администратора и как минимум один аутентификатор, зарегистрированный на этом брокере. После загрузки на машину-шаблон (“золотой” образ) требуемой версии дистрибутива Actor (в соответствии с типом используемой операционной системы) можно приступать к установке. Рекомендуется выполнять установку пакета Actor через командную консоль. При получении уведомления об ошибке из-за отсутствия зависимостей следует установить их. После установки необходимых зависимостей следует запустить конфигурацию Actor. На вкладке «Сервер UDS» («UDS Server») необходимо зарегистрировать Actor в брокере VDI, указав следующие параметры: * проверка SSL (SSL Validation) – тип проверки безопасности при соединении с брокером HOSTVM VDI; * сервер UDS (UDS Server) – имя или IP-адрес брокера HOSTVM VDI; * аутентификатор (authenticator) – аутентификатор брокера, которому принадлежит указываемый ниже пользователь с правами администратора, для регистрации Actor. Для отображения перечня аутентификаторов должна быть связь с брокером HOSTVM VDI. Аутентификатор «Администрирование» («Administration») соответствует суперпользователю (root), создаваемому при первоначальной настройке брокера. Другие типы аутентификаторов будут присутствовать в списке, если они были настроены в брокере; * имя пользователя (username) – имя пользователя с правами администратора в среде HOSTVM VDI (должен принадлежать ранее выбранному аутентификатору); * пароль (password) – пароль пользователя. Как только параметры будут указаны, следует нажать кнопку «Зарегистрироваться в UDS» («Register with UDS»). Чтобы проверить правильность подключения к брокеру HOSTVM VDI, необходимо нажать кнопку «Проверить конфигурацию» («Test configuration»). На вкладке «Дополнительно» («Advanced») можно указать следующие дополнительные параметры: * Preconnect – сценарий, запускаемый непосредственно перед подключением пользователя к виртуальному рабочему столу. Брокер HOSTVM VDI автоматически передаст следующие параметры, которые можно использовать в сценарии: имя пользователя, протокол (rdp, nx, pcoip ...), IP адрес клиента (SRC IP), имя клиента (SRC Host); * Runonce – сценарий, который запускается только один раз до того, как Actor применит свои настройки. После выполнения он удаляется из конфигурации. Параметры могут быть переданы прямо в него. Выполняемый сценарий необходимо завершить, перезапустив виртуальный рабочий стол. В противном случае рабочий стол никогда не применит настройки Actor, не позволяя ему достичь состояния «Действительный» («Valid») в панели управления брокера HOSTVM VDI; * Postconfig – сценарий, который выполняется, когда Actor завершает базовую настройку. Параметры могут быть переданы прямо в него. Сценарий запускается только один раз, но, в отличие от «Runonce», перезапускать виртуальный рабочий стол не требуется. Этот сценарий полезен для добавления некоторых собственных элементов в конфигурацию, созданную Actor, например, копирование файлов из локальной сети, выполнение скриптов конфигурации и т.д.; * Log Level – уровень логирования для отображения в файлах журнала Actor. Эти файлы журналов (udsactor.log) расположены по пути: `/var/log/` После установки и настройки Actor машина-шаблон (“золотой” образ) должна быть выключена, и будет доступна для использования брокером HOSTVM VDI для развертывания виртуальных рабочих столов на основе технологии клонирования. **Примечание:** в дополнение к установке Actor на уровне ОС необходимо обеспечить возможность работы протокола подключения, который в дальнейшем будет использоваться для подключения к созданным рабочим столам (например, установка и настройка XRDP, X2Go Server и т.д.). ### Особенности подготовки ВМ с ОС ALT-Linux 10.0 в качестве рабочих станций В Alt Linux стандартный пакет `udsactor-3.*.noarch.rpm` не устанавливается из-за неразрешимых зависимостей. Нужно поставить зависимости вручную: `apt-get install python3-module-PyQt5 python3-module-requests python3-module-six` И установить актор из пакета для alt linux: `rpm -Uvh udsactor-3.*.noarch.rpm` Пакет актора можно загрузить из личного кабинета HOSTVM. Также после установки актор нужно настроить – указать адрес брокера HOSTVM VDI и Учётную запись администратора. ![](/files/oEVvlx7xPPxoLE8qyCCa) Нажатие Test configuration должно проходить успешно. --- # 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 https://kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-admin-guide/base-image-preparation.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.