Använd kommandot Set-ToolsRepo run

Den här artikeln visar hur du använder kommandot Set-ToolsRepo run från början till slut, hur du laddar ned och lagrar rätt GuestStore-version av VMware Tools-ZIP-filen samt hur du verifierar att det har lyckats.

När ska kommandot Set-ToolsRepo köras?

Använd körningskommandot Set-ToolsRepo när du vill:

  • Gör en specifik VMware Tools-version tillgänglig för installation och uppgradering av VM-gästverktyg i ett Azure VMware Solution privat moln.
  • Publicera GuestStore-versionen av ZIP-filen VMware Tools centralt på den centrala vSAN-platsen för VMware Tools så att alla relevanta värdar kan referera till paketet.

Förutsättningar

  • En offentligt tillgänglig HTTP- eller HTTPS-URL som pekar på GuestStore-versionen av zip-filen VMware Tools. URL:en måste kunna nås från körningsmiljön för Azure VMware Solution köra kommandon.
  • Behörighet att köra Azure VMware Solution köra kommandopaket i Azure-portalen för det privata målmolnet.

Förväntat ZIP-innehåll

Zip-filen som du laddar upp måste:

  • Inkludera en nyttolastkatalog för VMware Tools i den förväntade layouten.
  • Innehåller den versionerade mappen under avsnittet vmware/apps/vmtools/windows64/vmtools-<version>/ . Mappnamnet måste följa formatet vmtools-<version> (till exempel vmtools-12.4.0).

-Validera alternativ

Alternativet -Validate aktiverar ett skrivskyddat revisionsläge för VMware Tools-arkivet. När du anger det här alternativet Set-ToolsRepo inspekterar du de aktuella metadatafilerna för datalagret utan att göra några ändringar i din miljö.

När du ska använda alternativet -Validate

  • Innan du kör Set-ToolsRepo, som en baslinjekontroll
  • När du har kört Set-ToolsRepo, för att bekräfta att allt är synkroniserat
  • Om du misstänker ett problem med en lagringsplats eller synkronisering och vill ha en snabb kontroll i skrivskyddat läge

Vad -Validate alternativet kontrollerar

  • Identifierar alla vSAN-datalager i Software-Defined Data Center (SDDC)
  • Läser lagringsplatsens metadata (top-level-metadata.json och version-metadata.json)
  • Verifierar att metadata- och datalagertillståndet är konsekventa och synkroniserade

Resultatet av alternativet -Validate

  • PASS: Versionsmatchning och datalager är synkroniserade.
  • FAIL: En matchningsfel eller inkonsekvens identifieras.

Vanliga fel för alternativet -Validate

  • Metadatamatchningsfel: Kör Set-ToolsRepo igen med en giltig ZIP-URL för VMware Tools (utan -Validate alternativet) för att distribuera om eller reparera lagringsplatsen. Kör Set-ToolsRepo -Validate sedan för att bekräfta att metadata är synkroniserade.
  • Det gick inte att hitta sökvägen till GuestStore: Lagringsplatsen kanske saknas eller är otillgänglig. Distribuera eller initiera igen genom att köra Set-ToolsRepo med en giltig ZIP-URL (utan alternativet -Validate ). Kör Set-ToolsRepo -Validate sedan för att kontrollera att lagringsplatsen finns och synkroniseras.

ZIP-URL för VMware Tools

Körningskommandot Set-ToolsRepo accepterar en offentligt tillgänglig HTTP- eller HTTPS-URL till GuestStore-versionen av ZIP-filen VMware Tools som publiceras på den centrala vSAN-platsen för VMware Tools.

Innan kommandot gör några ändringar sker verifieringen av dessa objekt:

  • URL:en använder HTTP eller HTTPS och är en direkt nedladdningslänk.
  • Filen kan nås utan interaktiv autentisering och kan laddas ned från slutpunkt till slutpunkt.

Arbetsflöde från början till slut

  1. Ladda ned den version av VMware Tools som krävs.

    Hämta GuestStore-versionen av ZIP-filen VMware Tools för den specifika version som du vill publicera på den centrala vSAN-platsen för VMware Tools.

  2. Lagra ZIP-filen på en offentligt tillgänglig URL via HTTP eller HTTPS. Du kan till exempel använda valfri webbserver eller objektlagring som kan hantera filen utan interaktiv autentisering.

    Ange sedan den direktnedladdnings-URL:en för användning med körningskommandot.

    Viktigt!

    URL:en måste vara en direkt nedladdningslänk och kunna nås utan interaktiv autentisering så att körningskommandot kan hämta ZIP-filen.

  3. Kör kommandot Azure VMware Solution Set-ToolsRepo run. Ange ZIP-URL:en från steg 2.

    När kommandot har slutförts indikerar dess utdata att det lyckades eller innehåller ett felmeddelande.

  4. VMware Tools-paketet publiceras.

    Den begärda versionen är tillgänglig från den centrala vSAN-platsen för VMware Tools för det privata molnet.

  5. Värdar är konfigurerade för att använda vSAN-lagringsplatsen.

    Som en del av körningskommandot uppdateras de relevanta ESXi-värdarna i det privata molnet för att använda den centrala vSAN-platsen som VMware Tools-källa.

Verifiering

När körningskommandot Set-ToolsRepo har körts följer du dessa valideringssteg:

  1. Gå till vCenter-klienten och bläddra i vSAN-datalagringen. Bekräfta att versionsmappen finns under GuestStore/vmware/apps/vmtools/windows64/.

  2. Kontrollera att rätt version av VMware Tools är tillgänglig för installation eller uppgradering från en virtuell gästtestdator (VM).

  3. Om det uppstår problem med VMware Tools efter en lyckad körningskommandoåtgärd samlar du in kommandots utdata och öppnar en supportbegäran.

Felsökning

Om körningskommandot misslyckas är de vanligaste orsakerna på kundsidan:

  • URL:en kan inte nås offentligt som en direkt nedladdningslänk.
  • ZIP-filen innehåller inte den förväntade mappstrukturen.

Använd felmeddelandet tillsammans med följande felsökningssteg.

URL- eller nedladdningsproblem

  • URL:en kan inte nås eller kunde inte laddas ned. Bekräfta att URL:en öppnas från ett externt nätverk och är en direkt nedladdningslänk. Bekräfta också att URL:en inte kräver inloggning, multifaktorautentisering eller tidsbegränsade token.
  • TLS/SSL-fel. Kontrollera att HTTPS-slutpunkten stöder modern TLS och visar ett giltigt certifikat.

Problem med ZIP-struktur

  • Det går inte att hitta den förväntade mappen. Kontrollera att ZIP-filen innehåller vmware/apps/vmtools/windows64/vmtools-<version> (inklusive den inledande vmware/ katalogen).
  • Flera versioner i en ZIP-fil. Lagra en ZIP-fil som endast innehåller den version som du avser att publicera, med en vmtools-<version>-mapp.

Problem med datalager

  • Publicerings- eller konfigurationsfel på tjänstsidan. Om URL:en och ZIP-strukturen är korrekta men körningskommandot fortfarande misslyckas samlar du in kommandots fullständiga utdata och öppnar en supportbegäran.
  • Tillfälliga fel. Försök köra kommandot igen när du har bekräftat att ZIP-URL:en fortfarande är giltig och kan nås.

Uppgraderingsalternativet VMware Tools är inte tillgängligt och inte på den aktuella versionen

Alternativet Installera eller uppgradera VMware-verktyg kan vara tillgängligt (visas nedtonat) för virtuella datorer i vCenter. Den här situationen kan inträffa när VMware Tools-lagringsplatsens metadata i vSAN-datalagret är inkonsekventa eller felaktiga.

Använd följande procedurer för lösning.

Kontrollera lagringsplatsens metadata i GuestStore

  1. Gå till vSAN Datastore>GuestStore>vmware>apps>vmtools>windows64.

    Skärmbild av GuestStore-sökvägen i vSAN-dataarkivet.

  2. Kontrollera följande filer:

    • Metadata på den översta nivån: windows64/metadata.json.

      Skärmbild av metadata.json-filen på den översta nivån i windows64-katalogen.

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

      Skärmbild av den versionsspecifika metadata.json filen i mappen vmtools-version.

Verifiera metadatakonsekvens

Den översta metadata.json nivåns fil och versionsspecifika metadata.json fil bör:

  • Använd samma version av VMware Tools.
  • Var konsekvent med varandra (som du ser i referensskärmbilder).

Om de matchar är metadata konsekventa. Om de inte matchar är metadata inkonsekventa.

Åtgärda metadatamatchningsfel (om de identifieras)

Om filen på den översta nivån är felaktig:

  1. Ta bort windows64/metadata.json (till exempel vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/metadata.json).

  2. Ladda upp rätt windows64/metadata.json fil från det högsta VMware Tools-paketet som du laddade upp.

Om den versionsspecifika filen är felaktig:

  1. Ta bort windows64/vmtools-<version>/metadata.json (till exempel vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/vmtools-<version>/metadata.json).

  2. Ladda upp rätt windows64/vmtools-<version>/metadata.json fil från det högsta VMware Tools-paketet som du laddade upp.

Se också till att båda metadatafilerna matchar VMware Tools-versionen.

Vänta på värduppdatering

Tillåt att ändringen sprids mellan värdar. Det kan ta upp till 24 timmar.

Kontrollera upplösningen

Kontrollera den virtuella datorn igen i vCenter. Alternativet Installera eller uppgradera VMware-verktyg bör nu vara tillgängligt.

Kontrollera enhetlighet (valfritt)

Kör Set-ToolsRepo -Validate för att bekräfta metadatakonsekvens.

Relaterat innehåll

  • Last updated on