Агент. Параметры конфигурирования

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

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

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

Перечень переменных и аргументов CLI, используемых Агентом, приведены в таблице.

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

Переменная окружения	Значение по умолчанию	Описание	Аргумент командной строки
Агент ВРМ
`TDSK_VDI_URL`	`Не задано`	Задает значение IP-адреса сервера Termidesk для подключения. В переменной `TDSK_VDI_URL` задается URL-строка с IP-адресом диспетчера Termidesk. При использовании аргумента `--host` задается только IP-адрес диспетчера Termidesk. Пример: `vdi-agent-config update --host 192.168.100.2` где `192.168.100.2` - адрес диспетчера Termidesk. Для вызова справки нужно ввести команду: `vdi-agent-config update --help`	`--host`
`TDSK_VDI_KEY`	`Не задано`	Задает значение мастер ключа для подключения к серверу Termidesk. Пример: `vdi-agent-config update --key 0123456789` где `0123456789` - значение ключа	`--key`
`TDSK_PIDFILE`	`/var/run/termidesk.pid`	Задает путь к `pid-`файлу	`Не задан`
`Не задано`	`Не задано`	Команда для входа в графическую сессию пользователя ВРМ. Для работы команды должна выть включена технология единого входа. Пример: `vdi-agent-config dmctl login --user-name USER --user-password PASSWORD` где: `USER` - имя пользователя; `PASSWORD` - пароль пользователя. Для вызова справки нужно ввести команду: `vdi-agent-config dmctl login --help`	`dmctl login`
Агент УВ
`Не задано`	`Не задано`	Используется для проброса устройств или их отключения. Аргумент командной строки вызывается через `virsh`. Пример: `termidesk-vmsd virsh attach-device` Для вызова справки нужно ввести команды: `termidesk-vmsd virsh attach-device --help` `termidesk-vmsd virsh detach-device --help`	`attach-device` `detach-device`
`Не задано`	`Не задано`	Используется для взаимодействия с QEMU из командной строки. Реализует функции управления пробросом USB-устройств и установки USB-фильтра. Для вызова справки нужно ввести команду: `termidesk-vmsd virsh qemu-monitor-command --help` Пример добавления USB-фильтра к ВМ «one-184»: `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»: `termidesk-vmsd virsh qemu-monitor-command --from-json '{"execute":"query-kvm"}' --domain-name one-184`	`qemu-monitor-command`
`TVMD_ILEVEL_SOCKET`	`63`	Задает значение метки целостности на создаваемый `TVMD-`сокет. Изменение значения метки целостности может понадобиться, если ОС, на которую устанавливается Агент УВ, имеет уровень целостности, отличный от 63. Параметр задается в `unit`-файле службы `termidesk-vmsd` (файл `/lib/systemd/system/termidesk-vmsd.service`). До изменения файла службы необходимо остановить ее командой `sudo systemctl stop termidesk-vmsd.service`. После изменения файла необходимо выполнить команды `sudo systemctl daemon-reload` и `sudo systemctl start termidesk-vmsd.service`	`--tvmd-ilevel-socket`
Видеоагент
`TDSK_DEBUG`	`Не задано`	Включение режима отладки. Возможные значения: `yes`	`Не задан`
Агент виртуальных смарт-карт
`TDSK_DEBUG`	`Не задано`	Включение режима отладки. Может также использоваться файл `/etc/reader.conf.d/exconf/vscard` (см. подраздел Настройка Агента виртуальных смарт-карт). Возможные значения: `yes`	`Не задан`
Сессионный Агент
`SSA_RETRY_DELAY`	`Не задано`	Время ожидания после запуска процесса сессионного Агента, рекомендуемое время ожидания не менее 3 секунд. Если обработчик не находит дочерний процесс и постоянно пытается перезапустить процесс и при этом нет внутренних ошибок - стоит попробовать увеличить время ожидания. По умолчанию используется 3 секунды	`Не задан`
`SSA_RETRIES_COUNT`	`Не задано`	Количество попыток перезапуска процесса сессионного Агента. По умолчанию выполняется 3 попытки	`Не задан`
`SSA_LISTEN`	`Не задано`	IP-адрес, на котором сессионный Агент ожидает входящие HTTP-запросы (по умолчанию используется 0.0.0.0). Для изменения IP-адреса необходимо задать его при вызове `session-agent`, например: `SSA_LISTEN=192.168.3.92 SSA_PORT=8833 session-agent`	`--listen` `-l`
`SSA_PORT`	`Не задано`	Порт, на котором сессионный Агент ожидает входящие HTTP-запросы (по умолчанию используется 31000). Для изменения порта необходимо задать его при вызове `session-agent`, например: `SSA_LISTEN=192.168.3.92 SSA_PORT=8833 session-agent`	`--port` `-p`
`SSA_LOG_LEVEL`	`Не задано`	Интенсивность отладочных сообщений в журналах (по умолчанию используется уровень INFO). Возможные значения: `NOTSET`, `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`	`Не задан`

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

Для настройки переносимых профилей следует обраться к подразделу Настройка переносимых профилей документа СЛЕТ.10001-01 90 02 «Руководство администратора. Настройка программного комплекса».

Для настройки технологии единого входа следует обраться к подразделу Настройка технологии единого входа в гостевой ОС ВМ документа СЛЕТ.10001-01 90 02 «Руководство администратора. Настройка программного комплекса».

Для настройки аутентификации пользователей ВРМ через файл следует обраться к подразделу Настройка аутентификации пользователей ВРМ через файл документа СЛЕТ.10001-01 90 02 «Руководство администратора. Настройка программного комплекса».