XenServer VM-Tools für Windows

XenServer VM Tools für Windows (ehemals Citrix VM Tools) bieten leistungsstarke I/O-Dienste ohne den Aufwand herkömmlicher Geräteemulation. XenServer VM Tools für Windows bestehen aus I/O-Treibern (auch bekannt als paravirtualisierte Treiber oder PV-Treiber) und dem Management Agent.

XenServer VM Tools für Windows müssen auf jeder Windows-VM installiert sein, damit die VM eine vollständig unterstützte Konfiguration hat. Eine VM funktioniert ohne sie, aber die Leistung wird beeinträchtigt.

Die Version der XenServer VM Tools für Windows wird unabhängig von der Version von Citrix Hypervisor aktualisiert. Stellen Sie sicher, dass Ihre XenServer VM Tools für Windows regelmäßig auf die neueste Version aktualisiert werden, sowohl in Ihren VMs als auch in allen Vorlagen, die Sie zum Erstellen Ihrer VMs verwenden. Weitere Informationen zur neuesten Version der Tools finden Sie unter Updates für XenServer VM Tools für Windows oder Neuigkeiten.

Installieren Sie die XenServer VM Tools

Hinweis:

Um XenServer VM Tools für Windows auf einer Windows-VM zu installieren, muss auf der VM Microsoft.NET Framework Version 4.0 oder höher ausgeführt werden.

Stellen Sie vor der Installation der XenServer VM Tools für Windows sicher, dass Ihre VM so konfiguriert ist, dass sie die I/O-Treiber von Windows Update empfängt. Windows Update ist die empfohlene Methode, um Updates für die I/O-Treiber zu erhalten. Wenn Windows Update jedoch keine verfügbare Option für Ihre VM ist, können Sie auch Aktualisierungen der E/A-Treiber über den Management Agent erhalten oder die Treiber manuell aktualisieren. Weitere Informationen finden Sie unter Aktualisieren der I/O-Treiber.

So installieren Sie die XenServer VM Tools für Windows:

1. Wir empfehlen, dass Sie einen Snapshot Ihrer VM erstellen, bevor Sie die XenServer VM Tools installieren oder aktualisieren.

2. Laden Sie die Datei XenServer VM Tools für Windows von der Citrix Hypervisor-Downloadseite herunter.

   1. Melden Sie sich bei Ihrem Citrix-Konto an, um auf die herunterladbaren Dateien zuzugreifen.
   2. Erweitern Sie die Produktabschnitte auf der Citrix Hypervisor-Downloadseite und klicken Sie auf eine beliebige unterstützte Version von Citrix Hypervisor.

   3. Gehen Sie auf der Produktseite zum Abschnitt Citrix Hypervisor Main Components.

      Die XenServer VM Tools für Windows sind in einer 32-Bit- und einer 64-Bit-Version verfügbar.

   4. Laden Sie die MSI-Datei herunter und überprüfen Sie Ihren Download anhand des angegebenen SHA256-Werts.

3. Kopieren Sie die Datei auf Ihre Windows-VM oder auf ein freigegebenes Laufwerk, auf das die Windows-VM zugreifen kann.

4. Führen Sie die managementagentxXX.msi Datei aus, um mit der Installation der XenServer VM Tools zu beginnen.

   Msiexec.exe /package managementagentxXX.msi
   

5. Befolgen Sie die Anweisungen im Installationsprogramm.

   • Folgen Sie den Anweisungen des Assistenten, um die Lizenzvereinbarung zu akzeptieren, und wählen Sie einen Zielordner aus.

   • Passen Sie die Einstellungen auf der Seite Einstellungen für Installation und Updates an. Der Citrix Hypervisor Windows Management Agent Setup-Assistent zeigt die empfohlenen Einstellungen an. Standardmäßig zeigt der Assistent die folgenden Einstellungen an:

     • Installieren Sie jetzt I/O-Treiber
     • Automatische Aktualisierungen des Verwaltungsagenten zulassen
     • Verhindern Sie automatische I/O-Treiber-Updates durch den Verwaltungsagenten
     • Anonyme Nutzungsinformationen an Citrix senden

     Wenn Sie die automatische Aktualisierung des Management Agents nicht zulassen möchten, wählen Sie Automatische Management-Agent-Updates nicht zulassen aus der Liste aus.

     Wenn Sie möchten, dass der Management Agent die I/O-Treiber automatisch aktualisiert, wählen Sie Automatische I/O-Treiberaktualisierungen durch den Management-Agenten zulassenaus. Wir empfehlen jedoch, dass Sie Windows Update verwenden, um die I/O-Treiber zu aktualisieren, nicht den Management Agent.

     Hinweis:

     Wenn Sie ausgewählt haben, I/O-Treiberaktualisierungen über den Windows Update-Mechanismus zu erhalten, erlauben Sie dem Management Agent nicht, die E/A-Treiber automatisch zu aktualisieren.

     Wenn Sie keine anonymen Nutzungsinformationen mit Citrix teilen möchten, deaktivieren Sie das Kontrollkästchen Anonyme Nutzungsinformationen an Citrix senden . Die an Citrix übertragenen Informationen enthalten die UUID der VM, die das Update anfordert. Es werden keine weiteren Informationen in Bezug auf die VM gesammelt oder an Citrix übertragen.

   • Klicken Sie auf Weiter und dann auf Installieren, um mit der Installation der XenServer VM Tools für Windows zu beginnen.

6. Starten Sie die VM neu, wenn Sie aufgefordert werden, den Installationsvorgang abzuschließen.

Hinweis:

Die XenServer VM Tools für Windows können einen Neustart mit /quiet /norestart oder /quiet /forcerestart angeben, nachdem die VM im Rahmen der Installation bereits einmal neu gestartet wurde.

E/A-Treiber werden automatisch auf einer Windows-VM installiert, die Updates von Windows Update erhalten kann. Wir empfehlen jedoch, die XenServer VM Tools für Windows zu installieren, um den Management Agent zu installieren und eine unterstützte Konfiguration beizubehalten.

Kunden, die die XenServer VM Tools für Windows oder den Management Agent über RDP installieren, sehen die Neustartaufforderung möglicherweise nicht, da sie nur in der Windows-Konsolensitzung angezeigt wird. Um sicherzustellen, dass Sie Ihre VM neu starten (falls erforderlich) und um Ihre VM in einen optimierten Zustand zu versetzen, geben Sie die Option Neustart erzwingen in RDP an. Die Option Neustart erzwingen startet die VM nur dann neu, wenn sie erforderlich ist, um die VM in einen optimierten Zustand zu versetzen.

Automatische Installation

Führen Sie einen der folgenden Befehle aus, um die XenServer VM Tools für Windows im Hintergrund zu installieren und zu verhindern, dass das System neu gestartet wird:

Msiexec.exe /package managementagentx86.msi /quiet /norestart
Msiexec.exe /package managementagentx64.msi /quiet /norestart
<!--NeedCopy-->

oder

Setup.exe /quiet /norestart
<!--NeedCopy-->

Eine nicht interaktive, aber nicht stille Installation kann erhalten werden, indem Sie Folgendes ausführen:

Msiexec.exe managementagentx86.msi /passive
Msiexec.exe managementagentx64.msi /passive
<!--NeedCopy-->

oder

Setup.exe /passive
<!--NeedCopy-->

Um die Installationseinstellungen anzupassen, verwenden Sie die folgenden Parameter mit den Befehlen für die unbeaufsichtigte Installation:

Führen Sie beispielsweise einen der folgenden Befehle aus, um eine unbeaufsichtigte Installation der Tools durchzuführen, die zukünftige automatische Management-Agent-Updates nicht zulassen und keine anonymen Informationen an Citrix senden:

Msiexec.exe /package managementagentx86.msi ALLOWAUTOUPDATE=NO IDENTIFYAUTOUPDATE=NO /quiet /norestart
Msiexec.exe /package managementagentx64.msi ALLOWAUTOUPDATE=NO IDENTIFYAUTOUPDATE=NO /quiet /norestart
<!--NeedCopy-->

Bei interaktiven, unbeaufsichtigten und passiven Installationen kann es nach dem nächsten Systemneustart zu mehreren automatisierten Neustarts kommen, bevor die XenServer VM Tools für Windows vollständig installiert sind. Dieses Verhalten ist auch bei Installationen mit dem angegebenen Flag /norestart der Fall. Bei Installationen, bei denen das Flag /norestart bereitgestellt wird, kann der erste Neustart jedoch manuell eingeleitet werden.

Die XenServer VM Tools für Windows werden standardmäßig im C:\Program Files\Citrix\XenTools Verzeichnis auf der VM installiert.

Hinweise:

• Um XenServer VM Tools für Windows auf einer Windows-VM zu installieren, muss auf der VM Microsoft.NET Framework Version 4.0 oder höher ausgeführt werden.
• Der Parameter /quiet gilt nur für die Installationsdialoge, aber nicht für die Installation des Gerätetreibers. Wenn der Parameter /quiet angegeben ist, fordert die Gerätetreiberinstallation bei Bedarf die Berechtigung zum Neustart an.
  • Wenn /quiet /norestart angegeben ist, wird das System nicht neu gestartet, nachdem die gesamte Tools-Installation abgeschlossen ist. Dieses Verhalten ist unabhängig davon, was der Benutzer im Reboot-Dialog angibt.
  • Wenn /quiet /forcerestart angegeben ist, wird das System neu gestartet, nachdem die gesamte Tools-Installation abgeschlossen ist. Dieses Verhalten ist unabhängig davon, was der Benutzer im Reboot-Dialog angibt.
  • Wenn die Gerätetreiberinstallation die Berechtigung zum Neustart anfordert, kann eine Tools-Installation mit dem angegebenen Parameter quiet weiterhin ausgeführt werden. Verwenden Sie den Task-Manager, um zu überprüfen, ob das Installationsprogramm noch läuft.

Warnung:

Die Installation oder Aktualisierung der XenServer VM Tools für Windows kann dazu führen, dass sich der Anzeigename und die ID einiger Netzwerkadapter ändern. Jede Software, die für die Verwendung eines bestimmten Adapters konfiguriert ist, muss möglicherweise nach der Installation oder dem Upgrade von XenServer VM Tools für Windows neu konfiguriert werden.

Aktualisieren Sie die XenServer VM Tools für Windows

Citrix Hypervisor verfügt über einen einfacheren Mechanismus zum automatischen Aktualisieren von E/A-Treibern (PV-Treiber) und den Management Agent für Windows-VMs. Dieser Mechanismus ermöglicht es Kunden, Updates zu installieren, sobald sie verfügbar sind.

Stellen Sie sicher, dass Ihre XenServer VM Tools für Windows regelmäßig auf die neueste Version aktualisiert werden, sowohl in Ihren VMs als auch in allen Vorlagen, die Sie zum Erstellen Ihrer VMs verwenden.

Wir empfehlen, dass Sie einen Snapshot Ihrer VM erstellen, bevor Sie die XenServer VM Tools installieren oder aktualisieren.

Wichtig:

Wenn Sie derzeit die 8.2.x.x-Treiber oder früher verwenden und die Management Agent-MSI-Datei verwenden möchten, um auf die neueste Version der Treiber zu aktualisieren, müssen Sie Device Manager verwenden, um die 8.2.x.x-Treiber von Ihrer VM zu deinstallieren, bevor Sie diese Treiber installieren. Wenn Sie diesen Schritt nicht abschließen, schlägt der MSI-Installationsvorgang fehl.

Wir empfehlen, die folgenden Einstellungen für die Aktualisierung der verschiedenen Komponenten der XenServer VM Tools für Windows zu verwenden:

1. Stellen Sie den Wert des folgenden Registrierungsschlüssels auf einen REG_DWORD-Wert von ‘3’ ein: HLKM\System\CurrentControlSet\services\xenbus_monitor\Parameters\Autoreboot
2. Stellen Sie sicher, dass Ihre VM so konfiguriert ist, dass sie I/O-Treiber von Windows Update empfängt.
3. Konfigurieren Sie den Management Agent so, dass er sich automatisch aktualisiert.

Der Abschnitt Virtualisierungsstatus auf der Registerkarte Allgemein einer VM in XenCenter gibt an, ob die VM Updates von Windows Update empfangen kann. Der Mechanismus zum Empfangen von E/A-Treiberupdates von Windows Update ist standardmäßig aktiviert. Wenn Sie keine I/O-Treiberupdates von Windows Update erhalten möchten, deaktivieren Sie Windows Update auf Ihrer VM oder geben Sie eine Gruppenrichtlinie an.

Wichtig:

Stellen Sie sicher, dass alle angeforderten VM-Neustarts im Rahmen des Updates abgeschlossen sind. Möglicherweise sind mehrere Neustarts erforderlich. Wenn alle angeforderten Neustarts nicht abgeschlossen sind, kann dies zu unerwartetem Verhalten führen.

Die folgenden Abschnitte enthalten Informationen zum automatischen Aktualisieren der I/O-Treiber und des Management Agents.

Aktualisieren Sie die I/O-Treiber

Sie können I/O-Treiber-Updates automatisch von Microsoft Windows Update erhalten, vorausgesetzt:

• Sie führen Citrix Hypervisor 8.2 Premium Edition aus oder haben Zugriff auf Citrix Hypervisor über die Berechtigung Citrix Virtual Apps and Desktops oder Citrix DaaS-Berechtigung.

• Sie haben eine Windows-VM mit XenCenter erstellt, das mit Citrix Hypervisor 8.2 ausgestellt wurde

• Windows Update ist innerhalb der VM aktiviert

• Die VM hat Zugriff auf das Internet oder kann eine Verbindung zu einem WSUS-Proxyserver herstellen.

Hinweis:

Windows Server Core unterstützt nicht die Verwendung von Windows Update zum Installieren oder Aktualisieren der I/O-Treiber. Verwenden Sie stattdessen das Installationsprogramm für XenServer VM Tools für Windows, das auf der Downloadseite von Citrix Hypervisorverfügbar ist. Die XenServer VM Tools sind als herunterladbare Komponente unter allen unterstützten Versionen von Citrix Hypervisor verfügbar. Sie müssen sich bei Ihrem Citrix-Konto anmelden, um auf diese Downloads zugreifen zu können.

Kunden können E/A-Treiber-Updates auch automatisch über den automatischen Management-Agent-Aktualisierungsmechanismus erhalten. Sie können diese Einstellung während der Installation von XenServer VM Tools für Windows konfigurieren. Weitere Informationen finden Sie unter Installieren der XenServer VM Tools für Windows.

Automatischer Neustart

Stellen Sie sicher, dass alle angeforderten VM-Neustarts im Rahmen des Updates abgeschlossen sind. Möglicherweise sind mehrere Neustarts erforderlich. Wenn alle angeforderten Neustarts nicht abgeschlossen sind, tritt möglicherweise ein unerwartetes Verhalten auf.

Sie können einen Registrierungsschlüssel festlegen, der die maximale Anzahl automatischer Neustarts angibt, die bei der Installation der Treiber über den Geräte-Manager oder Windows Update durchgeführt werden. Nachdem Sie den Xenbus-Treiber Version 9.1.1.8 oder höher installiert haben, verwenden die XenServer VM Tools für Windows die Anweisungen dieses Registrierungsschlüssels.

Um diese Funktion zu nutzen, Wir empfehlen, dass Sie so schnell wie möglich den folgenden Registrierungsschlüssel festlegen: HLKM\System\CurrentControlSet\services\xenbus_monitor\Parameters\Autoreboot. Der Wert des Registrierungsschlüssels muss eine positive Ganzzahl sein. Es wird empfohlen, die Anzahl der Neustarts im Registrierungsschlüssel auf 3 festzulegen.

Wenn dieser Registrierungsschlüssel festgelegt ist, führen die XenServer VM Tools für Windows so viele Neustarts durch, wie erforderlich sind, um die Updates abzuschließen, oder die im Registrierungsschlüssel angegebene Anzahl von Neustarts — je nachdem, welcher Wert niedriger ist.

Vor jedem Neustart kann Windows 60 Sekunden lang eine Warnung anzeigen, die vor dem bevorstehenden Neustart warnt. Sie können die Warnung verwerfen, aber diese Aktion bricht den Neustart nicht ab. Warten Sie aufgrund dieser Verzögerung zwischen den Neustarts einige Minuten nach dem ersten Neustart, bis der Neustartzyklus abgeschlossen ist.

Hinweise:

Diese Einstellung ist für Headless-Server mit statischen IP-Adressen erforderlich.

Diese automatische Neustartfunktion gilt nur für Aktualisierungen der Windows I/O-Treiber über den Geräte-Manager oder Windows Update. Wenn Sie das Management Agent-Installationsprogramm zum Bereitstellen Ihrer Treiber verwenden, ignoriert das Installationsprogramm diesen Registrierungsschlüssel und verwaltet die Neustarts der VM gemäß seinen eigenen Einstellungen.

Finden der I/O-Treiberversion

Um die Version der auf der VM installierten I/O-Treiber herauszufinden:

1. Navigieren Sie zu C:\Windows\System32\drivers.

2. Suchen Sie den Treiber aus der Liste.

3. Rechtsklicken Sie auf den Treiber und wählen Sie Eigenschaften und dann Details.

   Im Feld Dateiversion wird die Version des auf der VM installierten Treibers angezeigt.

Aktualisieren des Management-Agenten

Mit Citrix Hypervisor können Sie den Management Agent automatisch sowohl auf neuen als auch auf vorhandenen Windows-VMs aktualisieren. Standardmäßig ermöglicht Citrix Hypervisor die automatische Aktualisierung des Management Agents. Allerdings erlaubt es dem Management Agent nicht, die E/A-Treiber automatisch zu aktualisieren. Sie können die Einstellungen für das Management Agent-Update während der Installation von XenServer VM Tools für Windows anpassen. Die automatische Aktualisierung des Management Agents erfolgt nahtlos und startet die VM nicht neu. In Szenarien, in denen ein Neustart der VM erforderlich ist, wird auf der Registerkarte Konsole der VM eine Meldung angezeigt, die Benutzer über die erforderliche Aktion informiert.

Sie können die Management Agent-Updates automatisch abrufen, vorausgesetzt:

• Sie führen Citrix Hypervisor 8.2 Premium Edition aus oder haben Zugriff auf Citrix Hypervisor über die Berechtigung Citrix Virtual Apps and Desktops oder Citrix DaaS-Berechtigung.

• Sie haben XenServer VM Tools für Windows installiert, die mit Citrix Hypervisor 7.0 oder höher ausgegeben wurden

• Die Windows VM hat Zugriff auf das Internet

Finden Sie die Version des Management Agents

So ermitteln Sie die Version des Management Agents, der auf der VM installiert ist:

1. Navigieren Sie zu C:\Program Files\Citrix\XenTools.

2. Klicken Sie mit der rechten Maustaste auf XenGuestAgent aus der Liste und klicken Sie auf Eigenschaften und dann Details.

   Im Feld Dateiversion wird die Version des Management Agents angezeigt, der auf der VM installiert ist.

Verwalten automatischer Updates über die CLI

Mit Citrix Hypervisor können Sie die Befehlszeile verwenden, um die automatische Aktualisierung der I/O-Treiber und des Management Agents zu verwalten. Sie können msiexec.exe mit den in der folgenden Tabelle aufgeführten Argumenten ausführen, um anzugeben, ob die I/O-Treiber und der Management Agent automatisch aktualisiert werden. Informationen zur Installation von XenServer VM Tools für Windows mithilfe von msiexec.exe finden Sie unter Automatische Installation.

Hinweis:

Bei VMs, die entweder mit PVS oder MCS verwaltet werden, werden automatisierte Updates automatisch ausgeschaltet, wenn der Citrix Virtual Desktops VDA vorhanden ist und meldet, dass die Maschine nicht persistent ist.

Beispiel:

setup.exe  /passive /forcerestart ALLOWAUTOUPDATE=YES ALLOWDRIVERINSTALL=NO \
     ALLOWDRIVERUPDATE=NO IDENTIFYAUTOUPDATE=YES
<!--NeedCopy-->

oder

msiexec.exe /i managementagentx64.msi ALLOWAUTOUPDATE=YES ALLOWDRIVERINSTALL=NO \
    ALLOWDRIVERUPDATE=NO IDENTIFYAUTOUPDATE=YES
<!--NeedCopy-->

Umleiten der Management Agent-Aktualisierungen

Mit Citrix Hypervisor können Kunden Management Agent-Updates vor der Installation auf einen internen Webserver umleiten. Mit dieser Umleitung können Kunden die Updates überprüfen, bevor sie automatisch auf der VM installiert werden.

So leiten Sie die Management Agent-Aktualisierungen um:

Der Management Agent verwendet eine Aktualisierungsdatei, um Informationen über die verfügbaren Updates abzurufen. Der Name dieser Update-Datei hängt von der Version des Management Agents ab, die Sie verwenden:

• Verwenden Sie für Management Agent 9.2.1.35 und höher https://pvupdates.vmd.citrix.com/autoupdate.v1.json.
• Für Management Agent 9.0.0.0 bis 9.2.0.27 https://pvupdates.vmd.citrix.com/updates.v9.json.

Führen Sie die folgenden Schritte aus, um die Management Agent-Updates umzuleiten:

1. Laden Sie die Update-Datei herunter.

2. Laden Sie die Management Agent MSI-Dateien herunter, auf die in der Update-Datei

3. Laden Sie die MSI-Dateien auf einen internen Webserver hoch, auf den Ihre virtuellen Maschinen zugreifen können.

4. Aktualisieren Sie die Update-Datei, sodass sie auf die MSI-Dateien auf dem internen Webserver verweist.

5. Laden Sie die Update-Datei auf den Webserver hoch.

Automatische Updates können auch pro VM oder pro Pool umgeleitet werden. So leiten Sie Aktualisierungen auf einer Pro-VM-Basis um:

1. Öffnen Sie auf der VM als Administrator eine Eingabeaufforderung.

2. Führen Sie auf dem Computer, auf dem das Problem auftritt, den Befehl

   reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools /t REG_SZ /v update_url /d \
       url of the update file on the web server
   <!--NeedCopy-->
   

Führen Sie den folgenden Befehl aus, um die automatische Aktualisierung des Management Agents pro Pool umzuleiten:

xe pool-param-set uuid=pooluuid guest-agent-config:auto_update_url=url of the update file on the web server
<!--NeedCopy-->

Deaktivieren der Management Agent-Updates

So deaktivieren Sie die automatische Aktualisierung des Management Agents pro VM:

1. Öffnen Sie auf der VM als Administrator eine Eingabeaufforderung.

2. Führen Sie den folgenden Befehl aus:

   reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools /t REG_DWORD /v DisableAutoUpdate /d 1
   <!--NeedCopy-->
   

Um die automatische Aktualisierung des Management Agents pro Pool zu deaktivieren, führen Sie den folgenden Befehl aus:

xe pool-param-set uuid=pooluuid guest-agent-config:auto_update_enabled=false
<!--NeedCopy-->

Ändern der automatischen I/O-Treiber-Update-Einstellungen

Während der Installation von XenServer VM Tools für Windows können Sie angeben, ob der Management Agent die I/O-Treiber automatisch aktualisieren soll. Wenn Sie diese Einstellung lieber nach Abschluss des Installationsvorgangs für XenServer VM Tools für Windows aktualisieren möchten, führen Sie die folgenden Schritte aus:

1. Öffnen Sie auf der VM als Administrator eine Eingabeaufforderung.

2. Führen Sie den folgenden Befehl aus:

   reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools\AutoUpdate /t REG_SZ /v \
       InstallDrivers /d YES/NO
   <!--NeedCopy-->
   

So senden Sie anonyme Nutzungsinformationen an Citrix:

Während der Installation von XenServer VM Tools für Windows können Sie angeben, ob Sie anonyme Nutzungsinformationen an Citrix senden möchten. Wenn Sie diese Einstellung nach Abschluss des Installationsvorgangs für XenServer VM Tools für Windows aktualisieren möchten, führen Sie die folgenden Schritte aus:

1. Öffnen Sie auf der VM als Administrator eine Eingabeaufforderung.

2. Führen Sie den folgenden Befehl aus:

   reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools\AutoUpdate REG_SZ /v \
       IDENTIFYAUTOUPDATE /d YES/NO
   <!--NeedCopy-->
   

Deinstallieren Sie die XenServer VM Tools für Windows

Es wird nicht empfohlen, die XenServer VM Tools von Ihren Windows-VMs zu entfernen. Diese Tools sind erforderlich, damit Ihre Windows-VMs vollständig unterstützt werden. Wenn Sie sie entfernen, kann dies zu unerwartetem Verhalten führen. Deinstallieren Sie Ihre XenServer VM Tools nur als letzten Ausweg manuell.

Standarddeinstallation

Für eine Standarddeinstallation der XenServer VM Tools können Sie die Windows-Funktion zum Hinzufügen oder Entfernen von Programmen verwenden:

1. Erstellen Sie einen Snapshot der VM, bevor Sie beginnen.
2. Gehen Sie in der Windows-VM zu Programme hinzufügen oder entfernen.
3. Wählen Sie Citrix Hypervisor PV Tools aus und klicken Sie auf Deinstallieren.
4. Starten Sie die VM neu.

Der Befehl uninstall.exe

Bei der Deinstallation der XenServer VM Tools mithilfe der Windows-Funktion zum Hinzufügen oder Entfernen von Programmen wird die <tools-install-directory>\uninstall.exe Datei aufgerufen, um die Deinstallationsaktionen auszuführen. Sie können diesen Befehl stattdessen von einem PowerShell-Terminal oder einer Befehlszeile mit Administratorrechten aufrufen.

1. Erstellen Sie einen Snapshot der VM, bevor Sie beginnen.
2. Öffnen Sie als Administrator eine Eingabeaufforderung oder ein PowerShell-Terminal.
3. Führen Sie den Befehl <tools-install-directory>\uninstall.exe aus.
4. Starten Sie die VM neu.

Befehlsoptionen

Der Befehl uninstall.exe akzeptiert die folgenden Parameter:

• help - Zeigt Verwendungsinformationen für den Befehl an.
• log - Generiert eine Protokolldatei, die angibt, was der Befehl getan hat.
• verbose - Druckt auf die Konsole, was der Befehl bewirkt hat.
• disable - Deaktiviert Treiber, die vom Installationsprogramm MSI installiert wurden.
• force-disable - Deaktiviert die Treiber in allen Situationen.
• hidden - Löscht versteckte Geräte. Diese Geräte sind unbenutzt und wurden ersetzt, haben aber möglicherweise veraltete Registrierungseinträge hinterlassen.
• cleanup - Entfernt alte Deinstallationsprogramme aus dem Bereich Programme hinzufügen oder entfernen. Diese Deinstallationsprogramme können doppelte Einträge aus älteren Versionen der Tools enthalten.
• purge - (9.3.1 und höher) Setzt die VM auf einen sauberen Zustand zurück, wie sie vor der Installation eines Teils der XenServer VM Tools war. Weitere Informationen finden Sie unter Vollständige Deinstallation aller XenServer VM Tools-Komponenten.
• install - (9.3.1 und höher) Installiert den aktuellen Satz von I/O-Treibern und fordert bei Bedarf einen VM-Neustart auf.
• reboot- Startet die VM neu, nachdem alle anderen Befehlsoperationen abgeschlossen sind.

Vollständige Deinstallation aller XenServer VM Tools-Komponenten

Die neueste Version von XenServer VM Tools für Windows (9.3.1 und höher) enthält den Befehl. uninstall.exe purge Die Option purge in der Anwendung uninstall.exe setzt eine VM auf den Zustand zurück, bevor einer der I/O-Treiber installiert wurde. Wenn beim Upgrade Ihrer Tools auf eine neuere Version Probleme auftreten oder wenn Sie einen sauberen Status benötigen, um einen späteren Satz von Tools auf Ihrer VM zu installieren, verwenden Sie dieses Tool.

1. Erstellen Sie einen Snapshot der VM, bevor Sie beginnen.
2. Öffnen Sie als Administrator eine Eingabeaufforderung oder ein PowerShell-Terminal.
3. Führe den Befehl aus <tools-install-directory>\uninstall.exe purge verbose
4. Starten Sie die VM neu.

Nachdem Sie diesen Befehl verwendet haben, müssen Sie keine manuellen Bereinigungsschritte wie bei früheren Versionen der XenServer VM Tools ausführen. Alle Änderungen im Zusammenhang mit den XenServer VM Tools wurden entfernt.

Was entfernt die Option purge?

Wenn Sie den Befehl verwenden uninstall.exe purge, werden alle Spuren der XenServer VM Tools von Ihrer Windows-VM entfernt. Die Liste der mit diesem Befehl ausgeführten Aktionen lautet wie folgt:

• Dienstleistungen:
  • Deaktiviert alle XenServer VM Tools-Dienste, wodurch verhindert wird, dass installierte Treiber und Dienste beim Neustart gestartet werden.
  • Stoppt alle laufenden XenServer VM Tools-Dienste.
• Treiber:
  • Deinstalliert I/O-Treiber von allen Geräteknoten.
  • Deinstalliert versteckte Geräte. Diese Aktion entspricht der Aktion, die die Befehlszeilenoption hidden ausgeführt hat.
  • Deinstalliert zwischengespeicherte Treiberpakete, wodurch sie aus dem Treiberspeicher entfernt werden. Daher werden die I/O-Treiber nicht automatisch neu installiert.
• Registrierung:
  • Entfernt veraltete Registrierungsinformationen, die von Versionen der Treiber verwendet wurden, die nicht mehr unterstützt werden.
  • Löscht Schlüssel, die sich auf Tools beziehen, aus HKLM\System\CurrentControlSet\Control\Class\...
  • Löscht Schlüssel, die sich auf Werkzeuge beziehen, von HKLM\System\CurrentControlSet\Services.
  • Löscht Schlüssel, die sich auf Tools beziehen, aus HKLM\System\CurrentControlSet\Enum\...
• Dateien:
  • Löscht alle XenServer VM Tools-Treiberdateien aus C:\Windows\System32 und. C:\Windows\System32\drivers
  • Löscht XenServer VM INF Tools-Dateien von. C:\Windows\INF
  • Löscht alle veralteten Dateien, die von Versionen der Tools übrig geblieben sind, die nicht mehr unterstützt C:\Program Files\Citrix\XenToolswerden.
• Andere:
  • Löscht alte Einträge unter Programme hinzufügen oder entfernen. Diese Aktion entspricht der Aktion, die die Befehlszeilenoption cleanup ausgeführt hat.
  • Löscht einige der veralteten Statusinformationen des InstallAgents.
  • Entfernt xenfilt.sys aus den oberen Filtern. Diese Änderung verhindert, dass xenfilt.sys auf Treiberknoten geladen wird.
  • Entfernt die unplug-Schlüssel, wodurch die VM beim Neustart zu emulierten Geräten zurückkehrt.
  • Entfernt StartOverride von StorNvME. Diese Änderung erzwingt den Start von stornvme.sys beim Booten und ermöglicht die Funktion emulierter NVMe-Startgeräte (UEFI).

Was ist neu

Die Version der XenServer VM Tools für Windows wird unabhängig von der Version von Citrix Hypervisor aktualisiert. Stellen Sie sicher, dass Ihre XenServer VM Tools für Windows regelmäßig auf die neueste Version aktualisiert werden, sowohl in Ihren VMs als auch in allen Vorlagen, die Sie zum Erstellen Ihrer VMs verwenden.

XenServer VM-Tools für Windows 9.3.1

Veröffentlicht am 25. Januar 2023

Dieses Toolset enthält die folgenden Komponentenversionen:

• Installationsprogramm: 9.3.1
• Verwaltungsagent: 9.2.1.35
• xenbus: 9.1.5.54
• xeniface: 9.1.5.42
• xennet: 9.1.3.34
• xenvbd: 9.1.4.37
• xenvif: 9.1.8.58

Verbesserungen in 9.3.1

Diese Version beinhaltet die folgenden Verbesserungen:

• Verbesserungen des Hilfsprogramms uninstall.exe, einschließlich des Parameters purge. Weitere Informationen finden Sie unter Deinstallieren der XenServer VM Tools für Windows.
• Allgemeine Verbesserungen am XenServer VM Tools-Installationsprogramm.
• Allgemeine Verbesserungen der Zeichenkettenbehandlung von Registrierungsschlüsseln.

Behobene Probleme in 9.3.1

Diese Version enthält Korrekturen für die folgenden Probleme:

• Wenn die XenServer VM Tools über Windows Update aktualisiert werden, gehen manchmal die statischen IP-Einstellungen verloren und die Netzwerkeinstellungen ändern sich, um DHCP zu verwenden.
• Auf Windows-VMs können die Grant-Tabellen leicht erschöpft sein. In diesem Fall können Lese- und Schreibanforderungen fehlschlagen oder zusätzliche VIFs werden nicht korrekt aktiviert und können nicht gestartet werden.
• In seltenen Fällen kann es vorkommen, dass beim Upgrade der XenServer VM Tools für Windows der vorhandene Management Agent nicht heruntergefahren wird und das Upgrade nicht erfolgreich ist.
• Auf einer virtuellen Windows-Maschine sehen Sie möglicherweise sowohl die vorherige als auch die neueste Version der Tools oder des Management-Agents, die in Ihren installierten Programmen aufgeführt sind.
  • (VORHERIGE) Citrix XenServer Windows Management-Agent
  • (AKTUELLE) Citrix Hypervisor PV-Tools.

Frühere Releases

9.3.0

Veröffentlicht am 26. Juli 2022

Dieses Toolset enthält die folgenden Komponentenversionen:

• Installationsprogramm: 9.3.0
• Management-Agent: 9.2.0.27
• xenbus: 9.1.4.49
• xeniface: 9.1.4.34
• xennet: 9.1.3.34
• xenvbd: 9.1.3.33
• xenvif: 9.1.6.52

Diese Version beinhaltet die folgenden Verbesserungen:

• Allgemeine Verbesserungen am XenServer VM Tools-Installationsprogramm.

Diese Version enthält Korrekturen für die folgenden Probleme:

• Sicherheitssoftware blockierte sekundäre Datenträger, die als austauschbar gekennzeichnet sind, daran, dem Betriebssystem ausgesetzt zu werden, um die Datenexfiltration zu verhindern. Mit diesem Update können Sie eine VBD als nicht entfernbar kennzeichnen und diese über das Betriebssystem korrekt verfügbar machen.
• Auf einer Windows-VM ist manchmal die IP-Adresse eines SR-IOV-VIF in XenCenter nicht sichtbar.

9.2.3

Veröffentlicht am 28. April 2022

Dieses Toolset enthält die folgenden Komponentenversionen:

• Installationsprogramm: 9.2.3
• Management-Agent: 9.1.1.13
• xenbus: 9.1.3.30
• xeniface: 9.1.4.34
• xennet:
  • 9.1.1.8 (für Windows Server 2012 und Windows Server 2012 R2)
  • 9.1.2.23 (für alle anderen unterstützten Windows-Betriebssysteme)
• xenvbd: 9.1.2.20
• xenvif: 9.1.5.48

Diese Version enthält Korrekturen für die folgenden Probleme:

• In XenServer VM Tools für Windows Version 9.2.2 sind Zeitsynchronisierungsoptionen nicht verfügbar.
• Eine Rennbedingung kann dazu führen, dass Windows-VMs nach der Live-Migration auf Citrix Hypervisor 8.2 Cumulative Update 1 einen Bluescreen-Fehler anzeigen.
• Windows-VMs, auf denen Version 9.2.1 oder 9.2.2 der XenServer VM Tools installiert ist und die PVS-Ziele sind, können manchmal mit einem schwarzen Bildschirm einfrieren. Die Meldung “Guest Rx stalled” ist in den dom0-Kernelprotokollen enthalten. Dieses Problem tritt häufiger bei Poolmastern auf als bei anderen Poolmitgliedern.
• Auf einer Windows-VM mit mehr als 8 vCPUs funktioniert Receive Side Scaling möglicherweise nicht, da der Xenvif-Treiber die Umleitungstabelle nicht einrichten kann.

9.2.2

Veröffentlicht am 14. Januar 2022

Dieses Toolset enthält die folgenden Komponentenversionen:

• Installationsprogramm: 9.2.2
• Management-Agent: 9.1.1.13
• xenbus: 9.1.3.30
• xeniface: 9.1.2.22
• xennet:
  • 9.1.1.8 (für Windows Server 2012 und Windows Server 2012 R2)
  • 9.1.2.23 (für alle anderen unterstützten Windows-Betriebssysteme)
• xenvbd: 9.1.2.20
• xenvif: 9.1.3.31

Diese Version enthält Korrekturen für die folgenden Probleme:

• Während des Updates der Tools kann der Xenbus-Treiber einen Neustart veranlassen, bevor die Treiberinstallation abgeschlossen ist. Das Akzeptieren des Neustarts kann zu einem Bluescreen-Fehler in Ihrer Windows-VM führen.
• Beim Komprimieren gesammelter Diagnoseinformationen läuft das xt-bugtool-Diagnosetool nach 20 Sekunden ab. Dieses Verhalten kann dazu führen, dass die Diagnose-ZIP-Datei nicht korrekt erstellt wird.
• Das Teilen der VNC-Zwischenablage funktioniert nicht.
• Die vorherigen Versionen der Treiber wurden nicht über Windows Update veröffentlicht.

9.2.1

Veröffentlicht am 24. Juni 2021

Dieses Toolset enthält die folgenden Komponentenversionen:

• Installationsprogramm: 9.2.1
• Management-Agent: 9.1.0.10
• xenbus: 9.1.2.14
• xeniface: 9.1.1.11
• xennet: 9.1.1.8
• xenvbd: 9.1.1.8
• xenvif: 9.1.2.16

Hinweis:

Dieser Treibersatz wurde nicht über Windows Update bereitgestellt.

Diese Version enthält Korrekturen für die folgenden Probleme:

• In einigen Fällen kann der Laptop/Slate-Status der VM nicht geändert werden.
• Nach dem Neustart einer VM kann es manchmal vorkommen, dass übermäßig viele Protokollmeldungen an die Datei daemon.log gesendet werden.
• Ein Race Condition in den Treiberlastabhängigkeiten nach einem Betriebssystemupgrade kann verhindern, dass die XenServer VM Tools aktualisiert werden.
• Ein Speicherfehler kann zum Absturz von Windows-VMs führen.
• Manchmal ist die IP-Adresse eines SR-IOV-VIF in XenCenter nicht sichtbar. Um das Problem zu beheben, starten Sie den Management-Agenten im Service Manager der VM neu.
• Bei hoher Netzwerk- und Systemlast und geringen Ressourcen können bei virtuellen Computern sowohl in Citrix als auch in Treibern von Drittanbietern Bugchecks durchgeführt werden, in der Regel mit dem Code IRQL_NOT_LESS_OR_EQUAL. Dieser Fix verbessert die Netzwerkpufferung, um diese Bugchecks zu verhindern.
• Ein Upgrade der Windows-I/O-Treiber kann dazu führen, dass UEFI-VMs nicht gestartet werden und “0xC000000E” gemeldet werden. Ein erforderliches Gerät ist nicht angeschlossen oder es kann nicht darauf zugegriffen werden.””
• Bei der Installation der XenServer VM Tools nach der Deinstallation einer früheren Version der XenServer VM Tools kann ein Problem auftreten, das die folgende Fehlermeldung zurückgibt: „Dieses Gerät kann nicht gestartet werden (Code 10) (Operation failed) The requested operation was failed“.