Download PDF
Download page Переменные окружения и аргументы командной строки.
Переменные окружения и аргументы командной строки
Переменные окружения и другие параметры конфигурирования
В Termidesk используются переменные окружения и аргументы интерфейса командной строки (CLI) для указания параметров настройки компонентов программного комплекса.
Агент ВРМ предусматривает возможность конфигурирования переносимых профилей и настройки аутентификации пользователей ВРМ через файл с помощью модуля pam_tdsk
:
- для настройки переносимых профилей следует обратиться к подразделу Настройка переносимых профилей документа СЛЕТ.10001-01 90 02 «Руководство администратора. Настройка программного комплекса»;
- для настройки технологии единого входа следует обратиться к подразделу Настройка технологии единого входа в гостевой ОС ВМ документа СЛЕТ.10001-01 90 02 «Руководство администратора. Настройка программного комплекса»;
- для настройки аутентификации пользователей ВРМ через файл следует обратиться к подразделу Настройка аутентификации пользователей ВРМ через файл документа СЛЕТ.10001-01 90 02 «Руководство администратора. Настройка программного комплекса».
Переопределение параметров настройки Агента ВРМ может быть произведено:
- через интерфейс CLI и задание параметров функционирования с помощью аргументов командной строки;
- через переменные окружения. Использование переменных окружения может быть задано следующими способами:
- непосредственно в сервисном файле
/lib/systemd/system/termidesk-agent.service
. Для это нужно изменить указанный файл, добавив в секциюservice
либо переменную и ее значение (в примереEnvironment=
TDSK_VDI_URL=192.0.2.30
), либо указать файл с назначенными переменными:
- непосредственно в сервисном файле
Environment=TDSK_VDI_URL=192.0.2.30
EnvironmentFile=<путь_к_файлу_с_переменными_окружения>
После изменения сервисного файла нужно выполнить перезапуск конфигурации загруженных модулей и перезапустить службу:
sudo systemctl daemon-reload
sudo systemctl restart termidesk-agent.service
- через интерфейс CLI и аргумент
--env
; - через задание переменной окружения
TDSK_VDI_ENV
.
- через интерфейс CLI и аргумент
Перечень переменных окружения и аргументов CLI, используемых Агентами, приведены в таблицах: переменные окружения Агента ВРМ, переменные окружения Агента УВ, переменные окружения видеоагента, переменные окружения Агента смарт-карт.
Для использования интерфейса командной строки Агента ВРМ в ОС Microsoft Windows нужно:
- открыть командную строку от имени администратора;
- вызывать Агент ВРМ из каталога
C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe
; - перенаправить вывод команды в файл. В указанном файле будет показан результат выполнения команды.
Пример получения полной информации по доступным аргументам командной строки с выводом в файл C:\agent_help_all.txt
:
C:\Users\user>"C:\Program Files\UVEON\Termidesk Agent\TermideskAgentConfig.exe" -h > C:\agent_help_all.txt
Переменная окружения | Значение по умолчанию | Описание | Аргумент командной строки |
---|---|---|---|
TDSK_VDI_URL | Не задано | Задает значение IP-адреса для подключения к компоненту «Универсальный диспетчер». В переменной При использовании аргумента Пример для ОС Linux:
BASH
Пример для ОС Microsoft Windows:
BASH
где Пример IP-адреса приведен в соответствии с RFC 5737, он должен быть заменен на актуальный, используемый согласно схеме адресации, принятой в инфраструктуре организации. Для вызова справки нужно ввести команду:
BASH
| --host |
TDSK_VDI_KEY | Не задано | Задает значение мастер-ключа для подключения к компоненту «Универсальный диспетчер». Для получения значения мастер-ключа в «Портале администратора» компонента «Универсальный диспетчер» нужно перейти «Настройки - Системные параметры - Безопасность». Пример ОС Linux:
BASH
Пример для ОС Microsoft Windows:
BASH
| --key |
TDSK_VDI_SSL | Не задано | Включение использования защищенного SSL-соединения. Пример ОС Linux:
BASH
Пример для ОС Microsoft Windows:
BASH
Отключение параметра выполняется в графическом режиме Агента ВРМ или с помощью команды: Команда сбрасывает все настройки Агента ВРМ до значений по умолчанию.
BASH
| --ssl |
TDSK_VDI_ENV | Не задано | Включение подстановки значений параметров из переменных окружения. Пример ОС Linux:
BASH
Пример для ОС Microsoft Windows:
BASH
Отключение параметра выполняется в графическом режиме Агента ВРМ или с помощью команды: Команда сбрасывает все настройки Агента ВРМ до значений по умолчанию.
BASH
| --env |
TDSK_VDI_LOGLEVEL | Не задано | Задает категорию сообщений, которые будут записываться в журнал Агента ВРМ (возможные значения: В текущей версии Агента ВРМ настройка категории сообщений для записи в журнал через CLI не поддерживается. Приведена справочная информация. Пример ОС Linux:
BASH
Пример для ОС Microsoft Windows:
BASH
| --loglevel |
TDSK_PIDFILE | /var/run/termidesk.pid | Данный параметр применяется только для Агента ВРМ на ОС Linux. Задает путь к файлу журнала с идентификаторами запущенных приложений | Не задано |
Не задана | Не задано | Данный параметр применяется только для Агента ВРМ на ОС Linux. Команда для входа в графическую сессию пользователя ВРМ. Для работы команды должна выть включена технология единого входа. Пример:
BASH
где: Для вызова справки нужно ввести команду:
BASH
| |
В Агенте УВ используется аналог интерфейса virsh
для отправки команд через CLI.
Переменная окружения | Значение по умолчанию | Описание | Аргумент командной строки |
---|---|---|---|
Не задано | Не задано | Используется для проброса устройств или их отключения. Аргумент командной строки вызывается через Пример:
BASH
Для вызова справки нужно ввести команды:
BASH
| |
Не задано | Не задано | Используется для взаимодействия с QEMU из командной строки. Реализует функции управления пробросом USB-устройств и установки USB-фильтра. Для вызова справки нужно ввести команду:
BASH
Пример добавления USB-фильтра к ВМ «one-184»:
BASH
Пример использования QEMU для изменения конфигурации ВМ «one-184»:
BASH
| |
| 63 | Задает значение метки целостности на создаваемый Изменение значения метки целостности может понадобиться, если ОС, на которую устанавливается Агент УВ, имеет уровень целостности, отличный от 63. Параметр задается в До изменения файла службы нужно остановить ее командой:
BASH
После изменения файла нужно выполнить команды:
BASH
| --tvmd-ilevel-socket |
Переменная окружения | Значение по умолчанию | Описание | Аргумент командной строки |
---|---|---|---|
TDSK_DEBUG | Не задано | Включение режима отладки. Возможные значения: | Не задано |
Не задано | Не задано | Вывод справки по использованию аргументов командной строки. Для вызова справки нужно выполнить:
BASH
| -h |
Не задано | Не задано | Получение контрольных сумм входящих данных (используется алгоритм MD5). Служебный параметр, не для использования | -m |
Не задано | Не задано | Использование неблокирующего режима чтения. В этом режиме видеоагент продолжает принимать данные, даже если нет обновлений (в блокирующем режиме выполнение видеоагента останавливается до момента поступления новых данных). Служебный параметр, не для использования | -n |
Не задано | /dev/video0 | Устройство вывода видео | -o |
Не задано | /dev/virtio-ports/ru.termidesk.RealtimeStreaming.0 | Порт входящих данных. Менять значение не рекомендуется | -p |
Не задано | Не задано | Время ожидания между кадрами в порте входящих данных (в микросекундах). Служебный параметр, не для использования | -s |
Не задано | Не задано | Время ожидания между попытками открытия порта входящих данных (в секундах). Служебный параметр, не для использования | -t |
Не задано | Не задано | Вывод версии приложения. Для вывода версии нужно выполнить:
BASH
| -v |
TDSK_VIDEO_CODEC | libtheora | Кодек видеокамеры. Возможные значения:
| -c |
Переменная окружения | Значение по умолчанию | Описание | Аргумент командной строки |
---|---|---|---|
TDSK_DEBUG | Не задано | Включение режима отладки. Может также использоваться файл Возможные значения: | Не задано |