Configuring the Zoom VDI Linux plugin with ZoomMedia.ini

ZoomMedia.ini is the main configuration file for Zoom Citrix, Omnissa (formerly VMware), Azure Virtual Desktop (AVD), Teradici, and ThinPro plugin software. It contains several sections to cover most of plugin function areas.

Table of Contents

Position of configuration files 

Version 5.15.10 or higher

Ubuntu

Citrix/VMware/AVD/Teradici  plugin: /etc/zoomvdi/ZoomMedia.ini

Centos

Citrix/VMware plugin: /etc/zoomvdi/ZoomMedia.ini

ThinPro 

Citrix/VMware/AVD/Teradici  plugin: /etc/zoomvdi/ZoomMedia.ini

IGEL 

Citrix/VMware/AVD plugin: /etc/zoomvdi/ZoomMedia.ini

Elux 

Citrix/VMware plugin: /setup/elux/.config/ZoomMedia.ini

Note: The default ZoomMedia.ini for the Thin Client OS is slightly different due to the different file system hierarchies, and this is a superset of all sections and items currently supported:

[ENV]
PATH=/usr/lib/zoomcitrixplugin/
BIN=zoom
LD_LIBRARY_PATH=/usr/lib/zoomcitrixplugin/
SSB_HOME=~/.zoom
QSG_INFO=1
[LOG]
MAX_FILE_COUNT=10
MAX_FILE_SIZE=30
LOG_LEVEL=4
[FEATURE]
SHAREOFFLOAD=1
VIRTUALBACKGROUND=1
SMARTVB=0
[OS]
OS_DISTRO=ubuntu
[COMM]
DisableUDPBridge=
DisableICABridge=
DisableMMRDirect=
PingServerFromThinClient=
[PROXY]
proxyType=
pacFilePath=
httpProxyHost=
httpProxyPort=
httpsProxyHost=
httpsProxyPort=

Env setup for Zoom media process

PATH/BIN/LD_LIBRARY_PATH specifies the exact path location for the Zoom media process.

SSB_HOME points to where the log files will be located.

QSG_INFO is for Qt library to print out basic scene graph information.

Note: It is strongly suggested that you do not modify any value under this section. All items under this section are compulsive.

Log control for zoom media process

The whole VDI solution has an overall log control method. Zoom media process accepts log_level parameter from VDI Client and determines its own log level. In this case, the following items will take into effect:

MAX_FILE_COUNT is the maximum file number for one particular log type. The default should be 10 if not specified.

MAX_FILE_SIZE is the maximum file size (MBytes) for a single log file , no matter which type it is. The default should be 30 if not specified.

The maximum size of all log files can be calculated by MAX_FILE_SIZE * (MAX_FILE_COUNT * 3 + 1) MBytes, and 3 represents for our 3 log types(_AV/_citrix/_sdk postfixed), 1 represents for individual standard out log file: std_out_error.log.

If you configure this section like this:

[LOG]
MAX_FILE_COUNT=2
MAX_FILE_SIZE=3

The size of all log files is 3 * (2 *3 + 1) = 21 MBytes top.

LOG_LEVEL optional, specifies log level for Zoom media process only if the VDI Client does not send log_level parameter. The plugin log level can be controlled independently, even if a customer does not configure the LogLevel in VDI Client in VM.

Feature support based on different thin client OS

Note: It is strongly suggested that you do not modify any value under this section. Forcing to turn SHAREOFFLOAD on an unsupported platform will cause black window during annotation.

[OS] thin client OS

OS_DISTRO specified current OS running

Note: It is strongly suggested that you do not modify any value under this section. Forcing to change OS_DISTRO will cause unknown behavior.

Connection setup for thin client

Learn more about VDI client registry settings.

Note: The following section is optional:

Proxy configuration for plugin

proxyType specifies which proxy type you want to use. Currently, we support system pacfile manual noproxy

pacFilePath specifies pac file url if proxyType is choosing pacfile.

The following 4 items will take into effect if proxyType is choosing manual.

For example:

[PROXY]
proxyType=manual
pacFilePath=
httpProxyHost=10.100.10.10
httpProxyPort=8080
httpsProxyHost=
httpsProxyPort=