Product Documentation

Adaptive transport

Feb 23, 2017

Introduction

Adaptive transport is a new data transport mechanism for XenApp and XenDesktop. It is faster, more scalable, improves application interactivity, and is more interactive on challenging long-haul WAN and internet connections. Adaptive transport maintains high server scalability and efficient use of bandwidth. By using adaptive transport, ICA virtual channels automatically respond to changing network conditions. They intelligently switch the underlying protocol between the new Citrix protocol called Enlightened Data Transport (EDT) and TCP to deliver the best performance. It improves data throughput for all ICA virtual channels including Thinwire display remoting, file transfer (Client Drive Mapping), printing, and multimedia redirection. The same setting is applicable for both LAN and WAN conditions.

When set to Preferred, data transport over EDT is used as primary, with fallback to TCP.

By default, adaptive transport is disabled (Off) and TCP is always used.

For testing purposes, you can set Diagnostic mode, in which case only EDT is used, and fallback to TCP is disabled. 

localized image

Requirements and considerations

  • XenApp and XenDesktop 7.13
  • VDA for Desktop OS 7.13
  • VDA for Server OS 7.13
  • StoreFront 3.9
  • Citrix Receiver for Windows 4.7
  • Citrix Receiver for Mac 12.5
  • Citrix Receiver for iOS 7.2
  • IPv4 VDAs only. IPv6 and mixed IPv6 and IPv4 configurations are not supported.
  • NetScaler 11.1-51.21. For more information on NetScaler configuration, see Configuring NetScaler Gateway to support Advanced Transport.

Configuration

  1. Install XenApp and XenDesktop 7.13.
  2. Install StoreFront 3.9.
  3. Install the 7.13 VDA (for Desktop OS or Server OS)
  4. Install Citrix Receiver for Windows 4.7 (Citrix Receiver for Mac 12.4 or Citrix Receiver for iOS 7.2).
  5. In Studio, enable the policy setting, HDX Adaptive Transport (it is disabled by default). We also recommend that you do not enable this feature as a universal policy for all objects in the Site.
    • To enable the policy setting, set the value to Preferred, then click OK.
      • Preferred. Adaptive transport over EDT is used when possible, with fallback to TCP.
      • Diagnostic mode. EDT is forced on and falls back to TCP is disabled. We recommend this setting only for troubleshooting.
      • Off. TCP is forced on, and EDT is disabled.
  6. Click Next, and complete the steps in the wizard.
  7. 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.
  8. Launch a session from a supported Citrix Receiver to establish a connection using adaptive transport.
  9. For secure external access, configure DTLS encryption on NetScaler Unified Gateway. For more information, see Configuring NetScaler Gateway to support Advanced Transport.

To confirm that the policy setting has taken effect:

  • Check that the ICA UDP services are enabled on a VDA using netstat -a.
  • Check that the virtual channels are running over EDT using Director or the CtxSession.exe command-line utility available on the VDA.

Director example

In Director, Session Details > Connection Type displays the policy settings. Look for Connection type HDX. If the protocol is UDP, EDT is active for the session. If the protocol is TCP, the session is in fallback or default mode. If the Connection type is RDP, ICA is not in use and the protocol is n/a. For more information, see Monitor sessions.

localized image

 

CtxSession.exe example

This example illustrates that EDT over UDP is active for the session. Type CtxSession.exe in the command line.

C:\Program Files (x86)\Citrix\System32>CtxSession

Session 2 Transport Protocols: UDP -> CGP -> ICA

To see verbose statistics, use the -v switch:

>CtxSession -v