Freigeben über

Verwenden Sie das Supporttool, um AKS Arc-bezogene Probleme zu beheben und zu lösen.

Das Supporttool ist ein PowerShell-Modul, das Diagnose- und Wartungsfunktionen für AKS Arc-Umgebungen bereitstellt. Bevor Sie eine Supportanfrage öffnen, können Sie die angegebenen Befehle in diesem Modul ausführen, um Probleme zu diagnostizieren und zu beheben.

Vorteile

Das Supporttool verwendet einfache Befehle, um Probleme ohne Expertenwissen zu identifizieren. Das Tool bietet Folgendes:

  • Korrekturen für Installations- und Upgradeprobleme: Identifiziert und versucht, häufige Probleme zu beheben, die während des Installations- und Upgradeprozesses auftreten.
  • Diagnoseprüfungen: Stellt Diagnoseprüfungen basierend auf häufigen Problemen, Vorfällen und Telemetriedaten bereit.
  • Aktiviert das Windows-Knotenpoolfeature: Ermöglicht Benutzern das Aktivieren von Windows-Knotenpools und das Herunterladen der erforderlichen VHDs vor dem Erstellen von Windows-Knotenpools.
  • Regelmäßige Updates: Updates mit neuen Prüfungen und nützlichen Befehlen zum Verwalten, Beheben und Diagnostizieren von Problemen in AKS Arc.

Häufige Probleme, bei denen das Supporttool hilfreich sein kann

Sie sollten die Befehle ausführen, wenn eines der folgenden Symptome auftritt:

  • Das Lösungsupgrade schlägt im MOC-Binärstatus fehl.
  • Das Lösungsupgrade schlägt in der Arc Resource Bridge-Phase fehl.
  • DER MOC-Dienst bleibt nicht online.
  • Arc Resource Bridge ist offline.

Voraussetzungen

Stellen Sie Folgendes sicher, bevor Sie beginnen:

  • Sie haben Zugriff auf ein lokales Azure-System, das 2311 oder höher ausführt. Das System sollte bei Azure registriert werden.
  • Sie haben Zugriff auf einen Client, der eine Verbindung mit Ihrem lokalen Azure herstellen kann.

Herstellen einer Verbindung mit Ihrer lokalen Azure-Instanz

Führen Sie die folgenden Schritte auf Ihrem Client aus, um eine Verbindung mit einem der Computer in Ihrem lokalen Azure herzustellen.

  1. Führen Sie PowerShell als Administrator auf dem Client aus, den Sie zum Herstellen einer Verbindung mit Ihrem System verwenden.

  2. Öffnen Sie eine PowerShell-Remotesitzung auf einem Computer in Ihrer lokalen Azure-Instanz. Führen Sie den folgenden Befehl aus, und geben Sie die Anmeldeinformationen für Ihren Computer an, wenn Sie dazu aufgefordert werden:

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

    Note

    Melden Sie sich mit Ihren Anmeldeinformationen für das Bereitstellungsbenutzerkonto an. Dies ist das Konto, das Sie beim Vorbereiten von Active Directory erstellt und zum Bereitstellen von Azure Local verwendet haben.

    Erweitern Sie diesen Abschnitt, um eine Beispielausgabe anzuzeigen.

    Hier ist eine Beispielausgabe:

    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

Führen Sie die folgenden Befehle aus, um das Supporttoolmodul zu installieren:

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

Wenn Sie das Modul bereits installiert haben, können Sie es mit dem folgenden Cmdlet aktualisieren:

Update-Module -Name Support.AksArc

Note

Wenn Sie das Modul importieren, wird versucht, es automatisch aus der PowerShell-Galerie zu aktualisieren. Sie können auch die folgenden Methoden manuell verwenden, um zu aktualisieren.

Stellen Sie sicher, dass das neueste Modul in die aktuelle Instanz geladen wurde, indem Sie das Modul entfernen und importieren:

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

Verwenden des AKS Arc-Support-Tools

Dieser Abschnitt enthält Beispiele für die verschiedenen Cmdlets, die im Supporttool verfügbar sind.

Note

Stellen Sie sicher, dass Sie diese PowerShell-Befehle lokal ausführen, nicht in einer PowerShell-Remotesitzung.

Anzeigen der verfügbaren Cmdlets

Führen Sie das folgende Cmdlet aus, um eine Liste der verfügbaren Cmdlets im PowerShell-Modul anzuzeigen:

Get-Command -Module Support.AksArc

Ausführen von Diagnoseüberprüfungen

Sie können eine Diagnoseintegritätsprüfung für das System durchführen, um häufige Probleme zu erkennen:

Test-SupportAksArcKnownIssues

Die folgende Beispielausgabe des Test-SupportAksArcKnownIssues Befehls zeigt die Ergebnisse eines fehlgeschlagenen Tests an:

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

Die folgende Beispielausgabe zeigt ein erfolgreiches Ergebnis für alle Tests:

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.

Beheben häufiger Probleme

Dieser Befehl testet und behebt bekannte Probleme mit einer bestimmten Lösungsversion:

Invoke-SupportAksArcRemediation

Aktiviere das Windows-Knotenpool-Feature

Mit diesem Befehl wird das Windows-Knotenpoolfeature auf Ihrem AKS Arc-Cluster aktiviert:

Invoke-SupportAksArcRemediation_EnableWindowsNodepool -Verbose

Windows-Knotenpoolfunktion deaktivieren

Mit diesem Befehl wird das Windows-Knotenpoolfeature in Ihrem AKS Arc-Cluster deaktiviert. Stellen Sie vor dem Ausführen dieses Befehls sicher, dass auf Ihrem Cluster keine Windows-Knotenpools ausgeführt werden:

Invoke-SupportAksArcRemediation_DisableWindowsNodepool -Verbose

Nächste Schritte

Verwenden des Diagnoseprüftools zum Identifizieren häufiger Umgebungsprobleme

  • Last updated on