Product Documentation

Citrix Cloud Connector requirements

The Citrix Cloud Connector is a component with a collection of Windows services installed on Windows Server 2012 R2 or Windows Server 2016.

System requirements

The machine hosting the Cloud Connector must meet the following requirements:

  • Microsoft .NET Framework 4.5.1 or later installed
  • Joined to an Active Directory domain that contains the resources and users that you will use to create offerings for your users.
  • Connected to a network that can contact the resources you will use in your resource location. For more information, see Cloud Connector Proxy and Firewall Configuration.
  • Connected to the Internet. For more information, see Connectivity requirements.
  • Server clock is set to the correct UTC time.

Installation requirements

  • Download the Cloud Connector software only from Citrix Cloud Government and install it on prepared machines. By default the Cloud Connector installer attempts to connect with the control plane from which it is downloaded. So, if you attempt to install the software downloaded from a commercial Citrix Cloud account, the installer will not connect with Citrix Cloud Government.
  • Because the Cloud Connector software is downloaded, your browser must allow downloading executable files.
  • Install the Cloud Connector on domain-joined machine. If the machine is not joined to a domain, the Cloud Connector installer prevents the installation.
  • The machine where you are installing the Cloud Connector must be in sync with UTC time.
  • Turn off Internet Explorer Enhanced Security Configuration (IE ESC). If this is turned on, the Cloud Connector might not be able to establish connectivity with Citrix Cloud.
  • Ensure you’ve met the Connectivity requirements for all machines where you install the Cloud Connector.
  • If you’re installing the Cloud Connector in an environment that has a web proxy or strict firewall rules, see Citrix Cloud Connector proxy and firewall configuration for requirements before continuing the installation.
  • Ensure FIPS is not enabled on the machine you are installing the Cloud Connector. The Cloud Connector isn’t supported for use with FIPS-enabled machines. If you attempt to install the Cloud Connector on a FIPS-enabled machine, the installation fails.

Important installation considerations

  • Do not install the Cloud Connector on an Active Directory domain controller or any other machine critical to your resource location infrastructure. Regular maintenance on the Cloud Connector will perform machine operations that will cause an outage to these additional resources.
  • Do not download or install other Citrix products on the machines hosting the Cloud Connector.
  • Do not download or install the Cloud Connector on machines that are part of other Citrix product deployments (for example, Delivery Controllers in a XenDesktop deployment).

Important usage considerations

  • Keep all Cloud Connectors powered on at all times to ensure an always-on connection to Citrix Cloud Government.
  • Do not upgrade a previously-installed Cloud Connector with a newer version. Instead, uninstall the old Cloud Connector and then install the new one.
  • Citrix strongly recommends enabling Windows Update on all machines hosting the Cloud Connector.
  • Citrix strongly recommends installing at least two (2) Cloud Connectors in each resource location. In general, the number of Cloud Connectors you should install is N+1, where N is the capacity needed to support the infrastructure within your resource location. This ensures the connection between Citrix Cloud Government and your resource location remains intact in the event any single Cloud Connector becomes unavailable.
  • Each Active Directory forest you plan to use with Citrix Cloud Government should be reachable by two Cloud Connectors at all times.
  • After installation, do not move the machine hosting the Cloud Connector into a different domain. If the machine needs to be joined to be a different domain, uninstall the Cloud Connector and then re-install it after the machine is joined to the different domain.## View the health of the Cloud Connector

The Resource Locations page in Citrix Cloud Government displays the health status of all the Cloud Connectors in your resource locations.

Supported Active Directory functional levels

The Citrix Cloud Connector supports the following forest and domain functional levels in Active Directory.

Forest Functional Level Domain Functional Level Supported Domain Controllers
Windows Server 2008 R2 Windows Server 2008 R2 Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Server 2016
Windows Server 2008 R2 Windows Server 2012 Windows Server 2012, Windows Server 2012 R2, Windows Server 2016
Windows Server 2008 R2 Windows Server 2012 R2 Windows Server 2012 R2, Windows Server 2016
Windows Server 2008 R2 Windows Server 2016 Windows Server 2016
Windows Server 2012 Windows Server 2012 Windows Server 2012, Windows Server 2012 R2, Windows Server 2016
Windows Server 2012 Windows Server 2012 R2 Windows Server 2012 R2, Windows Server 2016
Windows Server 2012 Windows Server 2016 Windows Server 2016
Windows Server 2012 R2 Windows Server 2012 R2 Windows Server 2012 R2, Windows Server 2016
Windows Server 2012 R2 Windows Server 2016 Windows Server 2016
Windows Server 2016 Windows Server 2016 Windows Server 2016

Troubleshoot the Cloud Connector

The first step in diagnosing any issues with the Cloud Connector is to check the event messages and event logs. If you don’t see the Cloud Connector listed in your resource location or is “not in contact,” the event logs will provide some initial information.

If the Cloud Connector is “disconnected” and the event logs don’t indicate why a connection can’t be established between the Cloud Connector and Citrix Cloud, contact Citrix Support.

If the Cloud Connector is in an “error” state, there might be a problem hosting the Cloud Connector. Install the Cloud Connector on a new machine. If the issue persists, contact Citrix Support.

To troubleshoot commmon issues with installing or using the Cloud Connector, refer to CTX221535.

Event messages

Event messages are available in the Windows Event viewer on the connector machine. The Windows event logs that the Cloud Connector generates are in the following documents:

Event logs

By default, event logs are located in the C:\ProgramData\Citrix\WorkspaceCloud\Logs directory of the machine hosting the Cloud Connector.