Product Documentation

Configure Delivery Controllers

Feb 26, 2018

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:

  • citrix-linuxvda-scripts.zip

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 Update-BrokerServiceConfig.ps1 script.
  4. Run the Update-BrokerServiceConfig.ps1 script:
Command Copy

.\Update-BrokerServiceConfig.ps1

Tip

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

Command Copy

Set-ExecutionPolicy Unrestricted

The Update-BrokerServiceConfig.ps1 script updates the Broker Service configuration file by using 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 .prelinux appended to the file name.

These changes have no impact on the brokering of Windows VDAs configured to use the same Delivery Controller farm. A single Controller farm can manage and broker sessions for both Windows and Linux VDAs seamlessly.

Verify Delivery Controller configuration

When the required configuration changes have been applied to a Delivery Controller, the EndpointLinux string appears five times in the %PROGRAMFILES%\Citrix\Broker\Service\BrokerService.exe.config file.

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

Command Copy

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

findstr EndpointLinux BrokerService.exe.config