Install Horizon Version Manager

This task describes how to install Horizon Version Manager (HVM)

Procedure

1. Deploy the Horizon Version Manager OVA in vCenter.

   a. Open a browser and log into your management vCenter.

   b. Right click the cluster and click Deploy OVF Template…

c. Select the VM folder to which to deploy the appliance and name the appliance according to the details in the Service Provider Installation Worksheet.

d. Select the cluster, click Next, and wait for the validation to be finished.

e. Click Next on the Review details screen.

f. Select the datastore and click Next.

g. Select the destination network and click Next.

h. On the Customize template screen, fill out the four Root and Rundeck UI password text boxes, expand the Networking drop-down, fill out the four remaining text boxes, and click Next.

Note: The netmask field value is the CIDR value.

i. On the Ready to complete screen, click Finish to begin the deployment.

2. Power on VM and wait a few minutes.

3. Copy platform files to appliance.

   a. Start WinSCP and log into the newly deployed HVM appliance through its IP address using protocol type SCP and user name root.

   b. Accept all certificates.

   c. Transfer all Debian files, JSON, latest_rev.txt, and appliance template OVA from the folder in your file share to install-upgrade folder in the /opt directory. There are nine files in total.

4. Change the permissions on the JSON manifest.

   a. Right click the node-manifest.json file in WinSCP, click Properties, and change the permissions so that Owner, Group, and Others have full Read/Write/Execute.

   b. Click OK.

5. Close WinSCP.

6. Log into Horizon Version Manager RunDeck, proceeding past any SSL warnings.

   a. In a browser, navigate to https://HVM_IPADDRESS:4443/

   b. Log in with user name rundeck and the password you set previously.

   ![Rundeck Log In](images/GUID-210AAC10-7DBF-42E0-AB18-56B27440E54D-low.png)
   

7. Click Projects > Horizon-DaaS.

   

8. Click Jobs > Horizon-Air-Link Installer.

   

9. Fill out information based on the details in the Service Provider Installation Worksheet. All text boxes are case-sensitive.

   

   Note the following:

   • Make sure to select the HAL OVA, not HVM.
   • The HAL OVA should be uploaded along with other binaries to the HVM/install-upgrades folder.
   • You can skip the Route-Gateway, Webproxy-Server, and Webproxy-Port text boxes.
   • If you are reattempting this step, you must change the Force-Deploy text box to Yes to overwrite the previous failed appliance deployment.
   • For VXLAN, use the full network name that displays in vCenter/Networking.

10. Scroll back to the top and click Run Job Now.

11. Monitor the upload status in the bottom left of the browser window.

12. On the next screen, click the Log Output button and monitor progress.

    

13. If you must stop a job for any reason, scroll to the top of the page and click the Kill Job X button in the top right.

14. If the job fails and you must rerun it for any reason, scroll to the top of the page and click the Run Again… button and click Run Again. This action takes you back to the previous page so you can make corrections.

    

15. Once the upgrade is finished, the following appears in the log output:

    

    You can also scroll to the top of the page and verify that the job has a green check next to the job name.

    

16. You can now use Horizon Version Manager to deploy new service providers, upgrade existing service providers from Horizon DaaS 9.1.x or 9.0.x, or upgrade and migrate existing tenants.