Product Documentation

Configure delivery controllers

Sep 27, 2016

XenDesktop 7.7 or higher includes the necessary changes to support Linux Virtual Desktop, however, for previous versions a hotfix or update script is required. The installation and verification of these are provided in this section. 

Update delivery controller configuration

For XenDesktop 7.6 SP2, apply the Hotfix Update 2 to update the Broker for Linux Virtual Desktops. Hotfixes Update 2 is available here:

  • CTX142438: Hotfix Update 2 - For Delivery Controller 7.6 (32-bit) – English
  • CTX142439: Hotfix Update 2 - For Delivery Controller 7.6 (64-bit) – English

For earlier versions of XenDesktop, a PowerShell script named Update-BrokerServiceConfig.ps1 is provided which updates the broker service configuration. This is available in the following package:


Repeat the following steps on every Delivery Controller in the farm:

  1. Copy the Update-BrokerServiceConfig.ps1 script to the Delivery Controller machine.
  2. Open a Windows PowerShell console in the context of the local administrator.
  3. Browse to the folder containing the script.
  4. Execute the script:


command 複製



By default, PowerShell is configured to prevent the execution of PowerShell scripts. If the script fails to run, you may need to change the PowerShell execution policy before trying again:

command 複製

Set-ExecutionPolicy Unrestricted

The Update-BrokerServiceConfig.ps1 script updates the Broker service configuration file with new WCF endpoints required by the Linux VDA and restarts the broker service.  The script determines the location of the broker service configuration file automatically. A backup of the original configuration file is created in the same directory with the extension .prelinux.

These changes will have no impact on the brokering of Windows VDA's configured to use the same Delivery Controller farm. This allows for a single Controller farm to manage and broker sessions to both Windows and Linux VDAs seamlessly.

Verify delivery controller configuration

To verify whether the required configuration changes have been applied to a Delivery Controller, confirm the stringEndpointLinux appears five times in the file:

command 複製


From the Windows command prompt, logged on as a local administrator:

command 複製

cd "%PROGRAMFILES%"\Citrix\Broker\Service\

findstr EndpointLinux BrokerService.exe.config