De opdracht Set-ToolsRepo uitvoeren gebruiken

In dit artikel leest u hoe u de Set-ToolsRepo run-opdracht van end-to-end gebruikt, hoe u de juiste GuestStore-versie van het ZIP-bestand van VMware Tools downloadt en host en hoe u geslaagd kunt valideren.

Wanneer gebruikt u de opdracht Set-ToolsRepo uitvoeren

Gebruik de Set-ToolsRepo opdracht Uitvoeren als u het volgende wilt doen:

• Maak een specifieke versie van VMware Tools beschikbaar voor installatie en upgrade van VM-gasthulpprogramma's in een Azure VMware Solution privécloud.
• Publiceer centraal de GuestStore-versie van het ZIP-bestand van VMware Tools naar de centrale vSAN-locatie voor VMware Tools, zodat alle relevante hosts naar het pakket kunnen verwijzen.

Prerequisites

• Een openbaar toegankelijke HTTP- of HTTPS-URL die verwijst naar de GuestStore-versie van uw ZIP-bestand met VMware Tools. De URL moet bereikbaar zijn vanuit de uitvoeringsomgeving voor Azure VMware Solution opdrachten uitvoeren.
• Machtiging voor het uitvoeren van Azure VMware Solution Run Command-pakketten in de Azure-portal voor de doelprivate cloud.

Verwachte ZIP-inhoud

Het ZIP-bestand dat u uploadt, moet:

• Neem een map met nettoladingen van VMware Tools op in de verwachte indeling.
• Bevat de map met versies onder de sectie vmware/apps/vmtools/windows64/vmtools-<version>/. De mapnaam moet de notatie vmtools-<version> volgen (bijvoorbeeld vmtools-12.4.0).

-Optie Valideren

De -Validate optie schakelt een alleen-lezen auditmodus in voor de VMware Tools-opslagplaats. Wanneer u deze optie opgeeft, Set-ToolsRepo inspecteert u de huidige metagegevensbestanden van het gegevensarchief zonder wijzigingen aan te brengen in uw omgeving.

Wanneer gebruikt u de optie -Validate

• Voordat u Set-ToolsRepo uitvoert, als nulmeting
• Nadat u Set-ToolsRepo hebt uitgevoerd, om te bevestigen dat alles gesynchroniseerd is
• Als u een repository- of synchronisatieprobleem vermoedt en u een snelle controle met alleen-leestoegang wilt uitvoeren

Wat de -Validate optie controleert

• Identificeert alle vSAN-gegevensarchieven in het Software-Defined Data Center (SDDC)
• Metagegevens van opslagplaatsen lezen (top-level-metadata.json en version-metadata.json)
• Controleert of de status van de metagegevens en het gegevensarchief consistent en gesynchroniseerd is

Resultaten van de optie -Validate

• PASS: Versies komen overeen en gegevensarchieven zijn gesynchroniseerd.
• FAIL: Er is een afwijking of inconsistentie gedetecteerd.

Veelvoorkomende fouten met -Validate-opties

• Metagegevens komen niet overeen: voer Set-ToolsRepo opnieuw uit met een geldige ZIP-URL van VMware Tools (zonder de -Validate optie) om de opslagplaats opnieuw te implementeren of te herstellen. Voer vervolgens uit Set-ToolsRepo -Validate om te bevestigen dat de metagegevens zijn gesynchroniseerd.
• Het pad GuestStore is niet gevonden: de opslagplaats ontbreekt of is niet toegankelijk. Implementeren of opnieuw initialiseren door uit te voeren Set-ToolsRepo met een geldige ZIP-URL (zonder de -Validate optie). Voer vervolgens uit Set-ToolsRepo -Validate om te controleren of de opslagplaats aanwezig en gesynchroniseerd is.

ZIP-URL voor VMware Tools

De Set-ToolsRepo opdracht uitvoeren accepteert een openbaar toegankelijke HTTP- of HTTPS-URL naar de GuestStore-versie van het ZIP-bestand van VMware Tools dat wordt gepubliceerd naar de centrale locatie van vSAN voor VMware Tools.

Voordat de opdracht wijzigingen aanbrengt, vindt de validatie van deze items plaats:

• De URL maakt gebruik van HTTP of HTTPS en is een directe downloadkoppeling.
• Het bestand is bereikbaar zonder interactieve verificatie en kan end-to-end worden gedownload.

Eind-tot-eind werkstroom

1. Download de vereiste versie van VMware Tools.

   Haal de GuestStore-versie van het ZIP-bestand van VMware Tools op voor de specifieke versie die u wilt publiceren naar de centrale vSAN-locatie voor VMware Tools.

2. Host de ZIP op een openbaar toegankelijke HTTP- of HTTPS-URL. Gebruik bijvoorbeeld elke webserver of objectopslag die het bestand kan verwerken zonder interactieve verificatie.

   Geef vervolgens die directe download-URL op voor gebruik met de opdracht Uitvoeren.

   Belangrijk

   De URL moet een rechtstreekse downloadkoppeling zijn en bereikbaar zijn zonder interactieve verificatie, zodat de run-opdracht het ZIP-bestand kan ophalen.

3. Voer de opdracht Azure VMware Solution Set-ToolsRepo uitvoeren uit. Geef de ZIP-URL op uit stap 2.

   Wanneer de opdracht is voltooid, geeft de uitvoer aan dat de opdracht is geslaagd of een foutbericht bevat.

4. Het VMware Tools-pakket wordt gepubliceerd.

   De aangevraagde versie is beschikbaar vanaf de centrale locatie van vSAN voor VMware Tools voor de privécloud.

5. Hosts zijn geconfigureerd voor het gebruik van de vSAN-opslagplaats.

   Als onderdeel van de run-opdracht worden de relevante ESXi-hosts in de privécloud bijgewerkt om de centrale vSAN-locatie te gebruiken als de bron van VMware Tools.

Validatie

Voer de volgende validatiestappen uit nadat de Set-ToolsRepo opdracht is uitgevoerd:

1. Ga naar uw vCenter-client en blader door het vSAN-gegevensarchief. Controleer of de versiemap bestaat onder GuestStore/vmware/apps/vmtools/windows64/.

2. Controleer of de juiste versie van VMware Tools beschikbaar is om te installeren of te upgraden vanuit een virtuele machine (VM) voor gasttests.

3. Als er problemen optreden met VMware Tools na een geslaagde opdrachtbewerking, legt u de uitvoer van de opdracht vast en opent u een ondersteuningsaanvraag.

Troubleshooting

Als de opdracht uitvoeren mislukt, zijn de meest voorkomende oorzaken aan de klantzijde:

• De URL is niet openbaar bereikbaar als een directe downloadkoppeling.
• Het ZIP-bestand bevat niet de verwachte mapstructuur.

Gebruik het foutbericht samen met de volgende stappen voor probleemoplossing.

URL- of downloadproblemen

• URL is niet bereikbaar of kan niet worden gedownload. Controleer of de URL wordt geopend vanuit een extern netwerk en dat deze een directe downloadkoppeling is. Controleer ook of voor de URL geen aanmeldings-, meervoudige verificatie of tijdlimietstokens zijn vereist.
• TLS/SSL-fout. Zorg ervoor dat het HTTPS-eindpunt moderne TLS ondersteunt en een geldig certificaat presenteert.

Problemen met ZIP-structuur

• De verwachte map is niet gevonden. Zorg ervoor dat het ZIP-bestand bevat vmware/apps/vmtools/windows64/vmtools-<version> (inclusief de toonaangevende vmware/ map).
• Meerdere versies in één ZIP-bestand. Host een ZIP-bestand met slechts één versie die u wilt publiceren, met één vmtools-<version> map.

Problemen met het gegevensarchief

• Fout bij publiceren of configureren aan de servicezijde. Als de URL- en ZIP-structuur juist zijn, maar de opdracht uitvoeren nog steeds mislukt, legt u de volledige uitvoer van de opdracht vast en opent u een ondersteuningsaanvraag.
• Onregelmatige fouten. Voer de opdracht opnieuw uit nadat u hebt bevestigd dat de ZIP-URL nog steeds geldig en bereikbaar is.

Upgradeoptie voor VMware Tools is niet beschikbaar en niet op de huidige versie

De installatie - ofupgradeoptie van VMware Tools is mogelijk beschikbaar (grijs weergegeven) voor virtuele machines in vCenter. Deze situatie kan optreden wanneer de metagegevens van de VMware Tools-opslagplaats in het vSAN-gegevensarchief inconsistent of onjuist zijn.

Gebruik de volgende procedures voor probleemoplossing.

Metagegevens van opslagplaatsen controleren in GuestStore

1. Ga naar vSAN Datastore>GuestStore>vmware-apps>>vmtools>windows64.

   

2. Controleer de volgende bestanden:

   • Metagegevens op het hoogste niveau: windows64/metadata.json.

     

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

     

Consistentie van metagegevens valideren

Het metadata.json-bestand op het hoogste niveau en het versiespecifieke metadata.json-bestand moeten:

• Komt overeen met dezelfde versie van VMware Tools.
• Consistent zijn met elkaar (zoals weergegeven in referentieschermafbeeldingen).

Als deze overeenkomen, zijn de metagegevens consistent. Als ze niet overeenkomen, zijn de metagegevens inconsistent.

Corrigeer een discrepantie in de metagegevens (indien vastgesteld)

Als het bestand op het hoogste niveau onjuist is:

1. Verwijderen windows64/metadata.json (bijvoorbeeld vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/metadata.json).

2. Upload het juiste windows64/metadata.json bestand van het hoogste VMware Tools-pakket dat u hebt geüpload.

Als het versiespecifieke bestand onjuist is:

1. Verwijderen windows64/vmtools-<version>/metadata.json (bijvoorbeeld vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/vmtools-<version>/metadata.json).

2. Upload het juiste windows64/vmtools-<version>/metadata.json bestand van het hoogste VMware Tools-pakket dat u hebt geüpload.

Zorg er ook voor dat beide metagegevensbestanden overeenkomen met de versie van VMware Tools.

Wachten op het vernieuwen van de host

Wacht even tot de wijziging zich over alle hosts heeft verspreid. Het kan tot 24 uur duren.

Controleer de resolutie

Controleer de VM opnieuw in vCenter. De installatie- ofupgradeoptie van VMware Tools moet nu beschikbaar zijn.

Consistentie bevestigen (optioneel)

Voer deze opdracht uit Set-ToolsRepo -Validate om de consistentie van metagegevens te bevestigen.

Verwante inhoud

• Zie Run-opdrachten gebruiken voor meer informatie over run-opdrachten.