Руководство по публикации приложений в метапоставщике с MS RDSH

Данную инструкцию рекомендуется использовать для подготовки тестового стенда.

Публикация приложений в метапоставщике выполняется в следующей последовательности:

• шаг 1. Настройка образа виртуальной машины (ВМ) для использования в качестве метапоставщика;
• шаг 2. Активация экспериментального параметра метапоставщика в Termidesk;
• шаг 3. Установка плагина расширения InternalDB;
• шаг 4. Предварительные настройки Termidesk;
• шаг 5. Добавление метапоставщика в качестве поставщика ресурсов в Termidesk;
• шаг 6. Публикация фонда с приложением на базе метапоставщика;
• шаг 7. Настройка фонда ВРМ с публикацией приложения;
• шаг 8. Получение приложения через компонент «Клиент» (далее — Клиент) Termidesk.

В производственной эксплуатации конфигурацию необходимо вводить в домен MS Active Directory. При вводе конфигурации в домен, необходимо выполнить дополнительные настройки в шаге 1. Использование конфигурации без ввода в домен рекомендуется только на тестовых стендах.

В процессе проведения публикации приложения использована следующая среда:

Для подключения к опубликованному приложению используется Клиент версии 5.0.

При установке ОС Microsoft Windows Server 2019 и выше, утилита curl устанавливается по умолчанию. При использовании устаревших версий curl (менее 8.0) стоит учитывать отсутствие поддержки русского языка.

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

Создание локального пользователя

В качестве примера в ОС был создан пользователь user1. Учeтные данные пользователя будут использоваться для подключения к метапоставщику с использованием домена аутентификации Внутренняя БД.

Для создания локального пользователя в ОС Microsoft Windows Server 2019 следует нажать клавиши <Win+R>. В открывшемся окне «Выполнить» ввести команду control userpasswords2 и нажать экранную кнопку [OK].

В открывшемся окне «Учетные записи пользователей» нажать экранную кнопку [Добавить…].

В форме «Добавление пользователя» следует заполнить соответствующие данные и нажать экранную кнопку [Далее].

В окне «Учетные записи пользователей» следует выбрать учетную запись созданного пользователя и нажать экранную кнопку [Свойства].

В открывшемся окне «Свойства» учетной записи пользователя следует назначить соответствующую группу для доступа к удаленному приложению и нажать экранную кнопку [Применить].

При использовании сессионного Агента версии 4.2.1 и выше, шаг с установкой службы MS RDSH можно пропустить.

> Install-WindowsFeature -Name RDS-RD-Server

• выполнить перезапуск сервера:

> Restart-Computer

• установить сессионный Агент из msi-пакета termidesk-session-agent;
• установить Агент ВРМ из msi-пакета termidesk-agent.

После установки Агенты обязательно должны быть настроены.

Пример файла session_agent.ini:

[AGENT]
LISTEN_IP = 0.0.0.0
LISTEN_PORT = 31000
HEALTH_CHECK_ACCESS_KEY = None
INSTALL_RDS_ROLE_ON_NEXT_BOOT = True

[SSL]
USE_HTTPS = False
CERTIFICATE_PATH = C:\ProgramData\UVEON\Termidesk Session Agent\certs\cert.pem
PRIVATE_KEY_PATH = C:\ProgramData\UVEON\Termidesk Session Agent\certs\key.pem

[LOGGING]
LEVEL = INFO
ROTATION_LIMIT = 5
MAX_FILE_SIZE = 2097152

Подробное описание параметров конфигурационного файла приведено в таблице Параметры конфигурирования сессионного Агента.

• перезапустить службу сессионного Агента:

> Restart-Service TermideskSessionAgentService

• проверить состояние службы сессионного Агента:

> Get-Service -Name TermideskSessionAgentService

Столбец «Status» отображает состояние сервиса, где статус «Running» свидетельствует об успешном запуске сессионного Агента.

Публикация приложения

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

В ОС Microsoft Windows Server 2019 представлено 2 способа публикации приложения:

• публикация с помощью утилиты RemoteApp Tool;
• публикация с помощью сессионного Агента.

Вариант 1. Публикация приложения с помощью утилиты RemoteApp Tool

Не рекомендуется использовать данный вариант публикации для приложений с кириллическим названием.

Для публикации приложений с использованием данного варианта нужно:

• скачать утилиту RemoteApp Tool: https://github.com/kimmknight/remoteapptool#download;
• установить утилиту из msi-пакета, следуя инструкциям по установке;
• в окне утилиты нажать экранную кнопку «+» и указать расположение исполняемого файла публикуемого приложения;

Добавление публикуемого приложения

• отображение приложения в окне утилиты свидетельствует о его успешной публикации.

Успешная публикация приложения

Вариант 2. Публикация приложения с помощью сессионного Агента

Предусмотрено 2 способа публикации приложения с помощью сессионного Агента:

• с использованием веб-интерфейса сессионного Агента;
• с использованием утилиты curl.

В качестве примера используется адрес локальной установки сессионного Агента (запросы формируются на том же узле, где он установлен) — 127.0.0.1 и порт 31000.

Просмотр списка доступных для публикации приложений

Предусмотрено 2 способа просмотра списка доступных для публикации приложений с помощью сессионного Агента:

• с использованием веб-интерфейса сессионного Агента;
• с использованием утилиты curl.

Просмотр списка доступных для публикации приложений в веб-интерфейсе сессионного Агента

Для просмотра списка доступных для публикации приложений приложения нужно:

• используя веб-браузер, перейти по адресу: 127.0.0.1:31000/docs;
• в разделе «Meta» раскрыть POST-запрос /meta/available_apps и нажать экранную кнопку [Try it out];

Запрос списка доступных для публикации приложений

• затем нажать экранную кнопку [Execute] для выполнения GET-запроса.

Выполнение GET-запроса списка доступных для публикации приложений

Успешное выполнение запроса сгенерирует ответ в поле «Response body». Значение строки available_apps отобразит список приложений, доступных для публикации.

Список доступных для публикации приложений

Просмотр списка доступных для публикации приложений с помощью утилиты curl

Для просмотра списка доступных для публикации приложений нужно:

• открыть от имени администратора утилиту Командная строка;
• отправить GET-запрос:

curl -X GET http://127.0.0.1:31000/meta/available_apps -H "accept: application/json" -H "Authorization: Bearer <значение строки access_token без кавычек>"

BASH

Успешное выполнение запроса сгенерирует список приложений, доступных для публикации:

{"available_apps": {"Paint": "C:\\Windows\\system32\\mspaint.exe"}}

BASH

В ответе были предоставлены параметры:

• «"Paint"» — название приложения, доступного для публикации;
• «"C:\\Windows\\System32\\mspaint.exe"» — путь к исполняемому файлу приложения.

Публикация приложения с использованием веб-интерфейса сессионного Агента

Для публикации приложения нужно:

• используя веб-браузер, перейти по адресу: 127.0.0.1:31000/docs;
• в разделе «Meta» раскрыть POST-запрос /meta/applications и нажать экранную кнопку [Try it out].

Запрос на публикацию приложения

При этом поле «Request body» станет доступно для редактирования. После заполнения параметров публикуемого приложения нажать экранную кнопку [Execute] для выполнения POST-запроса.

Выполнение POST-запроса для публикации приложения

В примере были заданы параметры:

• «name»: «Paint» — указано имя публикуемого приложения;
• «path»: «C:\\Windows\\System32\\mspaint.exe» — путь к исполняемому файлу приложения.

Успешное выполнение запроса сгенерирует ответ в поле «Response body». Значение строки {"is created": "true"} свидетельствует об успешной публикации приложения.

Ответ об успешной публикации приложения

Публикация приложения с помощью утилиты curl

Для публикации приложения нужно:

• открыть от имени администратора утилиту Командная строка;
• отправить POST-запрос:

curl -X POST http://127.0.0.1:31000/meta/applications -H "accept: application/json" -H "Authorization: Bearer <значение строки access_token без кавычек>" -H "Content-Type: application/json" -d "{ \"name\": \"Paint\", \"path\": \"C:\\Windows\\system32\\mspaint.exe\"}"

BASH

В примере были заданы параметры:

• «\"name\"»: «\"Paint\"» — указано имя публикуемого приложения;
• «\"path\"»: «\"C:\\Windows\\system32\\mspaint.exe\"» — путь к исполняемому файлу приложения.

Успешное выполнение запроса сгенерирует ответ:

{"is_created": true}

BASH

Значение строки {"is_created": "true"} свидетельствует об успешной публикации приложения.

Для проверки корректности введенных значений можно использовать экранную кнопку [Проверить]. В случае успешной проверки отобразится сообщение «Проверка успешно завершена».

Для сохранения настроек следует нажать экранную кнопку [Сохранить].

:~$ sudo -u termidesk bash

Пользователь termidesk используется в качестве примера. При выполнении команд следует переключаться на пользователя, имеющего полномочия для управления Универсальным диспетчером.

• активировать параметр поддержки метапоставщика:

:~$ /opt/termidesk/sbin/termidesk-vdi-manage tdsk_config set --section Experimental --key experimental.metasessions.provider.enabled --value 1

Шаг 3. Установка плагина расширения InternalDB

При использовании метапоставщика без ввода в домен, рекомендуется установить плагин InternalDB для обеспечения корректной авторизации в ОС Microsoft Windows. Плагин устанавливается на узле с Termidesk.

Использование плагина InternalDB рекомендуется только при настройке тестового стенда. При вводе метапоставщика в домен, рекомендуется использовать службу управления учетными записями MS Active Directory.

Экспериментальный функционал, не вошедший в основной релиз Termidesk, можно добавить в программный комплекс через установку плагинов расширений (содержатся в каталоге addons в виде zip-архивов комплектации поставки Termidesk).

Для добавления плагина InternalDB на узле с установленным Termidesk нужно:

• распаковать содержимое zip-архива в целевой каталог (например, /tmp);
• переключиться на пользователя termidesk:

:~$ sudo -u termidesk bash

• перейти в каталог Termidesk:

:~$ cd /opt/termidesk/share/termidesk-vdi/

• активировать виртуальное окружение Termidesk:

:~$ source venv/bin/activate

• установить плагин из каталога /tmp/termidesk_internaldbauth, содержащего whl-файлы:

:~$ pip install --upgrade --no-index --find-links /tmp/termidesk_internaldbauth termidesk_internaldbauth

• выйти из окружения пользователя Termidesk:

:~$ exit

• обновить структуру БД и статических файлов командами:

:~$ sudo /opt/termidesk/sbin/termidesk-vdi-manage migrate
:~$ sudo /opt/termidesk/sbin/termidesk-vdi-manage collectstatic --no-input

• перезапустить службы Termidesk:

:~$ sudo systemctl restart termidesk-vdi.service termidesk-taskman.service termidesk-celery-beat.service termidesk-celery-worker.service

При этом откроется окно «Создать новый объект (Внутренняя БД)».

Подробное описание полей приведено в таблице «Данные для добавления аутентификации через внутреннюю БД».

Для проверки правильности заполнения формы можно использовать экранную кнопку [Тест].

Для сохранения объекта следует нажать экранную кнопку [Сохранить].

При этом откроется форма «Внутренняя БД». В открывшейся форме в разделе «Группы» нажать экранную кнопку [Создать] и выбрать из выпадающего списка соответствующую группу.

При этом откроется окно «Создать новый объект (Группа)».

При этом откроется окно «Создать новый объект».

Подробное описание полей приведено в таблице «Данные для редактирования пользователя домена аутентификации».

В примере используются учетные данные пользователя, созданного в шаге 1.

При этом откроется окно «Создать новый объект (ОС Windows)». В окне нужно заполнить поля «Название», «Комментарий» (при необходимости).

При этом откроется окно «Создать новый объект (RDP (терминальный доступ))».

Подробное описание полей приведено в таблице «Данные для добавления прямого подключения к серверам терминалов».

Для проверки правильности заполнения формы можно использовать экранную кнопку [Тест].

При этом откроется окно «Создать новый объект». В открывшемся окне ввести текстовое наименование изображения, нажать экранную кнопку [Выберите изображение] и указать расположение логотипа. После загрузки логотипа нажать экранную кнопку [Сохранить].

При этом откроется окно «Создать новый объект». Для добавления параметров группы рабочих мест нужно заполнить поля «Название», «Комментарий» (при необходимости).

При этом откроется окно «Создать новый объект (Платформа oVirt/RHEV)».

Подробное описание полей приведено в таблице «Данные для добавления платформы oVirt/RHEV».

Для проверки правильности заполнения формы можно использовать экранную кнопку [Тест].

Для сохранения объекта следует нажать экранную кнопку [Сохранить].

При этом откроется форма «Шаблоны рабочих мест». В открывшейся форме нужно нажать экранную кнопку [Создать] и из выпадающего списка выбрать шаблон: «Связанный клон oVirt/RHEV».

При этом откроется окно «Создать новый объект (Связанный клон oVirt/RHEV)».

Подробное описание полей приведено в таблице «Данные для добавления шаблона на основе связанного клона для oVirt/RHEV».

При этом откроется окно «Мастер публикации фонда». В полях формы «Базовые настройки фонда» следует ввести соответствующие данные и нажать экранную кнопку [Далее].

Подробное описание полей приведено в таблице «Базовые настройки фонда».

Далее будет выполнен переход на форму «Дополнительные настройки фонда», где следует произвести дополнительные настройки фонда ВРМ.

 Подробное описание полей приведено в таблице «Дополнительные настройки фонда».

При задании количества рабочих мест в кеше 1-го уровня следует учитывать, что метапоставщик будет выполнять балансировку нагрузки между созданными ВРМ.

В форме «Завершение настройки фонда» следует нажать экранную кнопку [Завершить]. При успешном создании фонда в этом же окне должно появиться сообщение «Фонд успешно создан!», окно будет автоматически закрыто по истечении 3 секунд.

Перед публикацией обязательно проверить, что для фонда ВРМ используется политика «Действие при выходе пользователя из ОС» со значением «Нет», для того выбрать наименование фонда ВРМ и нажать экранную кнопку [Политики].

Далее на странице фонда ВРМ в разделе «Публикации» нажать экранную кнопку [Создать].

В окне «Новая публикация» в раскрывающемся списке выбрать ВМ, на основе которой будет выполняться тиражирование ВРМ. После ввода опционального текстового комментария нажать экранную кнопку [Опубликовать] для запуска задачи создания фонда ВРМ.

Сразу после публикации в столбце «Прогресс» будет отображена индикация серым цветом, указывающая на начало процесса публикации. Далее индикация синим цветом будет отображать прогресс выполнения публикации. Необходимо дождаться индикации зеленым цветом, сообщающей об успешном завершении процесса публикации.

Подробная информация о прогрессе публикаций содержится в подразделе Публикация фонда ВРМ.

При этом откроется окно «Мастер публикации фонда». В полях формы «Тип публикации» следует выбрать соответствующую службу для публикации и нажать экранную кнопку [Далее].

Далее будет выполнен переход на форму «Поставщик», где следует выбрать поставщика ресурсов для размещения публикации.

В форме «Параметры нового поставщика» следует заполнить параметры поставщика ресурсов для его создания.

Подробное описание полей приведено в таблице «Данные для добавления сервера терминалов (метапоставщик)».

На следующем шаге задать наименование приложения и выбрать приложение для публикации.

В форме «Настройки фонда» нужно заполнить поля «Название», «Изображение» и «Группа».

На следующем шаге задать домен аутентификации и группу пользователей, входящую в этот домен, которым будет доступен фонд. Шаг опционален: параметры можно добавить после завершения работы мастера публикации, в созданном фонде на странице «Рабочие места - Фонды».

Затем выбрать пользователя домена аутентификации. Шаг опционален: параметры можно добавить после завершения работы мастера публикации, в созданном фонде на странице «Рабочие места - Фонды».

Далее выбрать протокол доставки, который будет доступен для фонда. Протокол доставки можно добавить и/или изменить после завершения работы мастера публикации в созданном фонде на странице «Рабочие места - Фонды».

В следующем окне ознакомиться с параметрами будущего фонда и завершить настройку, нажав экранную кнопку [Завершить].

При этом откроется форма «Политики». В открывшейся форме следует выделить политику «Механизм обеспечения безопасности на уровне сети (RDP)» и нажать экранную кнопку [Изменить].

При этом откроется окно «Изменить Механизм обеспечения безопасности на уровне сети (RDP)». Для корректного подключения к опубликованному приложению через Клиент в раскрывающемся списке окна «Изменить Механизм обеспечения безопасности на уровне сети (RDP)» нужно выбрать значение «NLA».

• в открывшемся окне «Добавление нового сервера» ввести IP-адрес Универсального диспетчера и нажать экранную кнопку [Да];

• в полях окна «Настройка подключения к серверу» нужно заполнить соответствующие поля и нажать экранную кнопку [Да];

• созданный сервер отобразится в списке Клиента. Для подключения к серверу нажать экранную кнопку [Подключиться];

• в открывшемся окне выбрать приложение «Paint»;

• в окне «Подключение к удалённому рабочему столу» нажать экранную кнопку [Подключить];

Для подключения к опубликованному приложению без подтверждения рекомендуется включить параметр «Больше не выводить запрос о подключениях к этому компьютеру».

• в случае успешного подключения Клиент отобразит окно с опубликованным приложением.