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

Before you begin

  • Verify that you have the URL for downloading the Horizon vRealize Orchestrator plug-in installation file (.vmoapp file).

  • Verify that you have vRealize Orchestrator (either the virtual appliance or the Windows service) set up 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 permission to install vRealize Orchestrator plug-ins 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.

About this task

This topic provides specific guidance for installing the Horizon vRealize Orchestrator plug-in. This plug-in is supported with vRealize Orchestrator 6.0.5, and 7.2 or later. The procedure for installing vRealize Orchestrator plug-ins is similar for all plug-ins, and the documentation for general plug-in installation, update, and troubleshooting is provided elsewhere. See the vRealize Orchestrator Documentation page at https://www.vmware.com/support/pubs/orchestrator_pubs.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.

Procedure

  1. Download the plug-in file to a location accessible from the vRealize Orchestrator appliance or service.

    The installer filename is o11nplugin-horizon-1.4.0-xxxxxxx.vmoapp, where xxxxxx is the build number.

  2. Open a browser and launch 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

    1. 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.4.0 build xxxxxxx) Plug-in with same name was already installed (1.3.0 build xxxxxxx): overwriting existing plug-in.

  5. Go to the Enabled plug-ins installation status section and confirm that Horizon 1.4.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 plug-in installation to complete.

    Installation can take several minutes.

  8. Launch 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. vCenter Automation Center 6.0 is not supported by this release of the Horizon vRealize Orchestrator plug-in.

What to do next

Log in to 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 Horizon vRealize Orchestrator plug-in.

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