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

В 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

Не задано