Instalar agentes VDA mediante scripts

October 13, 2023

Contribución de:

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 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.

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

Los medios de instalación contienen scripts de ejemplo para instalar, actualizar o quitar los agentes Virtual Delivery Agent (VDA) de máquinas en Active Directory. También puede usar los scripts para mantener las imágenes maestras que utilicen Machine Creation Services y Citrix Provisioning (antes Provisioning Services).

Acceso requerido:

El script necesita acceso de lectura para Todos en el recurso compartido de red donde se encuentra el comando de instalación de VDA. El comando de instalación es XenDesktopVdaSetup.exe en la imagen ISO del producto completo; VDAWorkstationSetup.exe o VDAServerSetup.exe en un instalador independiente.

Los detalles de registros se almacenan localmente en cada máquina. Si quiere registrar los resultados en una ubicación centralizada, para poder consultarlos y analizarlos, los scripts necesitan acceso de Lectura y Escritura para Todos en el recurso compartido de red correspondiente.

Para comprobar los resultados de la ejecución de un script, consulte el recurso compartido de registros centralizados. 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 su fecha y hora. El nombre de la carpeta indica si la operación se realizó o no correctamente, con el prefijo PASS o FAIL, respectivamente. Puede usar herramientas estándar de búsqueda de directorios para buscar una instalación o eliminación fallidas en el recurso compartido de registros centralizados. Esas herramientas ofrecen una alternativa a la búsqueda local en las máquinas de destino.

Antes de comenzar una instalación, consulte y complete las tareas de Antes de instalar.

Instalar o actualizar agentes VDA mediante el script

Obtenga el script de ejemplo InstallVDA.bat, ubicado en el directorio \Support\AdDeploy\ de los medios de instalación. Citrix recomienda realizar una copia de seguridad de los scripts originales antes de personalizarlos.

Modifique el script:

Especifique la versión del VDA que quiere instalar: SET DESIREDVERSION. Por ejemplo: la versión 7 se puede especificar como 7.0. El valor completo se encuentra en los medios de instalación, en el archivo ProductVersion.txt. Sin embargo, no es necesaria una coincidencia completa.
Especifique el recurso compartido de red desde donde se invocará al instalador. Indique la raíz de la distribución (el nivel superior del árbol). Cuando se ejecute el script, se invocará automáticamente la versión apropiada del instalador (32 bits o 64 bits). Por ejemplo: SET DEPLOYSHARE=\\fileserver1\share1.
Si lo desea, puede especificar también una ubicación en el recurso compartido de red para guardar los registros centralizados. Por ejemplo: SET LOGSHARE=\\fileserver1\log1).
Especifique las opciones de configuración del agente VDA como se describe en Instalación desde la línea de comandos. Las opciones /quiet y /noreboot se incluyen de manera predeterminada en el script y son necesarias: SET COMMANDLINEOPTIONS=/QUIET /NOREBOOT.

Mediante la directiva de grupo Scripts de inicio, asigne el script a la unidad organizativa donde se encuentran las máquinas. Esta unidad organizativa debe contener solo las máquinas donde quiere instalar VDA. Cuando se reinicien las máquinas de esa unidad organizativa, el script se ejecutará en todas ellas. Se instala un VDA en cada máquina que tenga un sistema operativo compatible.

Eliminar agentes VDA mediante el script

Obtenga el script de ejemplo UninstallVDA.bat en el directorio \Support\AdDeploy\ de los medios de instalación. Citrix recomienda realizar una copia de seguridad de los scripts originales antes de personalizarlos.

Modifique el script.

Especifique la versión del VDA que quiere quitar: SET CHECK\_VDA\_VERSION. Por ejemplo: la versión 7 se puede especificar como 7.0. El valor completo se puede encontrar en los medios de instalación, en el archivo ProductVersion.txt (por ejemplo, 7.0.0.3018). Sin embargo, no es necesaria una coincidencia completa.
Si lo desea, puede especificar también una ubicación en el recurso compartido de red para guardar los registros centralizados.

Mediante la directiva de grupo Scripts de inicio, asigne el script a la unidad organizativa donde se encuentran las máquinas. Esta unidad organizativa debe contener solo las máquinas de donde quiere quitar el VDA. Cuando se reinicien las máquinas de esa unidad organizativa, el script se ejecutará en todas ellas. Se elimina el VDA de cada máquina.

Solucionar problemas

El script genera archivos de registros internos que describen el progreso de la ejecución del script. El script copia un registro llamado Kickoff_VDA_Startup_Script en el recurso compartido de registros centralizados a los pocos segundos de iniciarse la implementación. Eso permite comprobar que el proceso global está funcionando. Si este registro no se copia al recurso compartido de registros centralizados como es de esperar, puede inspeccionar la máquina local para buscar a qué se debe. 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 el contenido de esos registros para comprobar que el script:

Se ejecuta según lo previsto.
Detecta correctamente el sistema operativo de destino.
Está configurado correctamente para que apunte a la ROOT del recurso compartido DEPLOYSHARE (que contiene el archivo AutoSelect.exe).
Es capaz de autenticarse en los dos puntos compartidos DEPLOYSHARE y LOG.

Para obtener información sobre cómo informa Citrix del resultado de la instalación de un componente, consulte Códigos de retorno en la instalación de Citrix.

En Studio, la versión instalada de VDA en el panel Detalles referente al grupo de entrega puede no ser la versión real instalada en las máquinas. La pantalla Programas y características de la máquina muestra la versión real del VDA.

Después de instalar un VDA, no se pueden entregar aplicaciones o escritorios a los usuarios hasta que el VDA se registre con 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.

En este artículo

Instalar o actualizar agentes VDA mediante el script
Eliminar agentes VDA mediante el script
Solucionar problemas

¿Le ha resultado útil?