Surveillance et dépannage
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, visibles sous forme de colonnes pouvant être utilisées 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
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 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’affiche 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é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 façon 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 être menée à bien. 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 le programme d’installation du 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, 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 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 répertorie tous les VDA et leurs versions de l’agent de mise à niveau VDA.
- Pour vérifier les versions de l’agent de mise à niveau VDA au niveau du catalogue, vous pouvez utiliser le script suivant :
Remarque :
- > Le script est fourni à titre d’exemple et peut 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 le dépannage des échecs de mise à niveau et des problèmes de communication du VUA avec 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 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 plafonné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 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 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) 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 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.
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 continuellement écrits dans un fichier. Pour activer la journalisation dans un fichier, suivez ces étapes :
- Accédez au dossier
C:\Program Files\Citrix\CitrixUpgradeAgent. - Ouvrez le fichier
Citrix.UpdateServices.UpdateAgent.exe.config. - Modifiez la valeur de
LogToFileà1. - 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 continuellement des journaux, ce qui peut potentiellement 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 en place. 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 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 les 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 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 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.