Surveillance et dépannage

Surveillance des mises à niveau VDA planifiées

Les VDA et les catalogues de machines possèdent deux attributs pour aider à surveiller l’état de préparation et le statut actuel des mises à niveau VDA, 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 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 :

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, la mise à niveau du VDA s’affichera toujours comme Disponible.

État de la mise à niveau du VDA

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

Dépannage des mises à niveau VDA planifié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 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 pour les installations VDA se trouvent dans :
  • %temp%/Citrix/XenDesktop Installer
• Les journaux de mise à niveau pour les installations 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 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 pourrait nécessiter d’être adapté à votre environnement spécifique. Nous vous recommandons de tester le script minutieusement 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 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.

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 - 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 la 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 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

Dépanner les échecs de téléchargement de la mise à niveau VDA

Suivez les étapes ci-dessous pour dépanner et résoudre 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 activé. Voir 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 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 du VDA.

Dépanner les échecs de validation de la mise à niveau du VDA

Suivez les étapes ci-dessous pour dépanner et 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 activé, 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. Voir Exigences de mise à niveau du VDA.

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

Nous 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 du 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 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.