Actualizaciones de VDA (vista previa)

Introducción

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.

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 sobre las actualizaciones programadas 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, consulte Informe técnico: Servicio de actualización de VDA de Citrix. Allí encontrará una descripción general del servicio, información detallada sobre su funcionamiento y otros recursos útiles.

Consideraciones

• 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 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, ejecute 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. Puede usar systemctl para habilitar e iniciar este servicio.

• Como práctica recomendada, le aconsejamos que pruebe 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 puede usar directamente URL de Azure CDN u otros repositorios en línea. Debe administrar los paquetes de VDA usted mismo. Esto se aplica tanto a las actualizaciones de versiones principales como secundarias.

• Ignore “Latest VDA Version” y “Upgrade State” en el Servicio de actualización de VDA. Solo “VDA Upgrade State” es relevante para Linux.

• La ruta del archivo para el paquete 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. Debe proporcionar el archivo de paquete completo.

• Especifique la ruta en formato de ruta 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\/<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. Puede usar cualquiera de las opciones en Studio o PowerShell sin afectar la actualización.

• La degradación de VDA no es compatible.

Requisitos previos

• Plano de control: Citrix DaaS™

• Versión de VDA: 2503 o posterior

  Nota:

  Recomendamos usar el VDA CR más reciente.

• Los VDA deben tener instalado el Agente de actualización de VDA y el servicio debe estar en ejecución.
• Tiene 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:

1. Habilite la actualización de VDA para un catálogo.

   • Puede habilitar la actualización de VDA al crear un catálogo.
   • Puede habilitar la actualización de VDA al modificar un catálogo.

2. Actualice los 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 VDA.

   Nota:

   Al programar las 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.

3. El proceso de actualización de VDA no admite la actualización de componentes adicionales ni el uso de funciones como la restauración. Omita estos dos pasos.

4. Configure las opciones de programación, incluida la hora de actualización y el umbral de errores de actualización. El umbral de errores probablemente determina cuántas actualizaciones fallidas se toleran antes de que se detenga el proceso o se activen las alertas.

5. Seleccione “Usar recurso compartido de archivos local” para la ubicación del instalador de VDA. Proporcione la ruta en formato UNC de Windows (por ejemplo, \\server\share\path).

6. La opción “Forzar cierre de sesión de sesiones” 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 la sesión de las sesiones desconectadas, PowerShell puede cerrar la sesión de 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 actualización y encuentra sesiones desconectadas. Luego, el agente espera 15 minutos antes de volver a intentar la consulta.

Actualizar VDA con PowerShell

Puede configurar las actualizaciones de VDA mediante el SDK de PowerShell remoto en Windows. Para obtener más información sobre el SDK de PowerShell remoto, consulte Citrix DaaS Remote PowerShell SDK.

Estos son los cmdlets de PowerShell:

• Get-VusCatalog

  Utilice 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

  Utilice este cmdlet para obtener detalles de una máquina, como MachineName, Uid, Uuid, UpgradeState (Available, UpToDate, Scheduled, Unknown) y StateId (estado de Upgrade scheduled).

• Get-VusComponentVersion

  Utilice este cmdlet para comprobar si los VDA han informado de las versiones de los componentes. Utilice el MachineId para filtrar los VDA. MachineId es el UUID de Get-BrokerMachine.

• New-VusMachineUpgrade

  Utilice este cmdlet para configurar las actualizaciones de VDA a nivel de máquina.

• New-VusCatalogSchedule

  Utilice 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 VDA Upgrade Agent (ctxvua). Actúa como intermediario, comunicándose con el servicio VDA Upgrade Service 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

1. 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 que se debe consultar para detectar 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 del sistema operativo durante la actualización.

Problemas comunes

Esta sección aborda los problemas comunes encontrados durante las actualizaciones de VDA, centrándose específicamente en las opciones deshabilitadas en Studio y el estado “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 (en gris) en Studio para un catálogo determinado.

Solución: Compruebe si el servicio VDA Upgrade Service es compatible con el tipo de catálogo que está utilizando. Si no lo es, no podrá utilizar estas funciones de actualización automatizadas y deberá gestionar las actualizaciones manualmente.

Problema común 2: Estado “Actualización desconocida”

Síntoma: Después de habilitar el servicio VDA Upgrade Service 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. Eventualmente debería actualizarse a “Disponible” o “Actualizado”.

Pasos para la solución de problemas de “Actualización desconocida”:

1. verificar que el Agente de actualización de VDA está informando las versiones.

   • Paso 1a: Obtener el UUID de la máquina:

        Get-BrokerMachine -DNSName '<hostname>'
      <!--NeedCopy-->
     

   • Paso 1b: Comprobar 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 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” (compruebe 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.

2. verificar la sincronización del Servicio de actualización de VDA.

   Paso 2a: Comprobar si el Servicio de actualización de VDA ha sincronizado la máquina desde la base de datos del Broker:

   ```
   Get-VusEntityUnit -EntityUUID ""
   <!--NeedCopy--> ```
   

   Reemplace "" por el EntityUUID real si se conoce, o ejecútelo sin él para obtener todos. 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 VDA.

   Paso 2b: Si la máquina no se ha sincronizado, espere un tiempo para que el Servicio de actualización de VDA se sincronice. Luego, confirme que se haya establecido el “Tipo de actualización”.

Referencias

• Informe técnico: Servicio de actualización de VDA de Citrix
• Actualizar VDA