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

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

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

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

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

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

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

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

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

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

Создание локального пользователя в ОС ALSE выполняется командой:

sudo useradd -m -d /home/<домашний_каталог> <имя_пользователя>

где:

-m —  создание домашнего каталога, если он не существует;

-d — путь к домашнему каталогу.

Для созданного пользователя нужно задать пароль:

sudo passwd <имя_пользователя>

Установка STAL

ОС, на которой разворачивается STAL, должна быть установлена с графическим интерфейсом.

Для получения пакетов установки нужно:

• подключить локальный репозиторий Termidesk на узле, где предполагается установка;
• в файле /etc/apt/sources.list включить следующие источники пакетов (репозитории):

deb https://download.astralinux.ru/astra/stable/1.7_x86-64/repository-base/ 1.7_x86-64 main contrib non-free
deb https://download.astralinux.ru/astra/stable/1.7_x86-64/repository-extended/ 1.7_x86-64 main contrib non-free

При наличии в файле /etc/apt/sources.list репозитория astra-ce нужно закомментировать его, чтобы избежать установки несовместимых версий пакетов:

# Расширенный репозиторий (компонент astra-ce)
#deb https://dl.astralinux.ru/astra/stable/1.7_x86-64/repository-extended/ 1.7_x86-64 astra-ce

BASH

• обновить данные пакетного менеджера:

:~$ sudo apt update

Для установки STAL нужно выполнить следующие шаги:

• установить STAL:

:~$ sudo apt install stal-rdp-transport
:~$ sudo apt install stal

• после установки основных пакетов STAL нужно установить пакеты поддержки функциональности:

:~$ sudo apt install stal-multimedia stal-redirect-api stal-redirect-drive stal-redirect-print stal-redirect-clip stal-redirect-scard

где:

stal-multimedia - пакет поддержки проигрывания звука;

stal-redirect-api - пакет базового API, от которого зависят следующие пакеты;

stal-redirect-drive - пакет реализации перенаправления диска;

stal-redirect-print - пакет реализации перенаправления принтера;

stal-redirect-clip - пакет реализации буфера обмена;

stal-redirect-scard - пакет реализации перенаправления смарт-карт.

• проверить состояние STAL:

:~$ sudo systemctl status stal-proxy
:~$ sudo systemctl status termidesk-stal
:~$ sudo systemctl status stal-rdpepc
:~$ sudo systemctl status stal-watchdog

Строка Active отображает состояние сервиса, где статус active (running)означает успешный запуск.

:~$ sudo apt install -y qemu-guest-agent spice-vdagent xserver-xorg-video-qxl

• установить пакет libcanberra-pulse для корректной работы аудио:

:~$ sudo apt install -y libcanberra-pulse

• привести файл /etc/acpi/events/powerbtn-acpi-support к виду:

event=button/power
action=/sbin/poweroff

При необходимости ввести метапоставщик в домен нужно:

• для ввода в домен MS AD установить пакет astra-ad-sssd-client:

:~$ sudo apt install -y astra-ad-sssd-client

• для ввода в домен FreeIPA установить пакет astra-freeipa-client:

:~$ sudo apt install -y astra-freeipa-client

В случае возникновения ошибки: «Не удалось создать сессию в STAL» при подключении к метапоставщику через Клиент, на узле с установленным метапоставщиком рекомендуется отключить (systemctl --now mask) и удалить (apt remove) встроенную программу для управления сетевыми соединениями network-manager:

:~$ sudo systemctl --now mask NetworkManager && sudo apt remove network-manager

BASH

После удаления службы network-manager нужно отредактировать файл /etc/network/interfaces. Конфигурацию файла следует привести в соответствие схеме адресации, принятой в инфраструктуре предприятия и выполнить перезапуск службы сети:

:~$ sudo systemctl restart networking

BASH

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

:~$ sudo apt install termidesk-session-agent

После установки следует проверить состояние службы termidesk-session-agent:

:~$ sudo systemctl status termidesk-session-agent

Строка Active отображает состояние сервиса, где статус active (running)или active (exited)свидетельствует об успешном запуске Агента и его готовности к работе.

• ввести пароль суперпользователя ОС;
• указать параметры конфигурирования.

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

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

Для проверки состояния службы Агента ВРМ ввести команду:

:~$ sudo systemctl status termidesk-agent

Строка Active отображает состояние сервиса, где статус active (running) или active (exited) свидетельствует об успешном запуске Агент ВРМ и его готовности к работе.

:~$ 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 для обеспечения корректной авторизации в ОС ALSE. Плагин устанавливается на узле с Универсальным диспетчером.

Использование плагина InternalDB рекомендуется только при настройке тестового стенда.

Экспериментальный функционал, не вошедший в основной релиз 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

• установить плагин:

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

где /tmp/termidesk_internaldbauth — каталог с whl-файлами;

• выйти из окружения пользователя 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для этого следует перейти к настройкам политик публикуемого приложения и для параметра «Политика управления глубиной цвета (RDP)» задать значение «32 бит».

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

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

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

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

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

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

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