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

Конфигурационный файл 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, приведен в таблице.

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

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

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

SpiceDisableTicketingTrue

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

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

  • True - разрешить подключение без предоставления пароля;
  • False - запретить подключение без предоставления пароля
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

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

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

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 - разрешить использование и обмен информацией в буферах обмена

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

SpiceUsbChannelNum0

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

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

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

EnableWebdavTrue

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

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

  • True - разрешить перенаправление каталога;
  • False - запретить перенаправление каталога

Секция ServerFlags

AutoAddDevicesFalse

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

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

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