Az AKS Arctal kapcsolatos problémák elhárítása és megoldása a támogatási eszközzel

A támogatási eszköz egy PowerShell-modul, amely diagnosztikai és szervizelési képességeket biztosít az AKS Arc-környezetekhez. A támogatási kérelem megnyitása előtt futtathatja a modulban megadott parancsokat a problémák diagnosztizálásához és esetleges megoldásához.

Előnyök

A támogatási eszköz egyszerű parancsokkal azonosítja a szakértői termékismeret nélküli problémákat. Az eszköz a következő lehetőségeket biztosítja:

  • Javítások a telepítési és frissítési problémákhoz: Azonosítja és megpróbálja elhárítani a telepítési és frissítési folyamat során előforduló gyakori problémákat.
  • Diagnosztikai ellenőrzések: Diagnosztikai állapot-ellenőrzéseket biztosít a gyakori problémák, incidensek és telemetriai adatok alapján.
  • Engedélyezi a Windows-csomópontkészlet funkciót: Lehetővé teszi a felhasználók számára a Windows-csomópontkészletek engedélyezését és a szükséges virtuális merevlemezek letöltését a Windows-csomópontkészletek létrehozása előtt.
  • Rendszeres frissítések: Frissítések új ellenőrzésekkel és hasznos parancsokkal az AKS Arc problémáinak kezeléséhez, hibaelhárításához és diagnosztizálásához.

Gyakori problémák, amelyekben a támogatási eszköz segíthet

Futtassa a parancsokat, ha a következő tünetek valamelyikét tapasztalja:

  • A megoldásfrissítés sikertelen az MOC bináris állapotában.
  • A megoldásfrissítés az Arc Resource Bridge szakaszában meghiúsul.
  • Az MOC szolgáltatás nem marad online.
  • Az Arc Resource Bridge offline állapotban van.

Előfeltételek

Mielőtt hozzákezd, győződjön meg az alábbiakról:

  • Hozzáféréssel rendelkezik egy Azure helyi rendszerhez, amely a 2311-es vagy annál magasabb verziót futtatja. A rendszert regisztrálni kell az Azure-ban.
  • Hozzáféréssel rendelkezik egy olyan ügyfélhez, amely csatlakozhat az Azure Local-hoz.

Csatlakozás a helyi Azure-példányhoz

Kövesse az alábbi lépéseket az ügyfélen az Azure Local egyik gépéhez való csatlakozáshoz.

  1. Azon az ügyfélen futtassa a PowerShellt rendszergazdaként, amelyet a rendszerhez való csatlakozáshoz használ.

  2. Nyisson meg egy távoli PowerShell-munkamenetet az Azure Local-példány egy gépén. Futtassa a következő parancsot, és adja meg a számítógép hitelesítő adatait, amikor a rendszer kéri:

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

    Note

    Jelentkezzen be az üzembehelyezési felhasználói fiók hitelesítő adataival. Az Active Directory előkészítésekor létrehozott és az Azure Local üzembe helyezéséhez használt fiók.

    Bontsa ki ezt a szakaszt egy példakimenet megtekintéséhez.

    Íme egy példakimenet:

    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

A Támogatási eszköz modul telepítéséhez futtassa a következő parancsokat:

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

Ha már telepítve van a modul, az alábbi parancsmaggal frissítheti:

Update-Module -Name Support.AksArc

Note

Amikor importálja a modult, a rendszer megpróbálja automatikusan frissíteni azt a PowerShell-gyűjteményből. Manuálisan is frissíthet az alábbi módszerekkel.

A modul eltávolításával és importálásával győződjön meg arról, hogy a legújabb modul van betöltve az aktuális példányba:

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

Az AKS Arc támogatási eszköz használata

Ez a szakasz a támogatási eszközben elérhető különböző parancsmagokra mutat be példákat.

Note

Győződjön meg arról, hogy ezeket a PowerShell-parancsokat helyileg futtatja, nem pedig távoli PowerShell-munkamenetben.

Elérhető parancsmagok megtekintése

A PowerShell-modulban elérhető parancsmagok listájának megtekintéséhez futtassa a következő parancsmagot:

Get-Command -Module Support.AksArc

Diagnosztikai ellenőrzések végrehajtása

Diagnosztikai állapotellenőrzést végezhet a rendszeren a gyakori problémák észleléséhez:

Test-SupportAksArcKnownIssues

A parancs alábbi példakimenete Test-SupportAksArcKnownIssues egy sikertelen teszt eredményeit mutatja be:

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

Az alábbi példakimenet az összes teszt sikeres eredményét mutatja:

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.

Gyakori problémák elhárítása

Ez a parancs teszteli és kijavítja az adott megoldásverzióval kapcsolatos ismert problémákat:

Invoke-SupportAksArcRemediation

A Windows-csomópontkészlet funkció engedélyezése

Ez a parancs engedélyezi a Windows-csomópontkészlet funkciót az AKS Arc-fürtben:

Invoke-SupportAksArcRemediation_EnableWindowsNodepool -Verbose

A Windows-csomópontkészlet funkció letiltása

Ez a parancs letiltja a Windows-csomópontkészlet funkciót az AKS Arc-fürtön. A parancs futtatása előtt győződjön meg arról, hogy nem fut Windows-csomópontkészlet a fürtön:

Invoke-SupportAksArcRemediation_DisableWindowsNodepool -Verbose

Következő lépések

A diagnosztikai ellenőrző eszköz használata a gyakori környezeti problémák azonosításához