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.
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.
Verify that you have completed the required preparation steps:
- Verify that you have completed the steps in the applicable subtopics under Download and Deploy the Horizon Cloud Connector into Your Pod's Environment.
- If you have deployed Horizon Cloud Connector 1.6 or later, verify that you have completed the steps in Verify the Horizon Pod and Virtual Appliance Are Ready to Be Paired.
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:
- You have met the DNS, ports, and protocols requirements when using the Horizon Cloud Connector to pair a Horizon pod with Horizon Cloud.
- Your DNS configuration in your network topology enables the deployed Horizon Cloud Connector to resolve the FQDN of the pod's Connection Server. If the deployed Horizon Cloud Connector cannot resolve the Connection Server using DNS, the onboarding wizard will encounter an unexpected error at the step where you enter the pod's domain credentials.
- The Horizon Cloud Connector virtual appliance must reach the Internet to talk to the Horizon Cloud control plane and display the browser-based configuration portal. If your environment requires use of a proxy server and proxy configuration with deployed appliances, verify that you have configured the deployed Horizon Cloud Connector appliance with the proxy settings required for your environment. See the proxy-related information in Preparing to Run the Onboarding Wizard to Pair a Horizon Pod with Horizon Cloud Using Horizon Cloud Connector, Horizon Cloud Connector Known Considerations, and Modifying Proxy Settings for Horizon Cloud Connector 1.6 or Later.
- You have the credentials of the My VMware account that is associated with the Horizon Cloud customer account to which you are pairing the pod. As described in Connect Horizon Cloud Service with an Existing Horizon Pod to Use Horizon Subscription Licenses or Cloud-Hosted Services or Both, a My VMware account is required to authenticate with the cloud management plane to set up the connector and establish the connection to use that license for the Horizon subscription offerings.
- 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.
- (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/
- (Horizon pods on premises or in VMware Cloud on AWS) Obtain the URL from the appliance's blue console screen.
- 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.
- 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.
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.
- 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.
- 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.
- 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.
- 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.
- 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:
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.
- 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.
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.
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.
- Select .
- Turn off the Cloud Monitoring Service toggle.