Überwachung und Fehlerbehebung

Überwachung geplanter VDA-Upgrades

VDAs und Maschinenkataloge verfügen über zwei Attribute, die zur Überwachung der Bereitschaft und des aktuellen Status von VDA-Upgrades dienen. Diese sind als Spalten sichtbar und können zum Filtern in Studio oder im Detailbereich der VDAs oder Kataloge verwendet werden.

• VDA-Upgrade
• VDA-Upgrade-Status

VDA-Upgrade

VDA-Upgrade liefert Informationen darüber, ob der VDA oder Maschinenkatalog den VDA-Upgrade-Agent konfiguriert hat und ob VDAs auf dem neuesten Stand sind oder ob ein Upgrade verfügbar ist. Die verfügbaren Status sind wie folgt:

Hinweis:

Für VDAs, die den LTSR-Track verwenden, wird ein Katalog nur dann als „Aktuell“ angezeigt, wenn die VDAs auf dem neuesten kumulativen Update (CU) der neuesten Long Term Service (LTSR)-Version sind. Wenn der VDA auf dem neuesten CU einer früheren LTSR-Version ist, wird der VDA-Upgrade-Status weiterhin als Verfügbar angezeigt.

VDA-Upgrade-Status

Der VDA-Upgrade-Status liefert Informationen über den Status eines geplanten Upgrades. Die Status des VDA-Upgrade-Status sind wie folgt:

Fehlerbehebung bei geplanten VDA-Upgrades

Wenn Upgrade-Fehler auftreten, können die folgenden Protokolle Ihnen helfen, die Probleme zu identifizieren und zu beheben. Sie können diese Protokolle auch dem technischen Support von Citrix zur Verfügung stellen, um den Unterstützungsprozess zu beschleunigen.

VDA-Installationsprotokolle

Bei der Fehlerbehebung von Upgrade-Fehlern sollten Sie die Protokolle sowohl für die Erstinstallation des VDA als auch für das fehlgeschlagene Upgrade sammeln und überprüfen. Protokolle für Installationen und Upgrades finden Sie an den folgenden Speicherorten.

• Installationsprotokolle für VDA-Installationen befinden sich unter:
  • %temp%/Citrix/XenDesktop Installer
• Upgrade-Protokolle für VDA-Installationen befinden sich entweder unter:
  • C:\Windows\Temp\Citrix\XenDesktop Installer oder
  • C:\Windows\SystemTemp\Citrix\XenDesktop Installer

VDA-Upgrade-Agent-Version

Beim Sammeln von Daten zur Fehlerbehebung bei Upgrade-Fehlern über VUS ist es wichtig, die Version des Upgrade-Agenten auf den VDAs zu kennen. Um die Versionen des VDA-Upgrade-Agenten zu überprüfen, verwenden Sie das folgende Cmdlet: Get-VusComponentVersion -ComponentType VUS. Es listet alle VDAs und ihre VDA-Upgrade-Agent-Versionen auf.

Um die Versionen des VDA-Upgrade-Agenten auf Katalogebene zu überprüfen, können Sie das folgende Skript verwenden:

Hinweis:

Das Skript ist als Beispiel gedacht und muss möglicherweise an Ihre spezifische Umgebung angepasst werden. Wir empfehlen Ihnen, das Skript gründlich zu testen, bevor Sie es in einer Produktionsumgebung einsetzen.

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 $_ }

Protokolle für den VDA-Upgrade-Agent

Protokolle des VDA-Upgrade-Agent (VUA) können wichtige Informationen zur Fehlerbehebung bei Upgrade-Fehlern und Problemen bei der Kommunikation des VUA mit dem VDA-Upgrade-Dienst liefern. Folgende Protokolle können Sie sammeln:

• Citrix Diagnostic Facility (CDF)-Traces. Der Name des CDF-Moduls ist VdaUpgradeAgent.
• Windows-Ereignisprotokolle. Zeigen Sie Protokolle in der Ereignisanzeige > Windows-Protokolle > Anwendungen > Citrix VDA Upgrade Agent Service an.

Es ist eine Registrierungseinstellung verfügbar, die es Administratoren ermöglicht, eine rotierende Protokolldatei zu aktivieren, die wichtige Informationen zur Fehlerbehebung erfasst und gleichzeitig verhindert, dass die Protokolldateien zu groß werden. Die Gesamtgröße der Protokolldateien ist auf 20 MB begrenzt. Erstellen Sie den folgenden Registrierungsschlüssel, um die Protokollierung in eine Datei zu aktivieren:

• Schlüssel: HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent\LogToFile

• Wertname: LogToFile

• Werttyp: REG_DWORD

• Wertdaten:

  • 0 - Dateiverfolgung deaktiviert

  • 1 - Dateiverfolgung aktiviert

Um den Registrierungsschlüssel „LogToFile“ auf einem VDA mithilfe von PowerShell zu erstellen, verwenden Sie das folgende Cmdlet:

New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent\LogToFile -Name LogToFile -Value 1 -PropertyType DWord -Force

Um LogToFile für Maschinengruppen im großen Maßstab zu aktivieren, sollten Sie die LogToFile-Registrierung auf allen VDA-Organisationseinheiten (OUs) über die Gruppenrichtlinienpräferenz erstellen.

Hinweis:

• Wenn LogToFile=1 festgelegt ist, werden Protokolle nur in die Datei geschrieben. Sie werden nicht in den CDF-Traces angezeigt.
• Der Neustart des VDA Upgrade Agent-Dienstes ist erforderlich, damit die Registrierungsänderung wirksam wird.
• Die Protokolldatei wird im Ordner C:\ProgramData\Citrix\Update Services\Logs erstellt.

Beheben von Fehlern beim VDA-Upgrade-Download

Führen Sie die folgenden Schritte aus, um Downloadfehler im Zusammenhang mit der VDA-Upgradefunktion zu beheben:

1. Stellen Sie sicher, dass relevante URLs zur Positivliste hinzugefügt wurden, wenn eine URL-Filterung vorhanden ist. Siehe Konnektivität.

2. Nachdem Sie die erforderlichen URLs zur Positivliste hinzugefügt haben, versuchen Sie, das VDA-Upgrade neu zu planen.

Sie können CDF-Tracing aktivieren oder LogToFile auf 1 setzen, um detaillierte Protokolle zur Analyse zu erfassen. Wenn das Problem mit dem Downloadfehler weiterhin besteht, überprüfen Sie die Fehler. Wenn die Fehlermeldung „Download Failed: This access control list is not in canonical form and therefore cannot be modified“ (Download fehlgeschlagen: Diese Zugriffssteuerungsliste ist nicht in kanonischer Form und kann daher nicht geändert werden) angezeigt wird, deutet dies darauf hin, dass die Berechtigungen für den Ordner C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA falsch sind.

Um das Problem zu beheben, führen Sie eine der folgenden Aktionen aus:

• Option 1: Setzen Sie die Zugriffssteuerungslisten (ACLs) für den Ordner mit dem folgenden Befehl zurück. (Der Befehl setzt die ACLs mit den standardmäßig geerbten ACLs für alle übereinstimmenden Dateien zurück.)
  • icacls.exe “C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA” /reset /T /C /L /Q
• Option 2: Löschen Sie den VDA-Ordner unter Downloads und planen Sie dann das VDA-Upgrade.

Fehlerbehebung bei Validierungsfehlern des VDA-Upgrades

Führen Sie die folgenden Schritte aus, um Downloadfehler im Zusammenhang mit der VDA-Upgradefunktion zu beheben:

1. Stellen Sie sicher, dass relevante URLs zur Positivliste hinzugefügt wurden, falls eine URL-Filterung vorhanden ist, insbesondere die URLs der Zertifikatsperrliste (CRL) oder des Online Certificate Status Protocol (OCSP), die für die Sperrprüfung erforderlich sind. Siehe VDA-Upgrade-Anforderung.

2. Nachdem Sie die erforderlichen URLs zur Positivliste hinzugefügt haben, versuchen Sie, das VDA-Upgrade neu zu planen.

Wir empfehlen, die CDF-Ablaufverfolgung zu aktivieren oder LogToFile auf 1 zu setzen, um detaillierte Protokolle zur Analyse zu erfassen. Die Protokolle können die folgenden Fehler enthalten:

• RevocationStatusUnknown
• Die Sperrfunktion konnte den Sperrstatus des Zertifikats nicht überprüfen.
• Die Sperrfunktion konnte die Sperrung nicht überprüfen, da der Sperrserver offline war.

Der VDA-Upgrade-Agent verwendet Windows-Systemaufrufe, um Zertifikate zu validieren und Sperrprüfungen durchzuführen. Die oben genannten Fehler weisen darauf hin, dass der Agent keine Verbindung zu den CRL- oder OCSP-URLs herstellen kann.

Die Windows CryptoAPI unterstützt derzeit keine Proxy-Einstellungen. Lesen Sie den Abschnitt VDAs mit Proxy-Konfigurationen, um Ihre VDA-Proxys für ausgehende CRL-Aufrufe zu konfigurieren.