For linked-clone and instant clone desktops, you install the desktop agent on the parent virtual machine that Horizon Composer users to generate the linked-clone and instant clone virtual machines. For desktops in automated and manual desktop pools, you install the desktop agent on each virtual machine desktop source in the desktop pool. For RDSH Services pools, you install the desktop agent on the RDSH server.

About this task

Guest Operating System

Version

Edition

Service Pack

Windows 10

64-bit and 32-bit

Enterprise

Windows 10 Anniversary

Windows 8.1

64-bit and 32-bit

Enterprise and Professional

Latest update

Windows 8

64-bit and 32-bit

Enterprise and Professional

None

Windows 7

64-bit and 32-bit

Enterprise and Professional

SP1

Windows Server 2016

64-bit

Datacenter

None

Windows Server 2012 R2

64-bit

Datacenter

None

Windows Server 2008 R2

64-bit

Datacenter

SP1

Windows Server 2016

64-bit

Standard and Datacenter

None

Prerequisites

  • Install and configure vRealize Operations for Horizon.

  • If you are installing the desktop agent in linked-clone and instant clone desktops, become familiar with the recompose operation. For information about recomposing linked-clone and instant clone desktops, see the Horizon administration document for your Horizon version.

  • Verify that you downloaded the desktop agent installation files.

Procedure

  • To install the desktop agent for linked-clone desktops, perform these steps on the parent virtual machine in the linked-clone desktop pool.
    1. In vSphere Client, open the console for the parent virtual machine and log in to the guest operating system as an administrator.
    2. Copy the desktop agent installation file that corresponds to the guest operating system in the parent virtual machine.

      Option

      Description

      64-bit guest operating system

      VMware-v4vdesktopagent-x86_64-6.5-buildnumber.exe

      32-bit guest operating system

      VMware-v4vdesktopagent-6.5-buildnumber.exe

    3. Run the EXE file, accept the EULA, and click Install.
    4. When the installation finishes, click Finish.

      The desktop agent is installed in the same folder as View Agent.

    5. Shut down the parent virtual machine.
    6. In vSphere Client, take a snapshot of the parent virtual machine in its powered-down state.
    7. In Horizon Administrator, recompose the linked-clone desktops.

      The recompose operation updates all of the linked-clone desktops anchored to the parent virtual machine, causing the desktop agent to be installed on each linked-clone desktop.

  • To install the desktop agent for desktops in an automated or manual desktop pool, perform these steps on each virtual machine in the pool.
    Important:

    For an automated desktop pool, you must also modify the virtual machine template so that the desktop agent is installed in newly created desktops in the pool.

    1. Copy the desktop agent installation file that corresponds to the guest operating system to the virtual machine.

      Option

      Description

      64-bit guest operating system

      VMware-v4vdesktopagent-x86_64-6.5-buildnumber.exe

      32-bit guest operating system

      VMware-v4vdesktopagent-6.5-buildnumber.exe

    2. Run the EXE file, accept the EULA, and click Install.
    3. When the installation finishes, click Finish.

      The desktop agent is installed in the same folder as View Agent.

  • To install the desktop agent on a RDSH server or physical machine desktop source, perform these steps.
    1. Copy the desktop agent installation file that corresponds to the operating system of the terminal server or physical machine.

      Option

      Description

      64-bit guest operating system

      VMware-v4vdesktopagent-x86_64-6.5-buildnumber.exe

      32-bit guest operating system

      VMware-v4vdesktopagent-6.5-buildnumber.exe

    2. Run the EXE file, accept the EULA, and click Install.
    3. When the installation finishes, click Finish.

      The desktop agent is installed in the same folder as View Agent.

      Note:

      While uninstalling the desktop agent, you are prompted to close vmwAgent even if nothing related is opened. Ignore the message and proceed with the uninstallation.

      Note:

      You can upgrade Desktop agents from version 6.2, 6.2.1, 6.3, and 6.4 to version 6.5.