Instalar VDA mediante scripts

Nota:

Citrix no se hace responsable de los problemas causados por scripts adaptados a los entornos de producción de los clientes. Para cualquier problema de instalación relacionado con Citrix, abra un caso de soporte técnico con los registros de instalación pertinentes a través del portal de asistencia de Citrix.

Este artículo se aplica a la instalación de VDA en máquinas con sistemas operativos Windows. Para obtener información sobre los VDA para sistemas operativos Linux, consulte la documentación de Linux Virtual Delivery Agent.

El medio de instalación contiene scripts de ejemplo que instalan, actualizan o quitan Virtual Delivery Agents (VDA) para máquinas en Active Directory. También puede usar los scripts para mantener las imágenes maestras utilizadas por Machine Creation Services™ y Citrix Provisioning (antes Provisioning Services).

Acceso necesario:

  • Los scripts necesitan acceso de lectura para Todos a la ubicación compartida de red donde se encuentra el comando de instalación del VDA. El comando de instalación es XenDesktopVdaSetup.exe en la ISO del producto completo, o VDAWorkstationSetup.exe o VDAServerSetup.exe en un instalador independiente.
  • Los detalles de registro se almacenan en cada máquina local. Para registrar los resultados de forma centralizada para su revisión y análisis, los scripts necesitan acceso de lectura y escritura para Todos a la ubicación compartida de red adecuada.

Para comprobar los resultados de la ejecución de un script, examine la ubicación compartida de registros central. Los registros capturados incluyen el registro del script, el registro del instalador y los registros de instalación de MSI. Cada intento de instalación o eliminación se registra en una carpeta con marca de tiempo. El título de la carpeta indica el resultado de la operación con el prefijo PASS o FAIL. Puede usar herramientas de búsqueda de directorios estándar para encontrar una instalación o eliminación fallida en la ubicación compartida de registros central. Esas herramientas ofrecen una alternativa a la búsqueda local en las máquinas de destino.

Antes de iniciar cualquier instalación, lea y complete las tareas en Preparar la instalación.

Instalar o actualizar VDA mediante el script

  1. Obtenga el script de ejemplo InstallVDA.bat de \Support\AdDeploy\ en el medio de instalación. Citrix recomienda hacer una copia de seguridad del script original antes de personalizarlo.
  2. Modifique el script:
    • Especifique la versión del VDA que se va a instalar: SET DESIREDVERSION. El valor completo se puede encontrar en el medio de instalación en el archivo ProductVersion.txt. Sin embargo, no se requiere una coincidencia exacta.
    • Especifique la ubicación compartida de red donde se invocará el instalador. Apunte a la raíz del diseño (el punto más alto del árbol). La versión adecuada del instalador (de 32 o 64 bits) se llama automáticamente cuando se ejecuta el script. Por ejemplo: SET DEPLOYSHARE=\\fileserver1\share1.
    • Opcionalmente, especifique una ubicación de recurso compartido de red para almacenar registros centralizados. Por ejemplo: SET LOGSHARE=\\fileserver1\log1).
    • Especifique las opciones de configuración de VDA como se describe en Instalar mediante la línea de comandos. Las opciones /quiet y /noreboot se incluyen de forma predeterminada en el script y son obligatorias: SET COMMANDLINEOPTIONS=/QUIET /NOREBOOT /NORESUME.
  3. Mediante los scripts de inicio de directivas de grupo, asigne el script a la OU que contiene sus máquinas. Esta OU debe contener solo las máquinas en las que desea instalar el VDA. Cuando las máquinas de esa OU se reinician, el script se ejecuta en todas ellas. Se instala un VDA en cada máquina que tiene un sistema operativo compatible.

Eliminar VDA mediante el script

  1. Obtenga el script de ejemplo UninstallVDA.bat de \Support\AdDeploy\ en el medio de instalación. Citrix recomienda hacer una copia de seguridad del script original antes de personalizarlo.
  2. Modifique el script.
    • Especifique la versión del VDA que desea eliminar: SET CHECK\_VDA\_VERSION. El valor completo se puede encontrar en el medio de instalación en el archivo ProductVersion.txt (por ejemplo, 7.0.0.3018). Sin embargo, no se requiere una coincidencia exacta.
    • Opcionalmente, especifique una ubicación de recurso compartido de red para almacenar registros centralizados.
  3. Mediante los scripts de inicio de directivas de grupo, asigne el script a la OU que contiene sus máquinas. Esta OU debe contener solo las máquinas de las que desea eliminar el VDA. Cuando las máquinas de la OU se reinician, el script se ejecuta en todas ellas. El VDA se elimina de cada máquina.

Solucionar problemas

  • El script genera archivos de registro internos que describen el progreso de la ejecución del script. El script copia un registro Kickoff_VDA_Startup_Script en el recurso compartido de registro central a los pocos segundos de iniciar la implementación. Puede verificar que el proceso general funciona. Si este registro no se copia en el recurso compartido de registro central como se esperaba, solucione el problema inspeccionando la máquina local. El script coloca dos archivos de registro de depuración en la carpeta %temp% de cada máquina:

    • Kickoff_VDA_Startup_Script_<DateTimeStamp>.log
    • VDA_Install_ProcessLog_<DateTimeStamp>.log

    Revise estos registros para asegurarse de que el script:

    • Se ejecuta según lo esperado.
    • Detección correcta del sistema operativo de destino.
    • Configurado correctamente para apuntar a la ROOT del recurso compartido DEPLOYSHARE (contiene el archivo llamado AutoSelect.exe).
    • Capaz de autenticarse en los recursos compartidos DEPLOYSHARE y LOG.
  • Para obtener información sobre cómo Citrix informa del resultado de las instalaciones de componentes, consulte Códigos de retorno de la instalación de Citrix.

  • En la pantalla de Studio para un grupo de entrega, la entrada Versión de VDA instalada en el panel Detalles podría no ser la versión instalada en las máquinas. La visualización de programas y características de la máquina muestra la versión real del VDA.

  • Una vez instalado un VDA, no puede entregar aplicaciones o un escritorio a los usuarios hasta que se registre en un Delivery Controller.

    Para obtener información sobre los métodos de registro de VDA y cómo solucionar problemas de registro, consulte Registro de VDA.

Instalar VDA mediante scripts