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 VMware 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 archivo del instalador de Horizon Agent for Linux desde el sitio de descarga de VMware en https://my.vmware.com/web/vmware/downloads.

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

    Descargue el archivo tar del instalador de Horizon Agent con el nombre de archivo VMware-horizonagent-linux-x86_64-YYMM-y.y.y-xxxxxxx.tar.gz, donde YYMM es el número de versión de marketing, y.y.y es el número de versión interna y xxxxxxx es el número de compilación.

  2. Descomprima el archivo tar para su distribución Linux. Por ejemplo:
    tar -xvzf VMware-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 usario 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.

    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ón Descripció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 Parámetros de configuración para Easy Setup Tool.

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 Descripción general de Easy Setup Tool. 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 Descripción general de Easy Setup Tool. 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 Descripción general de Easy Setup Tool. 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, desactvie 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.

Tabla 1. Parámetros para el nivel de indicaciones predeterminado
Parámetro de configuración Descripción
EASYINSTALL_HOSTNAME Especifique el nombre de host para el host (opcional).
EASYINSTALL_DNS_LIST Especifique el DNS para el host (opcional).
EASYINSTALL_DOMAIN_FQDN Especifique el FQDN del dominio de Active Directory al que desea unirse.
EASYINSTALL_DOMAIN_JOIN_USER Especifique la cuenta de usuario que se utilizará para la unión de dominio.
EASYINSTALL_DOMAIN_JOIN_PASSWORD Especifique la contraseña que se utilizará para la unión de dominio.
EASYINSTALL_PROXY Especifique 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.
Tabla 2. Parámetros para el nivel de indicaciones avanzado
Nombre de la configuración Descripción
EASYINSTALL_NTP Introduzca la dirección IP del servidor NTP (opcional).
EASYINSTALL_DOMAIN_JOIN Especifique si desea unirse al dominio Active Directory [Y/n].
EASYINSTALL_AGENT_MANAGED Especifique si desea instalar Horizon Agent en modo administrado [Y/n].
EASYINSTALL_AGENT_MULTIPLE_SESSION Especifique si desea instalar compatibilidad con varias sesiones [Y/n].
EASYINSTALL_AGENT_WEBCAM Especifique si desea instalar la función de redireccionamiento de cámara web [y/N].
EASYINSTALL_AGENT_AUDIO_IN Especifique si desea instalar el soporte para el redireccionamiento de la entrada de audio [y/N].
EASYINSTALL_AGENT_USB_REDIRECTION Especifique si desea instalar la función de redireccionamiento USB [y/N].
EASYINSTALL_AGENT_CLIENT_DRIVE_REDIRECTION Especifique si desea instalar la función de redireccionamiento de unidades cliente [Y/n].
EASYINSTALL_AGENT_CLIPBOARD_REDIRECTION Especifique si desea instalar la función de redireccionamiento del portapapeles [Y/n].
EASYINSTALL_AGENT_PRINTER_REDIRECTION Especifique si desea instalar la función de redireccionamiento de impresora [Y/n].
EASYINSTALL_AGENT_SKIP_BUILD_MODULES Especifique si desea omitir la creación de los módulos requeridos [y/N].
EASYINSTALL_AGENT_SINGLE_SIGN_ON Especifique si desea instalar compatibilidad con el inicio de sesión único [Y/n].
EASYINSTALL_AGENT_RESTART_AFTER_INSTALLATION Especifique si desea reiniciar la máquina automáticamente después de la instalación [y/N].
EASYINSTALL_HORIZON_CONNECTION_SERVER_ADDRESS Introduzca el FQDN o la dirección IP de Connection Server (solo para el modo no administrado).
EASYINSTALL_HORIZON_ADMIN_DOMAIN Introduzca el nombre de dominio del administrador de Connection Server (solo para el modo no administrado).
EASYINSTALL_HORIZON_ADMIN_USER Introduzca el nombre de administrador de Connection Server (solo para el modo no administrado).
EASYINSTALL_HORIZON_ADMIN_PASSWORD Introduzca la contraseña de administrador de Connection Server (solo para el modo no administrado).
Tabla 3. Parámetros para el nivel de indicaciones de experto
Nombre de la configuración Descripción
EASYINSTALL_AGENT_FIPS Especifique si desea instalar el soporte para el modo FIPS [y/N].
EASYINSTALL_AGENT_IPV6 Especifique si desea instalar el soporte para redes IPv6 [y/N].
EASYINSTALL_AGENT_NO_HOSTED_APP Especifique si desea no permitir grupos de aplicaciones de sesión única [y/N].
EASYINSTALL_AGENT_DISABLE_VMWGREETER Especifique si desea desactivar la pantalla de inicio de VMware, que admite las funciones True SSO y SSO de tarjetas inteligentes [y/N].
EASYINSTALL_AGENT_SMARTCARD_REDIRECTION Especifique si desea instalar la función de redireccionamiento de tarjeta inteligente [y/N].
EASYINSTALL_AGENT_TRUE_SSO Especifique si desea instalar la función True SSO [y/N].
EASYINSTALL_AGENT_SELF_SIGNED_CERT_SUBJECT_DN Introduzca el DN del firmante del certificado autofirmado de preferencia (opcional).
EASYINSTALL_AGENT_JMS_SSL_KEYSTORE_PASSWORD Introduzca la contraseña del almacén de claves SSL JMS de preferencia (opcional).
EASYINSTALL_AGENT_VHCI_SOURCE_DOWNLOAD_PATH Especifique la ruta del archivo del paquete de origen VHCI (opcional).
EASYINSTALL_AGENT_V4L2LOOPBACK_SOURCE_DOWNLOAD_PATH Especifique la ruta del archivo del paquete de origen V4L2Loopback (opcional).
EASYINSTALL_HORIZON_ADMIN_KDC Especifique el centro de distribución de claves (KDC) de Kerberos para el dominio de administrador de VMware Horizon 8 (opcional, solo para el modo no administrado).
EASYINSTALL_HORIZON_CONNECTION_SERVER_KDC Especifique el KDC para el dominio de Connection Server (opcional, solo para el modo no administrado).
EASYINSTALL_HORIZON_CONNECTION_SERVER_DOMAIN Introduzca 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.