Skip to main content

14 de abril de 2026

Usar Easy Setup Tool para preparar una máquina Linux

En esta página se describe la herramienta Easy Setup Tool (easyinstall_viewagent.sh) para máquinas Linux. Esta herramienta realiza todas las instalaciones y configuraciones del sistema necesarias para que una máquina Linux esté disponible para su uso en una implementación de Horizon 8.

Descripción general de Easy Setup Tool

La herramienta Easy Setup Tool es un instalador guiado que realiza las siguientes operaciones en la máquina Linux.

  • Comprobación previa del sistema

    Valida que la máquina cumple los siguientes requisitos:

    La herramienta muestra una notificación si la máquina no cumple ciertos requisitos.

  • Configuraciones del sistema

    Realiza las siguientes configuraciones de sistema:

    • Configura el DNS.

    • Configura los ajustes de NTP y de nombre de host, y une la máquina al dominio de Active Directory especificado.

      Nota: Esta versión de Easy Setup Tool solo utiliza el método de autenticación System Security Services Daemon (SSSD) para la unión al dominio.

  • Instalación de Horizon Agent

    Realiza las siguientes operaciones en la máquina:

    • Compila los siguientes módulos de kernel para admitir ciertas funciones de los escritorios Linux:
      • Controlador V4L2Loopback, que admite Audio/vídeo en tiempo real (RTAV)
      • Controlador USB VHCI, que admite el redireccionamiento USB
    • Instala las dependencias de agente obligatorias, como se indica en Instalar paquetes de dependencia Linux para Horizon Agent.
    • Instala Horizon Agent for Linux con las opciones de instalación especificadas.

Nota: Para obtener información sobre cómo especificar los parámetros de instalación, como el dominio de Active Directory, las opciones de instalación del agente y el nivel de las indicaciones del instalador, consulte "Parámetros de configuración para Easy Setup Tool".

Descargar y ejecutar Easy Setup Tool

  1. Descargue el paquete de instalación de Horizon Agent for Linux de Omnissa Customer Connect.

    Vaya a la página de descargas de la versión actual de Horizon 8 y, a continuación, a la página de descarga de Horizon para Linux de 64 bits.

    Descargue el instalador tarball de Horizon Agent cuyo nombre sigue el patrón Omnissa-horizonagent-linux-x86_64-YYMM-y.y.y-xxxxxxx.tar.gz, donde YYMM es el número de la versión de marketing, y.y.y es el número de la versión interna y xxxxxxx es el número de compilación.

  2. Descomprima el archivo tar para su distribución Linux. El siguiente comando utiliza agent-installer para hacer referencia al archivo tarball del instalador.

    tar -xvzf *Omnissa-horizonagent-linux-x86_64-YYMM-y.y.y-xxxxxxx.tar.gz*
    
  3. Desplácese hasta la carpeta tarball y ejecute el script easyinstall.viewagent.sh como usuario raíz. Anexe los parámetros de la línea de comandos para cualquier opción de instalación que desee incluir.

    Para obtener información detallada, consulte "Parámetros de la línea de comandos para Easy Setup Tool" a continuación.

    Utilice los siguientes ejemplos de comandos como referencia:

    #Run the Easy Setup Tool with default prompts and installation options
    ./easyinstall_viewagent.sh
    
    #Run the tool in silent mode with installation options specified in easyinstall.conf
    ./easyinstall_viewagent.sh -s -f ./easyinstall.conf
    
  4. Permita que Easy Setup Tool continúe sin interrupciones y responda a las indicaciones del instalador según sea necesario.

  5. Una vez finalizada la instalación, reinicie la máquina Linux para que se apliquen los cambios.

  6. Ejecute el siguiente comando para comprobar que el servicio viewagent está iniciado.

    sudo service viewagent status
    

Parámetros de la línea de comandos para Easy Setup Tool

En la siguiente tabla se describen los parámetros de la línea de comandos que puede anexar al comando ./easyinstall_viewagent.sh para especificar las opciones de instalación y los niveles de indicaciones.

OpciónDescripción
-s, --silent Ejecuta Easy Setup Tool en modo silencioso omitiendo todas las indicaciones del instalador. Las opciones de instalación requeridas se recuperan del archivo de configuración especificado por el parámetro -f. Para obtener más información, consulte la sección "Parámetros de configuración para Easy Setup Tool" en este tema. Ejemplo de comando:

./easyinstall_viewagent.sh -s -f ./easyinstall.conf
-l, --prompt-level Especifica el nivel de interacción del usuario en función del nivel de las indicaciones del instalador. La configuración de cada nivel de indicaciones se recupera del archivo de configuración especificado por el parámetro -f. Para obtener más información, consulte "Parámetros de configuración para Easy Setup Tool". Valores permitidos:
  • default: muestra solo las indicaciones de las opciones de instalación básicas. Cuando el parámetro -l no se incluye o no está configurado, se utilizará el nivel de indicaciones default.
  • advanced: además de las indicaciones del nivel default, muestra indicaciones de opciones de instalación avanzadas, como si se deben instalar las funciones de la experiencia remota.
  • expert: además de las indicaciones de los niveles default y advanced, muestra indicaciones de opciones de instalación de experto, como si se deben instalar soporte para FIPS.
Ejemplo de comando:

./easyinstall_viewagent.sh -l advanced -f ./easyinstall.conf
-f, --config-file Lee las configuraciones del archivo de configuración especificado. Si desea obtener más información, consulte Parámetros de configuración para Easy Setup Tool. Ejemplo de comando:

./easyinstall_viewagent.sh -s -f ./easyinstall.conf
-p, --pre-check-only Solo realiza las operaciones de comprobación previa descritas en la descripción general. No realiza configuraciones del sistema ni la instalación de Horizon Agent. Ejemplo de comando:

./easyinstall_viewagent.sh -p
-c, --configure-only Solo realiza las configuraciones del sistema descritas en la descripción general. No realiza operaciones de comprobación previa ni la instalación de Horizon Agent. Ejemplo de comando:

./easyinstall_viewagent.sh -c
-i, --install-agent-only Solo instala Horizon Agent, como se describe en la descripción general. No realiza operaciones de comprobación previa ni configuraciones del sistema. Ejemplo de comando:

./easyinstall_viewagent.sh -i
-h, --help Muestra información de ayuda para Easy Setup Tool y sale de la herramienta. Ejemplo de comando:

./easyinstall_viewagent.sh -h

Parámetros de configuración para Easy Setup Tool

Para especificar los parámetros de configuración de Easy Setup Tool, puede escribir los parámetros en un archivo de configuración y, a continuación, recuperar el archivo con el parámetro de línea de comandos -f.

Por ejemplo, el siguiente comando ejecuta las herramientas con el nivel de indicaciones del instalador advanced, según se especifica en el archivo de configuración easyinstall.conf.


./easyinstall_viewagent.sh -l advanced -f ./easyinstall.conf

Tenga en cuenta las siguientes reglas y convenciones al escribir un archivo de configuración:

  • Consulte la plantilla de configuración easyinstall.conf.template, que se encuentra en la misma carpeta tarball que contiene el script easyinstall_viewagent.sh.

  • Guarde el archivo de configuración en la misma carpeta tarball.

  • Los parámetros de configuración se agrupan en conjuntos que corresponden a los tres niveles de indicaciones del instalador: default, advanced y expert.

  • Para omitir una indicación, desactive el parámetro de configuración de esa indicación en el archivo de configuración.

  • En las siguientes tablas, las entradas etiquetadas como "Opcional" corresponden a las indicaciones que aceptan entradas opcionales. Los usuarios pueden omitir una indicación opcional sin introducir ninguna entrada.

  • Para las indicaciones que aceptan entradas "y" o "n", la configuración en mayúsculas representa la configuración predeterminada.

    Por ejemplo, el parámetro EASYINSTALL_AGENT_MANAGED toma "Y" como configuración predeterminada, lo que significa que Horizon Agent se instala en modo administrado de forma predeterminada. La configuración predeterminada se aplica al omitir una indicación o al ejecutar Easy Setup Tool en modo silencioso.

Parámetros para el nivel de indicaciones predeterminado

Parámetro de configuraciónDescripción
EASYINSTALL_HOSTNAMEEspecifique el nombre de host para el host (opcional).
EASYINSTALL_DNS_LISTEspecifique el DNS para el host (opcional).
EASYINSTALL_DOMAIN_FQDNEspecifique el FQDN del dominio de Active Directory al que desea unirse.
EASYINSTALL_DOMAIN_JOIN_USEREspecifique la cuenta de usuario que se utilizará para la unión de dominio.
EASYINSTALL_DOMAIN_JOIN_PASSWORDEspecifique la contraseña que se utilizará para la unión de dominio.
EASYINSTALL_PROXYEspecifique el servidor proxy que se utilizará durante el proceso de configuración (opcional).
EASYINSTALL_AGENT_ACCEPT_GENERAL_TERMS Especifique si acepta el acuerdo de Términos generales [S/N]. Debe aceptar los Términos generales para continuar con Easy Setup Tool.

Parámetros para el nivel de indicaciones avanzado

Nombre de la configuraciónDescripción
EASYINSTALL_NTPIntroduzca la dirección IP del servidor NTP (opcional).
EASYINSTALL_DOMAIN_JOINEspecifique si desea unirse al dominio Active Directory [Y/n].
EASYINSTALL_AGENT_MANAGEDEspecifique si desea instalar Horizon Agent en modo administrado [Y/n].
EASYINSTALL_AGENT_MULTIPLE_SESSIONEspecifique si desea instalar compatibilidad con varias sesiones [Y/n].
EASYINSTALL_AGENT_WEBCAMEspecifique si desea instalar la función de redireccionamiento de cámara web [y/N].
EASYINSTALL_AGENT_AUDIO_INEspecifique si desea instalar el soporte para el redireccionamiento de la entrada de audio [y/N].
EASYINSTALL_AGENT_USB_REDIRECTIONEspecifique si desea instalar la función de redireccionamiento USB [y/N].
EASYINSTALL_AGENT_CLIENT_DRIVE_REDIRECTIONEspecifique si desea instalar la función de redireccionamiento de unidades cliente [Y/n].
EASYINSTALL_AGENT_CLIPBOARD_REDIRECTIONEspecifique si desea instalar la función de redireccionamiento del portapapeles [Y/n].
EASYINSTALL_AGENT_PRINTER_REDIRECTIONEspecifique si desea instalar la función de redireccionamiento de impresora [Y/n].
EASYINSTALL_AGENT_SKIP_BUILD_MODULESEspecifique si desea omitir la creación de los módulos requeridos [y/N].
EASYINSTALL_AGENT_SINGLE_SIGN_ONEspecifique si desea instalar compatibilidad con el inicio de sesión único [Y/n].
EASYINSTALL_AGENT_RESTART_AFTER_INSTALLATIONEspecifique si desea reiniciar la máquina automáticamente después de la instalación [y/N].
EASYINSTALL_HORIZON_CONNECTION_SERVER_ADDRESSIntroduzca el FQDN o la dirección IP de Connection Server (solo para el modo no administrado).
EASYINSTALL_HORIZON_ADMIN_DOMAINIntroduzca el nombre de dominio del administrador de Connection Server (solo para el modo no administrado).
EASYINSTALL_HORIZON_ADMIN_USERIntroduzca el nombre de administrador de Connection Server (solo para el modo no administrado).
EASYINSTALL_HORIZON_ADMIN_PASSWORDIntroduzca la contraseña de administrador de Connection Server (solo para el modo no administrado).

Parámetros para el nivel de indicaciones de experto

Nombre de la configuraciónDescripción
EASYINSTALL_AGENT_FIPSEspecifique si desea instalar el soporte para el modo FIPS [y/N].
EASYINSTALL_AGENT_IPV6Especifique si desea instalar el soporte para redes IPv6 [y/N].
EASYINSTALL_AGENT_NO_HOSTED_APPEspecifique si desea no permitir grupos de aplicaciones de sesión única [y/N].
EASYINSTALL_AGENT_DISABLE_HZNGREETEREspecifique si desea desactivar la pantalla de inicio de Horizon, que admite las funciones True SSO y SSO de tarjetas inteligentes [y/N].
EASYINSTALL_AGENT_SMARTCARD_REDIRECTIONEspecifique si desea instalar la función de redireccionamiento de tarjeta inteligente [y/N].
EASYINSTALL_AGENT_TRUE_SSOEspecifique si desea instalar la función True SSO [y/N].
EASYINSTALL_AGENT_SELF_SIGNED_CERT_SUBJECT_DNIntroduzca el DN del firmante del certificado autofirmado de preferencia (opcional).
EASYINSTALL_AGENT_JMS_SSL_KEYSTORE_PASSWORDIntroduzca la contraseña del almacén de claves SSL JMS de preferencia (opcional).
EASYINSTALL_AGENT_VHCI_SOURCE_DOWNLOAD_PATHEspecifique la ruta del archivo del paquete de origen VHCI (opcional).
EASYINSTALL_AGENT_V4L2LOOPBACK_SOURCE_DOWNLOAD_PATHEspecifique la ruta del archivo del paquete de origen V4L2Loopback (opcional).
EASYINSTALL_HORIZON_ADMIN_KDCEspecifique el centro de distribución de claves (KDC) de Kerberos para el dominio de administrador de Horizon 8 (opcional, solo para el modo no administrado).
EASYINSTALL_HORIZON_CONNECTION_SERVER_KDCEspecifique el KDC para el dominio de Connection Server (opcional, solo para el modo no administrado).
EASYINSTALL_HORIZON_CONNECTION_SERVER_DOMAINIntroduzca el nombre de dominio de Connection Server (opcional, solo para el modo no administrado).

Consideraciones sobre las funciones de Easy Setup Tool

Las siguientes consideraciones y limitaciones se aplican a Easy Setup Tool.

¿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…