Surveillance et dépannage
Surveillance des mises à niveau VDA planifiées
-
Les VDA et les catalogues de machines disposent de deux attributs permettant de surveiller l’état de préparation et le statut actuel des mises à niveau VDA, visibles sous forme de colonnes utilisables pour filtrer dans Studio ou dans le volet de détails des VDA ou des catalogues.
- Mise à niveau VDA
- État de la mise à niveau VDA
Mise à niveau VDA
« Mise à niveau VDA » fournit des informations pour savoir si l’agent de mise à niveau VDA est configuré pour le VDA ou le catalogue de machines, et 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 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 mise à niveau VDA. |
Remarque :
Pour les VDA utilisant la piste LTSR, un catalogue ne s’affichera 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, « Mise à niveau VDA » s’affichera toujours comme Disponible.
État de la mise à niveau VDA
« État de la mise à niveau VDA » fournit des informations sur le statut d’une mise à niveau planifiée. Les statuts d’« É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 n’est 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 répartition de la charge des mises à niveau VDA. |
- |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 le programme d'installation du VDA.|
| - | Empty | Aucune mise à niveau n’est planifiée pour le VDA. |
Dépannage des mises à niveau VDA planifiées
Si vous rencontrez des échecs de mise à niveau, les journaux suivants peuvent vous aider à identifier et à dépanner 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 VDA
Lors du dépannage des échecs de mise à niveau, recueillez 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 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 VDA, utilisez la cmdlet suivante : Get-VusComponentVersion -ComponentType VUS. Elle répertorie 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 :
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 VDA
Les journaux de l’agent de mise à niveau VDA (VUA) peuvent fournir des informations essentielles pour dépanner les échecs de mise à niveau et les problèmes de communication du VUA avec le service de mise à niveau VDA. Les journaux que vous pouvez collecter incluent :
- Traces du service de diagnostic Citrix (CDF). Le nom du module CDF est VdaUpgradeAgent.
- Journaux d’événements Windows. Affichez les journaux dans l’Observateur d’événements > Journaux Windows > Applications > Service de l’agent de mise à niveau VDA Citrix.
Pour les versions 7.44 et ultérieures de VUA
Dans la version 7.44 de l’agent du service de mise à niveau VDA (incluse dans la version 2503), 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 limitée à 20 Mo. Créez la clé de registre suivante pour activer la journalisation dans un fichier :
- Clé :
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent -Name LogToFile -Value 1 -PropertyType DWord -Force
-
Nom de la valeur :
LogToFile -
Type de valeur :
REG_DWORD -
Données de 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 -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) VDA via une préférence de stratégie de groupe.
Remarque :
- Lorsque
LogToFile=1est 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 nécessaire pour que la modification du registre prenne effet.
- Le fichier journal est créé dans le dossier C:\ProgramData\Citrix\Update Services\Logs.
Pour les versions de VUA antérieures à 7.43
Si nécessaire, vous pouvez modifier le fichier de configuration de l’agent de mise à niveau 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 Citrix VDA Upgrade Agent. Cela crée un fichier journal à l’emplacement :
C:\ProgramData\Citrix\Update Services\Logs.
Remarque :
- L’activation de la journalisation dans un fichier via le fichier .config écrit en continu des journaux, 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
LogToFile=1est défini, 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 de la mise à niveau VDA
Suivez les étapes ci-dessous pour résoudre les échecs de téléchargement liés à la fonctionnalité de mise à niveau VDA :
-
Assurez-vous que les URL pertinentes ont été ajoutées à la liste d’autorisation si le filtrage d’URL est activé. Consultez Exigences de mise à niveau VDA.
-
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 vous voyez le message d’erreur suivant : « 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 échecs de téléchargement liés à la fonctionnalité de mise à niveau VDA :
-
Assurez-vous que les URL pertinentes ont été ajoutées à la liste d’autorisation si le filtrage d’URL est activé, 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.
-
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 des vérifications de révocation. Les erreurs ci-dessus indiquent que l’agent ne peut pas établir de connexion aux URL CRL ou OCSP.
L’API de chiffrement Windows ne prend actuellement pas 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.