Udostępnij przez

Rozwiązywanie problemów związanych z usługą AKS Arc za pomocą narzędzia pomocy technicznej

Narzędzie do obsługi to moduł programu PowerShell, który zapewnia funkcje diagnostyczne i korygowania dla środowisk usługi AKS Arc. Przed otwarciem wniosku o pomoc techniczną możesz uruchomić określone polecenia w tym module, aby pomóc zdiagnozować i potencjalnie rozwiązać problemy.

Korzyści

Narzędzie pomocy technicznej używa prostych poleceń do identyfikowania problemów bez wiedzy specjalistycznej. Narzędzie zapewnia:

  • Poprawki problemów z instalacją i uaktualnianiem: identyfikuje i próbuje rozwiązać typowe problemy występujące podczas procesu instalacji i uaktualniania.
  • Testy diagnostyczne: zapewnia testy kondycji diagnostycznej na podstawie typowych problemów, zdarzeń i danych telemetrycznych.
  • Włącza funkcję puli węzłów systemu Windows: umożliwia użytkownikom włączanie pul węzłów systemu Windows i pobieranie wymaganych dysków VHD przed utworzeniem pul węzłów systemu Windows.
  • Regularne aktualizacje: aktualizacje za pomocą nowych testów i przydatnych poleceń do zarządzania, rozwiązywania i diagnozowania problemów w usłudze AKS Arc.

Typowe problemy, w których narzędzie pomocy technicznej może pomóc

Należy uruchomić polecenia, jeśli wystąpi którykolwiek z następujących objawów:

  • Uaktualnienie rozwiązania kończy się niepowodzeniem w stanie binarnym MOC.
  • Aktualizacja rozwiązania kończy się niepowodzeniem na etapie Arc Resource Bridge.
  • Usługa MOC nie działa online.
  • Arc Resource Bridge jest offline.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że:

  • Masz dostęp do lokalnego systemu Azure z wersji 2311 lub nowszej. System powinien być zarejestrowany na platformie Azure.
  • Masz dostęp do klienta, który może nawiązać połączenie z lokalnym środowiskiem Azure.

Połącz się z lokalną instancją platformy Azure

Wykonaj następujące kroki na kliencie, aby nawiązać połączenie z jednym z komputerów w środowisku lokalnym platformy Azure.

  1. Uruchom program PowerShell jako administrator na kliencie, którego używasz do nawiązywania połączenia z systemem.

  2. Otwórz zdalną sesję programu PowerShell na komputerze na instancji Azure Local. Uruchom następujące polecenie i po wyświetleniu monitu podaj dane uwierzytelniające dla swojego komputera.

    $cred = Get-Credential
Enter-PSSession -ComputerName "<Azure Local node IP>" -Credential $cred

    Note

    Zaloguj się przy użyciu danych logowania użytkownika do wdrożenia. Jest to konto utworzone podczas przygotowywania usługi Active Directory i używane do wdrażania usługi Azure Local.

    Rozwiń tę sekcję, aby wyświetlić przykładowe dane wyjściowe.

    Oto przykładowe dane wyjściowe:

    PS C:\Users\Administrator> $cred = Get-Credential
  
cmdlet Get-Credential at command pipeline position 1
Supply values for the following parameters:
Credential
PS C:\Users\Administrator> Enter-PSSession -ComputerName "100.100.100.10" -Credential $cred 
[100.100.100.10]: PS C:\Users\Administrator\Documents>

Installation

Aby zainstalować moduł Narzędzia obsługi, uruchom następujące polecenia:

Install-Module -Name Support.AksArc
Import-Module Support.AksArc -force

Jeśli masz już zainstalowany moduł, możesz go zaktualizować przy użyciu następującego polecenia cmdlet:

Update-Module -Name Support.AksArc

Note

Podczas importowania modułu próbuje on automatycznie zaktualizować go z galerii programu PowerShell. Możesz również zaktualizować ręcznie przy użyciu następujących metod.

Sprawdź, czy masz załadowany najnowszy moduł w bieżącym wystąpieniu, usuwając i importując moduł.

Remove-Module -Name Support.AksArc
Import-Module -Name Support.AksArc

Użyj narzędzia wsparcia AKS Arc

Ta sekcja zawiera przykłady różnych poleceń cmdlet dostępnych w narzędziu pomocy technicznej.

Note

Upewnij się, że te polecenia programu PowerShell są uruchamiane lokalnie, a nie w sesji zdalnej programu PowerShell.

Wyświetlanie dostępnych poleceń cmdlet

Aby wyświetlić listę dostępnych poleceń cmdlet w module programu PowerShell, uruchom następujące polecenie cmdlet:

Get-Command -Module Support.AksArc

Przeprowadzanie testów diagnostycznych

W celu wykrywania typowych problemów można przeprowadzić kontrolę kondycji diagnostycznej w systemie:

Test-SupportAksArcKnownIssues

Następujące przykładowe dane wyjściowe polecenia Test-SupportAksArcKnownIssues pokazują wyniki testu, który zakończył się niepowodzeniem:

Test Name                                                  Status Message
---------                                                  --------------
Validate Failover Cluster Service Responsiveness           Passed Failover Cluster service is responsive.
Validate Missing MOC Cloud Agents                          Passed No missing MOC cloud agents found.
Validate MOC Cloud Agent Running                           Passed MOC Cloud Agent is running
Validate Missing MOC Node Agents                           Passed All MOC nodes have the Node Agent service installed and healthy.
Validate Missing MOC Host Agents                           Passed All nodes have MOC host agents installed and healthy
Validate MOC is on Latest Patch Version                    Failed MOC is not on the latest patch version. Current: 1.15.5.10626, Latest: 1.15.7.10719
Validate Expired Certificates                              Passed No expired certificates found
Validate MOC Nodes Not Active                              Passed All MOC nodes are in the 'Active' state
Validate Multiple MOC Cloud Agent Instances                Passed No multiple instances of MOC Cloud Agent found
Validate Windows Event Log Running                         Passed Windows Event Log is running
Validate Gallery Image Stuck In Deleting                   Passed No gallery images are stuck in deleting state
Validate Virtual Machine Stuck In Pending                  Passed No virtual machines are stuck in pending state
Validate Virtual Machine Management Service Responsiveness Passed Virtual Machine Management service is responsive

Następujące przykładowe dane wyjściowe pokazują pomyślny wynik dla wszystkich testów:

Test Name                                                  Status Message
---------                                                  --------------
Validate Failover Cluster Service Responsiveness           Passed  Failover Cluster service is responsive.
Validate Missing MOC Cloud Agents                          Passed  No missing MOC cloud agents found.
Validate MOC Cloud Agent Running                           Passed  MOC Cloud Agent is running
Validate Missing MOC Node Agents                           Passed  All MOC nodes have the Node Agent service installed and healthy.
Validate Missing MOC Host Agents                           Passed  All nodes have MOC host agents installed and healthy.
Validate MOC is on Latest Patch Version                    Passed  MOC is on the latest patch version.
Validate Expired Certificates                              Passed  No expired certificates found.
Validate MOC Nodes Not Active                              Passed  All NMC nodes are in the 'Active' state.
Validate NMC Nodes Sync with Cluster Nodes                 Passed  All NMC nodes are in sync with cluster nodes.
Validate Multiple NMC Cloud Agent Instances                Passed  No multiple instances of NMC Cloud Agent found.
Validate NMC Powershell Not Stuck in Updating              Passed  NMC Powershell is not stuck in updating state.
Validate Windows Event Log Running                         Passed  Windows Event Log is running
Validate Gallery Image Stuck In Deleting                   Passed  No gallery images are stuck in deleting state.
Validate Virtual Machine Stuck In Pending                  Passed  No virtual machines are stuck in pending state.
Validate Virtual Machine Management Service Responsiveness Passed  Virtual Machine Management service is responsive.

Korygowanie typowych problemów

To polecenie testuje i rozwiązuje znane problemy z daną wersją rozwiązania:

Invoke-SupportAksArcRemediation

Włączanie funkcji puli węzłów systemu Windows

To polecenie umożliwia funkcję puli węzłów dla Windows w klastrze AKS Arc.

Invoke-SupportAksArcRemediation_EnableWindowsNodepool -Verbose

Wyłącz funkcję puli węzłów Windows

To polecenie wyłącza funkcję puli węzłów Windows w klastrze AKS Arc. Przed uruchomieniem tego polecenia upewnij się, że w klastrze nie są uruchomione pule węzłów systemu Windows:

Invoke-SupportAksArcRemediation_DisableWindowsNodepool -Verbose

Dalsze kroki

Użyj narzędzia do sprawdzania diagnostycznego, aby zidentyfikować typowe problemy ze środowiskiem

  • Last updated on