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

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

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

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

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

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

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

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

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

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

Задает значение IP-адреса сервера Termidesk для подключения.

В переменной TDSK_VDI_URL задается URL-строка с IP-адресом диспетчера Termidesk.

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

Пример:

vdi-agent-config update --host 192.0.2.30

где 192.0.2.30 - адрес диспетчера Termidesk.

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

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

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

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

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

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

/usr/local/sbin/video_agent -h

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

/usr/local/sbin/video_agent -v

-v
Переменные окружения агента виртуальных смарт-карт

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

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

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

Не задано