EnglishFrançaisDeutschEspañolItaliano日本語한국어NederlandsPortuguês (Brasil)中文 (简体)中文 (繁體, 台灣)
Skip to main content

14 de abril de 2026

Requisitos del sistema para Horizon Agent for Linux

Para instalar Horizon Agent for Linux, debe cumplir ciertos requisitos para el sistema operativo Linux, la máquina virtual Linux, los componentes del sistema Horizon 8 y la plataforma de vSphere.

Distribuciones Linux compatibles con Horizon Agent

Consulte el artículo de la base de conocimientos Sistemas operativos invitados compatibles con Horizon Agent for Linux para obtener una lista de los sistemas operativos Linux compatibles con Horizon Agent.

Nota: Horizon Agent tiene paquetes de dependencia en algunas distribuciones de Linux. Consulte Instalar paquetes de dependencia para Horizon Agent para obtener más información.

Algunas funciones son compatibles con un subconjunto limitado de sistemas operativos Linux. Para obtener más información, consulte la sección de este documento que analiza la función específica.

El script de instalación de install_viewagent.sh proporciona un parámetro de --force que fuerza la instalación de Horizon Agent en distribuciones Linux que no aparecen en la matriz de compatibilidad de prueba. Consulte Opciones de la línea de comandos para instalar Horizon Agent for Linux.

Plataforma requerida y versiones del software

Para instalar y usar Horizon Agent for Linux, la implementación debe cumplir ciertos requisitos de la plataforma vSphere, Horizon Connection Server y el software de Horizon Client.

Plataforma y softwareVersiones compatibles
Versión de la plataforma de vSphere
  • vSphere 8.0 o una versión posterior
  • vSphere 7.0 o una versión posterior
Entorno de Horizon 8
  • Horizon Connection Server para su versión de Horizon 8
Software de Horizon Client
  • Utilice Horizon Client para su versión de Horizon 8.


    • Nota: Horizon Web Client está disponible con Horizon 8 versión 2412 y posteriores. En Horizon 8 2412 y versiones anteriores, Horizon Web Client se llama "HTML Access". En esta página se utiliza el nombre "Horizon Web Client" para hacer referencia a Horizon Web Client y HTML Access.
  • Clientes cero que admiten el protocolo Horizon Blast Nota: No se admiten clientes cero Teradici PCoIP.

Puertos utilizados por escritorios Linux

Para habilitar las sesiones de conexión, los escritorios Linux deben admitir conexiones TCP entrantes desde los dispositivos Horizon Client, Unified Access Gateway y Horizon Connection Server.

En distribuciones de Ubuntu y Debian, el firewall iptables está configurado de forma predeterminada con una directiva de entrada de ACEPTAR.

En distribuciones de RHEL y Rocky Linux, siempre que sea posible, el script del instalador de Horizon Agent configura el firewall iptables con una directiva de entrada de ACEPTAR. Para garantizar la compatibilidad con las conexiones entrantes, compruebe que iptables tenga una directiva de entrada ACCEPT para las nuevas conexiones a través del puerto Blast 22443.

Si habilita la puerta de enlace segura de Blast (BSG), las conexiones de cliente se dirigen desde un dispositivo de Horizon Client a través de la BSG en el Horizon Connection Server hasta el escritorio Linux. Cuando no habilita la BSG, las conexiones se realizan directamente desde el dispositivo de Horizon Client hasta el escritorio Linux.

Para obtener más información sobre los puertos usados por Horizon Agent en escritorios Linux, consulte el documento Seguridad de Horizon y la Guía de puertos de red de Horizon.

Verificar la cuenta Linux que usan las máquinas virtuales

La siguiente tabla muestra el nombre y el tipo de la cuenta que usan las máquinas virtuales Linux.

Nombre y tipo de cuenta

Nombre de la cuentaTipo de cuentaUsada por
rootIntegrada en Linux OSJava Standalone Agent, mksvchanserver, scripts de shell
hznblastCreada por el instalador del agente de LinuxBlastServer
<current login user>Linux OS integrado, usuarios de AD o de LDAPScript python

Entorno de escritorios

Horizon Agent for Linux es compatible con varios entornos de escritorio en distribuciones de Linux diferentes. La siguiente tabla muestra los entornos de escritorio predeterminados para cada distribución Linux y los demás entornos de escritorio que admite Horizon Agent for Linux.

Entornos de escritorio compatibles

Distribución de LinuxEntorno de escritorio predeterminadoEntornos de escritorio compatibles con Horizon Agent for Linux
UbuntuGnomeGnome Ubuntu, entorno de escritorio de K (K Desktop Environment, KDE), MATE
DebianGnomeGnome, KDE, MATE
RHEL y Rocky Linux 8.x/9.xGnomeGnome
SLED/SLESGnomeGnome

Nota: Cuando use distribuciones Ubuntu, el SSO no puede desbloquear una sesión KDE bloqueada. Debe proporcionar manualmente la contraseña para desbloquear la sesión.

Para cambiar el entorno de escritorio predeterminado que se usa en una de las distribuciones Linux admitidas, debe usar los pasos y comandos que aparecen a continuación y que son más apropiados para su escritorio Linux.

  1. Instale el sistema operativo de la distribución Linux admitida con la opción predeterminada del entorno de escritorio.

  2. Ejecute los comandos adecuados que se describen en la siguiente tabla para su distribución de Linux específica.

  3. Reinicie el escritorio para comenzar a usar el nuevo entorno de escritorio predeterminado.

    Comandos para instalar los entornos de escritorios

    Distribución de LinuxNuevo entorno de escritorio predeterminadoComandos para cambiar el entorno de escritorio predeterminado
    UbuntuKDE 
    apt install plasma-desktop
    UbuntuMATE 
    apt install ubuntu-mate-desktop

Si habilitó SSO en un escritorio Linux que tuviera instalados varios entornos de escritorio, utilice la siguiente información para seleccionar el entorno de escritorio que se usará en una sesión SSO.

  • En Ubuntu, use la información que aparece en siguiente tabla para establecer la opción SSODesktopType en el archivo /etc/omnissa/viewagent-custom.conf y especificar así el entorno de escritorio que se usará con SSO.

    Opción SSODesktopType

    Tipo de escritorioOpción de configuración SSODesktopType
    MATESSODesktopType=UseMATE
    GnomeUbuntuSSODesktopType=UseGnomeUbuntu
    GnomeFlashbackSSODesktopType=UseGnomeFlashback
    KDESSODesktopType=UseKdePlasma
    GnomeClassicSSODesktopType=UseGnomeClassic

  • En RHEL y Rocky Linux 9.x/8.x, para que el inicio de sesión SSO use Gnome Classic, quite todos los archivos de inicio de los escritorios, excepto el archivo de inicio Gnome Classic, del directorio /usr/share/xsession. Por ejemplo, ejecute el siguiente conjunto de comandos como usuario raíz:

    cd /usr/share/xsessions
mkdir backup
mv *.desktop backup
mv backup/gnome-classic.desktop ./

    Después de establecer la configuración inicial, el usuario final debe cerrar sesión o reiniciar el escritorio Linux para que Gnome Classic sea el escritorio predeterminado en la siguiente sesión SSO.

Si aparece una pantalla en blanco en Ubuntu 24.04, la causa puede estar relacionada con la configuración de Wayland. Revise lo siguiente para corregir la pantalla en blanco:

  • Edite /etc/gdm3/custom.conf.

    • En la sección Daemon, introduzca el comentario: WaylandEnable=false o WaylandEnable=true.

      • Ejemplo:

        [daemon]

        #WaylandEnable=false

  • Reinicie el servidor de GDM:

    • service gdm3 restart

Si desactivó SSO en un escritorio Linux que tenga varios entornos de escritorios instalados, no es necesario que realice los pasos anteriores. Los usuarios finales tienen que seleccionar el entorno de escritorio que quieran utilizar cuando inician sesión en ese escritorio Linux.

Requisitos de red

Horizon Blast Extreme admite el protocolo de datagramas de usuario (UDP) y el protocolo de control de transmisión (TCP). Las condiciones de red afectan al rendimiento de UDP y TCP. Para obtener una experiencia de usuario mejorada, seleccione UDP o TCP dependiendo de la condición de red.

  • Seleccione TCP si la condición de red es buena, por ejemplo, un entorno de red de área local (Local Area Network, LAN).
  • Seleccione UDP si la condición de red es deficiente, por ejemplo, un entorno de red de área extensa (Wide Area Network, WAN) con pérdida de paquetes y retraso temporal.

Utilice una herramienta para analizar la red, como Wireshark, para determinar si Horizon Blast Extreme utiliza TCP o UDP. Utilice el siguiente conjunto de pasos, en los que se usa Wireshark, como ejemplo de referencia.

  1. Descargue e instale Wireshark en la máquina virtual Linux.

    Para RHEL y Rocky Linux:

    sudo yum install wireshark

    Para Ubuntu:

    sudo apt install tshark

  2. Conéctese al escritorio Linux usando Omnissa Horizon Client.

  3. Abra una ventana de terminal y ejecute el siguiente comando, que muestra el paquete de TCP o el paquete de UDP que usa Horizon Blast Extreme.

    sudo tshark -i any | grep 22443

Las condiciones de red afectan a las funciones Redireccionamiento USB y Redireccionamiento de unidades cliente (Client Drive Redirection, CDR). Si la condición de red es deficiente, por ejemplo, un ancho de banda limitado con retrasos y pérdida de paquetes, la experiencia de usuario pierde calidad. En dicha condición, el usuario final puede experimentar una de las siguientes situaciones.

  • El proceso de copiar archivos remotos es lento. Por ello, envíe archivos de menor tamaño en su lugar.
  • El dispositivo USB no aparece en el escritorio remoto Linux.
  • Los datos USB no se envían completamente. Por ejemplo, si copia un archivo de gran tamaño, es posible que el archivo que pegue tenga un tamaño menor al original.

Controlador VHCI para el redireccionamiento USB

Nota: Para determinar la secuencia de instalación correcta para el controlador VHCI, utilice las siguientes directrices:

  • Si quiere instalar Horizon Agent con el instalador tarball .tar.gz, primero debe descargar y descomprime el instalador tarball, instalar el controlador VHCI y, a continuación, instalar Horizon Agent con el parámetro de instalación para la función de redireccionamiento USB.
  • Si quiere instalar Horizon Agent con el instalador RPM .rpm, primero debe instalar Horizon Agent, instalar el controlador VHCI y, a continuación, agregar la función de redireccionamiento USB a la configuración de Horizon Agent.

Si desea obtener más información, consulte Instalar Horizon Agent en una máquina Linux.

La función de redireccionamiento USB depende del controlador del kernel USB Virtual Host Controller Interface (VHCI). Para poder usar USB 3.0 y la función de redireccionamiento USB, debe instalar el controlador VHCI siguiendo estos pasos.

Nota: Los siguientes pasos utilizan el nombre agent-installer en lugar del nombre de archivo específico. Cuando use los comandos, incluya el nombre específico del archivo que está utilizando.

  1. Descargue el código fuente de USB VHCI de https://sourceforge.net/projects/usb-vhci/files/linux%20kernel%20module/.

  2. Identifique la ruta completa al archivo de revisión VHCI, según el formato del instalador de Horizon Agent. Para obtener instrucciones, consulte los siguientes ejemplos. (En los ejemplos, agent-installer hace referencia al nombre del archivo del instalador. Recuerde sustituir agent-installer por el nombre real de su instalación de Horizon Agent).

    • (Instalador tarball) Si descomprime el instalador tarball agent-installer.tar.gz en el directorio /install_tmp/, full-path_to_patch-file tendrá el patrón /install_tmp/agent-installer/resources/vhci/patch/vhci.patch.
    • (Instalador RPM) Si descarga el instalador RPM agent-installer.el8.x86_64.rpm y lo usa para instalar Horizon Agent, full-path_to_patch-file tendrá el patrón /usr/lib/omnissa/viewagent/resources/vhci/patch/vhci.patch.

  3. Para compilar el código fuente del controlador VHCI e instalar el archivo binario resultante en el sistema Linux, utilice los comandos de la siguiente tabla. Reemplace full-path_to_patch-file en los comandos con la ruta de archivo que identificó en el paso anterior.

    Por ejemplo, si la ruta del archivo tiene el patrón /install_tmp/agent-installer/resources/vhci/patch/vhci.patch, el comando patch sería:

    patch -p1 < /install_tmp/agent-installeri/resources/vhci/patch/vhci.patch

Compile e instale el controlador USB VHCI

Distribución de LinuxPasos para compilar e instalar el controlador USB VHCI
Ubuntu
  1. Instale los paquetes de dependencia. 
    <pre><code>sudo apt-get install make

    sudo apt-get install gcc sudo apt-get install libelf-dev

  2. (Ubuntu 22.04/24.04) Instale los archivos de encabezado del kernel. 
    <pre><code>sudo apt-get install linux-headers-$(uname -r)</code></pre></li>
  3. Compile e instale el controlador VHCI. 
    <pre><code>tar -xzvf vhci-hcd-1.15.tar.gz

    cd vhci-hcd-1.15 patch -p1 < full-path_to_patch-file make clean && make && sudo make install

  4. Si habilitó la interfaz de firmware extensible (EFI) y el arranque seguro UEFI en la máquina virtual, configure los ajustes de firma para el controlador VHCI. 
    <ol>
	<li>Cree un par de claves SSL para el controlador VHCI.

	    <pre><code>openssl req -new -x509 -newkey rsa:2048 -keyout MOK.priv -outform DER -out MOK.der -nodes -days 36500 -subj "/CN=Descriptive name/" -addext extendedKeyUsage=1.3.6.1.5.5.7.3.3</code></pre>    	</li>
	<li>Firme el controlador VHCI.

	    <pre><code>sudo /usr/src/linux-headers-$(uname -r)/scripts/sign-file sha256 ./MOK.priv ./MOK.der /lib/modules/$(uname -r)/kernel/drivers/usb/host/usb-vhci-iocifc.ko

    sudo /usr/src/linux-headers-$(uname -r)/scripts/sign-file sha256 ./MOK.priv ./MOK.der /lib/modules/$(uname -r)/kernel/drivers/usb/host/usb-vhci-hcd.ko

  5. Registre la clave para el arranque seguro UEFI.

    	    <pre><code>sudo mokutil --import MOK.der</code></pre>
	    <strong>Nota:</strong> Este comando envía una solicitud para establecer una contraseña de la clave de propietario de la máquina (MOK) para el arranque seguro UEFI.    	</li>
	<li>Para configurar el arranque seguro UEFI en la consola de vSphere, reinicie el sistema. Para obtener más información, consulte <a href="https://sourceware.org/systemtap/wiki/SecureBoot">https://sourceware.org/systemtap/wiki/SecureBoot</a>.
	</li>
</ol></li>
Debian
  1. Instale los paquetes de dependencia. 
    <pre><code>sudo  apt install -y  patch g++ make linux-headers-$(uname -r)</code></pre></li>
  2. Compile e instale el controlador VHCI. 
    <pre><code>tar -xzvf vhci-hcd-1.15.tar.gz

    cd vhci-hcd-1.15 patch -p1 < full-path_to_patch-file mkdir -p linux/$(echo $(uname -r) | cut -d '-' -f 1)/drivers/usb/core cp /lib/modules/$(uname -r)/source/include/linux/usb/hcd.h linux/$(echo $(uname -r) | cut -d '-' -f 1)/drivers/usb/core

    make clean && make && sudo make install

RHEL 8.x/9.x Rocky Linux 8.x/9.x
  1. Instale los paquetes de dependencia. 
    <pre><code>sudo yum install gcc-c++

    sudo yum install kernel-devel-$(uname -r) sudo yum install kernel-headers-$(uname -r) sudo yum install patch sudo yum install elfutils-libelf-devel

  2. Compile e instale el controlador VHCI. 
    <pre><code>tar -xzvf vhci-hcd-1.15.tar.gz

    cd vhci-hcd-1.15 patch -p1 < full-path_to_patch-file make clean && make && sudo make install

  3. (RHEL y Rocky Linux 9.x/8.x) Para garantizar que el controlador de VHCI funcione correctamente con el redireccionamiento USB, configure las opciones de firma para el controlador. 
    <ol>
	<li>Cree un par de claves SSL para el controlador VHCI.

	    <pre><code>openssl req -new -x509 -newkey rsa:2048 -keyout MOK.priv -outform DER -out MOK.der -nodes -days 36500 -subj "/CN=Descriptive name/" -addext extendedKeyUsage=1.3.6.1.5.5.7.3.3</code></pre>    	</li>
	<li>Firme el controlador VHCI.

	    <pre><code>sudo /usr/src/kernels/$(uname -r)/scripts/sign-file sha256 ./MOK.priv ./MOK.der /lib/modules/$(uname -r)/kernel/drivers/usb/host/usb-vhci-iocifc.ko

    sudo /usr/src/kernels/$(uname -r)/scripts/sign-file sha256 ./MOK.priv ./MOK.der /lib/modules/$(uname -r)/kernel/drivers/usb/host/usb-vhci-hcd.ko

  4. Registre la clave para el arranque seguro UEFI.

    	    <pre><code>sudo mokutil --import MOK.der</code></pre>
	    <strong>Nota:</strong> Este comando envía una solicitud para establecer una contraseña de la clave de propietario de la máquina (MOK) para el arranque seguro UEFI.    	</li>
	<li>Para configurar el arranque seguro UEFI en la consola de vSphere, reinicie el sistema. Para obtener más información, consulte <a href="https://sourceware.org/systemtap/wiki/SecureBoot">https://sourceware.org/systemtap/wiki/SecureBoot</a>.
	</li>
</ol></li>
SLED/SLES
  1. Busque la versión del paquete de kernel actual. 
    <pre><code>rpm -qa | grep kernel-default-$(echo $(uname -r) | cut -d '-' -f 1,2)</code></pre>    El resultado es el nombre del paquete de kernel instalado actualmente. Si, por ejemplo, el nombre del paquete es <code>kernel-default-3.0.101-63.1</code>, la versión actual del paquete del kernel será 3.0.101-63.1.</li>
  2. Instale los paquetes kernel-devel, kernel-default-devel, kernel-macros y patch. 
    <pre><code>sudo zypper install --oldpackage kernel-devel-<em>&lt;kernel-package-version&gt;</em> \

    kernel-default-devel-<kernel-package-version> kernel-macros-<kernel-package-version> patch Por ejemplo: 

    sudo zypper install --oldpackage kernel-devel-4.4.21-90.1 kernel-default-devel-4.4.21-90.1 kernel-macros-4.4.21-90.1 patch

  3. Compile e instale el controlador VHCI. 
    <pre><code>tar -xzvf vhci-hcd-1.15.tar.gz

    cd vhci-hcd-1.15 patch -p1 < full-path_to_patch-file mkdir -p linux/$(echo $(uname -r) | cut -d '-' -f 1)/drivers/usb/core cp /lib/modules/$(uname -r)/source/include/linux/usb/hcd.h linux/$(echo $(uname -r) | cut -d '-' -f 1)/drivers/usb/core make clean && make && sudo make install

  4. Para garantizar que el controlador de VHCI funcione correctamente con el redireccionamiento USB, configure las opciones de firma para el controlador. 
    <ol>
	<li>Cree un par de claves SSL para el controlador VHCI.

	    <pre><code>openssl req -new -x509 -newkey rsa:2048 -keyout MOK.priv -outform DER -out MOK.der -nodes -days 36500 -subj "/CN=Descriptive name/" -addext extendedKeyUsage=1.3.6.1.5.5.7.3.3</code></pre>    	</li>
	<li>Busque la ruta al archivo de firma para el controlador VHCI.

	    <pre><code>sudo find / -name sign-file</code></pre>
	    Este comando devuelve las rutas de acceso a todos los archivos de firma ubicados en el sistema. La ruta del archivo de firma para el controlador VHCI es similar al siguiente ejemplo.    	    <pre><code>/usr/src/linux-5.3.18-24.9-obj/x86_64/default/scripts/</code></pre>    	</li>
	<li>Firme el controlador VHCI. En los siguientes comandos, &lt;sign-file-path&gt; es la ruta al archivo de firma que encontró anteriormente en el paso&nbsp;4b.

	    <pre><code>sudo /&lt;sign-file-path&gt;/sign-file sha256 ./MOK.priv ./MOK.der /lib/modules/$(uname -r)/kernel/drivers/usb/host/usb-vhci-iocifc.ko

    sudo /<sign-file-path>/src/kernels/$(uname -r)/scripts/sign-file sha256 ./MOK.priv ./MOK.der /lib/modules/$(uname -r)/kernel/drivers/usb/host/usb-vhci-hcd.ko

  5. Registre la clave para el arranque seguro UEFI.

    	    <pre><code>sudo mokutil --import MOK.der</code></pre>
	    <strong>Nota:</strong> Este comando envía una solicitud para establecer una contraseña de la clave de propietario de la máquina (MOK) para el arranque seguro UEFI.    	</li>
	<li>Para configurar el arranque seguro UEFI en la consola de vSphere, reinicie el sistema. Para obtener más información, consulte <a href="https://sourceware.org/systemtap/wiki/SecureBoot">https://sourceware.org/systemtap/wiki/SecureBoot</a>.
	</li>
</ol></li>

Además, siga estas directrices:

  • Si el kernel de Linux cambia a una nueva versión, deberá volver a compilar e instalar el controlador VHCI, pero no es necesario que vuelva a instalar Horizon Agent for Linux.
  • También puede agregar Dynamic Kernel Module Support (DKMS) al controlador VHCI siguiendo pasos similares a los que aparecen en este ejemplo para un sistema Ubuntu.

    1. Instale los encabezados del kernel.

      sudo apt install linux-headers-`uname -r`

    2. Instale dkms mediante el siguiente comando.

      sudo apt install dkms

    3. Extraiga el archivo TAR de VHCI y aplique las revisiones.

      tar xzvf vhci-hcd-1.15.tar.gz
cd vhci-hcd-1.15
patch -p1 *<full-path_to_patch-file>*
cd ..

    4. Copie los archivos de origen de VHCI extraídos al directorio /usr/src.

      sudo cp -r vhci-hcd-1.15 /usr/src/usb-vhci-hcd-1.15

    5. Cree un archivo llamado dkms.conf y colóquelo en el directorio /usr/src/usb-vhci-hcd-1.15.

      sudo touch /usr/src/usb-vhci-hcd-1.15/dkms.conf

    6. Agregue los siguientes contenidos al archivo dkms.conf.

      PACKAGE_NAME="usb-vhci-hcd"
PACKAGE_VERSION=1.15
MAKE_CMD_TMPL="make KVERSION=$kernelver"
    
CLEAN="$MAKE_CMD_TMPL clean"
    
BUILT_MODULE_NAME[0]="usb-vhci-iocifc"
DEST_MODULE_LOCATION[0]="/kernel/drivers/usb/host"
MAKE[0]="$MAKE_CMD_TMPL"
    
BUILT_MODULE_NAME[1]="usb-vhci-hcd"
DEST_MODULE_LOCATION[1]="/kernel/drivers/usb/host"
MAKE[1]="$MAKE_CMD_TMPL"
    
AUTOINSTALL="YES"

    7. Agregue este controlador VHCI a dkms.

      sudo dkms add usb-vhci-hcd/1.15

    8. Compile el controlador VHCI.

      sudo dkms build usb-vhci-hcd/1.15

    9. Instale el controlador VHCI.

      sudo dkms install usb-vhci-hcd/1.15

Configuración de máquinas virtuales para gráficos 2D

Cuando cree máquinas virtuales Linux para una implementación de Horizon 8, debe cambiar la configuración de vCPU y la memoria virtual según los requisitos de rendimiento.

Las máquinas virtuales que están configuradas para usar NVIDIA GRID vGPU usan la tarjeta gráfica virtual de NVIDIA, que está basada en el acelerador de gráficos físicos NVIDIA. No es necesario cambiar la configuración de vCPU ni la memoria virtual de estas máquinas virtuales.

Las máquinas virtuales que están configuradas para usar gráficos 2D utilizan la tarjeta gráfica virtual basada en vSphere, y deberá cambiar los ajustes de vCPU y memoria virtual para mejorar el rendimiento del escritorio. Utilice las siguientes directrices:

  • Para mejorar el rendimiento de un escritorio 2D, configure más vCPU y memoria virtual para la máquina virtual Linux. Por ejemplo, configure 2 vCPU y 2 GB de memoria virtual.
  • Para una pantalla más grande con varios monitores, como cuatro monitores, establezca 4 vCPU y 4 GB de memoria virtual para la máquina virtual.
  • Para mejorar la reproducción de vídeo en escritorios 2D, establezca 4 vCPU y 4 GB de memoria virtual para la máquina virtual.

¿Le resultó útil esta página?

Enviar comentarios sobre este tema

¿Le resultó útil este tema?

No incluya información personal ni confidencial.

Generando el enlace…