Documentation produit
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Voir PDF

Surveillance et dépannage

April 8, 2026
Contributeur: 
C C

Surveillance des mises à niveau planifiées des VDA

  • Les VDA et les catalogues de machines possèdent deux attributs qui permettent de surveiller l’état de préparation et le statut actuel des mises à niveau de VDA. Ces attributs sont visibles sous forme de colonnes pouvant être utilisées pour filtrer dans Studio ou dans le volet des détails des VDA ou des catalogues.

  • Mise à niveau VDA
  • État de la mise à niveau VDA

Mise à niveau VDA

La Mise à niveau VDA fournit des informations sur la configuration de l’agent de mise à niveau VDA pour le VDA ou le catalogue de machines, et indique si les VDA sont à jour ou si une mise à niveau est disponible. Les statuts disponibles sont les suivants :

Mise à niveau VDA (Studio) Mise à niveau VDA (Powershell) Description
Niveau du catalogue
Non configuré MissingUpgradeType Aucune piste de mise à niveau (CR, LTSR, CR EAR ou LTSR EAR) n’a été sélectionnée pour le catalogue de machines.
Planifié UpgradeScheduled Une mise à niveau est planifiée pour le catalogue de machines.
Disponible UpgradeAvailable Les VDA du catalogue ne sont pas sur la dernière version de la piste de mise à niveau. Une mise à niveau est recommandée.
À jour UpToDate Les VDA du catalogue sont sur la dernière version de la piste de mise à niveau. Aucune action n’est requise.
Inconnu Unknown Récupération du dernier état de la mise à niveau VDA.
Niveau de la machine
Non configuré MissingUpgradeType Aucune piste de mise à niveau (CR, LTSR, CR EAR ou LTSR EAR) n’a été sélectionnée pour le catalogue de machines du VDA.
Planifié UpgradeScheduled Une mise à niveau est planifiée pour le VDA.
Disponible UpgradeAvailable Le VDA n’est pas sur la dernière version de la piste de mise à niveau. Une mise à niveau est recommandée.
À jour UpToDate Le VDA est sur la dernière version de la piste de mise à niveau. Aucune action n’est requise.
Vérification de l’état Unknown Récupération du dernier état de la mise à niveau VDA.

Remarque :

Pour les VDA utilisant la piste LTSR, un catalogue n’apparaîtra comme « À jour » que si les VDA sont sur la dernière mise à jour cumulative (CU) de la dernière version du service à long terme (LTSR). Si le VDA est sur la dernière CU d’une version LTSR précédente, la Mise à niveau VDA s’affichera toujours comme Disponible.

État de la mise à niveau VDA

L’État de la mise à niveau VDA fournit des informations sur le statut d’une mise à niveau planifiée. Les statuts de l’État de la mise à niveau VDA sont les suivants :

État de la mise à niveau VDA (Studio) État de la mise à niveau VDA (PowerShell) Description
Niveau du catalogue
Non planifié NotScheduled Aucune mise à niveau n’est planifiée pour le catalogue.
Planifié UpgradeScheduled Une mise à niveau est planifiée pour le catalogue.
En cours UpgradeInProgress Une mise à niveau est en cours pour le catalogue.
Annulé UpgradeCancelled Une mise à niveau a été annulée pour le catalogue. Cela peut être dû à une annulation manuelle ou au dépassement du seuil d’échec.
Échec UpgradeFailed Une mise à niveau planifiée pour le catalogue a échoué.
Réussi UpgradeSuccessful Une mise à niveau planifiée pour le catalogue s’est terminée avec succès. Remarque : Une mise à niveau réussie ne signifie pas que tous les VDA du catalogue ont été mis à niveau avec succès.
- Empty Aucune mise à niveau planifiée pour le catalogue.
Niveau de la machine
Planifié UpgradeScheduled Une mise à niveau est planifiée pour le VDA.
En attente de mise à niveau UpgradeInUpgradeWindow Une mise à niveau planifiée est active, mais le VDA n’a pas encore commencé la mise à niveau. Consultez « Concurrence » pour plus d’informations sur la manière dont les mises à niveau VDA sont équilibrées en charge. 
-  |En cours|UpgradeInProgress|Le VDA est en cours de mise à niveau.|
-  |Annulé|UpgradeCancelled|Une mise à niveau planifiée a été annulée pour le VDA avant le début de la mise à niveau.|
-  |Échec de la mise à niveau|UpgradeFailed|Le VDA a commencé la mise à niveau, mais celle-ci n'a pas pu se terminer avec succès. Consultez « Dépannage » pour plus d'informations.|
-  |Réussi|UpgradeSuccess|Le VDA a été mis à niveau avec succès.|
-  |Échec de la validation|UpgradeValidationFailed|La validation du certificat a échoué lors du téléchargement des métadonnées pour l'installateur VDA.| |-|Empty|Aucune mise à niveau n'est planifiée pour le VDA.|

Dépannage des mises à niveau planifiées des VDA

Si vous rencontrez des échecs de mise à niveau, les journaux suivants peuvent vous aider à identifier et à résoudre les problèmes. Vous pouvez également partager ces journaux avec le support technique de Citrix pour accélérer le processus d’assistance.

Journaux d’installation du VDA

Lors du dépannage des échecs de mise à niveau, collectez et examinez les journaux pour l’installation initiale du VDA et pour la mise à niveau ayant échoué. Les journaux d’installation et de mise à niveau se trouvent aux emplacements suivants.

  • Les journaux d’installation des VDA sont placés dans :
    • %temp%/Citrix/XenDesktop Installer
  • Les journaux de mise à niveau des VDA sont placés soit dans :
    • C:\Windows\Temp\Citrix\XenDesktop Installer ou
    • C:\Windows\SystemTemp\Citrix\XenDesktop Installer

Version de l’agent de mise à niveau VDA

Lors de la collecte de données pour le dépannage des échecs de mise à niveau via VUS, il est important de connaître la version de l’agent de mise à niveau sur les VDA. Pour vérifier les versions de l’agent de mise à niveau VDA, utilisez la cmdlet suivante : Get-VusComponentVersion -ComponentType VUS. Elle liste tous les VDA et leurs versions d’agent de mise à niveau VDA.

-  Pour vérifier les versions de l'agent de mise à niveau VDA au niveau d'un catalogue, vous pouvez utiliser le script suivant :

Remarque : - >

  • Le script est fourni à titre d’exemple et pourrait nécessiter une adaptation à votre environnement spécifique. Nous vous recommandons de tester le script minutieusement avant de l’utiliser dans un environnement de production.

  • 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 $_ }

Journaux liés à l’agent de mise à niveau VDA

Les journaux de l’agent de mise à niveau VDA (VUA) peuvent fournir des informations essentielles pour le dépannage des échecs de mise à niveau et des problèmes de communication entre le VUA et le service de mise à niveau VDA. Les journaux que vous pouvez collecter incluent :

  • Traces Citrix Diagnostic Facility (CDF). Le nom du module CDF est VdaUpgradeAgent.

  • Journaux d’événements Windows. Affichez les journaux dans Observateur d’événements > Journaux Windows > Applications > Citrix VDA Upgrade Agent Service.

  • Un paramètre de registre est disponible qui permet aux administrateurs d’activer un fichier journal rotatif qui capture des informations critiques pour le dépannage tout en empêchant les fichiers journaux de devenir trop volumineux. La taille totale des fichiers journaux est plafonnée à 20 Mo. Créez la clé de registre suivante pour activer la journalisation dans un fichier :

  • Clé : HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent\LogToFile

  • Nom de la valeur : LogToFile

  • Type de valeur : REG_DWORD

  • Données de la valeur :

    • 0 - traçage de fichier désactivé

    • 1 - traçage de fichier activé

Pour créer la clé de registre LogToFile sur un VDA à l’aide de PowerShell, utilisez la cmdlet suivante :

New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent\LogToFile -Name LogToFile -Value 1 -PropertyType DWord -Force

Pour activer LogToFile pour des groupes de machines à grande échelle, envisagez de créer la clé de registre LogToFile sur toutes les unités d’organisation (UO) VDA via la préférence de stratégie de groupe.

Remarque :

  • Lorsque LogToFile=1 est défini, les journaux sont écrits uniquement dans le fichier. Ils n’apparaîtront pas dans les traces CDF.
  • Le redémarrage du service VDA Upgrade Agent est nécessaire pour que la modification du registre prenne effet.
  • Le fichier journal est créé dans le dossier C:\ProgramData\Citrix\Update Services\Logs.

Résoudre les échecs de téléchargement de la mise à niveau du VDA

Suivez les étapes ci-dessous pour résoudre les échecs de téléchargement liés à la fonctionnalité de mise à niveau du VDA :

  1. Assurez-vous que les URL pertinentes ont été ajoutées à la liste d’autorisation si le filtrage d’URL est en place. Consultez Connectivité.

  2. Après avoir ajouté les URL nécessaires à la liste d’autorisation, essayez de replanifier la mise à niveau du VDA.

Vous pouvez activer le traçage CDF ou définir LogToFile sur 1 pour capturer des journaux détaillés à des fins d’analyse. Si le problème d’échec de téléchargement persiste, vérifiez les erreurs. Si vous voyez le message d’erreur suivant : « Download Failed: This access control list is not in canonical form and therefore cannot be modified » (Échec du téléchargement : cette liste de contrôle d’accès n’est pas sous forme canonique et ne peut donc pas être modifiée), cela indique que les autorisations sur le dossier C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA sont incorrectes.

Pour résoudre le problème, effectuez l’une des opérations suivantes :

  • Option 1 : Réinitialisez les listes de contrôle d’accès (ACL) sur le dossier à l’aide de la commande suivante. (La commande réinitialise les ACL avec les ACL héritées par défaut pour tous les fichiers correspondants.)
    • icacls.exe “C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA” /reset /T /C /L /Q
  • Option 2 : Supprimez le dossier VDA sous Téléchargements, puis planifiez la mise à niveau du VDA.

Résoudre les échecs de validation de la mise à niveau du VDA

Suivez les étapes ci-dessous pour résoudre les échecs de validation liés à la fonctionnalité de mise à niveau du VDA :

  1. Assurez-vous que les URL pertinentes ont été ajoutées à la liste d’autorisation si le filtrage d’URL est en place, en particulier les URL de la liste de révocation de certificats (CRL) ou du protocole OCSP (Online Certificate Status Protocol) nécessaires à la vérification de la révocation. Consultez Exigences de mise à niveau du VDA.

  2. Après avoir ajouté les URL nécessaires à la liste d’autorisation, essayez de replanifier la mise à niveau du VDA.

Nous vous suggérons d’activer le traçage CDF ou de définir LogToFile sur 1 pour capturer des journaux détaillés à des fins d’analyse. Les journaux peuvent inclure les erreurs suivantes :

  • RevocationStatusUnknown
  • La fonction de révocation n’a pas pu vérifier l’état de révocation du certificat.
  • La fonction de révocation n’a pas pu vérifier la révocation car le serveur de révocation était hors ligne.

L’agent de mise à niveau du VDA s’appuie sur les appels système Windows pour valider les certificats et effectuer les vérifications de révocation. Les erreurs ci-dessus indiquent que l’agent est incapable d’établir une connexion aux URL CRL ou OCSP.

L’API CryptoAPI de Windows ne prend pas actuellement en charge les paramètres de proxy. Consultez la section VDA avec configurations de proxy pour configurer vos proxys VDA afin de faciliter les appels CRL sortants.

Surveillance et dépannage
April 8, 2026
Contributeur: 
C C
April 8, 2026
Contributeur: 
C C

Dans cet article

Commentaires sur le site | Your privacy choices footer linkVos préférences de confidentialité | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.