Führen Sie den Befehl „Set-ToolsRepo“ aus.

In diesem Artikel erfahren Sie, wie Sie den Set-ToolsRepo Befehl "Ausführen" von Ende bis Ende verwenden, wie Sie die richtige GuestStore-Version der ZIP-Datei von VMware Tools herunterladen und hosten und wie Sie den Erfolg überprüfen können.

Wann der run-Befehl „Set-ToolsRepo“ verwendet wird

Verwenden Sie den Set-ToolsRepo Befehl "Ausführen", wenn Sie folgendes ausführen möchten:

• Stellen Sie eine bestimmte VMware Tools-Version für die Installation und das Upgrade von VM-Gasttools in einer Azure-VMware-Lösung privaten Cloud zur Verfügung.
• Veröffentlichen Sie zentral die GuestStore-Version der VMware Tools-ZIP-Datei an dem zentralen vSAN-Speicherort für VMware Tools, damit alle relevanten Hosts auf das Paket verweisen können.

Voraussetzungen

• Eine öffentlich zugängliche HTTP- oder HTTPS-URL, die auf die GuestStore-Version Ihrer VMware Tools ZIP-Datei verweist. Die URL muss von der Ausführungsumgebung für Azure-VMware-Lösung Run Commands aus erreichbar sein.
• Berechtigung zum Ausführen von Azure-VMware-Lösung Run-Command-Paketen im Azure-Portal für die Ziel-Private-Cloud.

Erwarteter ZIP-Inhalt

Die ZIP-Datei, die Sie hochladen, muss:

• Fügen Sie ein VMware Tools-Nutzlastverzeichnis in das erwartete Layout ein.
• Den versionierten Ordner im Abschnitt vmware/apps/vmtools/windows64/vmtools-<version>/ einfügen. Der Ordnername muss dem Format vmtools-<version> folgen (z. B vmtools-12.4.0. ).

-Validieren-Option

Die -Validate-Option aktiviert einen schreibgeschützten Audit-Modus für das VMware Tools-Repository. Wenn Sie diese Option festlegen, überprüft Set-ToolsRepo die aktuellen Metadatendateien des Datenspeichers, ohne Änderungen an Ihrer Umgebung vorzunehmen.

Wann die Option -Validate verwendet werden sollte

• Bevor Sie Set-ToolsRepo als Basiskontrolle ausführen
• Nachdem Sie ausgeführt haben Set-ToolsRepo, um zu bestätigen, dass alles synchronisiert ist
• Wenn Sie ein Problem mit dem Repository oder der Synchronisierung vermuten und eine schnelle schreibgeschützte Überprüfung durchführen möchten

Was die Option „-Validate“ überprüft

• Identifiziert alle vSAN-Datenspeicher im Software-Defined Data Center (SDDC)
• Liest Repositorymetadaten (top-level-metadata.json und version-metadata.json)
• Überprüft, ob die Metadaten und der Datenspeicherstatus konsistent und synchronisiert sind.

Ergebnisse der Option „-Validate“

• PASS: Versionen stimmen überein, und Datenspeicher werden synchronisiert.
• FAIL: Es wurde eine Nichtübereinstimmung oder Inkonsistenz erkannt.

Häufige -Validate Optionsfehler

• Metadaten stimmen nicht überein: Führen Sie Set-ToolsRepo mit einer gültigen VMware-Tools-ZIP-URL (ohne die Option -Validate) erneut aus, um das Repository neu bereitzustellen oder zu reparieren. Führen Sie dann aus Set-ToolsRepo -Validate , um zu bestätigen, dass die Metadaten synchronisiert sind.
• Der GuestStore-Pfad wurde nicht gefunden: Möglicherweise fehlt das Repository oder kann nicht darauf zugegriffen werden. Bereitstellen oder erneut initialisieren, indem Sie Set-ToolsRepo mit einer gültigen ZIP-URL ausführen (ohne die Option -Validate). Führen Sie dann aus Set-ToolsRepo -Validate , um zu überprüfen, ob das Repository vorhanden und synchronisiert ist.

VMware Tools ZIP-URL

Der Set-ToolsRepo Befehl "Ausführen" akzeptiert eine öffentlich zugängliche HTTP- oder HTTPS-URL zur GuestStore-Version der ZIP-Datei VMware Tools, die an dem zentralen vSAN-Speicherort für VMware Tools veröffentlicht wird.

Bevor der Befehl Änderungen vor sich nimmt, erfolgt die Überprüfung dieser Elemente:

• Die URL verwendet HTTP oder HTTPS und ist ein direkter Downloadlink.
• Die Datei ist ohne interaktive Authentifizierung zugänglich und kann durchgängig heruntergeladen werden.

Kompletter Workflow

1. Laden Sie die erforderliche VMware Tools-Version herunter.

   Rufen Sie die GuestStore-Version der VMware Tools-ZIP-Datei für die bestimmte Version ab, die Sie am zentralen Speicherort von vSAN für VMware Tools veröffentlichen möchten.

2. Hosten Sie die ZIP-Datei auf einer öffentlich zugänglichen HTTP- oder HTTPS-URL. Verwenden Sie beispielsweise einen beliebigen Webserver oder Objektspeicher, der die Datei ohne interaktive Authentifizierung bedienen kann.

   Geben Sie dann diese direkte Download-URL für die Verwendung mit dem Ausführungsbefehl an.

   Von Bedeutung

   Die URL muss ein direkter Downloadlink sein und ohne interaktive Authentifizierung erreichbar sein, damit der Ausführungsbefehl die ZIP-Datei abrufen kann.

3. Führen Sie den Ausführungsbefehl für Azure-VMware-Lösung Set-ToolsRepo aus. Geben Sie die ZIP-URL aus Schritt 2 an.

   Wenn der Befehl abgeschlossen ist, zeigt die Ausgabe erfolg an oder gibt eine Fehlermeldung an.

4. Das VMware Tools-Paket wird veröffentlicht.

   Die angeforderte Version ist vom zentralen vSAN-Speicherort für VMware Tools für die private Cloud verfügbar.

5. Hosts sind für die Verwendung des vSAN-Repositorys konfiguriert.

   Im Rahmen des Ausführungsbefehls werden die relevanten ESXi-Hosts in der privaten Cloud aktualisiert, um den zentralen vSAN-Speicherort als VMware Tools-Quelle zu verwenden.

Überprüfung

Führen Sie nach erfolgreicher Ausführung des Set-ToolsRepo Ausführungsbefehls die folgenden Überprüfungsschritte aus:

1. Wechseln Sie zu Ihrem vCenter-Client, und durchsuchen Sie den vSAN-Datenspeicher. Vergewissern Sie sich, dass der Versionsordner unter GuestStore/vmware/apps/vmtools/windows64/ vorhanden ist.

2. Vergewissern Sie sich, dass die richtige VMware Tools-Version verfügbar ist, um sie in einem virtuellen Gasttestcomputer (VM) zu installieren oder zu aktualisieren.

3. Wenn nach einem erfolgreichen Ausführungsbefehlsvorgang Probleme mit VMware Tools auftreten, erfassen Sie die Ausgabe des Befehls, und öffnen Sie eine Supportanfrage.

Problembehandlung

Wenn der Ausführungsbefehl fehlschlägt, sind die häufigsten kundenseitigen Ursachen:

• Die URL kann nicht öffentlich als direkter Downloadlink erreichbar sein.
• Die ZIP-Datei enthält nicht die erwartete Ordnerstruktur.

Verwenden Sie die Fehlermeldung zusammen mit den folgenden Schritten zur Problembehandlung.

URL- oder Downloadprobleme

• DIE URL kann nicht erreicht werden oder konnte nicht heruntergeladen werden. Vergewissern Sie sich, dass die URL über ein externes Netzwerk geöffnet wird und ein direkter Downloadlink ist. Stellen Sie außerdem sicher, dass für die URL keine Anmeldung, mehrstufige Authentifizierung oder zeitlich begrenzte Token erforderlich sind.
• TLS/SSL-Fehler. Stellen Sie sicher, dass der HTTPS-Endpunkt moderne TLS unterstützt und ein gültiges Zertifikat darstellt.

Probleme mit der ZIP-Struktur

• Der erwartete Ordner wurde nicht gefunden. Stellen Sie sicher, dass die ZIP-Datei enthält vmware/apps/vmtools/windows64/vmtools-<version> (einschließlich des führenden Verzeichnisses vmware/ ).
• Mehrere Versionen in einer ZIP-Datei. Hosten Sie eine ZIP-Datei, die nur die einzelne Version enthält, die Sie veröffentlichen möchten, mit einem vmtools-<version> Ordner.

Probleme mit datenspeichern

• Dienstseitiger Veröffentlichungs- oder Konfigurationsfehler. Wenn die URL- und ZIP-Struktur korrekt sind, aber der Ausführungsbefehl weiterhin fehlschlägt, erfassen Sie die vollständige Ausgabe des Befehls, und öffnen Sie eine Supportanfrage.
• Zeitweilige Fehler. Wiederholen Sie den Befehl "Ausführen", nachdem Sie bestätigt haben, dass die ZIP-URL noch gültig und erreichbar ist.

VMware Tools-Upgradeoption ist nicht verfügbar und nicht auf der aktuellen Version

Die Option VMware Tools Installieren oder Aktualisieren ist für virtuelle Maschinen in vCenter möglicherweise verfügbar (wird abgeblendet angezeigt). Diese Situation kann auftreten, wenn die VMware Tools-Repositorymetadaten im vSAN-Datenspeicher inkonsistent oder falsch sind.

Verwenden Sie für die Lösung die folgenden Verfahren.

Überprüfen von Repositorymetadaten im GuestStore

1. Wechseln Sie zu vSAN Datastore>GuestStore>vmware>apps>vmtools>windows64.

   

2. Überprüfen Sie die folgenden Dateien:

   • Metadaten der obersten Ebene: windows64/metadata.json.

     

   • Versionsspezifische Metadaten: windows64/vmtools-<version>/metadata.json.

     

Überprüfen der Metadatenkonsistenz

Die Datei auf der obersten Ebene metadata.json und die versionsspezifische metadata.json Datei sollten:

• Verwenden Sie dieselbe VMware Tools-Version.
• Seien Sie untereinander konsistent (wie in den Referenz-Screenshots dargestellt).

Wenn sie übereinstimmen, sind die Metadaten konsistent. Wenn sie nicht übereinstimmen, sind die Metadaten inkonsistent.

Beheben von Metadatenkonflikten (falls identifiziert)

Wenn die Datei auf oberster Ebene falsch ist:

1. windows64/metadata.json löschen (z. B. vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/metadata.json).

2. Laden Sie die richtige windows64/metadata.json Datei aus dem höchsten VMware Tools-Paket hoch, das Sie hochgeladen haben.

Wenn die versionsspezifische Datei falsch ist:

1. Löschen windows64/vmtools-<version>/metadata.json (z. B. vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/vmtools-<version>/metadata.json).

2. Laden Sie die richtige windows64/vmtools-<version>/metadata.json Datei aus dem höchsten VMware Tools-Paket hoch, das Sie hochgeladen haben.

Stellen Sie außerdem sicher, dass beide Metadatendateien mit der VMware Tools-Version übereinstimmen.

Auf Hostaktualisierung warten

Warten Sie, bis sich die Änderung auf alle Hosts übertragen hat. Das kann bis zu 24 Stunden dauern.

Überprüfen Sie die Auflösung

Überprüfen Sie den virtuellen Computer in vCenter erneut. Die Option "VMware Tools Installieren " oder "Upgrade " sollte jetzt verfügbar sein.

Konsistenz bestätigen (optional)

Führen Sie Set-ToolsRepo -Validate aus, um die Metadatenkonsistenz zu bestätigen.

Verwandte Inhalte

• Weitere Informationen zum Ausführen von Befehlen finden Sie unter Verwenden von Ausführungsbefehlen.