Product Documentation

Configure policies

May 22, 2017


Follow the installation articles to prepare the Linux VDA.  


Make sure that you install these dependencies before installing the Linux VDA package.


command Copy

sudo yum -y install openldap

sudo yum -y install libxml2

sudo yum -y install cyrus-sasl

sudo yum -y install cyrus-sasl-gssapi


command Copy

sudo zypper install openldap2

sudo zypper install libxml2

sudo zypper install cyrus-sasl

sudo zypper install cyrus-sasl-gssapi


command Copy

sudo apt-get install -y libldap-2.4-2

sudo apt-get install -y libsasl2-2

sudo apt-get install -y libsasl2-modules-gssapi-mit


Policy settings in Citrix Studio

To set policies in Citrix Studio, do the following:

  1. Open Citrix Studio
  2. Select the Policies panel. 
  3. Click Create Policy
  4. Set the policy according to the Policy support list

LDAP server setting on the VDA

The LDAP server setting on Linux VDA is optional for single domain environments but mandatory for multiple domain and multiple forest environments. This setting is required by the policy service to perform an LDAP search in these environments.

After installing the Linux VDA package, run the command:

command Copy


Enter all the LDAP servers in the suggested format: space-separated list of LDAP Fully Qualified Domain Names (FQDNs) with the LDAP port (e.g. 

localized image

You can also run the ctxreg command to write this setting to the registry directly:

command Copy

/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -t "REG_SZ" -v "ListOfLDAPServers" -d "" --force

New policy settings for the Linux VDA

The following policies apply only to the Linux VDA and can be configured only from Citrix Studio Version 7.12 or later:

  • ClipboardSelectionUpdateMode
  • PrimarySelectionUpdateMode
  • MaxSpeexQuality

These policies are described in the Policy support list. If you are using Citrix Studio Version 7.11 or earlier, you must configure these policies locally on the Linux VDA using the ctxreg command:

command Copy

/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\VirtualChannels\Clipboard\ClipboardSelection" -t "REG_DWORD" -v "Flags" -d "your value" --force

command Copy

/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\VirtualChannels\Clipboard\PrimarySelection" -t "REG_DWORD" -v "Flags" -d "your value" --force

command Copy

/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\VirtualChannels\Audio" -t "REG_DWORD" -v "MaxSpeexQuality" -d "your value" --force


The values are restricted to a certain range. For detailed descriptions, see the Policy support list.