Migrate Citrix Gateway to Citrix Gateway service for HDX proxy

You can migrate 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 might 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 Citrix Gateway as HDX Proxy

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 are Citrix Virtual Apps and Desktops environments.

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

This feature is now included with your Citrix Virtual Apps service, Citrix Virtual Desktops service, Citrix Virtual Apps and Desktops service, and Workspace Service entitlements. You can enable this feature.

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

On-premises Citrix Gateway appliance is customer managed and cloud based Citrix Gateway service is Citrix managed. This section explains how to migrate from an on-premises Citrix Gateway to cloud hosted Citrix Gateway service for HDX proxy. Though Citrix Gateway 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.

To enable this migration, enable Citrix Gateway service for Citrix Virtual Apps and Desktops. Once enabled, traffic starts traversing through Citrix Gateway service and an on-premises Citrix Gateway is no longer required.

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

  • The customer has subscribed for Citrix Cloud service and has purchased Citrix Virtual Apps and Desktops.

  • The 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 Citrix Virtual Apps and Desktops service users:

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

  2. Click the hamburger icon and choose Workspace Configuration.

  3. Click Service Integrations.

  4. Locate ellipsis next to Gateway, click the ellipsis, and then click Enable.

    Enable Gateway

Following are the steps to enable Citrix 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 ellipsis next to My Resource Location present under Citrix Virtual Apps and Desktops service.

  4. Click the ellipsis, click Configure Connectivity.

    Select configure connectivity

  5. Choose Gateway Service in the pop-up window and then click Save.

    Select gateway service

Roll back to Citrix Gateway

To roll back the HDX proxy to an on-premises Citrix Gateway, perform the following.

  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 ellipsis next to My Resource Location present under Virtual Apps and Desktops.

    Select configure connectivity

  4. Click the ellipsis, click Configure Connectivity.

  5. Choose Traditional Gateway and enter the FQDN.

    Select on-prem gateway

  6. Click Add and then click Save.

Migrate Citrix Gateway to Citrix Gateway service for HDX proxy