Citrix Virtual Apps and Desktops 7 2203 LTSR

Instalar VDAs mediante SCCM

Nota:

Citrix no se hace responsable de los problemas que surjan a causa de la implementación de un Virtual Delivery Agent (VDA) mediante herramientas de distribución de software como Microsoft System Center Configuration Manager (SCCM) adaptadas para coincidir con los entornos de producción del cliente. Para cualquier problema de instalación relacionado con Citrix, abra un caso de soporte técnico con los registros de instalación pertinentes utilizando el portal de asistencia de Citrix.

Información general

Para implementar correctamente un Virtual Delivery Agent (VDA) mediante Microsoft System Center Configuration Manager (SCCM) o herramientas de distribución de software similares, Citrix® recomienda utilizar el instalador de VDA en una secuencia de pasos.

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

Reinicios

El número de reinicios necesarios durante la instalación del VDA depende del entorno. Por ejemplo:

  • Puede ser necesario un reinicio para las actualizaciones pendientes o los reinicios de instalaciones de software anteriores.
  • Los archivos bloqueados previamente por otros procesos podrían necesitar actualizaciones, lo que forzaría un reinicio adicional.
  • Algunos componentes opcionales del instalador de VDA (como Citrix Profile Management y Citrix Files) podrían requerir un reinicio.

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

Definir la secuencia de tareas

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

  • El VDA se puede instalar desde una copia accesible del medio 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 un VDA, la máquina en la que está instalado debe estar en modo de mantenimiento, sin sesiones.
  • Cuando una instalación de VDA se ejecuta por primera vez en una máquina, el instalador de VDA que se utiliza se copia en esa máquina.
    • Cuando se utiliza un instalador de VDA distinto de VDAWorkstationCoreSetup_XXXX.exe, el instalador de VDA se copia en %ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exe.
    • Cuando se utiliza 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 de línea de comandos /NOREBOOT, /NORESUME y /QUIET a sus opciones de línea de comandos.
    • /QUIET: No muestre la interfaz de usuario durante la instalación, para que SCCM tenga el control del proceso de instalación.
    • /NOREBOOT: Suprime el reinicio automático del instalador de VDA. SCCM activa los reinicios cuando es necesario.
    • /NORESUME: Normalmente, cuando se necesita un reinicio durante la instalación, el instalador de VDA establece una clave de registro runonce (\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce). Cuando la máquina se reinicia, Windows utiliza la clave para iniciar el instalador de VDA. Esto es un problema para SCCM, porque SCCM no puede supervisar la instalación y capturar el código de salida.

Ejemplo de secuencia de instalación mediante SCCM

El siguiente ejemplo muestra la secuencia de instalación.

  1. TAREA DE SCCM 1: Prepare la máquina reiniciándola.
  2. TAREA DE SCCM 2: Inicie la instalación del VDA.
    1. Agregue las opciones /quiet, /noreboot y /noresume a las opciones de la línea de comandos.
    2. Ejecute el instalador de VDA que prefiera (imagen local o uno de los instaladores mínimos).
    3. SCCM debe capturar el código de retorno.
      • Si el código de retorno es 0 u 8, la instalación se ha completado y es necesario reiniciar.
      • Si el código de retorno es 3, reinicie la máquina y, a continuación, pase el control a la TAREA DE SCCM 3.
  3. TAREA DE SCCM 3: Continúe la instalación del VDA.
    1. Si la TAREA DE SCCM 2 no devuelve un 0 o un 8, la instalación debe continuar una vez que se complete el reinicio.
    2. La TAREA DE SCCM 3 se repite hasta que el instalador de VDA devuelve un 0 o un 8 (lo que indica una instalación correcta) o un 3 (lo que indica que la TAREA DE SCCM 3 debe repetirse). Cualquier otro código de retorno se debe tratar como un error, y la TAREA DE SCCM 3 debe informar de un error y detenerse.
    3. Reanude la instalación del VDA ejecutando el instalador de VDA adecuado (XenDesktopVdaSetup.exe para la mayoría de los casos, o XenDesktopRemotePCSetup.exe si se utilizó VDAWorkstationCoreSetup_XXXX.exe) desde la ubicación donde se copió (como se describe en Definir la secuencia de tareas), sin parámetros de línea de comandos. (El instalador de VDA utiliza los parámetros que guardó durante la primera ejecución del instalador).
    4. Esté atento al código de retorno del instalador de VDA.
      • 0 u 8: Correcto, instalación completa, se requiere reiniciar.
      • 3: La instalación no está completa. Reinicie la máquina y repita la TAREA DE SCCM 3 hasta que se devuelva un 0 o un 8. Cualquier otro código de retorno se debe tratar como un error, y la TAREA DE SCCM 3 debe informar de un error y finalizar.

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

Ejemplos de comandos de instalación de VDA

Las opciones de instalación disponibles varían según el instalador que se utilice. Consulte los siguientes artículos para obtener detalles sobre las opciones de línea de comandos.

Comandos de instalación para Remote PC Access

  • El siguiente comando utiliza el instalador VDA principal de sesión única (VDAWorkstationCoreSetup.exe):

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

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

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

Comando de instalación para VDI dedicado

  • El siguiente comando utiliza el instalador 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 VDAs mediante SCCM