Citrix Virtual Apps and Desktops

Instalar agentes VDA mediante SCCM

Nota:

Citrix no se hace responsable de los problemas que puedan surgir por la implementación de un Virtual Delivery Agent (VDA) mediante herramientas de distribución de software, como Microsoft System Center Configuration Manager (SCCM), adaptadas a los entornos de producción de los clientes. Para cualquier problema de Citrix relacionado con la instalación, inicie un caso de asistencia técnica con los registros de instalación pertinentes en el portal de Citrix Support.

Overview

Para implementar correctamente un Virtual Delivery Agent (VDA) con Microsoft System Center Configuration Manager (SCCM) o herramientas de distribución de software similares, Citrix recomienda usar el instalador de VDA a través de una serie de pasos.

Citrix no recomienda utilizar la utilidad de limpieza de VDA como parte de la instalación o la actualización de un VDA. Utilice la utilidad de limpieza de VDA solamente en el caso limitado en que el instalador de VDA haya fallado antes.

Reinicios

La cantidad de reinicios necesarios durante la instalación del VDA depende del entorno. Por ejemplo:

  • Es posible que necesite reiniciar por actualizaciones pendientes o instalaciones de software anteriores.
  • Es posible que haya archivos previamente bloqueados por otros procesos que necesiten actualizaciones, lo que obliga a realizar un reinicio más.
  • Es posible que algunos componentes opcionales del instalador de VDA (como Citrix Profile Management o Citrix Files) requieran un reinicio.

El secuenciador de tareas de SCCM administra todos los reinicios necesarios.

Definir la secuencia de tareas

Después de identificar todos los requisitos previos y reinicios, utilice el secuenciador de tareas de SCCM para completar lo siguiente:

  • Los VDA se pueden instalar desde una copia accesible de los medios de instalación o desde uno de los instaladores independientes de VDA:

    • VDAWorkstationSetup_XXXX.exe
    • VDAServerSetup_XXXX.exe
    • VDAWorkstationCoreSetup_XXXX.exe

    Para obtener más información sobre los instaladores de VDA, consulte Instaladores.

  • Al actualizar la versión de un VDA, la máquina en la que está instalado debe estar en modo de mantenimiento, sin sesiones.
  • Cuando se ejecuta la instalación de un VDA por primera vez en una máquina, el instalador de VDA que se utiliza se copia en esa máquina.
    • Al utilizar un instalador de VDA que no sea VDAWorkstationCoreSetup_XXXX.exe, el instalador de VDA se copia en %ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exe.
    • Al utilizar VDAWorkstationCoreSetup_XXXX.exe, el instalador de VDA se copia en %ProgramData%\Citrix\XenDesktopSetup\XenDesktopRemotePCSetup.exe. `
  • La ubicación del directorio del instalador de VDA también se almacena en el Registro “HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\MetaInstall” “MetaInstallerInstallLocation”.
  • Agregue las opciones /NOREBOOT, /NORESUME y /QUIET de la línea de comandos a sus opciones de línea de comandos.
    • /QUIET: No muestra la interfaz de usuario durante la instalación, de modo que SCCM controla el proceso de la instalación.
    • /NOREBOOT: Impide que el instalador de VDA se reinicie automáticamente. SCCM activa los reinicios cuando es necesario.
    • /NORESUME: Normalmente, cuando es necesario reiniciar durante la instalación, el instalador de VDA establece una clave del Registro runonce (\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce). Al reiniciar la máquina, Windows utiliza la clave para iniciar el instalador de VDA. Esto es un problema para SCCM, ya que SCCM no puede supervisar la instalación ni capturar el código de salida.

Ejemplo de secuencia de instalación mediante SCCM

En este ejemplo se muestra la secuencia de instalación.

  1. Reiniciar el equipo: Prepare el equipo reiniciándolo. Reinicie el equipo
  2. Primer intento de instalación del VDA: inicie la instalación del VDA.
    1. Agregue las opciones /quiet, /noreboot y /noresume a sus opciones de línea de comandos.
    2. Ejecute el instalador de VDA que prefiera (imagen local o uno de los instaladores mínimos). Primer intento de instalación del VDA
    3. SCCM debe capturar el código de devolución.
      • Si el código de devolución es 0 u 8, la instalación se ha completado y es necesario reiniciar. SCCM captura el código de devolución
      • Si el código de retorno es 3, reinicie la máquina y, a continuación, pase el control a Segundo intento de instalación del VDA. Reiniciar máquina
  3. Segundo intento de instalación del VDA: continúe con la instalación del VDA.
    1. Tras el primer intento de instalación del VDA, si el archivo %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml existe, la instalación no se completó correctamente y debe continuar una vez finalizado el reinicio. Segundo intento de instalación del VDA
    2. El segundo intento de instalación de VDA se repite hasta que no exista el archivo %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml o hasta que se devuelva un código de retorno distinto de 0 u 8. Trate los demás códigos de devolución como un error y SEGUNDO INTENTO DE INSTALCIÓN DEL VDA debería notificar un error y detenerse.
    3. Para reanudar la instalación de VDA, ejecute el instalador de VDA adecuado (XenDesktopVdaSetup.exe en la mayoría de los casos o XenDesktopRemotePCSetup.exe si se utilizó VDAWorkstationCoreSetup_XXXX.exe) desde el %programdata%\ Citrix\XenDesktopSetup\ directorio de archivos sin parámetros de la línea de comandos. (el instalador de VDA utiliza los parámetros que guardó durante la primera ejecución del instalador). Actualizar el editor de secuencias de tareas
    4. Preste atención al código de devolución del instalador de VDA.
      • 0 u 8: Operación correctamente realizada, instalación completa, es necesario reiniciar. Instalación exitosa completada
      • 3: La instalación no se ha completado. Reinicie la máquina y repita SEGUNDO INTENTO DE INSTALACIÓN DEL VDA hasta que el archivo %programdata%\ Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml no exista o hasta que se devuelva un 0 u 8. Trate los demás códigos de devolución como un error y SEGUNDO INTENTO DE INSTALCIÓN DEL VDA debería notificar un error y finalizar.

Para obtener más información acerca de los códigos de retorno, consulte Códigos de retorno en la instalación de Citrix.

Ejemplos de comandos de instalación de VDA

Las opciones de instalación disponibles varían dependiendo del instalador que se utilice. Consulte los siguientes artículos para obtener información detallada sobre las opciones de línea de comandos

Comandos de instalación para Acceso con Remote PC

  • Este comando utiliza el instalador de VDA básico de sesión única (VDAWorkstationCoreSetup.exe):

    VDAWorkstationCoreSetup.exe /quiet /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot

  • Este comando utiliza el instalador de VDA completo de sesión única (VDAWorkstationSetup.exe):

    VDAWorkstationSetup.exe /quiet /remotepc /physicalmachine /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot

Comando de instalación para imagen de disco virtual (VDI) dedicada

  • Este comando utiliza el instalador de VDA completo de sesión única (VDAWorkstationSetup.exe):

    VDAWorkstationSetup.exe /quiet /components vda /controllers “control.domain.com” /enable_hdx_ports /enable_remote_assistance /noresume /noreboot

Instalar agentes VDA mediante SCCM