Configuring the Zoom VDI Linux plugin with ZoomMedia.ini

Last Updated:

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

Position of configuration files 

Zoom version: 5.8.0

Ubuntu

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

Centos

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

ThinPro 

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

IGEL 

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

Elux 

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

Zoom version: 5.7.6 and 5.7.8

Ubuntu

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

VMware plugin: /etc/zoomvdi/vmware/ZoomMediaVmware.ini

AVD plugin: /etc/zoomvdi/wvd/ZoomMediaWVD.ini

CentOS

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

VMware plugin: /etc/zoomvdi/vmware/ZoomMediaVmware.ini

AVD plugin: /etc/zoomvdi/wvd/ZoomMediaWVD.ini

ThinPro 

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

VMware plugin: /etc/zoomvdi/vmware/ZoomMediaVmware.ini

AVD plugin: /etc/zoomvdi/wvd/ZoomMediaWVD.ini

IGEL 

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

VMware plugin: /etc/zoomvdi/vmware/ZoomMediaVmware.ini

AVD plugin: /etc/zoomvdi/wvd/ZoomMediaWVD.ini

Elux 

Citrix plugin: /setup/elux/zoomvdi/.citrix/ZoomMedia.ini

VMware plugin: /setup/elux/zoomvdi/.vmware/ZoomMediaVmware.ini      

Zoom version: < 5.7.6

Ubuntu

Citrix plugin: /opt/Citrix/ICAClient/config/ZoomMedia.ini  (depends where Citrix receiver is installed)

VMware plugin: /etc/vmware/ZoomMediaVmware.ini

AVD plugin: /etc/wvd/ZoomMediaWVD.ini

Centos 

Citrix plugin: /opt/Citrix/ICAClient/config/ZoomMedia.ini  (depends where Citrix receiver is installed)

VMware plugin: /etc/vmware/ZoomMediaVmware.ini

AVD plugin: /etc/wvd/ZoomMediaWVD.ini

ThinPro 

Citrix plugin: /opt/Citrix/ICAClient/config/ZoomMedia.ini  (depends where Citrix receiver is installed)

VMware plugin: /etc/vmware/ZoomMediaVmware.ini

AVD plugin: /etc/wvd/ZoomMediaWVD.ini

IGEL 

Citrix plugin: /opt/Citrix/ICAClient/config/ZoomMedia.ini  (depends where Citrix receiver is installed)

VMware plugin: /etc/vmware/ZoomMediaVmware.ini

AVD plugin: /etc/wvd/ZoomMediaWVD.ini

Elux 

Citrix plugin: /opt/Citrix/ICAClient/config/ZoomMedia.ini (or /setup/ica which is link to /opt/Citrix/ICAClient/config)

VMware plugin: /setup/elux/.vmware/ZoomMediaVmware.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 (VDI Troubleshooting). 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

  • SHAREOFFLOAD currently, only support this feature switch.
  • VIRTUALBACKGROUND  Switcher that shows the setting tab Background & Filters
  • SMARTVB Switch that forces enable smart VB feature.

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

Please refer to: https://support.zoom.us/hc/en-us/articles/360032343371

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.

  • httpProxyHost specifies ip address for http proxy server.
  • httpProxyPort specifies port number for http proxy server.
  • httpsProxyHost specifies ip address for https proxy server.
  • httpsProxyPort specifies port number for https proxy server. 

For example:

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

Zoom Community

Join the 100K+ other members in the Zoom Community! Login with your Zoom account credentials and start collaborating.