Переменные окружения и другие параметры конфигурирования
В Termidesk используются переменные окружения и аргументы интерфейса командной строки (CLI) для указания параметров настройки компонентов программного комплекса.
Агент ВРМ предусматривает возможность конфигурирования переносимых профилей и настройки аутентификации пользователей ВРМ через файл с помощью модуля pam_tdsk:
- для настройки переносимых профилей следует обратиться к подразделу Настройка переносимых профилей документа СЛЕТ.10001-01 90 02 «Руководство администратора. Настройка программного комплекса»;
- для настройки технологии единого входа следует обратиться к подразделу Настройка технологии единого входа в гостевой ОС ВМ документа СЛЕТ.10001-01 90 02 «Руководство администратора. Настройка программного комплекса»;
- для настройки аутентификации пользователей ВРМ через файл следует обратиться к подразделу Настройка аутентификации пользователей ВРМ через файл документа СЛЕТ.10001-01 90 02 «Руководство администратора. Настройка программного комплекса».
Переопределение параметров настройки Агента ВРМ может быть произведено:
- через интерфейс 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=<путь_к_файлу_с_переменными_окружения>
После изменения сервисного файла нужно выполнить перезапуск конфигурации загруженных модулей и перезапустить службу:
sudo systemctl daemon-reload sudo systemctl restart termidesk-agent.service
- через интерфейс CLI и аргумент
--env; - через задание переменной окружения
TDSK_VDI_ENV.
- через интерфейс CLI и аргумент
Перечень переменных окружения и аргументов 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
| Переменная окружения | Значение по умолчанию | Описание | Аргумент командной строки |
|---|---|---|---|
TDSK_VDI_URL | Не задано | Задает значение IP-адреса для подключения к компоненту «Универсальный диспетчер». В переменной При использовании аргумента Пример для ОС Linux: sudo termidesk-agent-config update --host 192.0.2.30 Пример для ОС Microsoft Windows: C:\Users\user>"C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --host 192.0.2.30 где Пример IP-адреса приведен в соответствии с RFC 5737, он должен быть заменен на актуальный, используемый согласно схеме адресации, принятой в инфраструктуре организации. Для вызова справки нужно ввести команду: sudo termidesk-agent-config update --help | --host |
TDSK_VDI_KEY | Не задано | Задает значение мастер-ключа для подключения к компоненту «Универсальный диспетчер». Для получения значения мастер-ключа в «Портале администратора» компонента «Универсальный диспетчер» нужно перейти «Настройки - Системные параметры - Безопасность». Пример ОС Linux: sudo termidesk-agent-config update --key 0123456789 Пример для ОС Microsoft Windows: C:\Users\user>"C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --key 0123456789 | --key |
TDSK_VDI_SSL | Не задано | Включение использования защищенного SSL-соединения. Пример ОС Linux: sudo termidesk-agent-config update --ssl Пример для ОС Microsoft Windows: C:\Users\user>"C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --ssl Отключение параметра выполняется в графическом режиме Агента ВРМ или с помощью команды: Команда сбрасывает все настройки Агента ВРМ до значений по умолчанию. sudo termidesk-agent-config delete | --ssl |
TDSK_VDI_ENV | Не задано | Включение подстановки значений параметров из переменных окружения. Пример ОС Linux: sudo termidesk-agent-config update --env Пример для ОС Microsoft Windows: C:\Users\user>"C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --env Отключение параметра выполняется в графическом режиме Агента ВРМ или с помощью команды: Команда сбрасывает все настройки Агента ВРМ до значений по умолчанию. sudo termidesk-agent-config delete | --env |
TDSK_VDI_LOGLEVEL | 10000 | Задает категорию сообщений, которые будут записываться в журнал Агента ВРМ. Возможные значения:
Пример ОС Linux: sudo termidesk-agent-config update --loglevel 10000 Пример для ОС Microsoft Windows: C:\Users\user>"C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --loglevel 10000 | --loglevel |
TDSK_PIDFILE | /var/run/termidesk.pid | Данный параметр применяется только для Агента ВРМ на ОС Linux. Задает путь к файлу журнала с идентификаторами запущенных приложений | Не задано |
Не задана | Не задано | Данный параметр применяется только для Агента ВРМ на ОС Linux. Команда для входа в графическую сессию пользователя ВРМ. Для работы команды должна выть включена технология единого входа. Пример: sudo termidesk-agent-config dmctl login --user-name USER --user-password PASSWORD где: Для вызова справки нужно ввести команду: sudo termidesk-agent-config dmctl login --help | |
В Агенте УВ используется аналог интерфейса virsh для отправки команд через CLI.
| Переменная окружения | Значение по умолчанию | Описание | Аргумент командной строки |
|---|---|---|---|
Не задано | Не задано | Используется для проброса устройств или их отключения. Аргумент командной строки вызывается через Пример: sudo termidesk-vmsd virsh attach-device Для вызова справки нужно ввести команды: sudo termidesk-vmsd virsh attach-device --help sudo termidesk-vmsd virsh detach-device --help | |
Не задано | Не задано | Используется для взаимодействия с QEMU из командной строки. Реализует функции управления пробросом USB-устройств и установки USB-фильтра. Для вызова справки нужно ввести команду: sudo termidesk-vmsd virsh qemu-monitor-command --help Пример добавления 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 Пример использования QEMU для изменения конфигурации ВМ «one-184»: sudo termidesk-vmsd virsh qemu-monitor-command --from-json '{"execute":"query-kvm"}' --domain-name one-184
| |
| 63 | Задает значение метки целостности на создаваемый Изменение значения метки целостности может понадобиться, если ОС, на которую устанавливается Агент УВ, имеет уровень целостности, отличный от 63. Параметр задается в До изменения файла службы нужно остановить ее командой: sudo systemctl stop termidesk-vmsd.service После изменения файла нужно выполнить команды: sudo systemctl daemon-reload sudo systemctl start termidesk-vmsd.service | --tvmd-ilevel-socket |
| Переменная окружения | Значение по умолчанию | Описание | Аргумент командной строки |
|---|---|---|---|
TDSK_DEBUG | Не задано | Включение режима отладки. Возможные значения: | Не задано |
Не задано | Не задано | Вывод справки по использованию аргументов командной строки. Для вызова справки нужно выполнить: sudo /usr/local/sbin/video_agent -h | -h |
Не задано | Не задано | Получение контрольных сумм входящих данных (используется алгоритм MD5). Служебный параметр, не для использования | -m |
Не задано | Не задано | Использование неблокирующего режима чтения. В этом режиме видеоагент продолжает принимать данные, даже если нет обновлений (в блокирующем режиме выполнение видеоагента останавливается до момента поступления новых данных). Служебный параметр, не для использования | -n |
Не задано | /dev/video0 | Устройство вывода видео | -o |
Не задано | /dev/virtio-ports/ru.termidesk.RealtimeStreaming.0 | Порт входящих данных. Менять значение не рекомендуется | -p |
Не задано | Не задано | Время ожидания между кадрами в порте входящих данных (в микросекундах). Служебный параметр, не для использования | -s |
Не задано | Не задано | Время ожидания между попытками открытия порта входящих данных (в секундах). Служебный параметр, не для использования | -t |
Не задано | Не задано | Вывод версии приложения. Для вывода версии нужно выполнить: sudo /usr/local/sbin/video_agent -v | -v |
TDSK_VIDEO_CODEC | libtheora | Кодек видеокамеры. Возможные значения:
| -c |
| Переменная окружения | Значение по умолчанию | Описание | Аргумент командной строки |
|---|---|---|---|
TDSK_DEBUG | Не задано | Включение режима отладки. Может также использоваться файл Возможные значения: | Не задано |