Actualizaciones de versión de VDA (Technical Preview)
Introducción
Anteriormente, la actualización de versión de VDA requería una intervención manual completa. La versión 2503 simplifica las actualizaciones de versión de VDA para implementaciones de DaaS al introducir el agente de actualización de versiones de VDA (VDA Upgrade Agent, VUA). Las actualizaciones desde la versión 2503 en adelante se pueden realizar más tarde directamente desde una ruta de archivo compartida o local.
VDA Upgrade Agent, ctxvua, es responsable de comunicarse con el servicio de actualización de versiones de VDA y realizar las siguientes funciones:
- Comprobaciones programadas: VDA Upgrade Agent consulta al servicio de actualización de versiones de VDA para obtener información de actualización programada cada 15 minutos.
- Actualizaciones automáticas: Al recibir instrucciones de actualización de versión, VDA Upgrade Agent actualiza automáticamente la versión del VDA.
- Informe de estado: VDA Upgrade Agent notifica el resultado de la actualización (correcto o error) al servicio de actualización de versiones de VDA.
Para obtener más información sobre el servicio de actualización de versiones de VDA, consulte Resumen técnico: Servicio de actualización de Citrix VDA. Allí podrá encontrar una descripción general del servicio, información detallada sobre cómo funciona y otros recursos útiles.
Consideraciones
-
Los Linux VDA se actualizan mediante comandos de administración de paquetes subyacentes (como rpm o apt), reflejando el proceso de actualización manual; los archivos de configuración se gestionan automáticamente durante la actualización mediante línea de comandos.
-
A diferencia de Windows, Linux VDA incluye un agente de actualización de versiones de VDA (VDA Upgrade Agent, VUA) integrado. Esto simplifica el proceso de actualización de versión, ya que el agente ya está presente. La versión de VDA Upgrade Agent está vinculada a la versión del VDA.
-
De forma predeterminada, VDA Upgrade Agent está inhabilitado. Para habilitar el agente, ejecute los comandos siguientes:
/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\UpdateServices\UpdateAgent" -t "REG_DWORD" -v "fEnabled" -d "0x00000001" --force systemctl start ctxvua.service <!--NeedCopy--> -
El servicio VDA Upgrade Agent (ctxvua) está inhabilitado de forma predeterminada. Puede usar systemctl para habilitar e iniciar este servicio.
-
Como práctica recomendada, se aconseja probar minuciosamente las actualizaciones de VDA antes de pasar a un entorno de producción.
-
A diferencia de Windows, las actualizaciones de versión de Linux VDA solo se admiten desde una ruta de archivo. Esto significa que no puede usar directamente las URL de Azure CDN ni otros repositorios en línea. Debe administrar los paquetes VDA usted mismo. Esto se aplica tanto a las actualizaciones de versiones principales como a las secundarias.
-
Omita la “Versión más reciente del VDA” y el “Estado de la actualización de versión” en el servicio de actualización de versiones de VDA. Para Linux solo es relevante el “Estado de la actualización de versión de VDA”.
-
La ruta de archivo del paquete VDA puede ser local en la máquina VDA o una ubicación compartida (por ejemplo, un recurso compartido de red montado en el VDA). El sistema no está diseñado para descargar el paquete automáticamente. Debe proporcionar el archivo del paquete completo.
-
Especifique la ruta en el formato UNC de Windows (que comienza con \\) para pasar la validación de ruta al usar Studio o Citrix DaaS Remote PowerShell SDK. Por ejemplo, /mnt/pkg\/<nombre-del-paquete> debe introducirse como \\mnt\pkg\<nombre-del-paquete>.
-
La distinción entre VDA de “servidor” y de “estación de trabajo” no se aplica a Linux. Puede usar cualquiera de las opciones en Studio o PowerShell sin que afecte a la actualización de versión.
-
No se admite pasar a una versión anterior de VDA.
Requisitos previos
- Plano de control: Citrix DaaS
-
Versión de VDA: 2503 o posterior
Nota: No
Recomendamos usar la última versión CR de VDA.
- Los VDA deben tener VDA Upgrade Agent instalado y el servicio debe estar ejecutándose.
- Tiene permisos para actualizar la versión de los VDA.
- La actualización de versión de VDA se configura con la opción CR o LTSR adecuada en Studio.
- Los VDA no están en uso. (Los usuarios deben cerrar sesión en ellos).
- Los VDA no están en modo de mantenimiento. (Un administrador puede poner un VDA en modo de mantenimiento. También se puede poner automáticamente en modo de mantenimiento si ha superado la cantidad máxima de intentos de registro permitida).
- Los VDA deben pertenecer a un grupo de entrega y estar registrados en DaaS.
- El VDA de destino admite el sistema operativo del VDA actual.
Actualizar VDA mediante Studio
Flujo de trabajo general de las tareas
He aquí un flujo de trabajo general para actualizar VDA mediante Studio:
-
Habilite la actualización de versión de VDA para un catálogo.
- Puede habilitar la actualización de versión de VDA al crear un catálogo.
- Puede habilitar la actualización de versión de VDA al modificar un catálogo.
-
Actualizar la versión de VDA por catálogo. Las actualizaciones de VDA por máquina no están disponibles actualmente. Para obtener más información, consulte Configurar la actualización automática de versiones de los VDA.
Nota: No
Al programar la actualización de versiones de VDA para un catálogo, se incluirán todas las máquinas del catálogo en el ámbito de la actualización. Por lo tanto, se recomienda hacer una copia de seguridad de esas máquinas antes de iniciar la actualización.
-
El proceso de actualización de versión de VDA no admite la actualización de componentes adicionales ni el uso de funciones como la restauración. Omita estos dos pasos.
-
Configure las opciones de programación, incluidos la hora de la actualización y el umbral de error. El umbral de error probablemente determina cuántas actualizaciones de versión fallidas se toleran antes de que se detenga el proceso o se desencadenen alertas.
-
Seleccione “Usar recurso compartido de archivos local” para la ubicación del instalador de VDA. Proporcione la ruta en el formato UNC de Windows (por ejemplo, \\servidor\recurso_compartido\ruta).
-
La opción “Forzar cierre de sesiones” controla cómo se manejan las sesiones de usuario durante las actualizaciones de versión de VDA. Si bien la interfaz de usuario de Studio solo permite cerrar sesiones desconectadas, PowerShell puede cerrar todas las sesiones (conectadas y desconectadas). El cierre de sesión no es inmediato. El servicio de actualización de versiones de VDA inicia el cierre de sesión después de que VDA Upgrade Agent intente consultar la programación de actualización y encuentre sesiones desconectadas. A continuación, el agente espera 15 minutos antes de intentar de nuevo la consulta.
Actualizar la versión de los VDA mediante PowerShell
Puede configurar actualizaciones de versión de VDA mediante Remote PowerShell SDK en Windows. Para obtener más información sobre Remote PowerShell SDK, consulte Citrix DaaS Remote PowerShell SDK.
Estos son los cmdlets de PowerShell:
-
Get-VusCatalog
Use este cmdlet para obtener detalles de un catálogo, como el nombre, Uid, Uuid, estado de actualización de versión (disponible, actualizado, programado, desconocido), actualización programada e ID de estado (estado de actualización programada).
-
Get-VusMachine
Use este cmdlet para obtener detalles de una máquina, como nombre de máquina, Uid, Uuid, estado de actualización de versión (disponible, actualizado, programado, desconocido) e ID de estado (estado de actualización programada).
-
Get-VusComponentVersion
Use este cmdlet para comprobar si los VDA han notificado las versiones de los componentes. Use el ID de máquina, MachineId, para filtrar los VDA. MachineId es el UUID de Get-BrokerMachine.
-
New-VusMachineUpgrade
Use este cmdlet para configurar la actualización de versiones de los VDA al nivel de máquina.
-
New-VusCatalogSchedule
Use este cmdlet para programar la actualización de versiones al nivel de catálogo de máquinas.
Ejemplo
Get-BrokerMachine -DNSName 'u22-test*'
New-VusCatalogSchedule -CatalogName "test-catalog" -UpgradeNow -DurationInHours 2 -LogoffOption ActiveAndDisconnectedSessions -VdaServerPackageUri "\\root\xendesktopvda_24.11.0.1-1.ubuntu22.04_amd64.deb"
Get-VusComponent -CatalogName 'test-catalog'
Get-VusCatalog -Name 'test-catalog'
<!--NeedCopy-->
Solución de problemas
El núcleo del proceso de actualización gira en torno al servicio VDA Upgrade Agent (ctxvua). Este actúa de intermediario, comunicándose con el servicio de actualización de versiones de VDA y ejecutando el script /opt/Citrix/VDA/sbin/update_helper.sh para las operaciones relacionadas con el sistema operativo. Durante la actualización, la información sobre el proceso se almacena en el Registro.
Registro
| Use el comando **/opt/Citrix/VDA/bin/ctxreg dump | grep -i UpdateAgent** para examinar los parámetros del Registro relacionados con VDA Upgrade Agent. Esto puede revelar problemas de configuración o problemas con el proceso de actualización de versión en sí. |
- Comprobar configuración: El archivo de configuración para el servicio ctxvua se encuentra en /etc/xdl/updateagent.conf. Revisar este archivo puede ayudar a identificar configuraciones incorrectas.
Registros
Los siguientes archivos de registro son cruciales para la resolución de problemas:
-
/var/log/xdl/vua.log: Archivo de registro para el servicio ctxvua. Este es el registro principal para comprobar problemas relacionados con el funcionamiento del agente de actualización de versión. El archivo de configuración del servicio ctxvua se encuentra en /etc/xdl/updateagent.conf. Revisar este archivo puede ayudar a identificar configuraciones incorrectas.
-
/var/log/xdl/update_helper.log: Archivo de registro para el script update_helper.sh. Este registro es esencial para diagnosticar problemas relacionados con las tareas a nivel del sistema operativo durante la actualización de versión.
Problemas comunes
En esta sección se tratan problemas comunes observados durante las actualizaciones de versión de VDA, centrándose específicamente en las opciones inhabilitadas en Studio y el estado “Actualización de versión desconocida”.
Problema común 1: Opciones de actualización de versión inhabilitadas
Síntoma: Las opciones para “Establecer el tipo de actualización de versión” y “Actualizar versión de VDA” están inhabilitadas (atenuadas) en Studio para un catálogo determinado.
Solución: Compruebe si el servicio de actualización de versiones de VDA es compatible con el tipo de catálogo que está usando. Si no es así, no podrá usar estas funciones de actualización automatizada y deberá administrar las actualizaciones manualmente.
Problema común 2: Estado “Actualización de versión desconocida”
Síntoma: Después de habilitar el servicio de actualización de versiones de VDA para un catálogo de máquinas, el “Estado de actualización de versión” permanece “Desconocido” en lugar de cambiar a “Disponible” o “Actualizado” como se esperaba. “Actualización desconocida” es un estado transitorio. Eventualmente debería cambiar a “Disponible” o “Actualizado”.
Pasos para solucionar problemas de “Actualización desconocida”:
-
Verifique que VDA Upgrade Agent esté notificando las versiones.
-
Paso 1a: Obtenga el UUID de la máquina:
Get-BrokerMachine -DNSName '<hostname>' <!--NeedCopy--> -
Paso 1b: Compruebe la versión del componente notificada por el agente:
Get-VusComponentVersion -MachineId "<UUID>" <!--NeedCopy-->Si el comando Get-VusComponentVersion devuelve un valor en blanco, significa que VDA Upgrade Agent no ha notificado su versión. Esto podría indicar que el VDA está “registrado de forma rígida” (compruebe los parámetros tanto del catálogo de máquinas como del grupo de entrega). También indica que es posible que VDA Upgrade Agent no esté instalado o ejecutándose en el VDA de destino.
-
-
Verifique la sincronización del servicio de actualización de versiones de VDA.
Paso 2a: Compruebe si VDA Upgrade Agent ha sincronizado la máquina con la base de datos del broker:
``` Get-VusEntityUnit -EntityUUID "" <!--NeedCopy--> ```Sustituya
""por el EntityUUID real si lo conoce, o ejecute sin él para obtener todo. Si observa que está en blanco, puede indicar que la máquina no se ha sincronizado con el servidor del servicio de actualización de versiones de VDA.Paso 2b: Si la máquina no se ha sincronizado, espere un tiempo para que el servicio de actualización de versiones de VDA se sincronice. A continuación, confirme que se haya configurado el “Tipo de actualización de versión”.