Citrix Virtual Apps and Desktops

Instalar agentes VDA mediante SCCM

Información general

Microsoft Endpoint Configuration Manager, anteriormente System Center Configuration Manager (SCCM), es un producto de Windows que habilita la administración, implementación y protección de dispositivos y aplicaciones en toda la empresa.

Nota:

El siguiente artículo describe solo las recomendaciones basadas en la forma en que Citrix ha probado el entorno. Puede personalizar estos pasos según sus necesidades. Citrix no se hace responsable de las actualizaciones o ajustes necesarios para adaptarlo a las necesidades de los clientes.

Recomendaciones

  • Para implementar correctamente un Virtual Delivery Agent (VDA) con 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.

Antes de comenzar

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.
  • 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. Para obtener más información sobre la instalación de VDA, consulte Instaladores.

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

Pasos clave para implementar VDA con SCCM

En los pasos siguientes se describe cómo implementar el VDA mediante SCCM en la máquina virtual.

  1. Instalar el VDA.
  2. Crear una unidad organizativa (OU).
  3. Verificar las máquinas.
  4. Usar VDA para distribuir contenido.

Paso 1: Instalar el VDA

Después de identificar todos los requisitos previos, use el secuenciador de tareas de SCCM para completar las tareas siguientes:

  1. Instale los VDA 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.

    Nota:

    Al actualizar la versión de un VDA, la máquina en la que está instalado debe estar en modo de mantenimiento, sin sesiones.

  2. 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 usar un instalador de VDA que no sea VDAWorkstationCoreSetup_XXXX.exe, el instalador de VDA se copia en %ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exe.
    • Cuando se usa VDAWorkstationCoreSetup_XXXX.exe, el instalador del VDA se copia en %ProgramData%\Citrix\XenDesktopSetup\XenDesktopRemotePCSetup.exe.
  3. La ubicación del directorio del instalador de VDA también se almacena en el Registro HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\MetaInstall” “MetaInstallerInstallLocation”.

  4. Agregue las opciones de línea de comandos /NOREBOOT, /NORESUME y /QUIET.

    • /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 de Registro RunOnce (\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce). Windows usa la clave para abrir el instalador del VDA cuando se reinicia la máquina. Esto es un problema para SCCM, ya que SCCM no puede supervisar la instalación ni capturar el código de salida.

Paso 2: Crear una unidad organizativa (OU)

  1. Cree dos máquinas virtuales unidas a un dominio que quiera agregar a la OU. Cuando las máquinas virtuales se crean inicialmente, se encuentran en la carpeta Equipos. Mueva las máquinas virtuales a la carpeta SCCM. Ejemplo: WIN10EN-BB80MJ4.cseblr.com W2K19ST-EBPR3UG.cseblr.com

    SCCM VDA

  2. En Microsoft Configuration Manager, vaya a \Administration\Overview\Hierarchy Configuration\Discovery Methods\.

  3. Haga clic en Detección de sistemas de Active Directory y seleccione la casilla de verificación Habilitar detección de sistemas de Active Directory para habilitar la detección automática de las máquinas virtuales recién creadas.

  4. Haga clic en el icono para seleccionar nuevos contenedores.

  5. En la sección Ubicación , agregue la ruta en la que se encuentran las máquinas virtuales de SCCM.

  6. Vaya a \Administration\Overview\Site Configuration\Sites y haga clic con el botón secundario en el VDA de SCCM.

  7. Seleccione Configuración de instalación de cliente > Instalación de inserción de cliente. Se abre la ventana Propiedades de la instalación de inserción de cliente.

  8. Una vez que las máquinas virtuales estén configuradas en Enabled, podrá ver la lista de máquinas virtuales como se muestra en las siguientes imágenes.

    SCCM

    SCCM

  9. Cree una Colección de dispositivos para crear la unidad organizativa. Introduzca el Nombre de la colección.

    Colección de dispositivos

  10. Siga las instrucciones del asistente.

    Reglas de pertenencia

    Se crea la OU.

    Creación de OU

  11. Agregue las máquinas virtuales creadas a la colección de dispositivos recién creada.

    1. Haga clic con el botón secundario en la VM. Seleccione Agregar elementos seleccionados > Agregar elementos seleccionados a la colección de dispositivos existente.

      Agregar elemento

    2. En la ventana Seleccionar colección, seleccione el nombre del dispositivo. En este ejemplo, es Devices-SCCM.

      Lista de dispositivos

    Devices-SCCM aparece en Activos y compatibilidad > Información general > Recopilaciones de dispositivos.

    Dispositivo en la lista

  12. Seleccione Instalar cliente en el Recopilador de dispositivos.

    Instalar cliente

  13. Seleccione el sitio de instalación requerido.

    Sitio de instalación

  14. Siga las instrucciones del asistente. El Asistente para instalar el cliente de Configuration Manager se completa correctamente.

    Instalación completa

Para obtener información detallada, consulte Administrar colecciones en la documentación de Microsoft.

Paso 3: Verificar las máquinas

  1. En la máquina cliente, verifique que el cliente esté instalado. Para ello, compruebe si el proceso CCMExec se está ejecutando.

    CCMexe.exe

  2. Verifique si el cliente se está ejecutando para las máquinas virtuales de SCCM.

Paso 4: Usar VDA para distribuir contenido

Los pasos siguientes describen cómo puede usar el VDA implementado para distribuir contenido en las máquinas virtuales asociadas.

  1. Crear un paquete

  2. Distribuir contenido

Crear un paquete

  1. Para crear un paquete, haga clic con el botón secundario en el VDA que quiera y, a continuación, haga clic en Crear paquete.

    Crear paquete

  2. Especifique la ubicación de los archivos de origen de este paquete haciendo clic en Examinar.

    Examinar paquete

  3. Seleccione un tipo de paquete.

    Asistente para la creación de paquetes y programas

  4. Introduzca el nombre del paquete y la línea de comandos.

    Especificar los detalles del paquete

  5. Haga clic en Next.

    Paquete correcto

Para obtener información detallada, consulte los Paquetes y programas de Configuration Manager en la documentación de Microsoft.

Distribuir contenido

  1. Haga clic con el botón secundario en el nombre del paquete que ha creado.

  2. Seleccione Distribuir contenido.

    Distribuir contenido

  3. En la ventana del Asistente para distribuir contenido, seleccione la ubicación de los archivos de origen del paquete que ha creado. En este ejemplo, es 2019-SCCM. Haga clic en Next.

    Especificar ubicación

  4. Verifique que el paquete (en este ejemplo Zodiac) esté disponible para su implementación.

    Verificación

    La siguiente imagen muestra que el paquete está disponible para su implementación.

    Paquete para implementar

Para obtener información detallada, consulte Implementación y administración de contenido para Configuration Manager en la documentación de Microsoft.

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 de línea de comandos /quiet, /noreboot y /noresume.

    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 la versión del editor de secuencia 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