Переменные окружения и другие параметры конфигурирования

В Termidesk используются переменные окружения и аргументы интерфейса командной строки (CLI) для указания параметров настройки компонентов программного комплекса.

Агент ВРМ предусматривает возможность конфигурирования переносимых профилей и настройки аутентификации пользователей ВРМ через файл с помощью модуля pam_tdsk:

Переопределение параметров настройки Агента ВРМ может быть произведено:

  • через интерфейс CLI и задание параметров функционирования с помощью аргументов командной строки;
  • через переменные окружения.  Использование переменных окружения может быть задано следующими способами:
    • непосредственно в сервисном файле /lib/systemd/system/termidesk-agent.service. Для это нужно изменить указанный файл, добавив в секцию service либо переменную и ее значение (в примере Environment=TDSK_VDI_URL=192.0.2.30), либо указать файл с назначенными переменными:
Environment=TDSK_VDI_URL=192.0.2.30
EnvironmentFile=<путь_к_файлу_с_переменными_окружения>
BASH

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

:~$ sudo systemctl daemon-reload
:~$ sudo systemctl restart termidesk-agent.service
BASH
    • через интерфейс CLI и аргумент --env;
    • через задание переменной окружения TDSK_VDI_ENV.

Перечень переменных окружения и аргументов CLI, используемых Агентами, приведены в таблицах: переменные окружения Агента ВРМпеременные окружения Агента УВпеременные окружения видеоагентапеременные окружения Агента смарт-карт.

Для использования интерфейса командной строки Агента ВРМ в ОС Microsoft Windows нужно:

  • открыть командную строку от имени администратора;
  • вызывать Агент ВРМ из каталога C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe;
  • перенаправить вывод команды в файл. В указанном файле будет показан результат выполнения команды.

Пример получения полной информации по доступным аргументам командной строки с выводом в файл C:\agent_help_all.txt:

C:\Users\user>"C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" -h > C:\agent_help_all.txt
BASH
Переменные окружения Агента ВРМ

Переменная окруженияЗначение по умолчаниюОписаниеАргумент командной строки
TDSK_VDI_URLНе задано

Задает значение IP-адреса для подключения к компоненту «Универсальный диспетчер».

В переменной TDSK_VDI_URL задается URL-строка с IP-адресом компонента «Универсальный диспетчер».

При использовании аргумента --host задается только IP-адрес компонента «Универсальный диспетчер».

Пример для ОС Linux:

:~$ sudo termidesk-agent-config update --host 192.0.2.30
BASH

Пример для ОС Microsoft Windows:

C:\Users\user>"C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --host 192.0.2.30
BASH

где 192.0.2.30 - IP-адрес компонента «Универсальный диспетчер».

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

Для вызова справки нужно ввести команду:

:~$ sudo termidesk-agent-config update --help
BASH
--host
TDSK_VDI_KEYНе задано

Задает значение мастер-ключа для подключения к компоненту «Универсальный диспетчер».

Для получения значения мастер-ключа в «Портале администратора» компонента «Универсальный диспетчер» нужно перейти «Настройки - Системные параметры - Безопасность».

Пример ОС Linux:

:~$ sudo termidesk-agent-config update --key 0123456789
BASH

Пример для ОС Microsoft Windows:

C:\Users\user>"C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --key 0123456789
BASH
--key
TDSK_VDI_SSLНе задано

Включение использования защищенного SSL-соединения.

Пример ОС Linux:

:~$ sudo termidesk-agent-config update --ssl
BASH

Пример для ОС Microsoft Windows:

C:\Users\user>"C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --ssl
BASH

Отключение параметра выполняется в графическом режиме Агента ВРМ или с помощью команды:

Команда сбрасывает все настройки Агента ВРМ до значений по умолчанию.

:~$ sudo termidesk-agent-config delete
BASH
--ssl
TDSK_VDI_ENVНе задано

Включение подстановки значений параметров из переменных окружения.

Пример ОС Linux:

:~$ sudo termidesk-agent-config update --env
BASH

Пример для ОС Microsoft Windows:

C:\Users\user>"C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --env
BASH

Отключение параметра выполняется в графическом режиме Агента ВРМ или с помощью команды:

Команда сбрасывает все настройки Агента ВРМ до значений по умолчанию.

:~$ sudo termidesk-agent-config delete
BASH
--env
TDSK_VDI_LOGLEVELНе задано

Задает категорию сообщений, которые будут записываться в журнал Агента ВРМ (возможные значения: DEBUG, INFO).

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

Пример ОС Linux:

:~$ sudo termidesk-agent-config update --loglevel INFO
BASH

Пример для ОС Microsoft Windows:

C:\Users\user>"C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --loglevel INFO
BASH
--loglevel
TDSK_PIDFILE/var/run/termidesk.pid

Данный параметр применяется только для Агента ВРМ на ОС Linux.

Задает путь к файлу журнала с идентификаторами запущенных приложений

Не задано
Не заданаНе задано

Данный параметр применяется только для Агента ВРМ на ОС Linux.

Команда для входа в графическую сессию пользователя ВРМ.

Для работы команды должна выть включена технология единого входа.

Пример:

:~$ sudo termidesk-agent-config dmctl login --user-name USER --user-password PASSWORD
BASH

где:

USER - имя пользователя;

PASSWORD - пароль пользователя.

Для вызова справки нужно ввести команду:

:~$ sudo termidesk-agent-config dmctl login --help
BASH

dmctl login

В Агенте УВ используется аналог интерфейса virsh для отправки команд через CLI.

Переменные окружения Агента УВ

Переменная окруженияЗначение по умолчаниюОписаниеАргумент командной строки
Не задано Не задано

Используется для проброса устройств или их отключения.

Аргумент командной строки вызывается через virsh.

Пример:

:~$ sudo termidesk-vmsd virsh attach-device
BASH

Для вызова справки нужно ввести команды:

:~$ sudo termidesk-vmsd virsh attach-device --help
:~$ sudo termidesk-vmsd virsh detach-device --help
BASH

attach-device

detach-device

Не задано Не задано

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

Реализует функции управления пробросом USB-устройств и установки USB-фильтра.

Для вызова справки нужно ввести команду:

:~$ sudo termidesk-vmsd virsh qemu-monitor-command --help
BASH

Пример добавления USB-фильтра к ВМ «one-184»:

:~$ sudo termidesk-vmsd virsh qemu-monitor-command --usbredir-add "0x03:-1:-1:-1:1|-1:-1:-1:-1:0" --domain-name one-184
BASH

Пример использования QEMU для изменения конфигурации ВМ «one-184»:

:~$ sudo termidesk-vmsd virsh qemu-monitor-command --from-json '{"execute":"query-kvm"}' --domain-name one-184
BASH

qemu-monitor-command

TVMD_ILEVEL_SOCKET

63

Задает значение метки целостности на создаваемый TVMD-сокет.

Изменение значения метки целостности может понадобиться, если ОС, на которую устанавливается Агент УВ, имеет уровень целостности, отличный от 63.

Параметр задается в unit-файле службы termidesk-vmsd (файл /lib/systemd/system/termidesk-vmsd.service).

До изменения файла службы нужно остановить ее командой:

:~$ sudo systemctl stop termidesk-vmsd.service
BASH

После изменения файла нужно выполнить команды:

:~$ sudo systemctl daemon-reload
:~$ sudo systemctl start termidesk-vmsd.service
BASH
--tvmd-ilevel-socket
Переменные окружения видеоагента

Переменная окруженияЗначение по умолчаниюОписаниеАргумент командной строки
TDSK_DEBUG Не задано

Включение режима отладки.

Возможные значения: yes

Не задано
Не задано Не задано

 Вывод справки по использованию аргументов командной строки.

Для вызова справки нужно выполнить:

:~$ sudo /usr/local/sbin/video_agent -h
BASH
-h
Не задано Не задано

Получение контрольных сумм входящих данных (используется алгоритм MD5).

Служебный параметр, не для использования

-m
Не задано Не задано

Использование неблокирующего режима чтения. В этом режиме видеоагент продолжает принимать данные, даже если нет обновлений (в блокирующем режиме выполнение видеоагента останавливается до момента поступления новых данных).

Служебный параметр, не для использования

-n
Не задано /dev/video0

Устройство вывода видео

-o
Не задано /dev/virtio-ports/ru.termidesk.RealtimeStreaming.0

Порт входящих данных. Менять значение не рекомендуется

-p
Не задано Не задано

Время ожидания между кадрами в порте входящих данных (в микросекундах).

Служебный параметр, не для использования

-s
Не задано Не задано

Время ожидания между попытками открытия порта входящих данных (в секундах).

Служебный параметр, не для использования

-t
Не задано Не задано

Вывод версии приложения.

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

:~$ sudo /usr/local/sbin/video_agent -v
BASH
-v
TDSK_VIDEO_CODEClibtheora

Кодек видеокамеры. 

Возможные значения:

  • libtheora - нативный метод кодирования Theora;
  • theora - кодирование через конвейер Gstreamer.
-c
Переменные окружения Агента смарт-карт

Переменная окруженияЗначение по умолчаниюОписаниеАргумент командной строки
TDSK_DEBUG Не задано

Включение режима отладки. Может также использоваться файл /etc/reader.conf.d/exconf/vscard (см. подраздел Настройка Агента виртуальных смарт-карт).

Возможные значения: yes

Не задано