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
Support | Dell.
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
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 official documentation from
docs.citrix.com to set the VDI settings. All settings are case-sensitive.
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:
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:
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.
Data is not available for the Topic
Please provide ratings (1-5 stars).
Please provide ratings (1-5 stars).
Please provide ratings (1-5 stars).
Please select whether the article was helpful or not.
Comments cannot contain these special characters: <>()\