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

Procedure

  1. Deploy the Horizon Version Manager OVA in vCenter.
    1. Open a browser and log into your management vCenter.
      vCenter Sign-On Screen
    2. Right click the cluster and click Deploy OVF Template…
      Deploy OVF Template Menu Selection
    3. Select the VM folder to which to deploy the appliance and name the appliance according to the details in the Service Provider Installation Worksheet.
    4. Select the cluster, click Next, and wait for the validation to be finished.
      Validating Progress Bar
    5. Click Next on the Review details screen.
    6. Select the datastore and click Next.
      Select Storage Screen
    7. Select the destination network and click Next.
      Select Networks Screen
    8. 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.
      Networking Section of Customize Template Screen
    9. 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.
    1. Start WinSCP and log into the newly deployed HVM appliance through its IP address using protocol type SCP and user name root.
    2. Accept all certificates.
    3. Transfer all Debian files, JSON, latest_rev.txt, and appliance template OVA from the folder in your file share to /opt/vmware/hvm/install-upgrade. There are nine files in total.
  4. Change the permissions on the JSON manifest.
    1. 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.
      node-manifest.json Properties Dialog
    2. Click OK.
  5. Close WinSCP.
  6. Log into Horizon Version Manager RunDeck, proceeding past any SSL warnings.
    1. In a browser, navigate to https://HVM_IPADDRESS:4443/
    2. Log in with user name rundeck and the password you set previously.
      Rundeck Log In
  7. Click Projects > Horizon-DaaS.
    Rundeck Projects Page
  8. Click Jobs > Horizon-Air-Link Installer.
    Rundeck Jobs Page
  9. Fill out information based on the details in the Service Provider Installation Worksheet. All text boxes are case-sensitive
    Horizon-Air-Link Installer Page

    Note the following:

    • Make sure to select the HAL OVA, not HVM.
    • 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.
    Horizon-Air-Link Installer Log Output Button Horizon-Air-Link Installer Log Data
  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.
    Run Again Button
  15. Once the upgrade is finished, the following appears in the log output:
    Example of Log Data

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

    Green Check Mark Next to Job Name
  16. You can now use Horizon Version Manager to deploy new service providers, upgrade existing service providers from Horizon DaaS 9.0.0 or 9.0.1, or upgrade and migrate existing tenants.