Supervisión y solución de problemas
Supervisión de actualizaciones de versión 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 versión de VDA que son visibles como columnas para filtrar en Studio o en el panel de detalles de los VDA o catálogos.
- Actualización de versión de VDA
- Estado de la actualización de versión de VDA
Actualización de versión de VDA
La actualización de versión de VDA proporciona información sobre si el VDA o el catálogo de máquinas tienen configurado el agente de actualización de versiones de VDA y si los VDA están actualizados o si hay una actualización disponible. Los estados disponibles son los siguientes:
| Actualización de versión de VDA (Studio) | Actualización de versión de VDA (PowerShell) | Descripción |
|---|---|---|
| Nivel de catálogo | ||
| No configurado | MissingUpgradeType | No se ha seleccionado una opción de actualización (CR, LTSR, CR EAR o LTSR EAR) para el catálogo de máquinas. |
| Programado | UpgradeScheduled | Está prevista una actualización de versión para el catálogo de máquinas. |
| Disponible | UpgradeAvailable | Los VDA en el catálogo no tienen la versión más reciente de la opción de actualización elegida. Se recomienda actualizar la versión. |
| Actualizado | UpToDate | Los VDA del catálogo tienen la versión más reciente de la opción de actualización elegida. No se requiere ninguna acción. |
| Desconocido | Desconocido | Obteniendo el estado de actualización de versión de VDA más reciente. |
| Nivel de máquina | ||
| No configurado | MissingUpgradeType | No se ha seleccionado una opción de actualización (CR, LTSR, CR EAR o LTSR EAR) para el catálogo de máquinas del VDA. |
| Programado | UpgradeScheduled | Está prevista una actualización de versión del VDA. |
| Disponible | UpgradeAvailable | El VDA no tiene la versión más reciente de la opción de actualización elegida. Se recomienda actualizar la versión. |
| Actualizado | UpToDate | El VDA tiene la versión más reciente de la opción de actualización elegida. No se requiere ninguna acción. |
| Comprobando estado | Desconocido | Obteniendo el estado de actualización de versión de VDA más reciente. |
Nota: No
Para los VDA que usan la opción LTSR, un catálogo solo se mostrará como Actualizado si los VDA tienen la actualización acumulativa (CU) más reciente de la versión Long Term Service Release (LTSR) más reciente. Si el VDA tiene la actualización CU más reciente de una versión LTSR anterior, la actualización de versión de VDA seguirá apareciendo como Disponible.
Estado de la actualización de versión de VDA
El estado de la actualización de versión de VDA proporciona información sobre el estado de una actualización programada. Los estados de actualización de versión de VDA son los siguientes:
| Estado de actualización de versión de VDA (Studio) | Estado de actualización de versión de VDA (PowerShell) | Descripción |
|---|---|---|
| Nivel de catálogo | ||
| Sin programar | NotScheduled | No está prevista ninguna actualización de versión para el catálogo. |
| Programado | UpgradeScheduled | Está prevista una actualización de versión para el catálogo. |
| En curso | UpgradeInProgress | Hay una actualización de versión del catálogo en curso. |
| Cancelado | UpgradeCancelled | Se canceló una actualización de versión para el catálogo. Puede deberse a una cancelación manual o a que se alcanzó el umbral de fallo. |
| Error | UpgradeFailed | Falló una actualización de versión programada para el catálogo. |
| Correcto | UpgradeSuccessful | Se completó correctamente una actualización de versión programada para el catálogo. Nota: Una actualización correcta no significa que todos los VDA del catálogo se hayan actualizado correctamente. |
| - | Vacío | No hay ninguna programación de actualización prevista para el catálogo. |
| Nivel de máquina | ||
| Programado | UpgradeScheduled | Está prevista una actualización de versión del VDA. |
| Esperando actualización | UpgradeInUpgradeWindow | Hay una actualización de versió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 actualización de versión de VDA. |
| En curso | UpgradeInProgress | El VDA se está actualizando actualmente. |
| Cancelado | UpgradeCancelled | Se canceló una actualización de versión programada para el VDA antes de que comenzara. |
| Actualización fallida | UpgradeFailed | El VDA comenzó a actualizarse pero el proceso no se completó correctamente. Para obtener más información, consulte “Solución de problemas”. |
| Correcto | UpgradeSuccess | La versión de 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 de versión prevista para el VDA. |
Solución de problemas de actualizaciones de versión de VDA programadas
Si observa errores de actualización, los siguientes registros pueden ayudarle a identificar y solucionar los problemas. También puede compartir estos registros con la asistencia técnica de Citrix para agilizar el proceso de asistencia.
Registros de instalación de VDA
Al solucionar problemas con la actualización de versió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 de versión se pueden encontrar en las siguientes ubicaciones.
- Los registros de la instalación de VDA se colocan en:
- %temp%/Citrix/XenDesktop Installer
- Los registros de actualización de versión de VDA se colocan en:
- C:\Windows\Temp\Citrix\XenDesktop Installer
Versión de VDA Upgrade Agent
Al recopilar datos para solucionar errores de actualización a través de VUS, es importante conocer la versión de VDA Upgrade Agent en los VDA. Para comprobar las versiones del agente de actualización de versiones de VDA, use el siguiente cmdlet: Get-VusComponentVersion -ComponentType VUS. Muestra todos los VDA y sus versiones del agente de actualización de versiones de VDA.
Para comprobar las versiones del agente de actualización de versiones de VDA a nivel de catálogo, puede utilizar el siguiente script:
Nota: No
El script sirve de ejemplo y es posible que necesite adaptarlo a su entorno específico. Se recomienda probar exhaustivamente el script antes de usarlo 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 versiones de VDA
Los registros de VDA Upgrade Agent (VUA) pueden proporcionar información esencial para solucionar problemas de actualización y con la comunicación de VUA con el servicio de actualización de versiones de VDA. Los registros que puede recopilar incluyen:
- Rastreos de Citrix Diagnostic Facility (CDF). El nombre del módulo CDF es VdaUpgradeAgent.
- Registros de eventos de Windows. Consulte los registros en el Visor de eventos > Registros de Windows > Aplicaciones > Citrix VDA Upgrade Agent Service.
Para las versiones de VUA 7.44 y posteriores
En la versión 7.44 de VDA Upgrade Agent Service (incluida en la versión 2503), hay disponible un parámetro de Registro que permite a los administradores habilitar un archivo de registro rotativo, el cual captura información crítica para la resolución de problemas y, al mismo tiempo, evita que los archivos de registros crezcan demasiado. El tamaño total de los archivos de registros está limitado a 20 MB. Cree la siguiente clave de Registro para habilitar la captura de registros en un archivo:
-
Clave:
HKLM\SOFTWARE\Citrix\UpdateServices\UpdateAgent\LogToFile -
Nombre del valor:
LogToFile -
Tipo de valor:
REG_DWORD -
Información del valor:
-
0: Seguimiento de archivos inhabilitado -
1: Seguimiento de archivos habilitado
-
Para crear la clave de Registro LogToFile en un VDA mediante PowerShell, use el siguiente cmdlet:
New-ItemProperty -Path HKLM\SOFTWARE\Citrix\UpdateServices\UpdateAgent\LogToFile -Name LogToFile -Value 1 -PropertyType DWord -Force
Para habilitar LogToFile a gran escala en grupos de máquinas, considere la posibilidad de crear LogToFile en todas las unidades organizativas (OU) de los VDA mediante Preferencias de directivas de grupo.
Nota: No
Cuando se establece
LogToFile=1, los registros se escriben solo en el archivo. No aparecerán en los rastros de CDF.
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 versiones de VDA para que los registros se escriban continuamente en un archivo. Para habilitar la captura de registros en un archivo, siga estos pasos:
- Vaya a la carpeta
C:\Archivos de programa\Citrix\CitrixUpgradeAgent. - Abra el archivo
Citrix.UpdateServices.UpdateAgent.exe.config. - Cambie el valor de
LogToFilea1. - Reinicie Citrix VDA Upgrade Agent Service. Se crea un archivo de registros en:
C:\ProgramData\Citrix\Update Services\Logs.
Nota: No
- Habilitar la captura de registros en un archivo a través del archivo .config escribe registros continuamente, lo que potencialmente consume espacio de almacenamiento. Recuerde inhabilitar la captura de registros una vez que se haya resuelto el problema. Para inhabilitar el registro, primero establezca
LogToFileen0y, a continuación, reinicie Citrix VDA Upgrade Agent Service.- Cuando se establece
LogToFile=1, los registros se escriben solo en el archivo. No aparecerán en los rastros de CDF.
Solucionar errores de descarga en la actualización de versiones de VDA
Siga los pasos que se indican a continuación para solucionar problemas y errores de descarga relacionados con la función de actualización de versiones de VDA:
-
Asegúrese de que se hayan agregado las URL relevantes a la lista de permitidos si se ha implementado el filtrado de URL. Consulte el requisito de actualización de versión de VDA.
-
Tras agregar las URL necesarias a la lista de permitidos, pruebe a reprogramar la actualización de versiones de VDA.
Puede habilitar el rastreo de CDF o configurar LogToFile en 1 con el objetivo de capturar registros detallados para su análisis. Si el problema del error de descarga persiste, compruebe los errores. Si aparece el siguiente mensaje de error “Error en la 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 en la carpeta C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA son incorrectos.
Para solucionar el problema, realice una de estas acciones:
-
Opción 1: Restablezca las listas de control de acceso (ACL) en la carpeta usando 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 de versión de VDA.
Solucionar errores de validación en la actualización de versiones de VDA
Siga los pasos que se indican a continuación para solucionar problemas y errores de descarga relacionados con la función de actualización de versiones de VDA:
-
Asegúrese de agregar las URL pertinentes a la lista de permitidos si existe el filtrado de URL, 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 comprobar la revocación. Consulte el requisito de actualización de versión de VDA.
-
Tras agregar las URL necesarias a la lista de permitidos, pruebe a reprogramar la actualización de versiones de VDA.
Sugerimos habilitar el rastreo de CDF o configurar LogToFile en 1 con el objetivo de capturar registros detallados para su análisis. Los registros pueden incluir estos 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 desconectado.
El agente de actualización de versiones de VDA recurre a las llamadas del sistema de Windows para validar certificados y comprobar revocaciones. Los errores anteriores indican que el agente no puede establecer una conexión con las URL de CRL u OCSP.
Actualmente, la herramienta CryptoAPI de Windows no admite parámetros de proxy. Revise la sección VDA con configuraciones de proxy para configurar sus proxies de VDA para facilitar las llamadas CRL salientes.