Supervisión y solución de problemas
Supervisión de las actualizaciones de VDA programadas
Los VDA y los catálogos de máquinas tienen dos atributos para ayudar a supervisar la preparación y el estado actual de las actualizaciones de VDA, que son visibles como columnas que se pueden usar para filtrar en Studio o en el panel de detalles de los VDA o catálogos.
- Actualización de VDA
- Estado de actualización de VDA
Actualización de VDA
Actualización de VDA proporciona información sobre si el VDA o el catálogo de máquinas tiene el agente de actualización de VDA configurado y si los VDA están actualizados o si hay una actualización disponible. Los estados disponibles son los siguientes:
| Actualización de VDA (Studio) | Actualización de VDA (Powershell) | Descripción |
|---|---|---|
| Nivel de catálogo | ||
| No configurado | MissingUpgradeType | No se ha seleccionado una ruta de actualización (CR, LTSR, CR EAR o LTSR EAR) para el catálogo de máquinas. |
| Programado | ActualizaciónProgramada | Hay una actualización programada para el catálogo de máquinas. |
| Disponible | ActualizaciónDisponible | Los VDA del catálogo no están en la versión más reciente de la pista de actualización. Se recomienda una actualización. |
| Actualizado | Actualizado | Los VDA del catálogo están en la versión más reciente de la pista de actualización. No se requiere ninguna acción. |
| Desconocido | Desconocido | Recuperando el estado más reciente de la actualización del VDA. |
| Nivel de máquina | ||
| No configurado | TipoDeActualizaciónFaltante | No se ha seleccionado una pista de actualización (CR, LTSR, CR EAR o LTSR EAR) para el catálogo de máquinas del VDA. |
| Programado | ActualizaciónProgramada | Hay una actualización programada para el VDA. |
| Disponible | ActualizaciónDisponible | El VDA no está en la última versión de la pista de actualización. Se recomienda una actualización. |
| Actualizado | Actualizado | El VDA está en la última versión de la pista de actualización. No se requiere ninguna acción. |
| Comprobando estado | Desconocido | Recuperando el estado más reciente de la actualización del VDA. |
Nota:
Para los VDA que utilizan la pista LTSR, un catálogo solo se mostrará como Actualizado si los VDA están en la última actualización acumulativa (CU) de la última versión de servicio a largo plazo (LTSR). Si el VDA está en la última CU de una versión LTSR anterior, la actualización del VDA seguirá mostrándose como Disponible.
Estado de la actualización del VDA
El estado de actualización de VDA proporciona información sobre el estado de una actualización programada. Los estados de actualización de VDA son los siguientes:
| Estado de actualización de VDA (Studio) | Estado de actualización de VDA (PowerShell) | Descripción |
|---|---|---|
| Nivel de catálogo | ||
| No programada | NotScheduled | No hay ninguna actualización programada para el catálogo. |
| Programada | UpgradeScheduled | Hay una actualización programada para el catálogo. |
| En curso | UpgradeInProgress | Hay una actualización en curso para el catálogo. |
| Cancelada | Actualización cancelada | Se canceló una actualización para el catálogo. Esto puede deberse a una cancelación manual o a que se alcanzó el umbral de error. |
| Fallido | Actualización fallida | Falló una actualización programada para el catálogo. |
| Correcto | Actualización correcta | Una actualización programada para el catálogo se completó correctamente. Nota: Una actualización correcta no significa que todos los VDA del catálogo se hayan actualizado correctamente. |
| - | Vacío | No hay ninguna actualización programada para el catálogo. |
| Nivel de máquina | ||
| Programado | Actualización programada | Hay una actualización programada para el VDA. |
| Esperando actualización | UpgradeInUpgradeWindow | Hay una actualización programada activa, pero el VDA aún no ha comenzado a actualizarse. Consulte «Simultaneidad» para obtener más información sobre cómo se equilibran las cargas de las actualizaciones de VDA. |
| En curso | UpgradeInProgress | El VDA se está actualizando actualmente. |
| Cancelado | UpgradeCancelled | Se ha cancelado una actualización programada para el VDA antes de que comenzara la actualización. |
| Error de actualización | UpgradeFailed | El VDA comenzó a actualizarse, pero la actualización no se completó correctamente. Consulte «solución de problemas» para obtener más información. |
| Correcto | UpgradeSuccess | El VDA se actualizó correctamente. |
| Validación fallida | UpgradeValidationFailed | La validación del certificado falló al descargar los metadatos para el instalador de VDA. |
| - | Vacío | No hay ninguna actualización programada para el VDA. |
Solución de problemas de actualizaciones programadas de VDA
Si encuentra errores de actualización, los siguientes registros pueden ayudarle a identificar y solucionar los problemas. También puede compartir estos registros con el Soporte técnico de Citrix para agilizar el proceso de asistencia.
Registros de instalación de VDA
Al solucionar problemas de errores de actualización, recopile y revise los registros tanto de la instalación inicial del VDA como de la actualización fallida. Los registros de instalación y actualización se pueden encontrar en las siguientes ubicaciones.
- Los registros de instalación para las instalaciones de VDA se encuentran en:
- %temp%/Citrix/XenDesktop Installer
- Los registros de actualización para las instalaciones de VDA se encuentran en:
- C:\Windows\Temp\Citrix\XenDesktop Installer o
- C:\Windows\SystemTemp\Citrix\XenDesktop Installer
Versión del agente de actualización de VDA
Al recopilar datos para solucionar problemas de errores de actualización a través de VUS, es importante conocer la versión del agente de actualización en los VDA. Para comprobar las versiones del agente de actualización de VDA, utilice el siguiente cmdlet: Get-VusComponentVersion -ComponentType VUS. Enumera todos los VDA y sus versiones del agente de actualización de VDA.
Para comprobar las versiones del agente de actualización de VDA a nivel de catálogo, puede utilizar el siguiente script:
Nota:
El script se presenta como un ejemplo y podría necesitar adaptarse a su entorno específico. Le recomendamos que pruebe el script a fondo antes de utilizarlo en un entorno de producción.
Param( [Parameter (Mandatory=$true)][string] $CatalogName )try { $Uuids = Get-BrokerMachine -CatalogName $CatalogName | Select-Object -Property UUID
if($Uuids -eq $null){throw "Cannot find CatalogName " +$CatalogName}Write-Output("Catalog Name passed is "+$CatalogName)
foreach($Uuid in $Uuids) { $compVersion = Get-VusComponentVersion -MachineId $machine.UUID -ComponentType VUS $Machine = Get-BrokerMachine -UUID $compVersion.MachineId Write-Output(“MachineName: “+$Machine.MachineName+”, Machine UUID:”+$machine.MachineId+”, VUA Version:”+$compVersion.Version) } } catch { Write-Output(“Exception Occured”) Write-Host $_ }
Registros relacionados con el agente de actualización de VDA
Los registros del agente de actualización de VDA (VUA) pueden proporcionar información esencial para solucionar problemas de errores de actualización y problemas de comunicación del VUA con el servicio de actualización de VDA. Los registros que puede recopilar incluyen:
- Rastros de Citrix Diagnostic Facility (CDF). El nombre del módulo CDF es VdaUpgradeAgent.
- Registros de eventos de Windows. Vea los registros en el Visor de eventos > Registros de Windows > Aplicaciones > Servicio de agente de actualización de VDA de Citrix.
Para versiones de VUA 7.44 y posteriores
En la versión 7.44 del agente del servicio de actualización de VDA (incluida en la versión 2503), hay una configuración de registro disponible que permite a los administradores habilitar un archivo de registro rotatorio que captura información crítica para la solución de problemas, al tiempo que evita que los archivos de registro crezcan demasiado. El tamaño total de los archivos de registro está limitado a 20 MB. Cree la siguiente clave de registro para habilitar el registro en un archivo:
-
Clave:
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent -Name LogToFile -Value 1 -PropertyType DWord -Force -
Nombre del valor:
LogToFile -
Tipo de valor:
REG_DWORD -
Datos del valor:
-
0- rastreo de archivos deshabilitado -
1- rastreo de archivos habilitado
-
Para crear la clave de registro LogToFile en un VDA mediante PowerShell, utilice el siguiente cmdlet:
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent -Name LogToFile -Value 1 -PropertyType DWord -Force
Para habilitar LogToFile para grupos de máquinas a escala, considere crear el registro LogToFile en todas las unidades organizativas (OU) de VDA a través de la preferencia de directiva de grupo.
Nota:
- Cuando se establece
LogToFile=1, los registros se escriben solo en el archivo. No aparecerán en los rastreos CDF.- Es necesario reiniciar el servicio del Agente de actualización de VDA para que el cambio en el registro surta efecto.
- El archivo de registro se crea en la carpeta C:\ProgramData\Citrix\Update Services\Logs
Para versiones de VUA anteriores a la 7.43
Si es necesario, puede modificar el archivo de configuración del Agente de actualización de VDA para que los registros se escriban continuamente en un archivo. Para habilitar el registro en un archivo, siga estos pasos:
- Vaya a la carpeta
C:\Program Files\Citrix\CitrixUpgradeAgent. - Abra el archivo
Citrix.UpdateServices.UpdateAgent.exe.config. - Cambie el valor de
LogToFilea1. - Reinicie el servicio Citrix VDA Upgrade Agent. Esto crea un archivo de registro en:
C:\ProgramData\Citrix\Update Services\Logs.
Nota:
- Habilitar el registro en un archivo a través del archivo .config escribe registros continuamente, lo que podría consumir espacio de almacenamiento. Recuerde deshabilitar el registro una vez resuelto el problema. Para deshabilitar el registro, primero establezca
LogToFileen0y luego reinicie el servicio Citrix VDA Upgrade Agent.- Cuando
LogToFile=1está establecido, los registros se escriben solo en el archivo. No aparecerán en los seguimientos de CDF.
Solucionar problemas de errores de descarga de la actualización de VDA
Siga los pasos que se indican a continuación para solucionar y resolver los errores de descarga relacionados con la función de actualización de VDA:
-
Asegúrese de que las URL relevantes se hayan añadido a la lista de permitidos si el filtrado de URL está activado. Consulte Requisito de actualización de VDA.
-
Después de añadir las URL necesarias a la lista de permitidos, intente reprogramar la actualización de VDA.
Puede habilitar el seguimiento de CDF o establecer LogToFile en 1 para capturar registros detallados para su análisis. Si el problema de error de descarga persiste, compruebe los errores. Si ve el siguiente mensaje de error “Error de descarga: Esta lista de control de acceso no está en formato canónico y, por lo tanto, no se puede modificar”, indica que los permisos de la carpeta C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA son incorrectos.
Para solucionar el problema, realice una de las siguientes acciones:
-
Opción 1: Restablezca las listas de control de acceso (ACL) en la carpeta mediante el siguiente comando. (El comando restablece las ACL con las ACL heredadas predeterminadas para todos los archivos coincidentes.)
- icacls.exe “C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA” /reset /T /C /L /Q
- Opción 2: Elimine la carpeta VDA en Descargas y, a continuación, programe la actualización del VDA.
Solucionar problemas de errores de validación de la actualización del VDA
Siga los pasos que se indican a continuación para solucionar y resolver los errores de descarga relacionados con la función de actualización del VDA:
-
Asegúrese de que las URL relevantes se hayan agregado a la lista de permitidos si el filtrado de URL está habilitado, especialmente las URL de la lista de revocación de certificados (CRL) o del protocolo de estado de certificados en línea (OCSP) necesarias para la comprobación de revocación. Consulte Requisito de actualización del VDA.
-
Después de agregar las URL necesarias a la lista de permitidos, intente reprogramar la actualización del VDA.
Sugerimos habilitar el rastreo de CDF o establecer LogToFile en 1 para capturar registros detallados para su análisis. Los registros pueden incluir los siguientes errores:
- RevocationStatusUnknown
- La función de revocación no pudo comprobar el estado de revocación del certificado.
- La función de revocación no pudo comprobar la revocación porque el servidor de revocación estaba sin conexión.
El agente de actualización del VDA se basa en llamadas al sistema de Windows para validar certificados y realizar comprobaciones de revocación. Los errores anteriores indican que el agente no puede establecer una conexión con las URL de CRL u OCSP.
La CryptoAPI de Windows no admite actualmente la configuración de proxy. Revise la sección VDA con configuraciones de proxy para configurar sus proxies de VDA y facilitar las llamadas CRL salientes.