Installing or upgrading vRealize Orchestrator Plug-in for Horizon involves downloading the latest installer file and using the vRealize Orchestrator Configuration user interface to upload and install the plug-in.

This topic provides specific guidance for installing vRealize Orchestrator Plug-in for Horizon. The procedure for installing vRealize Orchestrator Plug-in for Horizon is similar for all plug-ins. For general plug-in installation, update, and troubleshooting information, see the vRealize Orchestrator documentation.

Prerequisites

  • Verify that the functional prerequisites are met. See Functional Prerequisites for vRealize Orchestrator Plug-in for Horizon.
  • Verify that you have the URL for downloading the vRealize Orchestrator Plug-in for Horizon installation file.
  • Verify that vRealize Orchestrator is set up and configured to work with vCenter Single Sign-On. For information, see the Installing and Configuring VMware vRealize Orchestrator document.
  • Verify that you have credentials for an account that has permission to install vRealize Orchestrator Plug-in for Horizon and to authenticate through vCenter Single Sign-On.
  • If appropriate for your version of vRealize Orchestrator, verify that VMware vRealize Orchestrator client is installed and that you can use Administrator credentials to log in to it.

Procedure

  1. Download the vRealize Orchestrator Plug-in for Horizon installer file to a location that is accessible from the vRealize Orchestrator appliance or service.
    The installer filename is o11nplugin-horizon-1.5.0-xxxxxxx.vmoapp, where xxxxxx is the build number.
  2. Open a browser and start the vRealize Orchestrator Configuration interface.
    An example of the URL format is https://server.mycompany.com:8283.
  3. To upload the plug-in installer file, use the vRealize Orchestrator Configuration interface.
    1. Click the Manage Plugin icon.
    2. Upload the plug-in installer file
      The file must be in .vmoapp format.
  4. In the Install a Plugin pane, when prompted, accept the license agreement.
    Important: If you are upgrading, a message appears after the plug-in is installed, for example, Horizon (1.5.0 build xxxxxxx) Plug-in with same name was already installed (1.4.0 build xxxxxxx): overwriting existing plug-in.
  5. Go to the Enabled plug-ins installation status section and confirm that Horizon 1.5.0.xxxxxxx is listed.
    xxxxxx is the build number. A status message appears for the installation or upgrade.
    Type of Installation Message
    New installation Plug-in will be installed at next server startup.
    Upgrade Will perform installation at next server startup.
  6. Restart the vRealize Orchestrator Server service.
  7. Wait for the vRealize Orchestrator Plug-in for Horizon installation to finish.
    The installation can take several minutes.
  8. Start the vRealize Orchestrator Configuration interface again, click the Plug-ins item, and verify that the status changed to Installation OK.
  9. If you are upgrading, delete the vCAC61 folder from the Workflows tab.
    This folder is in Library > Horizon > Workflows.
    After the upgrade, the vCAC61 folder is empty, so you can delete it. You cannot delete the vCAC60 folder because it contains published items.
    Important: Do not use any of the workflows in the vCAC60 folder. vRealize Orchestrator Plug-in for Horizon 1.5 does not support vRealize Automation 6.0.

What to do next

Log in to vRealize Orchestrator and use the Workflow tab to navigate through the library to the Horizon folder. You can now browse through the workflows provided by vRealize Orchestrator Plug-in for Horizon.

Continue to perform the configuration tasks. See Configure the Connection to a Pod in VMware Horizon 8.