Upgrade Horizon Agent on a Windows Machine

You can upgrade Horizon Agent on a Windows machine by installing the latest version of Horizon Agent over the existing installation. You do not need to uninstall the previous version first.

Note: For general guidelines on upgrading desktop pools, see Upgrading Published and Virtual Desktops.

Prerequisites

• Verify that the machine meets the requirements described in System Requirements for Horizon Agent for Windows. A minimum of 2 CPUs is required to upgrade Horizon Agent from version 7.x or later. 4 CPUs provide optimal performance.

• Verify that no Horizon sessions are active on the machine.

• Download the latest Horizon Agent installer file from Omnissa Customer Connect.

  The installer filename has the pattern Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe, where YYMM is the marketing version number, y.y.y is the internal version number, and xxxxxx is the build number.

• Verify that you have administrative rights on the machine.

Upgrade Horizon Agent Interactively

1. To start the Horizon Agent installation, double-click the installer file.

2. Accept the license terms.

3. Follow the installation prompts.

   Note: Previously installed custom setup options and configuration are preserved during the upgrade. If you want to change them, select a new set of custom setup options without uninstalling the previous version. See Custom Setup Options for Horizon Agent for Windows.

4. Restart the machine if prompted you to do so.

Upgrade Horizon Agent Silently

A silent upgrade uses the same commands as a silent installation. See Installing Omnissa Horizon Agent for Windows Silently.

To apply a Horizon Agent patch silently, use the REINSTALL=ALL MSI property with the patch (.msp) file. The following example installs a patch, where agent-installer.msp is the name of the patch file:

msiexec /p agent-installer.msp /qn REINSTALL=ALL

For more information about the MSI command-line options and properties, see Microsoft Windows Installer Command-Line Options and Silent Installation Properties for Horizon Agent for Windows.

What to do next

If the machine has multiple NICs, configure the subnet that Horizon Agent uses. See Configure a Virtual Machine with Multiple NICs for Horizon Agent.