Product Documentation

Migrate Citrix ADC VPX to Citrix Gateway service for HDX proxy

This following sections guides you in migrating from a Citrix ADC VPX 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 XenApp Service, XenDesktop Service, XenApp and XenDesktop Service, or Workspace Service they are entitled to use on premise Citrix ADC VPX for HDX. Number of VPXs provided depended on the volume of service purchased. Customers are expected to use these VPXs for only HDX proxy and it is EULA enforced.

Figure 1. Deployment with Citrix ADC VPX 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 on premise Citrix ADC VPX to cloud based Citrix Gateway service

VPX is customer managed and cloud service is Citrix managed. This section explains how to migrate from on-premise 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 pretty simple and straight forward with just a few clicks.

Also, please refer to FAQs for any additional information.

To enable this migration, just enable Citrix Gateway service for XenApp and XenDesktop service. Once enabled, traffic will start traversing through Citrix Gateway service and on premise Citrix ADC VPX will no longer be required.

Following are the assumptions made before you begin migration from on premise Citrix ADC VPX to cloud based Citrix Gateway service.

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

  • Customer uses on-premise 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 pop up window and click Save.

    localized image

Roll back to VPX

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

Following are the steps to roll back the HDX proxy to on premise 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 on premise 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 ADC VPX to Citrix Gateway service for HDX proxy