Horizon Agent for Linux has some dependency packages unique to a Linux distribution. You must install these packages before installing Horizon Agent for Linux.


Verify that a new virtual machine (VM) is created in vCenter Server and your Linux distribution is installed on the machine.


  1. Install the mandatory packages that are not installed or upgraded by default. The installer breaks the installation if any package does not meet the requirement.
    Table 1. Mandatory Dependency Packages

    Linux Distribution


    RHEL 7 or CentOS 7

    Upgrade VMware Graphic driver for 2D desktop and vSGA desktop.


    This option is not application for vDGA and vGPU as they use NVIDIA Graphic driver in the VM.

    yum install mesa-libxatracker xorg-x11-drv-vmware mesa-private-llvm mesa-dri-drivers

    After updating, the packages should have the following versions or later:

    • xorg-x11-drv-vmware-13.0.2-7.20150211git8f0cf7c.el7.x86_64

    • mesa-libxatracker-10.6.5-3.20150824.el7.x86_64

    • mesa-private-llvm-3.6.2-2.el7.x86_64

    • mesa-dri-drivers-10.6.5-3.20150824.el7.x86_64


    The update is not available for CentOS default online repository. You must enable the CentOS continuous release (CR) repository.

    yum-config-manager --enable "CentOS-7 - cr"

    After upgrading VMware Graphic driver, you can disable the repository again.

    yum-config-manager --disable "CentOS-7 - cr"

    SLED 11 SP3/SP4

    Upgrade xorg-x11-server to a version later than

    zypper install xorg-x11-server

    SLES 12 SP1 (for Horizon 7 versions 7.0.1/7.0.2)

    Upgrade VMware Graphic driver, xf86-video-vmware, to a version later than 13.1.0-5.2

    zypper install xf86-video-vmware

    You must enable the OpenSUSE online repository to install it.

    1. zypper addrepo http://download.opensuse.org/distribution/leap/42.1/repo/oss/ oss-42.1
    2. zypper ref
    3. zypper install xf86-video-vmware
    4. zypper removerepo oss-42.1

    SLES 12 SP1 (for Horizon 7 version 7.0.3 or later)

    Upgrade xf86-video-vmware to a version later than 13.0.2-3.2 from the SUSE repository

    1. Register SUSE 12 to enable the SUSE repositories.

      SUSEConnect -r Registration Code -e Email
    2. Update the xf86-video-vmware version.

      zypper install xf86-video-vmware

    SLES 12 SP1

    Install python-gobject2 is required for SLES 12 Linux desktop when you are installing Horizon Agent.

    1. Remove the OpenSUSE repositories.

    2. Register SUSE 12 to enable the SUSE repositories.

      SUSEConnect -r Registration Code -e Email
    3. Install python-gobject2.

      zypper install python-gobject2


    python-object2 on OpenSUSE is not compatible with SUSE 12.

    Ubuntu 14.04

    Upgrade indicator-session to 12.10.5+15.04.20150327, available in https://launchpad.net/ubuntu/wily/amd64/indicator-session/12.10.5+15.04.20150327-0ubuntu1

    wget http://launchpadlibrarian.net/201393830/indicator-session_12.10.5+15.04.20150327-0ubuntu1_amd64.deb
    sudo dpkg -i ./indicator-session_12.10.5+15.04.20150327-0ubuntu1_amd64.deb 

    Ubuntu 16.04

    apt-get install python-dbus python-gobject

  2. Install the optional package for Horizon Agent.
    • By default, RHEL or CentOS 6.7 has glibc-2.12-1.166.el6.x86_64 installed which might cause a deadlock issue. As a result, the desktop connection is stuck. To overcome this issue, you must upgrade glibc to the latest version from an online repository.

      sudo yum install glibc
    • On Ubuntu 14.04 desktops with multiple monitors, gnome-session-fallback is needed to disable Compiz for better performance..

      sudo apt-get install gnome-session-fallback
    • On Ubuntu 16.04 desktops with multi-monitors, gnome-session-flashback is needed to disable Compiz for better performance..

      sudo apt-get install gnome-session-flashback