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

March 18, 2026
Contributeur: 
C

Surveillance des mises à niveau planifiées des VDA

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

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

Mise à niveau des VDA

La mise à niveau des VDA fournit des informations sur la configuration de l’agent de mise à niveau des 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 des VDA (Studio)|Mise à niveau des 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 mise à niveau des 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 mise à niveau des 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 de service à long terme (LTSR). Si le VDA est sur la dernière CU d’une version LTSR précédente, la mise à niveau des VDA affichera toujours Disponible.

État de la mise à niveau des VDA

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

État de la mise à niveau des VDA (Studio) État de la mise à niveau des 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 seuil d’échec atteint.
Échec UpgradeFailed Une mise à niveau planifiée pour le catalogue a échoué.
Réussite 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 des 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éussite 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’installeur 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 des VDA

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

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

Version de l’agent de mise à niveau des VDA

Lors de la collecte de données pour dépanner les é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 des VDA, utilisez la cmdlet suivante : Get-VusComponentVersion -ComponentType VUS. Elle répertorie tous les VDA et leurs versions de l’agent de mise à niveau des VDA.

Pour vérifier les versions de l’agent de mise à niveau des VDA au niveau du catalogue, vous pouvez utiliser le script suivant :

Remarque :

Ce script est fourni à titre d’exemple et pourrait nécessiter une adaptation à votre environnement spécifique. Nous vous recommandons de tester minutieusement le script 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 des VDA

Les journaux de l’agent de mise à niveau des 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 des 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 > Service de l’agent de mise à niveau des VDA Citrix.

Un paramètre de registre est disponible qui permet aux administrateurs d’activer un fichier journal rotatif qui capture les 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 - le traçage de fichier est désactivé

    • 1 - le traçage de fichier est 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 une 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 Agent de mise à niveau VDA est requis 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 VDA

Suivez les étapes ci-dessous pour résoudre les problèmes et les échecs de téléchargement liés à la fonctionnalité de mise à niveau 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 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 le message d’erreur suivant s’affiche : « Download Failed: This access control list is not in canonical form and therefore cannot be modified », 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 VDA.

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

Suivez les étapes ci-dessous pour résoudre les problèmes et les échecs de validation liés à la fonctionnalité de mise à niveau 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 liste de révocation de certificats (CRL) ou de protocole d’état de certificat en ligne (OCSP) nécessaires à la vérification de la révocation. Consultez Exigences de mise à niveau VDA.

  2. Après avoir ajouté les URL nécessaires à la liste d’autorisation, essayez de replanifier la mise à niveau 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 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 Windows CryptoAPI 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
March 18, 2026
Contributeur: 
C
March 18, 2026
Contributeur: 
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.