Product Documentation

Configure policies

Sep 27, 2016


Follow the installation topics to prepare the Linux VDA. 


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


command 複製

sudo yum -y install openldap

sudo yum -y install libxml2

sudo yum -y install cyrus-sasl

sudo yum -y install cyrus-sasl-gssapi


Policy settings in Citrix Studio

To set policies in Citrix Studio, do the following:

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

LDAP server settings 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 複製


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 複製

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

New policies setting guide

The following policies only exist in Linux VDA and cannot be set from Citrix Studio.

  • ClipboardSelectionFlags
  • PrimarySelectionFlags
  • MaxSpeexQuality

The descriptions of these policies are listed in the policy support list. You can write these values to the registry using the command ctxreg.

command 複製

/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 複製

/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 複製

/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. Refer to the policy support list for detailed descriptions.


Organizational Unit(OU)/User or group filters fail

  • Make sure you perform the LDAP Server Setting according to Configuration
  • If it still fails, do the following:
  1. Download the latest version of xdping from our website and install it.
  2. Run the command: xdping -T ldap.
  3. Follow the instructions listed in xdping.