Dell ThinOS 2402 Administrator’s Guide

VDI Configuration Editor

ThinOS enables the IT administrator to configure the VDI-related settings by dynamically modifying the VDI configuration files of your ThinOS device. You can configure the Citrix settings, Horizon Blast settings, and Zoom plug-in settings either using Admin Policy Tool or Wyse Management Suite.

To use the VDI settings feature, you must first upgrade to Wyse Management Suite v3.5.866 using the Configuration UI package v1.5 300 or later. If you are using Wyse Management Suite public cloud, the Configuration UI package is updated automatically by Dell.

NOTE:Ensure that you read the disclaimer on the VDI Configuration Editor page before configuring the options. Improper configuration may lead to VDI applications not work properly. You must also read the Citrix, VMware, and Zoom official documentation from their respective websites to set the relevant VDI settings. All settings are case-sensitive.

To access the configuration page, go to Advanced > VDI Configuration Editor on Wyse Management Suite policy settings or Admin Policy Tool. For more information about how to configure the VDI dynamic settings, see the Dell Wyse ThinOS 9.1.4234 and 9.1.5xxx Administrator's Guide at www.dell.com/support.

NOTE:VDI settings dynamically write into the VDI configuration files of the device. For settings to take effect, you must log out and log in to the broker again, or configure the settings before logging into the broker.

Citrix Configuration Editor

Citrix VDI settings

Citrix settings are classified by VDI application and configuration type. The following Citrix VDI settings are supported:

Citrix INI settings
Citrix XML settings
Citrix JSON settings
Citrix Keyboard layout settings

To update the file settings for Citrix VDI, see the Citrix Workspace app documentation at docs.citrix.com.

The following are the supported configuration file paths for the Citrix Workspace app:

/opt/Citrix/ICAClient/config/All_Regions.ini
/opt/Citrix/ICAClient/module.ini
~/.ICAClient/wfclient.ini
/opt/Citrix/ICAClient/config/wfclient.template
/opt/Citrix/ICAClient/config/AuthManConfig.xml
/opt/Citrix/ICAClient/config/kbdlayoutmap.tbl
/var/.config/citrix/hdx_rtc_engine/config.json
~/.ICAClient/appsrv.ini

Citrix INI settings allow you to enable or disable the Unified Communication Optimization when UC packages are installed on ThinOS. The following UC configurations are qualified by Dell Technologies:

Table 1. Enable or disable UC plug-in settingsEnable or disable UC plug-in settings.
UC Plug-ins	Enable UC Plug-in using VDI settings	Disable UC Plug-in using VDI settings	Details
Zoom Citrix	File: module.ini Operation: Add or Update Section: ICA 3.0 Key: ZoomMedia Value: On These settings enable the Zoom optimization with ZoomMedia=On in module.ini. These are the default settings after you install the UC package.	File: module.ini Operation: Add or Update Section: ICA 3.0 Key: ZoomMedia Value: Off These settings disable the Zoom optimization with ZoomMedia=Off in module.ini.	Change the values On/Off in module.ini to enable or disable the UC plug-in. Plug-in switch string is in the section [ICA 3.0].
Cisco Webex VDI	File: module.ini Operation: Add or Update Section: ICA 3.0 Key: CiscoTeamsVirtualChannel Value: On These settings enable Cisco Webex VDI optimization with CiscoTeamsVirtualChannel=On in module.ini. These are the default settings after you install the UC package.	File: module.ini Operation: Add or Update Section: ICA 3.0 Key: CiscoTeamsVirtualChannel Value: Off These settings disable Cisco Webex VDI optimization with CiscoTeamsVirtualChannel= Off in module.ini.	Change the values On/Off in module.ini to enable or disable the UC plug-in. Plug-in switch string is in the section [ICA 3.0].
Cisco Webex MeetingsVDI	File: module.ini Operation: Add or Update Section: ICA 3.0 Key: CiscoMeetingsVirtualChannel Value: On These settings enable Cisco Webex Meetings VDI optimization with CiscoMeetingsVirtualChannel=On in module.ini. These are the default settings after you install the UC package.	File: module.ini Operation: Add or Update Section: ICA 3.0 Key: CiscoMeetingsVirtualChannel Value: Off These settings disable Cisco Webex Meetings VDI optimization with CiscoMeetingsVirtualChannel=Off in module.ini.	Change the values On/Off in module.ini to enable or disable the UC plug-in. Plug-in switch string is in the section [ICA 3.0].
Cisco Jabber	File: module.ini Operation: Add or Update Section: ICA 3.0 Key: CiscoVirtualChannel Value: On These settings enable Cisco JVDI optimization with CiscoVirtualChannel=On in module.ini. These are the default settings after you install the UC package.	File: module.ini Operation: Add or Update Section: ICA 3.0 Key: CiscoVirtualChannel Value: Off These settings disable Cisco JVDI optimization with CiscoVirtualChannel=Off in module.ini.	Change the values On/Off in module.ini to enable or disable the UC plug-in. Plug-in switch string is in the section [ICA 3.0].
Microsoft Teams	File: module.ini Operation: Add or Update Section: ICA 3.0 Key: VDWEBRTC Value: On These settings enable Microsoft Teams optimization with VDWEBRTC =On in module.ini. These are the default settings after you install the UC package.	File: module.ini Operation: Add or Update Section: ICA 3.0 Key: VDWEBRTC Value: Off These settings disable Microsoft Teams optimization with VDWEBRTC=Off in module.ini.	Change the values On/Off in module.ini to enable or disable the UC plug-in. Plug-in switch string is in the section [ICA 3.0].
RTME	File: module.ini Operation: Add or Update Section: ICA 3.0 Key: HDXRTME Value: On These settings enable Skype for business optimization with HDXRTME =On in module.ini. These are the default settings after you install the UC package.	File: module.ini Operation: Add or Update Section: ICA 3.0 Key: HDXRTME Value: Off These settings disable Skype for business optimization with HDXRTME =Off in module.ini	Change the values On/Off in module.ini to enable or disable the UC plug-in. Plug-in switch string is in the section [ICA 3.0].

Horizon Blast Configuration Editor

NOTE:Ensure that you read the disclaimer on the VDI Configuration Editor page before configuring the options. Improper configuration may lead to VDI applications not work properly. You must also read the VMware official documentation at docs.vmware.com to set the VDI settings. All settings are case-sensitive. If a setting is defined in multiple locations, to know the value that must be used, see the VMware documentation.

The following are the supported configuration file paths for Horizon Blast Client:

~/.vmware/config
~/.vmware/view-preferences
/etc/vmware/config
/etc/vmware/view-default-config

Enable USB trace log—If you face any issues that are related to the USB device, you can enable the USB trace log for debugging purposes. Use the following settings in the ~/.vmware/config configuration file:

 view-usbd.logLevel = "trace"
log.logMinLevel = 140
loglevel.user.usb = 10

Numeric keypad numlock——If you face any issue that is related to the Num Lock key of the USB numeric keypad, you can use the following setting in the ~/.vmware/config configuration file to resolve the issue:

 mks.keyboard.suppressNumlocks = "TRUE" 
mks.keyboard.enableHotkeyNumlockBinding = "TRUE"

Zoom Plugin Configuration Editor

NOTE:Ensure that you read the disclaimer on the VDI Configuration Editor page before configuring the options. Improper configuration may lead to VDI applications not work properly. You must also read the Zoom official documentation at support.zoom.us to set the VDI settings. All settings are case-sensitive. To update the file settings under Zoom INI, see the Cisco document at Configuring the Zoom VDI Linux plugin with ZoomMedia.ini - Zoom Support.

The following are the supported configuration file paths for Zoom plug-ins:

Zoom Citrix— ~/.ICAClient/config/ZoomMedia.ini
Zoom Horizon— ~/.vmware/ZoomMediaVmware.ini

Important notes

Using the VDI configuration files, you cannot modify the following ThinOS settings that are in the Admin Policy Tool or Wyse Management Suite policy settings. A warning message is displayed when you modify the settings using VDI Configuration Editor.

Table 2. ThinOS settings - Not allowed to be modifiedThinOS list.
VDI/UC	Configuration files	Deny list
Citrix Workspace app	/opt/Citrix/ICAClient/usb.conf	All
	/opt/Citrix/ICAClient/config/All_Regions.ini	[Virtual Channels\Serial Port\Device] LastComPortNum=8 ComPort1= ComPort2= ComPort3= ComPort4= ComPort5= ComPort6= ComPort7= ComPort8=
	/opt/Citrix/ICAClient/config/module.ini	[ICA 3.0] KeyboardSync=
	~/.ICAClient/wfclient.ini	[WFClient] Version= KeyboardLayout= KeyboardMappingFile= KeyboardDescription= KeyboardType= CDMAllowed= DrivePath* DriveEnabled* DriveReadAccess* DriveWriteAccess* CursorStipple= TransportReconnectEnabled= ClientPrinterList= SFRAllowed EnableUDPAudio HDXWebCamWidth HDXWebCamHeight HDXWebCamFramesPerSec
	/var/.config/citrix/hdx_rtc_engine/config.json	{ "ProxyHostname": "xxxx", "ProxyPort": xx }
	~/.ICAClient/appsrv.ini	[WFClient] COMAllowed=
VMware Horizon	~/.vmware/config	viewusb.AllowAutoDeviceSplitting= viewusb.SplitExcludeVidPid= viewusb.SplitVidPid= viewusb.ExcludeVidPid= viewusb.IncludeVidPid= viewusb.IncludeFamily= viewusb.ExcludeFamily= mks.enableFIPSMode= usb.enableFIPSMode= viewusb.ExcludeAllDevices=
Zoom Citrix	~/.ICAClient/config/ZoomMedia.ini	[PROXY] proxyType= httpProxyHost= httpProxyPort= httpsProxyHost= httpsProxyPort=
Zoom Horizon	~/.vmware/ZoomMediaVmware.ini	[PROXY] proxyType= httpProxyHost= httpProxyPort= httpsProxyHost= httpsProxyPort=
Key Common Rule	N/A	Cmd, Command, Drive, Path special characters, such as: ~`!@#$%^&*()+=;:"'<>,?/ This rule is applied to Citrix INI Settings, Citrix XML Settings, Citrix JSON Settings, Horizon Blast Key-Value Settings, Zoom INI Settings Key fields, and keyboardID field in Citrix Keyboard Layout. Cmd, Command, Drive, and Path are partially matched. They cannot be contained in any inputs. 'proxyTypeTT' not in the deny list, but 'Cmd', 'Cmd1', 'Cmd2' are in the deny list. Special characters are not applied to Citrix INI Settings and Zoom INI Settings key fields.
Value field constriction	N/A	Unicode '..', '/' %2e%2e%2f— Unicode like input, such as '\u0001', '\uff01' %2e%2e%2f is URL encoding output, denote '../'
Case Insensitive	N/A	Only applied to Citrix INI Settings, Citrix XML Settings, Citrix JSON Settings, Horizon Blast Key-Value Settings, Zoom INI Settings Key fields, and keyboardID field in Citrix Keyboard Layout.

NOTE: Enabling or disabling the UC plug-in settings in VDI Configuration Editor > Citrix Configuration Editor is deprecated from ThinOS 2211.

Welcome

Welcome to Dell

Dell ThinOS 2402 Administrator’s Guide

VDI Configuration Editor

Rate this content