Użyj polecenia „Set-ToolsRepo run”

W tym artykule pokazano, jak używać polecenia Set-ToolsRepo run od początku do końca, jak pobrać i udostępnić właściwą wersję pliku ZIP narzędzi VMware Tools dla GuestStore oraz jak sprawdzić, czy operacja zakończyła się powodzeniem.

Kiedy należy użyć polecenia Set-ToolsRepo run

Set-ToolsRepo Użyj polecenia run, jeśli chcesz:

• Udostępnij określoną wersję narzędzi VMware Tools do instalacji i aktualizacji narzędzi gościa VM w chmurze prywatnej Rozwiązanie Azure VMware.
• Opublikuj centralnie wersję GuestStore pliku ZIP VMware Tools w centralnej lokalizacji vSAN dla VMware Tools, aby wszystkie odpowiednie hosty mogły korzystać z tego pakietu.

Wymagania wstępne

• Publicznie dostępny adres URL HTTP lub HTTPS prowadzący do wersji GuestStore pliku ZIP VMware Tools. Adres URL musi być osiągalny ze środowiska wykonawczego dla poleceń uruchamiania usługi Rozwiązanie Azure VMware.
• Uprawnienie do wykonywania pakietów poleceń uruchamiania usługi Rozwiązanie Azure VMware w portalu Azure dla docelowej chmury prywatnej.

Oczekiwana zawartość ZIP

Przesyłany plik ZIP musi:

• Dołącz katalog ładunku narzędzi VMware Tools do oczekiwanego układu.
• Umieść folder z numerem wersji w sekcji vmware/apps/vmtools/windows64/vmtools-<version>/. Nazwa folderu musi być zgodna z formatem vmtools-<version> (na przykład vmtools-12.4.0).

-Waliduj opcję

Opcja -Validate umożliwia tryb inspekcji tylko do odczytu dla repozytorium narzędzi VMware Tools. Po określeniu tej opcji Set-ToolsRepo sprawdza bieżące pliki metadanych magazynu danych bez wprowadzania żadnych zmian w środowisku.

Kiedy należy użyć opcji -Validate

• Przed uruchomieniem Set-ToolsRepo, jako sprawdzenie bazowe
• Po uruchomieniu polecenia Set-ToolsRepo, aby potwierdzić, że wszystko jest zsynchronizowane
• Jeśli podejrzewasz problem z repozytorium lub synchronizacją i chcesz szybko przeprowadzić kontrolę w trybie tylko do odczytu

Co sprawdza opcja -Validate

• Identyfikuje wszystkie magazyny danych vSAN w programowo definiowanym centrum danych (SDDC)
• Odczytuje metadane repozytorium (top-level-metadata.json i version-metadata.json)
• Sprawdza, czy stan metadanych i magazynu danych jest spójny i zsynchronizowany

Wyniki działania przełącznika -Validate

• PASS: wersje są zgodne i magazyny danych są zsynchronizowane.
• FAIL: Wykryto niezgodność lub niespójność.

Typowe błędy związane z opcją -Validate

• Niezgodność metadanych: uruchom ponownie Set-ToolsRepo z prawidłowym adresem URL pliku ZIP narzędzi VMware Tools (bez opcji -Validate), aby ponownie wdrożyć lub naprawić repozytorium. Następnie uruchom polecenie Set-ToolsRepo -Validate , aby potwierdzić, że metadane są zsynchronizowane.
• Nie znaleziono ścieżki GuestStore: Repozytorium może nie istnieć lub być niedostępne. Wdróż lub zainicjalizuj ponownie, uruchamiając Set-ToolsRepo z prawidłowym adresem URL pliku ZIP (bez opcji -Validate). Następnie uruchom polecenie Set-ToolsRepo -Validate , aby sprawdzić, czy repozytorium jest obecne i zsynchronizowane.

Adres URL pliku ZIP VMware Tools

Polecenie Set-ToolsRepo run przyjmuje publicznie dostępny adres URL HTTP lub HTTPS wskazujący na plik ZIP narzędzi VMware Tools w wersji GuestStore, który zostanie opublikowany w centralnej lokalizacji vSAN dla narzędzi VMware Tools.

Przed wprowadzeniem jakichkolwiek zmian w poleceniu następuje weryfikacja tych elementów:

• Adres URL używa protokołu HTTP lub HTTPS i jest bezpośrednim linkiem pobierania.
• Plik jest osiągalny bez uwierzytelniania interaktywnego i można go pobrać w całości.

Kompletny przepływ pracy

1. Pobierz wymaganą wersję narzędzi VMware.

   Pobierz wersję GuestStore pliku ZIP narzędzi VMware Tools dla konkretnej wersji, którą chcesz opublikować w centralnej lokalizacji vSAN dla VMware Tools.

2. Hostowanie pliku ZIP pod publicznie dostępnym adresem URL HTTP lub HTTPS. Na przykład należy użyć dowolnego serwera internetowego lub magazynu obiektów, który może obsługiwać plik bez uwierzytelniania interakcyjnego.

   Następnie podaj bezpośredni adres URL pobierania do użycia z poleceniem run.

   Ważna

   Adres URL musi być bezpośrednim linkiem pobierania i być dostępny bez uwierzytelniania interakcyjnego, aby można było pobrać plik ZIP za pomocą polecenia run.

3. Wykonaj polecenie uruchomienia rozwiązania Rozwiązanie Azure VMware Set-ToolsRepo. Podaj adres URL pliku ZIP z kroku 2.

   Po zakończeniu polecenia jego dane wyjściowe wskazują powodzenie lub komunikat o błędzie.

4. Pakiet narzędzi VMware tools jest publikowany.

   Żądana wersja jest dostępna w centralnej lokalizacji vSAN dla VMware Tools dla chmury prywatnej.

5. Hosty są skonfigurowane do korzystania z repozytorium vSAN.

   W ramach polecenia uruchamiania odpowiednie hosty ESXi w chmurze prywatnej są aktualizowane w celu używania centralnej lokalizacji vSAN jako źródła narzędzi VMware Tools.

Validation

Po pomyślnym wykonaniu polecenia Set-ToolsReporun wykonaj następujące kroki weryfikacyjne:

1. Przejdź do klienta vCenter i przeglądaj magazyn danych vSAN. Upewnij się, że folder wersji istnieje w obszarze GuestStore/vmware/apps/vmtools/windows64/.

2. Upewnij się, że dostępna jest poprawna wersja narzędzi VMware tools do zainstalowania lub uaktualnienia z poziomu maszyny wirtualnej testowej gościa.

3. Jeśli wystąpią jakiekolwiek problemy z narzędziami VMware po pomyślnym uruchomieniu operacji polecenia, przechwyć dane wyjściowe polecenia i otwórz żądanie pomocy technicznej.

Troubleshooting

Jeśli uruchomienie polecenia zakończy się niepowodzeniem, najczęstsze przyczyny po stronie klienta to:

• Adres URL nie jest publicznie dostępny jako link bezpośredniego pobierania.
• Plik ZIP nie zawiera oczekiwanej struktury folderów.

Użyj komunikatu o błędzie wraz z poniższymi krokami rozwiązywania problemów.

Problemy z adresem URL lub pobieraniem

• Adres URL nieosiągalny lub nie można pobrać. Upewnij się, że adres URL zostanie otwarty z sieci zewnętrznej i jest bezpośrednim linkiem pobierania. Upewnij się również, że adres URL nie wymaga logowania, uwierzytelniania wieloskładnikowego ani tokenów ograniczonych czasowo.
• Błąd TLS/SSL. Upewnij się, że punkt końcowy HTTPS obsługuje nowoczesny protokół TLS i prezentuje prawidłowy certyfikat.

Problemy ze strukturą ZIP

• Nie można odnaleźć oczekiwanego folderu. Upewnij się, że plik ZIP zawiera vmware/apps/vmtools/windows64/vmtools-<version> (w tym katalog wiodący vmware/ ).
• Wiele wersji w jednym pliku ZIP. Hostuj plik ZIP zawierający tylko jedną wersję, którą zamierzasz opublikować, z jednym vmtools-<version> folderem.

Problemy z magazynem danych

• Błąd publikowania lub konfiguracji po stronie usługi. Jeśli adres URL i struktura ZIP są poprawne, ale uruchomienie polecenia nadal kończy się niepowodzeniem, przechwyć pełne dane wyjściowe polecenia i otwórz żądanie pomocy technicznej.
• Sporadyczne błędy. Ponów próbę uruchomienia polecenia po potwierdzeniu, że adres URL pliku ZIP jest nadal prawidłowy i osiągalny.

Opcja uaktualnienia narzędzi VMware Tools jest niedostępna i nie jest dostępna w bieżącej wersji

Opcja Zainstaluj lub uaktualnij narzędzia VMware może być dostępna (jest wyświetlana wygaszona) dla maszyn wirtualnych w programie vCenter. Taka sytuacja może wystąpić, gdy metadane repozytorium narzędzi VMware Tools w magazynie danych vSAN są niespójne lub niepoprawne.

Aby rozwiązać ten problem, należy użyć następujących procedur.

Sprawdź metadane repozytorium w GuestStore

1. Przejdź do vSAN Datastore>GuestStore>vmware>apps>vmtools>windows64.

   

2. Sprawdź następujące pliki:

   • Metadane najwyższego poziomu: windows64/metadata.json.

     

   • Metadane specyficzne dla wersji: windows64/vmtools-<version>/metadata.json.

     

Weryfikowanie spójności metadanych

Plik główny metadata.json i plik metadata.json specyficzny dla danej wersji powinny:

• Dopasuj tę samą wersję narzędzi VMware.
• Zachowaj spójność między nimi (jak pokazano na referencyjnych zrzutach ekranu).

Jeśli są one zgodne, metadane są spójne. Jeśli nie są one zgodne, metadane są niespójne.

Naprawianie niezgodności metadanych (jeśli określono)

Jeśli plik najwyższego poziomu jest niepoprawny:

1. Usuń windows64/metadata.json (na przykład vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/metadata.json).

2. Prześlij prawidłowy plik windows64/metadata.json z pakietu VMware Tools w najwyższej wersji, który został przesłany.

Jeśli plik specyficzny dla wersji jest niepoprawny:

1. Usuń windows64/vmtools-<version>/metadata.json (na przykład vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/vmtools-<version>/metadata.json).

2. Prześlij prawidłowy plik windows64/vmtools-<version>/metadata.json z pakietu VMware Tools o najwyższej wersji, który został przesłany.

Upewnij się również, że oba pliki metadanych są zgodne z wersją narzędzi VMware Tools.

Poczekaj na odświeżenie hosta

Odczekaj, aż zmiany rozpropagują się między hostami. Może upłynąć do 24 godzin.

Sprawdź rozdzielczość

Ponownie sprawdź maszynę wirtualną w programie vCenter. Opcja Zainstaluj lub uaktualnij narzędzia VMware powinna być teraz dostępna.

Potwierdzanie spójności (opcjonalnie)

Uruchom polecenie Set-ToolsRepo -Validate , aby potwierdzić spójność metadanych.

Treści powiązane

• Aby dowiedzieć się więcej o poleceniach uruchamiania, zobacz Używanie poleceń uruchamiania.