In the base virtual machine's Windows operating system, run the Horizon Agents Installer to install the agent-related components that are required and appropriate for Horizon Cloud.

Note: Keep the following points in mind as you perform this task:
  • Installing a version of the Horizon Agents Installer that is older than the most recent version of the Horizon Agents Installer can cause problems subsequently when you create RDS pools based on the image VM. In this situation, when you create a new RDS pool, the system can allow you to select HTML Access (Blast) as a protocol, but this selection will not be applied to the pool even though it appears to have been applied successfully.
  • The Help Desk Plugin option is installed by default. If you choose not to install this option, performance-related metrics from user sessions in the desktop instances or farm server instances based on this image are not collected. As a result, some data will not be available in the user card for such sessions. For details, see The User Card in the Horizon Cloud Administration Console.
  • The vRealize Operations Desktop Agent option is installed by default. If you choose not to install this option, activity-related data from user sessions in the desktop instance or farm server instances based on this image is not reported to Horizon Cloud. As a result, data from end-user activity and other types of desktop activity will not be displayed in reports in the Administration Console.
  • The User Environment Manager option is not enabled by default. Selecting that option installs the User Environment Manager client component, known as the FlexEngine. Selecting that option installs FlexEngine using its typical mode. The typical mode requires a post-installation configuration step to configure the User Environment Manager Group Policy. For User Environment Manager usage information, see the User Environment Manager product documentation. User Environment Manager provides various options for achieving the persistence of end-user data, settings, and profiles of desktops provisioned by your pod.
    Note: When the User Environment Manager option is selected for installation, its resulting installation path is C:\Program Files\VMware\Horizon Agents\User Environment Manager.

Prerequisites

Verify that the virtual machine (VM) is created and configured as described in Create the Virtual Machine Manually in Your Pod in Microsoft Azure and Prepare the Manually Created Master VM Prior to Installing the Agents.

Procedure

  1. Navigate to where you downloaded the installer and start it.
    Important: If you want to use the URL redirection option with the desktops or RDS-based remote applications resulting from this base VM, you must use the command line to start the installer, adding the VDM_URL_FILTERING_ENABLED=1 parameter to the command.

    However, if you do install the URL redirection option, do not install the options for either serial port redirection or scanner redirection. This Horizon Cloud release does not support use of the serial port redirection and scanner redirection options.

    For example,
    VMware-Horizon-Agents-Installer-x.y.z-build-x64.exe VDM_URL_FILTERING_ENABLED=1
    Where x.y.z and build match the numbers in the file name.
    After a few minutes, the installation wizard displays its Welcome screen.
    • For a VDI desktop image, the Horizon Cloud Endpoint Desktop image is displayed.
      First screen of the Horizon Agents Installer when running on a Windows 10 VDI VM

    • For a server image, the Horizon Cloud RDSH App image is displayed.
      Welcome screen for the installer running on the RDS-enabled VM

  2. Click Configure.
    The wizard's next step displays. The following screenshot is an example of this step when running on a server image.
    Second screen of the installer wizard.

  3. Scroll down to see the feature options.
    The following screenshot is an example of this step when running on a server image.
    View Agent Installer window showing all the options selected for installation

  4. Select the check boxes for the features you want to install and click the arrow to move to the next step.
    If the VM is a GPU-backed Windows Server operating system VM, select the 3DRDSH option.
    Note: If you do not install the Help Desk Plugin option, performance-related metrics from user sessions in the desktop instances or farm server instances based on this image are not collected. As a result, some data will not be available in the user card for such sessions. For details, see The User Card in the Horizon Cloud Administration Console.
  5. If prompted with a message about using USB redirection securely, click OK.
    The final wizard step displays.
  6. Click Proceed with installation.
    The installer begins installing the components.
    Note: If a message displays asking for confirmation to install the VMware display adapters, click Install.
    When all the components are installed, the wizard displays Finish. The following screenshot is an illustration of the list of installed components when running the installer on a server image and only selecting default options. The specific entries might vary depending on the operating system and options you select.
    Screenshot showing the Finish link displayed in the wizard screen.

  7. When the wizard signals it is finished, click Finish.
  8. Click Restart Now to reboot the VM and have the configuration changes take effect.

What to do next

Pair the configured VM with the cloud plane by following the steps in Manually Pair the Configured Virtual Machine with Horizon Cloud.

If you selected to install the User Environment Manager option, configure a separate file server in your Microsoft Azure subscription that has at least SMB 2 enabled. Then configure User Environment Manager using that file server. Also configure the GPO settings. See the User Environment Manager documentation topics in the User Environment Manager product documentation.

For improved security regarding the use of the Horizon Agent, configure your Active Directory server domain policy GPO (Group Policy Object) to disable weak ciphers in SSL and TLS protocols. For information about disabling weak ciphers when communicating using the SSL/TLS protocol, see the appropriate agent-related information in the VMware HorizonĀ® 7 documentation set, such as Disable Weak Ciphers in SSL/TLS.