Переменные окружения и другие параметры конфигурирования
В Termidesk используются переменные окружения и аргументы интерфейса командной строки (CLI) для указания параметров настройки компонентов программного комплекса.
Для включения переопределения значений параметров Агента ВРМ через переменные окружения используются два способа:
- активация параметра «Разрешить переопределение значений через переменные окружения» в графическом интерфейсе Агента ВРМ;
- или назначение параметру
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
где:
--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
Агент ВРМ также предусматривает возможность конфигурирования переносимых профилей и настройки аутентификации пользователей ВРМ через файл с помощью модуля pam_tdsk. Для подробной информации следует обратиться к подразделам Настройка переносимых профилей для ОС Astra Linux Special Edition, Настройка технологии единого входа в гостевой ОС ВМ для протокола SPICE, Настройка аутентификации пользователей ВРМ через файл документа MultiExcerpt именем Децимальный номер не найден -- Проверьте имя страницы и имя MultiExcerpt используемые в MultiExcerpt-Include 90 02 «Руководство администратора. Настройка программного комплекса».
Перечень переменных окружения и аргументов CLI, используемых Агентами, приведены в таблицах: переменные окружения Агента ВРМ, переменные окружения Агента УВ, переменные окружения видеоагента, переменные окружения Агента смарт-карт.
| Переменная окружения | Значение по умолчанию | Описание | Аргумент командной строки |
|---|---|---|---|
TDSK_VDI_URL | Не задано | Задает URL-адрес компонента «Универсальный диспетчер» («Портала администратора») для подключения к нему |
|
TDSK_VDI_KEY | Не задано | Задает значение мастер-ключа для подключения к компоненту «Универсальный диспетчер» («Порталу администратора»). Для получения значения мастер-ключа в «Портале администратора» нужно перейти «Настройки - Системные параметры - Безопасность» |
|
TDSK_VDI_SSL | Не задано | Управление режимом использования защищенного SSL-соединения. Возможные значения:
Если не задать значение, то будет использоваться Пример для ОС Linux: sudo termidesk-agent-config update --ssl=True sudo termidesk-agent-config update --ssl Пример для ОС Microsoft Windows: "C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --ssl=True "C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --ssl |
|
TDSK_VDI_LOGLEVEL | 20000 | Задает категорию сообщений, которые будут записываться в журнал Агента ВРМ. Возможные значения (может указываться как цифровое значение, так и буквенное):
Пример ОС Linux: sudo termidesk-agent-config update --loglevel 20000 sudo termidesk-agent-config update --loglevel INFO Пример для ОС Microsoft Windows: "C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --loglevel 20000 "C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --loglevel INFO |
|
Не задано | Не задано | Управление режимом подстановки значений параметров из переменных окружения. Возможные значения:
Если не задать значение, то будет использоваться Пример ОС Linux: sudo termidesk-agent-config update --env=True sudo termidesk-agent-config update --env Пример для ОС Microsoft Windows: "C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --env=True "C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" update --env | --env |
TDSK_METRIC_INTERVAL | 3 | Интервал (в секундах) получения и обновления метрик узла Агентом ВРМ. Переменная окружения доступна с версии 5.1. По умолчанию интервал 3 секунды, однако через REST API получить метрики можно в любой момент |
|
SSSD_DEFAULT_CONF | /etc/sssd/sssd.conf | Задает путь к конфигурационному файлу, в котором задано значение параметра В зависимости от значения параметра
|
|
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 |
|
| Переменная окружения | Значение по умолчанию | Описание |
|---|---|---|
| 63 | Задает значение метки целостности на создаваемый По умолчанию после установки конфигурационный файл может не существовать. В этом случае нужно:
sudo mkdir /etc/termidesk
sudo chmod 755 /etc/termidesk
sudo touch /etc/termidesk/termidesk-vmsd.conf
sudo chmod 644 /etc/termidesk/termidesk-vmsd.conf Изменение значения метки целостности может понадобиться, если ОС имеет уровень целостности, отличный от 16. При возникновении ситуации, когда уровень целостности ОС отличается от 16, следует:
cat /etc/libvirt/libvirtd.conf | grep ilev_vm
|
| Не задано | Задает путь для исполняемого файла, реализующего альтернативный механизм сброса сессий (см. подраздел Использование альтернативного механизма сброса сессий) |
| Переменная окружения | Значение по умолчанию | Описание | Аргумент командной строки |
|---|---|---|---|
TDSK_DEBUG | Не задано | Включение режима отладки. Возможные значения: | Не задано |
Не задано | Не задано | Вывод справки по использованию аргументов командной строки. Для вызова справки нужно выполнить: sudo /usr/local/sbin/video_agent -h | -h |
Не задано | /dev/video0 | Устройство вывода видео | -o |
Не задано | Не задано | Вывод версии приложения. Для вывода версии нужно выполнить: sudo /usr/local/sbin/video_agent -v | -v |
TDSK_VIDEO_CODEC | libtheora | Кодек видеокамеры. Возможные значения:
| -c |
| Переменная окружения | Значение по умолчанию | Описание | Аргумент командной строки |
|---|---|---|---|
TDSK_DEBUG | Не задано | Включение режима отладки. Может также использоваться файл Возможные значения: | Не задано |