Actualizaciones de VDA (vista previa)
Introducción
Note: This is a note. This is a test line with multiple highlights.
-
<mark>Anteriormente, la actualización de los VDA requería una intervención manual completa. La versión 2503 simplifica las actualizaciones de VDA para las 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.</mark> -
<mark>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:</mark> -
<mark>Comprobaciones programadas</mark>:<mark>El Agente de actualización de VDA consulta el Servicio de actualización de VDA para obtener información sobre las actualizaciones programadas cada 15 minutos.</mark> -
<mark>Actualizaciones automatizadas</mark>:<mark>Al recibir las instrucciones de actualización, el Agente de actualización de VDA actualiza automáticamente el VDA.</mark> -
<mark>Informes de estado</mark>:<mark>El Agente de actualización de VDA informa del resultado de la actualización (éxito o fallo) al Servicio de actualización de VDA.</mark>
<mark>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.</mark>
<mark>Consideraciones</mark>
-
<mark>Los VDA de Linux se actualizan mediante comandos de administració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 de la línea de comandos.</mark> -
<mark>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.</mark> -
<mark>De forma predeterminada, el Agente de actualización de VDA está inhabilitado. Para habilitar el agente, ejecuta los siguientes comandos:</mark>- /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--> -
<mark>El servicio del Agente de actualización de VDA (ctxvua) está inhabilitado de forma predeterminada. Puedes usar systemctl para habilitar e iniciar este servicio.</mark> -
<mark>Como práctica recomendada, te recomendamos que pruebes las actualizaciones de VDA a fondo antes de pasar a producción.</mark>The quick brown fox. -
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 administrar 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.
-
<mark>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.</mark> -
<mark>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 Citrix DaaS Remote PowerShell SDK. Por ejemplo, **/mnt/pkg\<nombre-de-paquete\\>** debe introducirse como **\\\\mnt\\pkg\\\\<nombre-de-paquete\\>**.</mark> -
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 que ello afecte a la actualización.
- No se admite la degradación de VDA. The quick brown fox jumps over the lazy dog.
<mark>Requisitos previos</mark>
This is a test.
-
<mark>Plano de control: Citrix DaaS™</mark> -
<mark>Versión de VDA: 2503 o posterior</mark><mark>Nota:</mark><mark>Recomendamos usar el VDA CR más reciente.</mark> -
<mark>Los VDA deben tener instalado el Agente de actualización de VDA y el servicio debe estar en ejecución.</mark> -
<mark>Tienes permisos para actualizar VDA.</mark> -
<mark>La actualización de VDA está configurada con la pista CR o LTSR adecuada en Studio.</mark>-
<mark>Los VDA no están en uso. (Los usuarios deben cerrar sesión en ellos).</mark> -
<mark>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).</mark>
-
-
<mark>Los VDA deben pertenecer a un grupo de entrega y estar registrados en DaaS.</mark> -
<mark>El VDA de destino es compatible con el sistema operativo del VDA actual.</mark> -
<mark>Actualizar VDA con Studio</mark> -
<mark>Flujo de trabajo general</mark>
<mark>Un flujo de trabajo general para actualizar VDA con Studio es el siguiente:</mark>
-
<mark>Habilita la actualización de VDA para un catálogo.</mark>-
<mark>Puedes habilitar la actualización de VDA al crear un catálogo.</mark> -
<mark>Puedes habilitar la actualización de VDA al modificar un catálogo.</mark>
-
-
<mark>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.</mark><mark>Nota:</mark><mark>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, recomendamos hacer una copia de seguridad de esas máquinas antes de iniciar la actualización.</mark> -
<mark>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.</mark>
-
-
<mark>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.</mark>
-
-
<mark>Selecciona “Usar recurso compartido de archivos local” para la ubicación del instalador de VDA. Proporciona la ruta en formato UNC de Windows (por ejemplo, \\server\share\path).</mark> -
<mark>La opción “Forzar cierre de sesión” 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 intente consultar la programación de la actualización y encuentre sesiones desconectadas. Luego, el agente espera 15 minutos antes de volver a intentar la consulta.</mark>
<mark>Actualizar VDA con PowerShell</mark>
<mark>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.</mark>
- `<mark>`Los siguientes son los cmdlets de PowerShell:`</mark>`
- `<mark>`Get-VusCatalog`</mark>`
- `<mark>`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**).`</mark>`
-
<mark>Get-VusMachine</mark>Usa este cmdlet para obtener 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. |
- Comprueba 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 incorrectas.
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 los 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 incorrectas.
-
/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 “Desconocido” en lugar de cambiar a “Disponible” o “Actualizado” como se esperaba. “Actualización desconocida” es un estado transitorio. Eventualmente debería actualizarse a “Disponible” o “Actualizado”.
Pasos para solucionar problemas 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 de su versión. Esto podría indicar que el VDA está “registrado de forma fija” (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
""por 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, dale un tiempo al Servicio de actualización de VDA para que se sincronice. Luego, confirma que se ha establecido el “Tipo de actualización”.