Felsöka problem med VM-tillägg på Azure Arc-aktiverade servrar

Den här artikeln innehåller information om hur du felsöker och löser problem som kan uppstå vid försök att distribuera eller ta bort Tillägg för virtuella Azure-datorer på Azure Arc-aktiverade servrar. Allmän information finns i Tilläggshantering för virtuella datorer med Azure Arc-aktiverade servrar.

Allmän felsökning

Data om tillståndet för tilläggsdistributioner kan hämtas från Azure-portalen genom att välja den aktuella datorn och sedan välja Inställningar > Tillägg.

Prova följande steg för allmän felsökning. De här stegen gäller för alla VM-tillägg.

1. Kontrollera att Azure Connected Machine-agenten (azcmagent) är ansluten och att de beroende tjänsterna körs/är aktiva.

   azcmagent show Kör kommandot och kontrollera utdata för statusen (Azure Arc Proxy kan ignoreras):

   Skärmbild av tabellen som visar statusen för beroende tjänster som är igång eller avbrutna.

   Om andra tjänster än Azure Arc Proxy stoppas startar du om dem för att återuppta tilläggsåtgärderna.

2. Försök installera tillägget igen.

   Tillägg kan fastna i Misslyckade eller andra tillstånd av olika skäl. Om ett tilläggs status inte visas som Lyckades tar du bort tillägget och installerar det igen. Följande Azure PowerShell-kommando kan användas för att ta bort ett tillägg:

   Remove-AzConnectedMachineExtension -Name <Extension Name> -ResourceGroupName <RG Name> -MachineName <Machine Name>
   

3. Kontrollera gästagentloggen och granska aktiviteten från när tillägget etablerades. För Windows, kontrollera i %SystemDrive%\ProgramData\GuestConfig\ext_mgr_logs, och för Linux, kontrollera i /var/lib/GuestConfig/ext_mgr_logs.

4. Mer information finns i tilläggsloggarna för det specifika tillägget.

   För Windows-datorer:

   • Loggar lagras i C:\ProgramData\GuestConfig
   • Tilläggsinställningar och statusfiler finns i C:\Packages\Plugins

   För Linux-datorer:

   • Loggar lagras i /var/lib/GuestConfig
   • Tilläggsinställningar och statusfiler finns i C:\Packages\Plugins

   Tilläggstjänstloggar skrivs till …GuestConfig\ext_mgr_logs\gc_ext.log. Det visas fel när det gäller att ladda ned eller verifiera paketen.

5. Kontrollera felsökningsavsnitten i den tilläggsspecifika dokumentationen för att hitta felkoder, kända problem eller andra detaljer. Du hittar dokumentation för många tillägg i tilläggstabellen.

6. Granska systemloggarna. Sök efter andra åtgärder som kan störa tillägget, till exempel en långvarig installation av ett annat program som kräver exklusiv pakethanteringsåtkomst.

Kända problemområden

HandlerManifest.json filen finns inte för tillägget

Tillägget har fastnat i ett Deleting tillstånd. I tilläggstjänstloggen (gc_ext.log) ser du följande fel:

HandlerManifest.json file does not exist for extension

Analys

Tillägget saknar filen HandlerManifest.json. Detta kan inträffa om tillägget inte har avinstallerats korrekt.

Solution

1. Om du vill ta bort tillägget använder du az connectedmachine extension delete parametrarna --extension-name, --machine-nameoch --resource-group .

2. Om tillägget fortfarande är i samma tillstånd försöker du manuellt ta bort tillägget från datorn. Vissa tillägg kan kräva ytterligare rensningssteg. Referera till extensionsspecifik dokumentation i tilläggstabellen för vidare vägledning.

   För Windows-datorer:

   • Gå till C:\Packages\Plugins\
   • Ta bort mappen som motsvarar tillägget

   För Linux-datorer:

   • Gå till /var/lib/waagent/
   • Ta bort mappen som motsvarar tillägget

3. Avinstallera tillägget från Azure och installera sedan om det.

Nästa steg

Om du inte ser problemet här eller om du inte kan lösa problemet kan du prova någon av följande kanaler för support:

• Få svar från Azure-experter genom Microsoft Q&A.
• Öppna en supportbegäran för att få hjälp. Mer information finns i Skapa en Azure-supportbegäran.