Переменные окружения и аргументы командной строки

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

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

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

активация параметра «Разрешить переопределение значений через переменные окружения» в графическом интерфейсе Агента ВРМ;
или назначение параметру env значения True в конфигурационном файле (см. подраздел Конфигурационный файл Агента ВРМ).

Для других Агентов дополнительные действия не требуются.

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

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

"C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --host 192.0.2.30 --key 0123456789 --ssl False --loglevel 20000

BASH

где:

--host 192.0.2.30 - IP-адрес компонента «Универсальный диспетчер» («Портала администратора»);

--key 0123456789 - значение мастер-ключа для подключения к компоненту «Универсальный диспетчер» («Порталу администратора»);

--ssl False - отключение использования защищенного SSL-соединения;

--loglevel 20000 - категория сообщений.

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

"C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" -h > C:\agent_help_all.txt

BASH

Агент ВРМ также предусматривает возможность конфигурирования переносимых профилей и настройки аутентификации пользователей ВРМ через файл с помощью модуля pam_tdsk. Для подробной информации следует обратиться к подразделам Настройка переносимых профилей для ОС Astra Linux Special Edition, Настройка технологии единого входа в гостевой ОС ВМ для протокола SPICE, Настройка аутентификации пользователей ВРМ через файл документа СЛЕТ.10001-01 90 02 «Руководство администратора. Настройка программного комплекса».

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

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

Переменная окружения	Значение по умолчанию	Описание	Аргумент командной строки
`TDSK_VDI_URL`	`Не задано`	Задает URL-адрес компонента «Универсальный диспетчер» («Портала администратора») для подключения к нему	`--host`
`TDSK_VDI_KEY`	`Не задано`	Задает значение мастер-ключа для подключения к компоненту «Универсальный диспетчер» («Порталу администратора»). Для получения значения мастер-ключа в «Портале администратора» нужно перейти «Настройки - Системные параметры - Безопасность»	`--key`
`TDSK_VDI_SSL`	`Не задано`	Управление режимом использования защищенного SSL-соединения. Возможные значения: `True` - использовать защищенное SSL-соединение; `False` - не использовать защищенное SSL-соединение. Если не задать значение, то будет использоваться `True`. Пример для ОС Linux: `sudo termidesk-agent-config update --ssl=True sudo termidesk-agent-config update --ssl` BASH Пример для ОС Microsoft Windows: `"C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --ssl=True "C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --ssl` BASH	`--ssl`
`TDSK_VDI_LOGLEVEL`	`20000`	Задает категорию сообщений, которые будут записываться в журнал Агента ВРМ. Возможные значения (может указываться как цифровое значение, так и буквенное): `20000` - соответствует уровню DEBUG; `30000` - соответствует уровню INFO; `40000` - соответствует уровню WARN; `30000` - соответствует уровню ERROR; `40000` - соответствует уровню FATAL. Пример ОС Linux: `sudo termidesk-agent-config update --loglevel 20000 sudo termidesk-agent-config update --loglevel INFO` BASH Пример для ОС Microsoft Windows: `"C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --loglevel 20000 "C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --loglevel INFO` BASH	`--loglevel`
`Не задано`	`Не задано`	Управление режимом подстановки значений параметров из переменных окружения. Возможные значения: `True` - использовать подстановку значений параметров из переменных окружения; `False` - не использовать подстановку значений параметров из переменных окружения. Если не задать значение, то будет использоваться `True`. Пример ОС Linux: `sudo termidesk-agent-config update --env=True sudo termidesk-agent-config update --env` BASH Пример для ОС Microsoft Windows: `"C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --env=True "C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --env` BASH	`--env`
`TDSK_METRIC_INTERVAL`	`3`	Интервал (в секундах) получения и обновления метрик узла Агентом ВРМ. Переменная окружения доступна с версии 5.1. По умолчанию интервал 3 секунды, однако через REST API получить метрики можно в любой момент	`Не задано`
`SSSD_DEFAULT_CONF`	`/etc/sssd/sssd.conf`	Задает путь к конфигурационному файлу, в котором задано значение параметра `use_fully_qualified_names`. В зависимости от значения параметра `use_fully_qualified_names` будут применены действия: суффикс домена не будет подставлен, если `use_fully_qualified_names = False` или отсутствует; суффикс домена будет подставлен, если `use_fully_qualified_names = True`	`Не задано`
`TDSK_LOG_ROTATE_COUNT`	`5`	Задает максимальное количество файлов журналов. Переменная окружения доступна с версии 6.0	`Не задано`
`TDSK_LOG_ROTATE_MAX_SIZE`	`10`	Задает максимальный размер (МБ) файла журнала. Переменная окружения доступна с версии 6.0	`Не задано`
`LOUDPLAY_LISTEN_IPV4`	`127.0.0.1`	Задает IP-адрес сервера Loudplay для взаимодействия с ним	`Не задано`
`LOUDPLAY_LISTEN_PORT`	`10061`	Задает порт сервера Loudplay для взаимодействия с ним	`Не задано`
`LOUDPLAY_CONNECT_DELAY`	`30`	Задает время ожидания (в секундах), по истечении которого Агент ВРМ отключит неактивную сессию пользователя на сервере Loudplay	`Не задано`

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

Переменная окружения	Значение по умолчанию	Описание
`TVMD_ILEVEL_SOCKET`	`63`	Задает значение метки целостности на создаваемый `TVMD-`сокет. Параметр задается в конфигурационном файле `/etc/termidesk/termidesk-vmsd.conf`. По умолчанию после установки конфигурационный файл может не существовать. В этом случае нужно: создать каталог `/etc/termidesk`/: `sudo mkdir /etc/termidesk` BASH изменить права на каталог: `sudo chmod 755 /etc/termidesk` BASH создать конфигурационный файл: `sudo touch /etc/termidesk/termidesk-vmsd.conf` BASH изменить права на файл: `sudo chmod 644 /etc/termidesk/termidesk-vmsd.conf` BASH Изменение значения метки целостности может понадобиться, если ОС имеет уровень целостности, отличный от 16. При возникновении ситуации, когда уровень целостности ОС отличается от 16, следует: узнать текущий уровень целостности, выставляемый ОС для ВМ, командой: `cat /etc/libvirt/libvirtd.conf \| grep ilev_vm` BASH если полученный уровень отличается, то добавить параметр `TVMD_ILEVEL_SOCKET` с нужным значением уровня (например, `TVMD_ILEVEL_SOCKET=16`) в конфигурационный файл `/etc/termidesk/termidesk-vmsd.conf`
`LIBVIRT_PASSWORD_SCRIPT`	`Не задано`	Задает путь для исполняемого файла, реализующего альтернативный механизм сброса сессий (см. подраздел Использование альтернативного механизма сброса сессий)

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

Переменная окружения	Значение по умолчанию	Описание	Аргумент командной строки
`TDSK_DEBUG`	`Не задано`	Включение режима отладки. Возможные значения: `yes`	`Не задано`
`Не задано`	`Не задано`	Вывод справки по использованию аргументов командной строки. Для вызова справки нужно выполнить: `sudo /usr/local/sbin/video_agent -h` BASH	`-h`
`Не задано`	`/dev/video0`	Устройство вывода видео	`-o`
`Не задано`	`Не задано`	Вывод версии приложения. Для вывода версии нужно выполнить: `sudo /usr/local/sbin/video_agent -v` BASH	`-v`
`TDSK_VIDEO_CODEC`	`libtheora`	Кодек видеокамеры. Возможные значения: `libtheora` - нативный метод кодирования Theora; `theora` - кодирование через конвейер Gstreamer	`-c`

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

Переменная окружения Значение по умолчанию Описание

TDSK_DEBUG

Не задано

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

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