How to Configure HDX Enlightened Data Transport Protocol

How to Configure HDX Enlightened Data Transport Protocol

book

Article ID: CTX220732

calendar_today

Updated On:

Description

Adaptive transport for XenApp and XenDesktop optimizes data transport by leveraging a new Citrix protocol called Enlightened Data Transport (EDT) in preference to TCP whenever possible. Compared to TCP and UDP, EDT delivers a superior user experience on challenging long-haul WAN and Internet connections, dynamically responding to changing network conditions while maintaining high server scalability and efficient use of bandwidth. EDT is built on top of UDP and improves data throughput for all ICA virtual channels, including Thinwire display remoting, file transfer (Client Drive Mapping), printing, multimedia redirection (though we still recommend to use the ‘Audio over UDP real-time transport’ policy, since EDT is a reliable protocol. Setting that policy will effectively pull Audio out of EDT and allow it to run over a separate UDP port with no reliability). When UDP is not available, adaptive transport automatically reverts to TCP.

 User-added image

EDT runs on UDP ports 1494 and 2598.

  • CGP (therefore Session Reliability) is optional on direct EDT connections between Receiver and VDA (e.g. corporate MPLS), so the VDA could be listening on UDP 1494 only

  • CGP is required for EDT connections via NetScaler Gateway (VDA would be listening on UDP 2598 and 1494 but effectively using 2598)
    This is because of the role Session Reliability plays in the UDP-to-TCP fallback feature, as well as the fact that CGP is used as an authorization protocol via NetScaler (it carries the STA Ticket).

  • So if you have a NetScaler Gateway, EDT requires you enable Session Reliability, which in turn enables CGP.

  • Session Reliability is enabled in a Studio policy, and Storefront (Manage NetScaler Gateway > Select your NetScaler > Secure Ticket Authority > “Enable Session Reliability”)

    User-added image


Instructions

  1. In Studio, create or edit a policy to enable the setting, HDX Adaptive Transport (it is disabled by default. Note: In XenApp and XenDesktop 7.16, EDT is enabled by default). We also recommend that you do not enable this feature as a universal policy for all objects in the Site.
    1. To enable the policy setting, set the value to Preferred, then click OK.
      1. Preferred – Transporting data over UDP is used when possible, with fallback to TCP.
      2. Diagnostic mode - This value will always transport data over UDP, and fall back to TCP is disabled. We recommend this setting only for troubleshooting.
      3. Off - TCP is always used, and EDT is disabled.
HDX Adaptive Transport Policy
  1. Click Next, and complete the steps in the wizard.
  2. The policy takes effect when the user reconnects the ICA session. Though not required, you can run gpupdate /force to pull the policy setting to the server, but the user still has to reconnect the ICA session.
gpupdate /force
  1. Launch a session from a supported Citrix Receiver to establish a connection using Adaptive Transport.
  2. For secure external access, configure DTLS encryption on NetScaler Unified Gateway. For more information, see Configuring NetScaler Gateway to support Enlightened Data Transport.
  3. Open the right UDP Ports in the DMZ Firewalls:                                                                                    

User-added image

Note: If using the Command Line install for the VDA, then the UDP Ports need to be explicitly opened.

XenDesktopVDASetup.exe /ENABLE_HDX_UDP_PORTS

Not to be confused with pre-existing command line:  
/ENABLE_HDX_PORT which only opens Audio/RTP ports
 

Note: It is possible to disable the HDX Enlightened Data Transport policy on a per client basis even if the policy is enabled in Citrix Studio. This can be accomplished by adding the “receiver.adml” template to the client machine and changing the GPO setting at Computer Configuration > Administrative Templates > Citrix Receiver > Network > Routing > Transport Protocol for Receiver to: Enabled (EDT first with fallback to TCP) or Off (TCP).
 
Note: When the HDX Adaptive Transport policy changes and it requires us to stop an active Listener, all sessions currently connected via that Listener are gracefully disconnected. The users must then re-launch their sessions.

Additional Information