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

November 25, 2025
Contributeur: 
C

Surveillance des mises à niveau de VDA programmées

Les VDA et les catalogues de machines disposent de deux attributs permettant de surveiller l’état de préparation et l’état actuel des mises à niveau de VDA. Ces états sont présentés dans des colonnes permettant de filtrer les détails dans Studio ou dans le volet de détails des VDA ou des catalogues.

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

Mise à niveau de VDA

La mise à niveau de VDA fournit des informations indiquant si le VDA ou le catalogue de machines dispose de l’agent de mise à niveau de VDA configuré, 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
Au 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 du catalogue de machines est programmée.
Disponible UpgradeAvailable Les VDA du catalogue n’exécutent pas la dernière version de la piste de mise à niveau. Une mise à niveau est recommandée.
À jour UpToDate Les VDA du catalogue exécutent la dernière version de la piste de mise à niveau. Aucune action requise.
Inconnu Inconnu Récupération du dernier état de mise à niveau de VDA.
Au 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 de VDA est programmée.
Disponible UpgradeAvailable Le VDA n’exécute pas la dernière version de la piste de mise à niveau. Une mise à niveau est recommandée.
À jour UpToDate Le VDA exécute la dernière version de la piste de mise à niveau. Aucune action requise.
Vérification de l’état Inconnu Récupération du dernier état de mise à niveau de VDA.

Remarque :

Pour les VDA utilisant la piste LTSR, un catalogue ne s’affichera comme étant à jour que si les VDA exécutent la dernière mise à jour cumulative (CU) de la dernière version du service à long terme (LTSR). Si le VDA exécute la dernière CU d’une version LTSR précédente, la mise à niveau du VDA s’affichera toujours comme Disponible.

État de la mise à niveau de VDA

L’état de mise à niveau de VDA fournit des informations sur l’état d’une mise à niveau programmée. Les états de mise à niveau de VDA sont les suivants :

État de mise à niveau VDA (Studio) État de mise à niveau VDA (PowerShell) Description
Au niveau du catalogue    
Non programmé NotScheduled Aucune mise à niveau du catalogue n’est programmée.
Planifié UpgradeScheduled Une mise à niveau du catalogue est programmée.
En cours UpgradeInProgress Une mise à niveau du catalogue est en cours.
Annulé UpgradeCancelled Une mise à niveau du catalogue a été annulée. Il peut s’agir d’une annulation manuelle ou de l’atteinte du seuil d’échecs.
Échec UpgradeFailed Une mise à niveau programmée du catalogue a échoué.
Succès UpgradeSuccessful Une mise à niveau programmée du 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.
- Vide Aucune mise à niveau programmée pour le catalogue.
Au niveau de la machine    
Planifié UpgradeScheduled Une mise à niveau de VDA est programmée.
En attente de mise à niveau UpgradeInUpgradeWindow Une mise à niveau programmée est active, mais le VDA n’a pas encore démarré le processus. Consultez la page « Simultanéité » pour plus d’informations sur l’équilibrage de la charge de mise à niveau des VDA.
En cours UpgradeInProgress Le VDA est actuellement en cours de mise à niveau.
Annulé UpgradeCancelled Une mise à niveau programmée a été annulée pour le VDA avant le début du processus.
Échec de la mise à niveau UpgradeFailed Le VDA a démarré la mise à niveau, mais le processus a échoué. Consultez la page « Dépannage » pour plus d’informations.
Réussi UpgradeSuccess La mise à niveau de VDA a été effectuée avec succès.
La validation a échoué UpgradeValidationFailed La validation du certificat a échoué lors du téléchargement des métadonnées du programme d’installation de VDA.
- Vide Aucune mise à niveau n’est programmée pour le VDA.

Dépannage des mises à niveau de VDA programmées

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 de VDA

Lors du dépannage des échecs de mise à niveau, collectez et examinez les journaux relatifs à l’installation initiale de VDA et de la mise à niveau ayant échoué. Les journaux d’installation et de mise à niveau peuvent être trouvés aux emplacements suivants.

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

Version de l’agent de mise à niveau de VDA

Lors de la collecte de données pour résoudre les échecs de mise à niveau via VUS, il est important de connaître la version de l’agent de mise à niveau exécutée sur les VDA. Pour vérifier les versions de l’agent de mise à niveau de VDA, utilisez l’applet de commande suivant : Get-VusComponentVersion -ComponentType VUS. Il répertorie tous les VDA et les versions de leur agent de mise à niveau de VDA.

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

Remarque :

Le script est donné à titre d’exemple et il peut être nécessaire de l’adapter à votre environnement spécifique. Nous vous recommandons de tester le script rigoureusement 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 "Impossible de trouver le nom du catalogue " +$CatalogName } Write-Output("Le nom du catalogue transmis est "+$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 relatifs à l’agent de mise à niveau de VDA

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

  • Traces CDF (Citrix Diagnostic Facility). Le nom du module CDF est VdaUpgradeAgent.
  • Journaux d’événements Windows. Pour afficher les journaux, accédez à Observateur d’événements > Journaux Windows > Applications > Citrix VDA Upgrade Agent Service.

Un paramètre de registre est disponible pour permettre 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 limité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 valeur :

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

    • 1 - traçage de fichiers activé

Pour créer la clé de registre LogToFile sur un VDA à l’aide de PowerShell, utilisez l’applet de commande 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 le registre LogToFile sur toutes les unités d’organisation (UO) de VDA via les préférences de stratégie de groupe.

Remarque :

Lorsque vous définissez LogToFile=1, les journaux sont écrits uniquement dans le fichier. Ils n’apparaîtront pas dans les traces CDF.

Résoudre les échecs de téléchargement des mises à niveau de 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 reprogrammer 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 l’échec du téléchargement persiste, vérifiez les erreurs. Si le message d’erreur suivant s’affiche, « Échec du téléchargement : cette liste de contrôle d’accès n’est pas au format 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 ce 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 programmez la mise à niveau de VDA.

Résoudre les échecs de validation des mises à niveau de 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, 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 les Conditions requises pour la mise à niveau de VDA.

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

Nous vous recommandons 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 :

  • État de révocation inconnu
  • 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 de VDA s’appuie sur les appels système Windows pour valider les certificats et effectuer des contrôles de révocation. Les erreurs ci-dessus indiquent que l’agent n’est pas en mesure d’établir une connexion aux URL CRL ou OCSP.

Actuellement, Windows CryptoAPI ne prend pas en charge les paramètres de proxy. Consultez la section VDA avec configurations de proxy pour configurer les proxys VDA de façon à faciliter les appels CRL sortants.

Surveillance et dépannage
November 25, 2025
Contributeur: 
C
November 25, 2025
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.