Produktdokumentation
Citrix DaaS™
PDF anzeigen

Überwachung und Fehlerbehebung

May 4, 2026
Beitrag von: 
C

Überwachung geplanter VDA-Upgrades

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

  • VDA-Upgrade
  • VDA-Upgradestatus

VDA-Upgrade

„VDA-Upgrade“ gibt Aufschluss darüber, ob der VDA oder der Maschinenkatalog über den konfigurierten VDA-Upgrade-Agenten verfügt und ob die VDAs auf dem neuesten Stand sind oder ob ein Upgrade verfügbar ist. Die verfügbaren Status sind wie folgt:

VDA-Upgrade (Studio) VDA-Upgrade (PowerShell) Beschreibung
Katalogebene
Nicht konfiguriert MissingUpgradeType Für den Maschinenkatalog wurde keine Upgradelinie (CR, LTSR, CR EAR oder LTSR EAR) ausgewählt.
Geplant UpgradeScheduled Für den Maschinenkatalog ist ein Upgrade geplant.
Verfügbar UpgradeAvailable VDAs im Katalog verwenden nicht die neueste Version der Upgradelinie. Ein Upgrade wird empfohlen.
Aktuell UpToDate VDAs im Katalog verwenden die neueste Version der Upgradelinie. Keine Aktion erforderlich.
Unbekannt Unknown Abruf des aktuellen VDA-Upgradestatus.
Maschinenebene
Nicht konfiguriert MissingUpgradeType Für den Maschinenkatalog des VDAs wurde keine Upgradelinie (CR, LTSR, CR EAR oder LTSR EAR) ausgewählt.
Geplant UpgradeScheduled Für den VDA ist ein Upgrade geplant.
Verfügbar UpgradeAvailable Der VDA verwendet nicht die neueste Version der Upgradelinie. Ein Upgrade wird empfohlen.
Aktuell UpToDate Der VDA verwendet die neueste Version der Upgradelinie. Keine Aktion erforderlich.
Statusprüfung Unknown Abruf des aktuellen VDA-Upgradestatus.

Hinweis:

Bei VDAs, die die LTSR-Linie verwenden, wird ein Katalog nur dann als „Aktuell“ angezeigt, wenn die VDAs das neueste kumulative Update (CU) der neuesten Long Term Service Release (LTSR)-Version verwenden. Wenn der VDA das neueste CU einer früheren LTSR-Version verwendet, wird das VDA-Upgrade weiterhin als Verfügbar angezeigt.

VDA-Upgradestatus

„VDA-Upgradestatus“ bietet Informationen zum Status eines geplanten Upgrades. Die Status des VDA-Upgrades sind wie folgt:

VDA-Upgradestatus (Studio) VDA-Upgradestatus (PowerShell) Beschreibung
Katalogebene
Nicht geplant NotScheduled Für den Katalog ist kein Upgrade geplant.
Geplant UpgradeScheduled Für den Katalog ist ein Upgrade geplant.
In Bearbeitung UpgradeInProgress Ein Upgrade für den Katalog ist im Gange.
Abgebrochen UpgradeCancelled Ein Upgrade für den Katalog wurde abgebrochen. Dies kann auf einen manuellen Abbruch oder das Erreichen des Fehlerschwellenwerts zurückzuführen sein.
Fehlgeschlagen UpgradeFailed Ein geplantes Upgrade für den Katalog ist fehlgeschlagen.
Erfolgreich UpgradeSuccessful Ein geplantes Upgrade für den Katalog wurde erfolgreich abgeschlossen. Hinweis: Ein erfolgreiches Upgrade bedeutet nicht, dass alle VDAs im Katalog erfolgreich aktualisiert wurden.
- Empty Kein Upgrade für den Katalog geplant.
Maschinenebene
Geplant UpgradeScheduled Für den VDA ist ein Upgrade geplant.
Upgrade erwartet UpgradeInUpgradeWindow Ein geplantes Upgrade ist aktiv, aber der VDA hat noch nicht mit dem Upgrade begonnen. Weitere Informationen zur Lastverteilung von VDA-Upgrades finden Sie unter „Parallelität“. 
-  |In Bearbeitung|UpgradeInProgress|Der VDA wird gerade aktualisiert.|
-  |Abgebrochen|UpgradeCancelled|Ein geplantes Upgrade für den VDA wurde vor Beginn des Upgrades abgebrochen.|
-  |Upgrade fehlgeschlagen|UpgradeFailed|Der VDA hat mit dem Upgrade begonnen, aber das Upgrade konnte nicht erfolgreich abgeschlossen werden. Weitere Informationen finden Sie unter „Fehlerbehebung“.|
-  |Erfolgreich|UpgradeSuccess|Der VDA wurde erfolgreich aktualisiert.|
-  |Validierung fehlgeschlagen|UpgradeValidationFailed|Die Zertifikatsvalidierung ist beim Herunterladen der Metadaten für das VDA-Installationsprogramm fehlgeschlagen.|
- Empty Für den VDA ist kein Upgrade geplant.

Fehlerbehebung bei geplanten VDA-Upgrades

Wenn bei Upgrades Fehler auftreten, können Ihnen die folgenden Protokolle bei der Identifizierung und Behebung der Probleme helfen. Sie können diese Protokolle auch an den technischen Support von Citrix weiterleiten, um den Supportprozess zu beschleunigen.

VDA-Installationsprotokolle

Wenn Sie Probleme bei Upgrades beheben, sammeln und überprüfen Sie die Protokolle sowohl für die Erstinstallation des VDA als auch für das fehlgeschlagene Upgrade. Protokolle für Installation und Upgrades finden Sie an den folgenden Speicherorten.

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

Version des VDA-Upgrade-Agenten

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 Versionen des VDA-Upgrade-Agenten 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, 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 im Zusammenhang mit dem VDA-Upgrade-Agenten

VDA-Upgrade-Agent (VUA)-Protokolle können wichtige Informationen zur Fehlerbehebung bei Upgrade-Fehlern und Problemen bei der Kommunikation des VUA mit dem VDA-Upgradeservice liefern. Die von Ihnen erfassbaren Protokolle umfassen:

  • 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.

Für VUA-Versionen 7.44 und höher

In der VDA Upgrade Service Agent-Version 7.44 (enthalten in Release 2503) ist eine Registrierungseinstellung verfügbar, die es Administratoren ermöglicht, eine rotierende Protokolldatei zu aktivieren, die kritische 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 einer Datei zu aktivieren:

  • Schlüssel:

[[CODE_BLOCK_0]]

  • 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 -Name LogToFile -Value 1 -PropertyType DWord -Force

Um LogToFile für Maschinengruppen im großen Maßstab zu aktivieren, sollten Sie die Erstellung des LogToFile-Registrierungseintrags auf allen VDA-Organisationseinheiten (OUs) über Gruppenrichtlinienpräferenzen in Betracht ziehen.

Hinweis:

  • Wenn LogToFile=1 festgelegt ist, werden Protokolle nur in die Datei geschrieben. Sie werden nicht in den CDF-Traces angezeigt.
  • Ein 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.

Für VUA-Versionen vor 7.43

Bei Bedarf können Sie die Konfigurationsdatei des VDA Upgrade Agent ändern, sodass die Protokolle kontinuierlich in eine Datei geschrieben werden. Um die Protokollierung in eine Datei zu aktivieren, führen Sie die folgenden Schritte aus:

  1. Navigieren Sie zum Ordner C:\Program Files\Citrix\CitrixUpgradeAgent.
  2. Öffnen Sie die Datei Citrix.UpdateServices.UpdateAgent.exe.config.
  3. Ändern Sie den Wert von LogToFile in 1.
  4. Starten Sie den Citrix VDA Upgrade Agent-Dienst neu. Dadurch wird eine Protokolldatei unter C:\ProgramData\Citrix\Update Services\Logs erstellt.

Hinweis:

  • Das Aktivieren der Protokollierung in eine Datei über die .config-Datei schreibt kontinuierlich Protokolle und kann potenziell Speicherplatz belegen. Denken Sie daran, die Protokollierung zu deaktivieren, nachdem das Problem behoben wurde. Um die Protokollierung zu deaktivieren, setzen Sie zuerst LogToFile auf 0 und starten Sie dann den Citrix VDA Upgrade Agent-Dienst neu.
  • Wenn LogToFile=1 festgelegt ist, werden Protokolle nur in die Datei geschrieben. Sie werden nicht in den CDF-Traces angezeigt.

Beheben von Fehlern beim VDA-Upgrade-Download

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

  1. Stellen Sie sicher, dass relevante URLs zur Positivliste hinzugefügt wurden, falls eine URL-Filterung vorhanden ist. Siehe VDA-Upgrade-Anforderungen.

  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 Sie die folgende Fehlermeldung sehen: „Download Failed: This access control list is not in canonical form and therefore cannot be modified“, 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 einen der folgenden Schritte 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.

Beheben von Fehlern bei der VDA-Upgrade-Validierung

Führen Sie die folgenden Schritte aus, um Downloadfehler im Zusammenhang mit der VDA-Upgrade-Funktion 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-Anforderungen.

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

Wir empfehlen, CDF-Tracing 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. Überprüfen Sie den Abschnitt VDAs mit Proxy-Konfigurationen, um Ihre VDA-Proxys für ausgehende CRL-Aufrufe zu konfigurieren.

Überwachung und Fehlerbehebung
May 4, 2026
Beitrag von: 
C
May 4, 2026
Beitrag von: 
C

In diesem Artikel

Feedback zur Site | Your privacy choices footer linkIhre Datenschutzauswahl | Datenschutz und rechtliche Bestimmungen | Cookie-Einstellungen | Einstellungen für die Zustimmung | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.