Surveillance et dépannage
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. |
| Programmé | 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. |
| Programmé | 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. |
| Programmé | 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 | ||
| Programmé | 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
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
si($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 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.
Pour les versions VUA 7.44 et ultérieures
Dans la version 7.44 de l’agent de service de mise à niveau de VDA (inclus dans la version 2503), 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.
Pour les versions VUA antérieures à 7.43
Si nécessaire, vous pouvez modifier le fichier de configuration de l’agent de mise à niveau de VDA afin que les journaux soient écrits en continu dans un fichier. Pour activer la journalisation dans un fichier, procédez comme suit :
- Accédez au dossier
C:\Program Files\Citrix\CitrixUpgradeAgent. - Ouvrez le fichier
Citrix.UpdateServices.UpdateAgent.exe.config. - Remplacez la valeur de
LogToFilepar1. - Redémarrez le service de l’agent de mise à niveau de Citrix VDA. Cette modification crée un fichier journal dans le dossier :
C:\ProgramData\Citrix\Update Services\Logs.
Remarque
- L’activation de la journalisation dans un fichier via le fichier .config permet d’écrire des journaux en continu, ce qui peut consommer de l’espace de stockage. N’oubliez pas de désactiver la journalisation une fois le problème résolu. Pour désactiver la journalisation, définissez d’abord
LogToFilesur0, puis redémarrez le service Citrix VDA Upgrade Agent.- 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 :
-
Assurez-vous que les URL pertinentes ont été ajoutées à la liste d’autorisation si le filtrage d’URL est en place. Consultez les Conditions requises pour la mise à niveau de VDA.
-
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 :
-
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.
-
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.