Product Documentation

Configure Delivery Controllers

May 22, 2017

XenDesktop 7.6 or an earlier version requires the necessary changes to support the Linux VDA. Thus, for these versions of XenDesktop, a hotfix or update script is required. The installation and verification are provided in this article.  

Update Delivery Controller configuration

For XenDesktop 7.6 SP2, apply Hotfix Update 2 to update the Broker for Linux Virtual Desktops. Hotfix 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, you can use the PowerShell script named Update-BrokerServiceConfig.ps1 to update the Broker Service configuration. This script 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 Copy



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

command Copy

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 VDAs 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 that the stringEndpointLinux appears five times in the file:

file Copy


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

command Copy

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

findstr EndpointLinux BrokerService.exe.config