Actualizaciones de VDA (vista previa)
Introducción
-
Anteriormente, la actualización de VDA requería una intervención manual completa. La versión 2503 simplifica las actualizaciones de VDA para implementaciones de DaaS al introducir el Agente de actualización de VDA. Las actualizaciones a partir de la versión 2503 se pueden realizar directamente desde una ruta de archivo compartida o local.
-
El Agente de actualización de VDA ctxvua es responsable de comunicarse con el Servicio de actualización de VDA y de realizar las siguientes funciones:
- Comprobaciones programadas: El Agente de actualización de VDA consulta al Servicio de actualización de VDA para obtener información de actualización programada cada 15 minutos.
- Actualizaciones automatizadas: Al recibir las instrucciones de actualización, el Agente de actualización de VDA actualiza automáticamente el VDA.
- Informes de estado: El Agente de actualización de VDA informa del resultado de la actualización (éxito o fallo) al Servicio de actualización de VDA.
Para obtener más información sobre el servicio de actualización de VDA, consulta Tech Brief: Citrix VDA Upgrade service. Allí, puedes encontrar una descripción general del servicio, información detallada sobre cómo funciona y otros recursos útiles.
Consideraciones
-
Los VDA de Linux se actualizan mediante comandos de gestión de paquetes subyacentes (como rpm o apt), lo que refleja el proceso de actualización manual; los archivos de configuración se gestionan automáticamente durante la actualización por línea de comandos.
-
A diferencia de Windows, el VDA de Linux incluye un Agente de actualización de VDA integrado. Esto simplifica el proceso de actualización, ya que el agente ya está presente. La versión del Agente de actualización de VDA está vinculada a la versión del VDA.
-
De forma predeterminada, el Agente de actualización de VDA está inhabilitado. Para habilitar el agente, ejecuta los siguientes comandos:
- /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 del Agente de actualización de VDA (ctxvua) está inhabilitado de forma predeterminada. Puedes usar systemctl para habilitar e iniciar este servicio.
-
Como buena práctica, te recomendamos que pruebes las actualizaciones de VDA a fondo antes de pasar a producción.
-
A diferencia de Windows, las actualizaciones de VDA de Linux solo se admiten desde una ruta de archivo. Esto significa que no puedes usar directamente URL de Azure CDN u otros repositorios en línea. Debes gestionar los paquetes de VDA tú mismo. Esto se aplica tanto a las actualizaciones de versiones principales como secundarias.
-
Ignora “Latest VDA Version” y “Upgrade State” en el Servicio de actualización de VDA. Solo “VDA Upgrade State” es relevante para Linux.
-
La ruta de archivo para el paquete de VDA puede ser local a 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. Debes proporcionar el archivo de paquete completo.
-
Especifica la ruta en el formato de ruta UNC de Windows (que comienza con \\) para pasar la validación de la ruta al usar Studio o el SDK de PowerShell remoto de Citrix DaaS. Por ejemplo, /mnt/pkg\/<package-name> debe introducirse como \\mnt\pkg\<package-name>.
-
La distinción entre VDA de “servidor” y “estación de trabajo” no se aplica a Linux. Puedes usar cualquiera de las dos opciones en Studio o PowerShell sin afectar a la actualización.
-
No se admite la degradación de VDA.
Requisitos previos
- Plano de control: Citrix DaaS™
-
Versión de VDA: 2503 o posterior
Nota:
Te recomendamos usar el VDA CR más reciente.
- Los VDA deben tener el Agente de actualización de VDA instalado y el servicio debe estar en ejecución.
- Tienes permisos para actualizar VDA.
- La actualización de VDA está configurada con la pista 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 VDA puede ser puesto en modo de mantenimiento por un administrador. Un VDA también puede ser puesto automáticamente en modo de mantenimiento si ha excedido el número máximo de intentos de registro permitidos.)
- Los VDA deben pertenecer a un grupo de entrega y estar registrados en DaaS.
-
El VDA de destino es compatible con el sistema operativo del VDA actual.
-
Actualizar VDA con Studio
-
Flujo de trabajo general
Un flujo de trabajo general para actualizar VDA con Studio es el siguiente:
-
Habilita la actualización de VDA para un catálogo.
- Puedes habilitar la actualización de VDA al crear un catálogo.
- Puedes habilitar la actualización de VDA al modificar un catálogo.
-
Actualiza los VDA por catálogo. Las actualizaciones de VDA por máquina no están disponibles actualmente. Para obtener más información, consulta Configurar la actualización automática de VDA.
Nota:
Al programar actualizaciones de VDA para un catálogo, todas las máquinas del catálogo se incluyen en el ámbito de la actualización. Por lo tanto, te recomendamos hacer una copia de seguridad de esas máquinas antes de iniciar la actualización.
-
El proceso de actualización de VDA no admite la actualización de componentes adicionales ni el uso de funciones como la restauración. Omite estos dos pasos.
-
- Configura las opciones de programación, incluida la hora de actualización y el umbral de fallos de actualización. El umbral de fallos probablemente determina cuántas actualizaciones fallidas se toleran antes de que el proceso se detenga o se activen las alertas.
-
Selecciona “Use local file share” para la ubicación del instalador de VDA. Proporciona la ruta en formato UNC de Windows (por ejemplo, \\server\share\path).
-
La opción “Force logoff sessions” controla cómo se gestionan las sesiones de usuario durante las actualizaciones 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 VDA inicia el cierre de sesión después de que el Agente de actualización de VDA intenta consultar la programación de la actualización y encuentra sesiones desconectadas. Luego, el agente espera 15 minutos antes de volver a intentar la consulta.
Actualizar VDA con PowerShell
Puedes configurar las actualizaciones de VDA con el SDK de PowerShell remoto en Windows. Para obtener más información sobre el SDK de PowerShell remoto, consulta Citrix DaaS Remote PowerShell SDK.
- Los siguientes son los cmdlets de PowerShell:
- Get-VusCatalog
- Usa este cmdlet para obtener detalles de un catálogo como **Name**, **Uid**, **Uuid**, **UpgradeState** (**Available**, **UpToDate**, **Scheduled**, **Unknown**), **Upgrade scheduled** y **StateId** (estado de **Upgrade scheduled**).
-
Get-VusMachine
Usa este cmdlet para obtener los detalles de una máquina, como MachineName, Uid, Uuid, UpgradeState (Disponible, Actualizado, Programado, Desconocido) y StateId (estado de Actualización programada).
-
Get-VusComponentVersion
Usa este cmdlet para comprobar si los VDA han informado de las versiones de los componentes. Usa el MachineId para filtrar los VDA. El MachineId es el UUID de Get-BrokerMachine.
-
New-VusMachineUpgrade
Usa este cmdlet para configurar las actualizaciones de VDA a nivel de máquina.
-
New-VusCatalogSchedule
Usa este cmdlet para programar las actualizaciones de VDA a 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 del Agente de actualización de VDA (ctxvua). Actúa como intermediario, comunicándose con el Servicio de actualización de VDA y ejecutando el script /opt/Citrix/VDA/sbin/update_helper.sh para operaciones relacionadas con el sistema operativo. Durante la actualización, la información sobre el proceso se almacena en el registro.
Registro
| Usa el comando **/opt/Citrix/VDA/bin/ctxreg dump | grep -i UpdateAgent** para examinar la configuración del registro relacionada con el Agente de actualización de VDA. Esto puede revelar problemas de configuración o problemas con el propio proceso de actualización. |
- Comprobar la configuración: El archivo de configuración del servicio ctxvua se encuentra en /etc/xdl/updateagent.conf. Revisar este archivo puede ayudar a identificar configuraciones erróneas.
Registros
Los siguientes archivos de registro son cruciales para la solución de problemas:
-
/var/log/xdl/vua.log: Archivo de registro del servicio ctxvua. Este es el registro principal para comprobar si hay problemas relacionados con el funcionamiento del agente de actualización. El archivo de configuración del servicio ctxvua se encuentra en /etc/xdl/updateagent.conf. Revisar este archivo puede ayudar a identificar configuraciones erróneas.
-
/var/log/xdl/update_helper.log: Archivo de registro del script update_helper.sh. Este registro es esencial para diagnosticar problemas relacionados con las tareas a nivel de sistema operativo durante la actualización.
Problemas comunes
Esta sección aborda los problemas comunes que se encuentran durante las actualizaciones de VDA, centrándose específicamente en las opciones deshabilitadas en Studio y el estado de “Actualización desconocida”.
Problema común 1: Opciones de actualización deshabilitadas
Síntoma: Las opciones “Establecer tipo de actualización” y “Actualizar VDA” están deshabilitadas (atenuadas) en Studio para un catálogo determinado.
Solución: Comprueba si el Servicio de actualización de VDA es compatible con el tipo de catálogo que estás usando. Si no lo es, no podrás usar estas funciones de actualización automatizadas y deberás gestionar las actualizaciones manualmente.
Problema común 2: Estado de “Actualización desconocida”
Síntoma: Después de habilitar el Servicio de actualización de VDA para un catálogo de máquinas, el “Estado de actualización” permanece como “Desconocido” en lugar de cambiar a “Disponible” o “Actualizado” como se esperaba. “Actualización desconocida” es un estado transitorio. Finalmente, debería actualizarse a “Disponible” o “Actualizado”.
Pasos para solucionar el problema de “Actualización desconocida”:
-
Verifica que el Agente de actualización de VDA esté informando las versiones.
-
Paso 1a: Obtén el UUID de la máquina:
Get-BrokerMachine -DNSName '<hostname>' <!--NeedCopy--> -
Paso 1b: Comprueba la versión del componente informada por el agente:
Get-VusComponentVersion -MachineId "<UUID>" <!--NeedCopy-->Si el comando Get-VusComponentVersion devuelve un valor en blanco, significa que el Agente de actualización de VDA no ha informado su versión. Esto podría indicar que el VDA está “registrado de forma permanente” (comprueba la configuración del catálogo de máquinas y del grupo de entrega). También indica que el Agente de actualización de VDA podría no estar instalado o en ejecución en el VDA de destino.
-
-
Verifica la sincronización del Servicio de actualización de VDA.
Paso 2a: Comprueba si el Servicio de actualización de VDA ha sincronizado la máquina desde la base de datos del Broker:
``` Get-VusEntityUnit -EntityUUID "" <!--NeedCopy--> ```Reemplaza
""con el EntityUUID real si lo conoces, o ejecútalo sin él para obtener todos. Si observas que está en blanco, puede indicar que la máquina no se ha sincronizado con el servidor del Servicio de actualización de VDA.Paso 2b: Si la máquina no se ha sincronizado, espera un tiempo para que el Servicio de actualización de VDA se sincronice. Luego, confirma que el “Tipo de actualización” se haya establecido.