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

This topic provides specific guidance for installing vRealize Orchestrator Plug-in for Horizon. This plug-in is supported with vRealize Orchestrator 6.0.5, and 7.2 or later. The procedure for installing vRealize Orchestrator Plug-in for Horizon is similar for all plug-ins, and the documentation for the general plug-in installation, update, and troubleshooting is provided elsewhere. See the vRealize Orchestrator Documentation page at https://docs.vmware.com/en/vRealize-Orchestrator/index.html.

Note: For vRealize Orchestrator 6.0.5, no installable Windows client version is available. You must use a browser to log in to Orchestrator, and a Java-based client is used.

Prerequisites

  • Verify that you have the URL for downloading the vRealize Orchestrator Plug-in for Horizon installation file (.vmoapp file).
  • Verify that you have vRealize Orchestrator (either the virtual appliance or the Windows service) setup and configured to work with vCenter Single Sign-On. See "Register Orchestrator as a vCenter Single Sign On Solution in Advanced Mode" in Installing and Configuring VMware vRealize Orchestrator.
  • Verify that you have credentials for an account with the permission to install the vRealize Orchestrator Plug-in for Horizon and to authenticate through vCenter Single Sign-On.
  • If appropriate for your version of vRealize Orchestrator, verify that you have installed VMware vRealize Orchestrator Client and that you can log in with Administrator credentials.

Procedure

  1. Download the vRealize Orchestrator Plug-in for Horizon installer file to a location 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. Upload the plug-in installer file using the vRealize Orchestrator Configuration interface.
    vRealize Orchestrator Version Action
    6.0.5
    1. Click the Plug-ins item in the left pane and scroll down to the Install new plug-in section.
    2. In the Plug-in file text box, browse to the plug-in installer file and click Upload and install.
    7.2 or later Click the Manage Plugin icon and 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: 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, where xxxxxx is the build number.
    You see a status message 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 complete.
    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 located in Library > Horizon > Workflows.
    After the upgrade, the vCAC61 is empty, so that you can delete the folder. The vCAC60 folder cannot be deleted, however, because it contains published items.
    Important: Do not use any of the workflows in the vCAC60 folder. This release of the vRealize Orchestrator Plug-in for Horizon does not support vCenter Automation Center 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 the vRealize Orchestrator Plug-in for Horizon.

Continue with configuration tasks. See Configure the Connection to a Horizon Pod.