This list is a high level of the steps when you are onboarding your very first pod to your Horizon Cloud tenant environment and that pod is an existing Horizon pod that you have already stood up in a supported VMware SDDC (software-defined data center) environment. Such a manually deployed pod is one that you manually installed and configured in the VMware SDDC. After these onboarding steps are completed for your very first cloud-connected pod, the subscription license is applied to that onboarded pod. Additionally, if you selected the Full Feature option when deploying Horizon Cloud Connector, you can start using the cloud-hosted services that Horizon Cloud provides for that pod type, which include the Cloud Monitoring Service (CMS). At that point, you can also onboard additional pods.
The following diagram illustrates the overall flow.
Before beginning this workflow, you must have already installed and configured that Horizon pod. For information about manually installing a Horizon pod that you can use with this Horizon Cloud release:
- See the VMware Horizon software installation information according to the software edition that is running on the pod that you are going to connect to the cloud plane — Horizon 7 Documentation page or Horizon Documentation page.
- When manually installing Horizon pods using VMware Cloud on AWS capacity, start with the best practices guide for deploying Horizon pods on VMware Cloud on AWS, available from the Horizon on VMware Cloud on AWS product page.
- For installing Horizon pods on Azure VMware Solution (AVS), start with Tech Zone's Horizon on Azure VMware Solution Architecture and Horizon on Azure VMware Solution Configuration.
You onboard these types of pods to the cloud for two primary use cases: to activate a subscription license for that pod and to activate your use of those cloud-hosted services that Horizon Cloud provides for this type of pod, such as the Cloud Monitoring Service (CMS). The CMS is one of the central services provided in Horizon Cloud. CMS provides for visibility, health monitoring, and help desk services with cloud-connected pods. For a high-level description of the process of onboarding a pod to the cloud control plane, see Horizon Cloud Deployments and Onboarding Pods — Horizon Pods on VMware SDDCs and Horizon Cloud Pods on Microsoft Azure.
- Fulfill the prerequisites, which include obtaining a Horizon subscription license, such as the Horizon universal license. See VMware Horizon Pods with Horizon Cloud - Requirements Checklist - Updated as Appropriate for Connecting Pods Starting from the January 2021 Service Release as well as the prerequisites section in Connect Horizon Cloud Service with an Existing Horizon Pod to Use Horizon Subscription Licenses or Cloud-Hosted Services or Both.
- Verify you meet the DNS, ports, and protocol requirements for connecting a Horizon pod with Horizon Cloud. See DNS, Ports, and Protocols Requirements When Using Horizon Cloud Connector and a Horizon Pod.
- If your environment requires use of a proxy server for the Horizon Cloud Connector virtual appliance to reach the Internet, obtain the required proxy settings so that you can specify them when you deploy the appliance into your pod's environment.
- Optionally log in to the Horizon Cloud tenant portal and configure additional administrators for your tenant environment.
Tip: Even though you can complete the next steps to onboard the pod solely using the My VMware account that is the one initially associated with your tenant environment, it is prudent to configure additional administrators at the start of this process. If only a single My VMware account is associated with your tenant account and you lose access to the credentials, delays might occur because you'll have to open a service request with VMware to associate a new My VMware account with the tenant account. To prevent such delays, log in to the tenant portal at cloud.horizon.vmware.com with the initially associated My VMware account and then follow steps described in Add Administrators to Log in to Your Horizon Cloud Tenant Environment using the row in the General Setup section of the screen.
- Deploy the Horizon Cloud Connector virtual appliance into the pod's environment. Follow the steps described in the subtopics under Download and Deploy the Horizon Cloud Connector into Your Pod's Environment.
- After the virtual appliance is powered up, enable SSH access to the virtual appliance to remotely run commands in the appliance's operating system. Follow the steps in Enable SSH Access to the Horizon Cloud Connector Before Pairing It with Your Horizon Connection Server.
Note: Those steps to enable SSH are used for the time when the pod is not yet successfully paired with Horizon Cloud. After the pod is successfully paired with Horizon Cloud, then you will be able to use the browser-based Horizon Cloud Connector's configuration portal to activate and deactivate SSH access to the virtual appliance.
- If your environment requires use of a proxy and you did not specify proxy-related settings in the OVF deployment wizard, configure the proxy-related settings for the virtual appliance. See Modifying Proxy Settings for Horizon Cloud Connector 1.6 or Later for more details.
- If you want to access the browser-based Horizon Cloud Connector configuration portal using a fully qualified domain name (FQDN) instead of using the Horizon Cloud Connector virtual appliance's IP address, create a forward and reverse lookup record in your DNS server that maps an FQDN to the virtual appliance's IP address.
- Verify the health of the pod's system components and services by opening an SSH session to the Horizon Cloud Connector virtual appliance and running the
precheck.shdiagnostics script. See Verify the Horizon Pod and Virtual Appliance Are Ready to Be Paired for more details.
- Using either a mapped FQDN or the virtual appliance's IP address, log in to the browser-based Horizon Cloud Connector configuration portal and complete the onboarding steps that pair the connector with the pod's Connection Server. Follow the steps described in Complete Pairing the Horizon Pod with Horizon Cloud Using the Horizon Cloud Connector Configuration Portal.
Tip: When the connector and Connection Server are successfully paired, the Horizon Cloud Connector configuration portal will display a Congratulations message. At this point, VMware will activate your subscription license. The activation is typically completed after 30 minutes but can take up to 4 hours in some cases. When the license is activated, you will see the message Connected to License Service in your pod's web-based console's Product Licensing & Usage screen.
- Depending on your team standard practices and environment, optionally configure the Horizon Cloud Connector virtual appliance in areas such as configuring a CA-signed certificate and setting a password expiry for the appliance's root user. See the topic .
- Register your Active Directory domain with the deployed pod, which includes providing the names of service accounts. Ensure these service accounts meet the requirements described in Service Accounts That Horizon Cloud Requires for its Operations
Tip: Completing the Active Directory domain registration workflow enables you to take advantage of all the cloud-hosted services, such as the Cloud Monitoring Service (CMS). Until the pod's Active directory domain is registered with your tenant environment, the areas of the console involving those features are inaccessible.
- In the rare, atypical situation where your tenant environment already has Horizon Cloud pods in Microsoft Azure that are running manifests older than manifest 1600.0, you must give the Horizon Cloud Super Administrators role to an Active Directory group that includes the domain join account as a member. See the topic Assign Horizon Cloud Administrative Roles to Active Directory Groups in the Administration Guide.
You can find in-depth details on how to accomplish each workflow step in the topics that are linked from each step above or in the companion guide. See the Horizon Cloud Administration Guide.