Конфигурационный файл 30-teraqxl.xorg.conf

Конфигурационный файл /etc/X11/xorg.conf.d/30-teraqxl.xorg.conf используется для настройки параметров работы с виртуальным графическим процессором QXL и доступен только при установке TERA в среде функционирования ВМ.

При изменении конфигурационных параметров файла не рекомендуется изменять секции: Device,  InputDevice, Monitor, Screen, Display, ServerLayout. Параметры данных секций автоматически управляются сервером Xorg.

После изменения параметров конфигурации нужно выполнить перезапуск гостевой ОС РМ.

Перечень параметров, задающихся через файл /etc/X11/xorg.conf.d/30-teraqxl.xorg.conf, приведен в таблице.

ПараметрЗначение по умолчаниюОписание

Сетевые настройки и настройки безопасности

SpiceDisableTicketingTrue

Управление механизмом парольной аутентификации при подключении к гостевой ОС.

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

  • True - разрешить подключение без предоставления пароля;
  • False - для подключения будет использоваться пароль, указанный в  SpicePassword
SpicePassword Не задано

Использовать параметр не рекомендуется.

Задание пароля для подключения к гостевой ОС.

По умолчанию параметр не задан (закомментирован)

SpiceSaslFalse

Управление использованием механизма аутентификации SASL. По умолчанию после установки TERA этот механизм аутентификации не используется.

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

  • True - разрешить аутентификацию SASL;
  • False - запретить аутентификацию SASL
TeraLogFilename/var/log/termidesk/tera-server.log

Задание пути к файлу журнала

TeraDebugFalse

Управление использованием отладочного режима.

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

  • True - использовать отладочный режим при журналировании событий;
  • False - не использовать отладочный режим при журналировании событий
SpicePort5900

Порт для незащищенного подключения TERA.

При организации резервного канала для подключения следует указать два порта: основной и резервный через запятую.

Пример использования:

SpicePort=5900,5902

Значение 0 отключает использование незащищенного соединения

SpiceTlsPortНе задано

Порт для защищенного подключения TERA.

Для использования только защищенного соединения нужно присвоить параметру SpicePort значение 0 или закомментировать его.

При одновременном использовании защищенного и незащищенного соединения нужно указывать разные порты для параметров SpiceTlsPort и SpicePort.

При организации резервного канала для подключения следует указать два порта: основной и резервный через запятую.

Пример использования:

SpiceTlsPort=5901,5903

Значение 0 отключает использование защищенного соединения.

По умолчанию параметр не задан (закомментирован)

SpiceX509Dir/etc/termidesk/tera/sasl

Путь к каталогу, в котором размещаются сертификаты и закрытые ключи, используемые для защищенного соединения TLS.

По умолчанию самоподписанные сертификаты и закрытые ключи к ним появляются в каталоге /etc/termidesk/tera/sasl/ автоматически после установки TERA

SpiceCacertFileНе задано

Путь к файлу корневого сертификата для соединения TLS.

По умолчанию параметр не задан (закомментирован)

SpiceX509KeyFileНе задано

Путь к файлу ключа для соединения TLS.

По умолчанию параметр не задан (закомментирован)

SpiceX509KeyPassword12345678

Пароль для доступа к закрытому ключу сертификата.

По умолчанию после установки задан пароль доступа к закрытому ключу, размещенному в каталоге /etc/termidesk/tera/sasl/

SpiceX509CertFileНе задано

Путь к файлу сертификата для соединения TLS.

По умолчанию параметр не задан (закомментирован)

SpiceDhFileНе задано

Путь к файлу с ключами Диффи-Хеллмана для соединения TLS.

По умолчанию параметр не задан (закомментирован)

SpiceTlsCiphersНе задано

Путь к файлу с алгоритмом преобразований для соединения TLS.

По умолчанию параметр не задан (закомментирован)

SpiceAddr0.0.0.0

Адрес прослушивания входящих подключений

SpiceIPV4OnlyTrue

Управление прослушиванием входящих подключений только на IPv4-адресах.

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

  • True - прослушивать только IPv4-адреса;
  • False - прослушивать IPv4 и IPv6-адреса.

По умолчанию параметр не задан (закомментирован)

SpiceIPV6OnlyFalse

Управление прослушиванием входящих подключений только на IPv6-адресах.

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

  • True - прослушивать только IPv6-адреса;
  • False - прослушивать IPv4 и IPv6-адреса.

По умолчанию параметр не задан (закомментирован)

SpiceExitOnDisconnectTrue

Управление сервером TERA при отключении пользователя.

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

  • True - сервер TERA завершит сессию, и все связанные с ней ресурсы будут освобождены;
  • False - сервер TERA продолжит работу, и будет доступен для подключения даже после отключения всех текущих пользователей.

По умолчанию параметр не задан (закомментирован)

Настройки аудио

TeraAudioCodecopus

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

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

  • opus;
  • pcm
TeraAudioChannels2

Управление количеством аудиоканалов.

Возможные значения: 1,2

TeraAudioSampleRate0

Управление частотой дискретизации (Гц).

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

  • для аудиокодека opus:  0, 8000, 12000, 16000, 24000, 48000;
  • для аудиокодека pcm: 0, 2000, 4000, 6000, 8000, 12000, 16000, 24000, 44100.

Если для параметра используется значение 0, то ключевым параметром кодирования становится битрейт

TeraAudioBitrate0

Задание битрейта (Кбит/с) на один канал.

Возможные значения: 0, 8, 12, 16, 24, 32, 48, 64, 128.

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

TeraAudioVBRTrue

Управление использованием среднего (переменного) битрейта (Кбит/с) аудиопотока на один канал.

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

  • True - используется среднее значение битрейта для аудиопотока;
  • False - значение битрейта задается параметром TeraAudioBitrate

Настройки многомониторной конфигурации

NumHeads2

Управление количеством виртуальных мониторов, доступных для гостевой ОС

Настройки пропускной способности протокола

SpiceZlibGlzWanCompressionalways

Управление сжатием данных для оптимизации пропускной способности сети.

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

  • auto - автоматическое управление сжатием данных в зависимости от состояния сети;
  • never - отключение сжатия данных. Может привести к увеличению объема передаваемой информации и обеспечить минимальную задержку при передаче данных. Значение может использоваться для снижения нагрузки на пользовательских рабочих станциях с низкой однопоточной производительностью;

При отключении сжатия данных возможен значительный рост объема (трафика) видеопотока. В таком случае пропускной способности сети может оказаться недостаточно для стабильной работы.

  • always - включение сжатия данных. Может привести к уменьшению объема передаваемой информации и обеспечить высокую скорость передачи данных в условиях ограниченной пропускной способности сети
SpiceJpegWanCompressionalways

Управление сжатием изображения.

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

  • auto - автоматическое управление сжатием изображения в зависимости от состояния сети;
  • never - отключение сжатия данных. Может привести к увеличению объема передаваемой информации и обеспечить максимальное качество изображения. Значение может использоваться для снижения нагрузки на пользовательских рабочих станциях с низкой однопоточной производительностью;

При отключении сжатия данных возможен значительный рост объема (трафика) видеопотока. В таком случае пропускной способности сети может оказаться недостаточно для стабильной работы.

  • always - включение сжатия данных. Может привести к уменьшению качества изображения и обеспечить высокую скорость передачи изображения в условиях ограниченной пропускной способности сети
SpiceImageCompressionauto_glz

Управление алгоритмом сжатия изображения.

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

  • off - отключить алгоритм сжатия данных. Может использоваться для снижения нагрузки на пользовательских рабочих станциях с низкой однопоточной производительностью;

При отключении сжатия данных возможен значительный рост объема (трафика) видеопотока. В таком случае пропускной способности сети может оказаться недостаточно для стабильной работы.

  • auto_glz - автоматическое управление алгоритмом сжатия glz;
  • auto_lz - автоматическое управление алгоритмом сжатия lz;
  • quic - использование алгоритма сжатия данных quick;
  • glz - использование алгоритма сжатия данных glz;
  • lz - использование алгоритма сжатия данных lz
SpiceDeferredFPS10

Управление частотой следования опорных кадров (в секунду) видеоизображения.

Параметр позволяет сгладить визуальное представление, используя опорные кадры.

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

  • 0 - значение зарезервировано для автоматического режима, в котором скорость потока автоматически адаптируется под пропускную способность сети;
  • другое положительное целочисленное значение, которое отключит автоматическую адаптацию частоты следования опорных кадров

На пользовательских рабочих станциях с низкой однопоточной производительностью не рекомендуется использовать значения, отличные от 0.

SpiceStreamingVideofilter

Выбор режима передачи видеоизображения.

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

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

  • off - отключить передачу потокового видео. Параметр снижает нагрузку на сеть, но увеличивает задержку при отображении видеоизображения;
  • filter - включить передачу потокового видео. При этом поточной трансляции не будут подвергаться зоны на экране площадью меньше 96х96 (режим рекомендуется к использованию);
  • all - включить передачу потокового видео. При этом поточной трансляции будут подвергаться все зоны с медиаактивностью, в том числе малого размера (не рекомендуется к использованию из-за неоптимальности и повышения накладных расходов на работу сети).

По умолчанию параметр не задан (закомментирован)

SpiceVideoCodecsgstreamer:h264

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

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

  • mjpeg;
  • vp8;
  • h264.

По умолчанию параметр не задан (закомментирован)

EnableImageCacheTrue

Управление кешированием изображений.

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

  • True - включить кеширование изображений;
  • False - отключить кеширование изображений
EnableFallbackCacheTrue

Управление резервным кешированием.

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

  • True - включить резервное кеширование;
  • False - отключить резервное кеширование
EnableSurfacesTrue

Управление обновлением областей экрана.

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

  • True - включить обновление областей экрана. Параметр позволяет оптимизировать отображение сложной графики и ускоряет отрисовку, кешируя объекты на пользовательской стороне;
  • False - отключить обновление областей экрана

Настройки буферизации потока видеодрайвера

SurfaceBufferSize512

Управление максимальным размером буфера (в мегабайтах) для хранения обновленных областей экрана

CommandBufferSize512

Управление максимальным размером буфера (в мегабайтах) для хранения команд видеодрайвера

FrameBufferSize64

Управление максимальным размером буфера (в мегабайтах) для хранения кадров перед их отправкой с сервера на клиентскую часть

Настройки tera-vdagent

SpiceVdagentEnabledTrue

Управление взаимодействием видеодрайвера с сервисом tera-vdagentd.

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

  • True - разрешить взаимодействие с сервисом. Параметр позволяет использовать динамическое изменение разрешения экрана, буфер обмена с гостевой ОС;
  • False - запретить взаимодействие с сервисом
SpiceVdagentVirtioPath/tmp/xtera-virtio

Путь к виртуальному устройству virtio для взаимодействия сервиса tera-vdagentd с гостевой ОС

SpiceVdagentUinputPath/tmp/xtera-uinput

Путь к устройству uinput, используемому сервисом tera-vdagentd для отправки сигналов клавиатуры и мыши в гостевую ОС

SpiceVdagentUid0

Параметр не используется

SpiceVdagentGid0

Параметр не используется

SpiceAgentMouseTrue

Управление определением абсолютных или относительных координат мыши.

Отключение параметра рекомендуется в случаях, когда курсор мыши плохо позиционируется в приложениях.

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

  • True - использовать определение абсолютных координат мыши;
  • False - использовать определение относительных координат мыши
SpiceDisableCopyPasteFalse

Управление буфером обмена для передачи данных между гостевой ОС и пользовательской рабочей станцией.

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

  • Trueотключить использование и обмен информацией в буферах обмена. Информация с пользовательской рабочей станции перестает синхронизироваться при операциях копирования и вставки;
  • False - разрешить использование и обмен информацией в буферах обмена
TeraDisableKeyboardLocksFalse

Управление перенаправлением клавиатурных модификаторов между гостевой ОС и пользовательской рабочей станцией.

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

  • True - запретить перенаправление клавиатурных модификаторов;
  • False - разрешить перенаправление клавиатурных модификаторов.

При выборе значения True:

  • будет отсутствовать возможность доставлять в ПО Termidesk Viewer уведомления об автоматической смене клавиатурных модификаторов, например с помощью настроек графического менеджера;
  • будет отсутствовать возможность использования переключателей на экранной клавиатуре гостевой ОС при удаленном подключении к ней
TeraDisableTimeSyncTrue

Управление синхронизацией времени в гостевой ОС по информации от пользовательской рабочей станцией.

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

  • True - запретить синхронизацию времени;
  • False - разрешить синхронизацию времени
TeraDisableTimezoneSyncFalse

Управление синхронизацией временной зоны в гостевой ОС по информации от пользовательской рабочей станцией.

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

  • True - запретить синхронизацию временной зоны;
  • False - разрешить синхронизацию временной зоны.

При смене временной зоны через службу tera-vdagentd:

  • если временная зона не будет найдена, то пользователю будет выдана ошибка в ПО Termidesk Viewer;
  • если полученная временная зона будет отсутствовать в гостевой ОС, то будет автоматически выбран регион временной зоны, заменяющий отсутствующий;
  • атомарно поменяется символьная ссылка /etc/localtime на файл новой временной зоны;
  • в файле /etc/timezone будет записано название новой временной зоны;
  • будет подана команда смены временной зоны в ОС:
timedatectl set-timezone
  • будут перезагружены следующие службы (если они запущены и работают):
    • для ОС на базе подсистемы systemd: rsyslog, syslog-ng, cron, anacron, systemd-timesyncd, chronyd, ntpd, ntp, openntpd;
    • для других ОС: cron, rsyslog

Настройки перенаправления USB-устройств

SpiceUsbChannelNum0

Количество каналов для перенаправления USB-устройств.

Диапазон значений: от 0 до 8

Настройки перенаправления каталога

EnableWebdavTrue

Управление перенаправлением каталога из пользовательской рабочей станции в гостевую ОС.

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

  • True - разрешить перенаправление каталога;
  • False - запретить перенаправление каталога
WebdavSocketPath/var/run/termidesk/tera-webdav

Путь к сокету tera-webdav, необходимому для корректной работы службы перенаправления файлов и каталогов в гостевую ОС

Секция ServerFlags

AutoAddDevicesFalse

Управление автоматическим добавлением устройств в гостевую ОС при подключении по протоколу TERA.

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

  • True - разрешить автоматическое добавление устройств;
  • False - запретить автоматическое добавление устройств