Product Documentation

Migrate Citrix Gateway to Citrix Gateway service for HDX proxy

The following sections guide you in migrating from a Citrix Gateway for HDX proxy and to a fully managed cloud-based HDX proxy powered by Citrix Gateway service on Citrix Cloud.

Cloud based HDX Proxy

When Citrix Cloud customers purchase Citrix Virtual App Service, Virtual Desktop Service, Virtual App and Desktop Service, or Workspace Service they may use an on premises Citrix Gateway for secure remote access. The Citrix Gateway is purchased separately.

Figure 1. Deployment with Citrix Gateway as HDX Proxy localized image

Citrix Gateway service is a cloud based HDX proxy that provides secure remote access through a cloud-based gateway that front-ends virtual apps and desktop environments that is XenApp and XenDesktop environments.

Figure 2. Deployment with Citrix Gateway service as HDX Proxy localized image

This feature is now included with your XenApp Service, XenDesktop Service, XenApp and XenDesktop Service and Workspace Service entitlements. You can enable this feature.

Migration from an on premises Citrix Gateway to cloud based Citrix Gateway service

VPX is customer managed and cloud service is Citrix managed. This section explains how to migrate from an on premises VPX to cloud hosted Citrix Gateway service for HDX proxy. Though VPX and Citrix Gateway service provide HDX proxy, the underlying infrastructure and working mechanism is different. However, steps to enable HDX proxy on cloud is simple and straight forward with just a few clicks.

Also, please refer to FAQs for any additional information.

To enable this migration, enable Citrix Gateway service for XenApp and XenDesktop service. Once enabled, traffic starts traversing through Citrix Gateway service and an on premises Citrix Gateway will no longer be required.

Following are the assumptions made before you begin migration from an on premises Citrix Gateway to cloud based Citrix Gateway service.

  • Customer has subscribed for Citrix cloud service and has purchased XenApp and XenDesktop service.

  • Customer uses an on premises Active Directory to authenticate users on cloud.

Enable the Citrix Gateway service

Following are the steps to enable Citrix Gateway service for XenApp and XenDesktop service users:

  1. Sign into Citrix Cloud Services as an admin user.

  2. In the XenApp and XenDesktop Service menu, choose Manage > Service Delivery. The Service Delivery screen appears.
  3. Click NetScaler Gateway.
  4. Click Use cloud hosted Citrix NetScaler Gateway and click Save.

    localized image

Following are the steps to enable NetScaler Gateway Service for Citrix Workspace users.

  1. Sign into Citrix Cloud Services as an admin user.

  2. Click the hamburger icon and choose Workspace Configuration.

  3. In the Access tab under External Connectivity section, locate ellipses next to My Resource Location present under XenApp XenDesktop Service. Click the ellipses, click Configure Connectivity.

    localized image

  4. Choose NetScaler Gateway Service in the pop-up window and click Save.

    localized image

Roll back to VPX

To roll back the HDX proxy to an on premises VPX, please follow the below steps.

Following are the steps to roll back the HDX proxy to an on premises VPX for XenApp and XenDesktop service users.

  1. Sign into Citrix Cloud Services as an admin user.

  2. In the XenApp and XenDesktop Service menu, choose Manage > Service Delivery. The Service Delivery screen appears.

  3. Click NetScaler Gateway.

  4. Click Use your own NetScaler Gateway in resource location.

  5. Enter your NetScaler Gateway URL and click Save.

Following are the steps to roll back the HDX proxy to an on premises VPX for Citrix Workspace users.

  1. Sign into Citrix Cloud Services as an admin user.

  2. Click the hamburger icon on the top left and choose Workspace Configuration.

  3. In the Access tab under External Connectivity section, locate ellipses next to My Resource Location present under XenApp XenDesktop Service.

  4. Click the ellipses, click Configure Connectivity, and click Save.

  5. Choose Add Existing NetScaler Gateway in pop-up window and click Add. Click Save.

Migrate Citrix Gateway to Citrix Gateway service for HDX proxy