In this step in the workflow of onboarding a Horizon pod to Horizon Cloud, you use the Horizon Cloud Connector configuration portal to specify details that the Horizon Cloud Connector uses to pair with the Horizon pod's Connection Server. Completing these steps successfully results in that pod connected to your Horizon Cloud tenant environment.

Important: To ensure the proper functioning of the Horizon subscription license and other cloud-hosted services for a pod, you must pair only one Horizon Cloud Connector appliance with that pod. The pairing of more than one appliance with a pod is allowed only under certain circumstances such as appliance updates and troubleshooting procedures.

For an illustration of how the Horizon pod, Horizon Cloud, and Horizon Cloud Connector relate to each other in the pairing process, see the diagram shown in Connect Horizon Cloud Service with an Existing Horizon Pod to Use Horizon Subscription Licenses or Cloud-Hosted Services or Both.

Note: If you encounter connectivity issues with the Horizon Cloud Connector configuration portal, see the troubleshooting information in VMware Knowledge Base (KB) article 79859.

Prerequisites

Verify that you have completed the required preparation steps:

Also, verify that:

  • The Horizon Cloud Connector virtual appliance is powered on.
  • You have the URL for displaying the browser-based Horizon Cloud Connector configuration portal. This URL is based on the IP address of the virtual appliance, such as https://IP-address/ where IP-address is the appliance's IP address. Alternatively, if you have mapped a fully qualified domain name (FQDN) to the Horizon Cloud Connector virtual appliance's IP address in your DNS server, the configuration portal's URL is that FQDN.

Verify that you have fulfilled all the items described in Preparing to Run the Onboarding Wizard to Pair a Horizon Pod with Horizon Cloud Using Horizon Cloud Connector, especially:

Procedure

  1. Obtain the URL for launching the web-based configuration portal.
    • (Horizon pods on premises or in VMware Cloud on AWS) Obtain the URL from the appliance's blue console screen.

      Blue console of the Horizon Cloud Connector as it appears in the vSphere Client.
    • (Horizon pods in Azure VMware Solution) Obtain the URL by navigating to the appliance VM in the Azure portal VM Properties and noting of the IP address or FQDN of the appliance VM. Construct the URL as follows: https://IP-address or FQDN/
  2. Using a browser, navigate to the URL that you obtained in the previous step.
    Important: In this step, the Horizon Cloud Connector makes a connection to Horizon Cloud to display the login screen, which will be used to authenticate your My VMware account credentials with the cloud control plane. This connection is outbound HTTPS using port 443. If you do not see a login screen, verify that you have met the DNS, ports, and protocols requirements.
    The login screen for logging in to the Horizon Cloud Connector configuration portal appears.
  3. In the login screen, enter the My VMware account credentials and click Login.
    The following screenshot is an example of the login screen with the credentials entered before clicking Login.
    Example of the login screen filled in with the appropriate My VMware account credentials.

    When the Terms of Service message appears, click Accept to continue.

    The configuration portal displays the first step of the pod onboarding wizard. The following screenshot illustrates this step before any fields are filled in.
    Screenshot that illustrates the first step of the pod onboarding workflow.
  4. In the Connect to Horizon Connection Server field, enter the FQDN of the pod's Connection Server instance to which you are pairing the Horizon Cloud Connector.
    As you type in the field, the Connect button appears.

  5. When you have typed in the FQDN, click Connect.


    The Horizon Cloud Connector attempts to communicate with the specified Connection Server and retrieve its certificate information. This process can take a few minutes. When communication is established, the page displays the retrieved certificate information.

    If the Connection Server does not have a valid Root CA certificate, a warning message appears saying that the certificate cannot be automatically validated and you must confirm its validity by clicking the check box. The following screenshot is an example of this situation.



    If you see this message, verify that the displayed certificate information is accurate and click the check box so you can proceed to the next step.
    Note: If the Connection Server has a valid Root CA certificate, the wizard automatically validates the information and you can proceed to the next step.
    The following screenshot illustrates the screen after clicking the check box.

  6. In the credentials section, type the domain name and the administrator credentials used by the Connection Server and click Connect.
    This administrator account must have the Horizon predefined Administrators role with root access for the pod. For more information about the requirements of the administrator account, see Preparing to Run the Onboarding Wizard to Pair a Horizon Pod with Horizon Cloud Using Horizon Cloud Connector.

    The following screenshot illustrates this area of the screen.



    Note: At this point, the system detects whether the specified Connection Server instance is already paired with another instance of the Horizon Cloud Connector. In this case, the page displays a message asking whether you want to delete the existing pairing and pair this Connection Server with the new Horizon Cloud Connector instance. If the new Horizon Cloud Connector instance is at a later version than the existing instance, you also have the option to perform an appliance update by copying the existing configuration into the new Horizon Cloud Connector instance, as described in Manually Update the Horizon Cloud Connector Virtual Appliance.

    Click the appropriate action button in the message to continue pairing the pod using the following steps.

    Step 2 of the wizard appears.
  7. In this wizard step, provide details about the pod.
    The following screenshot is an example of this step filled in.

    These details are used in the cloud management plane to associate the paired Connection Server instance and Horizon Cloud Connector with your Horizon Cloud tenant environment. As an example, the specified name, location, and description will be visible in the administrative console so that you can identify this pod from your other pods that are connected to the control plane.
    Option Description
    Name Type a friendly name to identify this pod in your Horizon Cloud tenant environment.
    Data Center Location Select an existing location or click New to specify a new one to use for this pod. In the cloud-based administrative console, your pods are grouped and displayed according to the locations you specify.

    In the City Name text box, start typing the name of a city. The system automatically displays world city names in its backend geography lookup table that match your entered characters, and you can choose a city from that list.

    Note: You must select a city from the system's autocomplete list. Currently, due to a known issue, the location names are not localized.
    Description Optional: Enter a description for this pod.
  8. Proceed to the next wizard step by clicking Save.
    The wizard's configuring step appears. The system checks the connection to the specified Connection Server instance and completes the final configuration steps. The following screenshot is an example of this step.


    When the system determines the pod is successfully connected to the Horizon Cloud control plane, a congratulations screen appears with some guidance text and action buttons for post-configuration management tasks. The screen also shows the health status of activated cloud-hosted services. A gray dash icon indicates that the service is deactivated and therefore has no health status to display.

    The following screenshot is an example of this screen.



    Note: You might see components that always appear in a deactivated state. Such components are planned for use in a future service release. Also, the action buttons on the congratulations screen can vary depending on the version of Horizon Cloud Connector that you have deployed:
    • The Configure vCenter Server and Network Details button is available only if you have deployed Horizon Cloud Connector 1.7 or later.
    • The Configure Automatic Cloud Connector Updates button is available only if you have deployed Horizon Cloud Connector 1.6 or earlier and your Horizon Cloud tenant account is configured for automated updates of the Horizon Cloud Connector. For details about that feature, see the topic Automated Updates of the Horizon Cloud Connector Virtual Appliance in the Administration Guide.
    Note: (Horizon pods in Azure VMware Solution) Due to a known issue with Horizon Cloud Connector 1.7, certain components such as Cloud Broker Client Service, Cloud Gateway Service, Connector Client Service, and HzE-gateway might display with an error state. These error displays are incorrect and can be disregarded.
    Important: (Horizon pods on premises or in VMware Cloud on AWS) If you have deployed Horizon Cloud Connector 1.7 or later, the Horizon Cloud Connector vCenter Server Details window automatically opens in front of the congratulations screen. To support automated updates and the proper functionality of Horizon Cloud Connector, you must enter these mandatory vCenter Server and network details as described in the topic Automated Updates of the Horizon Cloud Connector Virtual Appliance in the Administration Guide. If you close the Horizon Cloud Connector vCenter Server Details window without entering the mandatory details, you will encounter repeated warning messages until you click the Configure vCenter Server and Network Details button and enter the details.


Results

When you reach this point, the pairing workflow is complete. At this point, VMware activates the subscription license, typically within 30 minutes after you paired the pod with the cloud control plane. When VMware has activated the subscription license, a message appears in your pod's web-based management console that indicates your pod is using the subscription type of license. The following screenshot is a sample illustration.

Attention: If 4 hours pass and you still do not see the Connected to License Service message in your pod's web-based management console's licensing area, contact your VMware representative.

Connected to License Service message in pod management console

What to do next

From this point, the pod is successfully paired with Horizon Cloud . For details about those Horizon Cloud Connector administrative and maintenance tasks that are typically done from this point on, see the topic Typical Administrative and Maintenance Tasks You Perform on the Horizon Cloud Connector After the Horizon Pod is Paired with Horizon Cloud in the Administration Guide.

Note: If you have just onboarded your first pod into a new tenant account using Horizon Cloud Connector 1.8 or later and you selected the Basic Feature profile in the deployment wizard, manually turn off the Cloud Monitoring Service (CMS) setting. Due to a known limitation, the CMS setting does not automatically turn off when you select the Basic Feature profile. Turning off the CMS setting manually ensures that the administration console does not make unnecessary attempts to connect to the CMS service.
  1. Select Settings > General Settings.
  2. Turn off the Cloud Monitoring Service toggle.