Dela via

Felsökningsguide för enhetsuppdatering för IoT Hub

Det här dokumentet innehåller några vanliga frågor och problem som användare av enhetsuppdatering har rapporterat. När enhetsuppdateringen fortsätter via den offentliga förhandsversionen uppdateras den här felsökningsguiden regelbundet med nya frågor och lösningar. Om du stöter på ett problem som inte visas i den här felsökningsguiden kan du läsa avsnittet Kontakta Microsoft Support för att dokumentera din situation.

Importera uppdateringar

F: Jag har problem med att ansluta min enhetsuppdateringsinstans till min IoT Hub-instans.

Kontrollera att dina IoT Hub-meddelandevägar är korrekt konfigurerade enligt enhetsuppdateringsresurser dokumentationen.

Du kanske inte har åtkomstbehörigheter konfigurerade på rätt sätt. Kontrollera att du har konfigurerat åtkomstbehörigheter korrekt enligt dokumentationen om åtkomstkontroll för enhetsuppdatering .

F: Jag får ett 500-liknande fel när jag importerar innehåll till enhetsuppdateringstjänsten.

En felkod i 500-intervallet kan tyda på ett problem med enhetsuppdateringstjänsten. Vänta 5 minuter och försök sedan igen. Om samma fel kvarstår följer du anvisningarna i avsnittet Kontakta Microsoft Support för att skicka en supportbegäran till Microsoft.

F: Jag vill behålla samma kompatibilitetsegenskaper (rikta min uppdatering till samma enhetstyp), men ändra providern eller namnet i importmanifestet. Men jag får felmeddelandet "Misslyckades: det gick inte att importera uppdateringen på grund av överskriden gräns" när jag gör det.

Samma exakta uppsättning kompatibilitetsegenskaper kan inte användas med fler än en kombination av uppdateringsprovider och namn. På så sätt kan enhetsuppdateringstjänsten med säkerhet avgöra vilka uppdateringar som ska vara tillgängliga för distribution till en viss enhet. Om du behöver uppdatera flera komponenter eller partitioner på en enda enhet, tillhandahåller funktionen för proxyuppdateringar denna möjlighet.

F: Jag får ett felmeddelande när jag importerar innehåll och vill veta mer om det.

Mer detaljerad information om importrelaterade felmeddelanden finns i dokumentationen Felkoder för enhetsuppdatering.

Enhetsfel

F: Hur kan jag se till att min enhet är ansluten till Enhetsuppdatering för IoT Hub?

Du kan kontrollera att enheten är ansluten till Enhetsuppdatering genom att kontrollera om den visas under avsnittet "Ogrupperade" enheter i kompatibilitetsvyn i Azure-portalen.

F: En eller flera av mina enheter kan inte uppdateras.

Det finns många möjliga grundorsaker till ett misslyckande vid enhetsuppdatering. Kontrollera att enheten är: 1) ansluten till din IoT Hub-instans, 2) ansluten till enhetsuppdateringsinstansen och 3) tjänsten Leveransoptimering (DO) körs. Om alla tre är sanna för din enhet följer du anvisningarna i avsnittet Kontakta Microsoft Support för att skicka en supportbegäran till Microsoft.

Distribuera en uppdatering

F: Jag har distribuerat en uppdatering till mina enheter, men kompatibilitetsstatusen säger att den inte finns med i den senaste uppdateringen. Vad ska jag göra?

Det kan ta upp till 5 minuter att uppdatera enhetens efterlevnadsstatus. Vänta och kontrollera sedan igen.

F: Min enhets distributionsstatus visar att den är inkompatibel, vad ska jag göra?

Tillverkarens och modellens egenskaper för en målenhet kan ha ändrats när enheten har anslutits till IoT Hub, vilket gör att enheten nu anses vara inkompatibel med uppdateringsinnehållet i den aktuella distributionen.

Kontrollera ADU Core Interface- för att se vilken tillverkare och modell enheten rapporterar till enhetsuppdateringstjänsten och kontrollera att den matchar den tillverkare och modell som du angav i importmanifestet av uppdateringsinnehållet som distribueras. Du kan ändra dessa egenskaper för en viss enhet med hjälp av konfigurationsfilen Enhetsuppdatering.

F: Jag ser att min distribution är i den "Aktiva" fasen, men ingen av mina enheter är "under uppdatering". Vad ska jag göra?

Se till att startdatumet för distributionen inte är inställt i framtiden. När du skapar en ny distribution är distributionens startdatum som standard nästa dag som ett skydd om du inte uttryckligen ändrar det. Du kan antingen vänta tills startdatumet för distributionen inträffar eller avbryta den pågående distributionen och skapa en ny distribution med önskat startdatum.

F: Jag försöker gruppera mina enheter, men jag ser inte taggen i listrutan när jag skapar en grupp.

Kontrollera att du har konfigurerat meddelandevägarna i din IoT Hub korrekt enligt enhetsuppdateringsresurser dokumentationen. Du måste tagga enheten igen när du har konfigurerat vägen.

En annan rotorsak kan vara att du använde taggen innan du anslöt enheten till Device Update för IoT Hub. Kontrollera att enheten redan är ansluten till Enhetsuppdatering. Du kan kontrollera att enheten har anslutits till Enhetsuppdatering för IoT Hub genom att se om den visas under "Ogrupperade" enheter i vyn Efterlevnad. Lägg tillfälligt till en tagg med ett annat värde och lägg sedan till den avsedda taggen igen när enheten är ansluten.

Om du använder Device Provisioning Service (DPS) ska du se till att tagga dina enheter när de har tilldelats och inte under skapande av enheter. Om du redan har taggat enheten under steget Skapa enhet måste du tillfälligt tagga enheten med ett annat värde när den har etablerats och sedan lägga till den avsedda taggen igen.

F: Min distribution slutfördes, men vissa enheter kunde inte uppdateras.

Detta kan ha orsakats av ett fel på klientsidan på de misslyckade enheterna. Se avsnittet Enhetsfel i den här felsökningsguiden.

F: Jag påträffade ett fel i användargränssnittet när jag försökte initiera en distribution.

Detta kan ha orsakats av en tjänst-/UX-bugg eller ett API-behörighetsproblem. Följ anvisningarna i avsnittet Kontakta Microsoft Support för att skicka en supportbegäran till Microsoft.

F: Jag startade en utrullning men den når inte ett slutläge.

Detta kan ha orsakats av ett problem med tjänstens prestanda, ett tjänstfel eller ett klientfel. Gör ett nytt försök att distribuera efter 10 minuter. Om du stöter på samma problem, vänligen hämta enhetsloggarna och konsultera avsnittet Enhetsfel i den här felsökningsguiden. Om samma problem kvarstår följer du anvisningarna i avsnittet Kontakta Microsoft Support för att skicka en supportbegäran till Microsoft.

F: Jag migrerade från en agent på enhetsnivå till att lägga till agenten som en modulidentitet på enheten, och min uppdatering visas som pågående trots att den har tillämpats på enheten.

Detta kan ha orsakats om du inte tog bort den äldre agenten som kommunicerade via ’enhetstvillingen’. När du etablerar enhetsuppdateringsagenten som en modul (se hur du) sker all kommunikation mellan enheten och enhetsuppdateringstjänsten via modultvillingen, så kom ihåg att tagga enhetens modultvilling när du skapar grupper och all kommunikation måste ske via modultvillingen.

Ladda ned uppdateringar till enheter

F: Hur återupptar jag en nedladdning när en enhet har återanslutit efter en period av frånkoppling?

Nedladdningen återupptas när anslutningen återställs inom 24 timmar. Efter 24 timmar måste nedladdningen initieras igen av användaren.

Använda Microsoft Connected Cache (MCC)

F: Jag stöter på ett problem när jag försöker distribuera MCC-modulen på min IoT Edge-enhet.

Se IoT Edge-dokumentationen för distribution av Edge-moduler till IoT Edge-enheter. Du kan kontrollera om MCC-modulen körs på din IoT Edge-enhet genom att gå till http://localhost:5100/Summary.

F: En av mina IoT-enheter försöker ladda ned en uppdatering via MCC, men misslyckas.

Det finns flera problem som kan orsaka att en IoT-enhet misslyckas vid anslutning till MCC. För att diagnostisera problemet samlar du in DO-klienten och Nginx-loggarna från den enhet som misslyckas (se avsnittet Kontakta Microsoft Support för instruktioner om hur du samlar in klientloggar).

Enheten kan misslyckas med att hämta innehåll från Internet för att skicka till sin MCC-modul eftersom URL:en som den använder inte är tillåten. För att avgöra om så är fallet måste du kontrollera dina IoT Edge-miljövariabler i Azure-portalen.

Kontakta Microsoft Support

Om du stöter på problem som inte kan lösas med hjälp av vanliga frågor och svar ovan kan du skicka en supportbegäran med Microsoft Support via Azure-portalens gränssnitt. Beroende på vilken kategori du anger att problemet tillhör kan du bli ombedd att samla in och dela ytterligare data för att hjälpa Microsoft Support att undersöka problemet.

Se nedan för instruktioner om hur du samlar in varje datatyp. Du kan använda getDevices för att söka efter ytterligare information i nyttolastsvaret för API:et.

Dessutom kan följande information vara användbar för att identifiera den bakomliggande orsaken till problemet:

  • Vilken typ av enhet du försöker uppdatera (Azure Percept, IoT Edge Gateway, annat)
  • Vilken enhetsuppdateringsklienttyp du använder (avbildningsbaserad, paketbaserad, simulator)
  • Vilket operativsystem din enhet kör
  • Information om enhetens arkitektur
  • Om du har använt Enhetsuppdatering för att uppdatera en enhet tidigare

Om du har någon av ovanstående information tillgänglig, inkludera den i din beskrivning av problemet.

Samla in klientloggar

  • På Raspberry Pi-enheten finns det två uppsättningar loggar som finns här:

    /adu/logs

    /var/cache/do-client-lite/log

  • För den paketerade klienten finns loggarna här:

    /var/log/adu

    /var/cache/do-client-lite/log

  • För simulatorn finns loggarna här:

    /tmp/aduc-logs

Felkoder

Du kan bli ombedd att ange felkoder när du rapporterar ett problem som rör import av en uppdatering, ett enhetsfel eller distribution av en uppdatering.

Felkoder kan hämtas genom att titta på gränssnittet ADUCoreInterface. Mer information om hur du parsar felkoder för självdiagnostik och felsökning finns i Felkoder för enhetsuppdatering dokumentationen.

Spårnings-ID

Du kan bli ombedd att ange ett spårnings-ID när du rapporterar ett problem som rör import eller distribution av en uppdatering.

Spårnings-ID:t för en viss användaråtgärd finns i API-svaret eller i avsnittet Importhistorik i Azure-portalens användargränssnitt.

För närvarande är spårnings-ID:n för distributionsåtgärder endast tillgängliga via API-svaret.

Deployments-ID

Du kan bli ombedd att ange ett distributions-ID när du rapporterar ett problem som rör distribution av en uppdatering.

Distributions-ID:t skapas av användaren när du anropar API:et för att initiera en distribution.

För närvarande genereras distributions-ID:t för distributioner som initieras från Azure-portalens användargränssnitt automatiskt och visas inte för användaren.

IoT Hub-instansnamn

Du kan bli ombedd att ange IoT Hub-instansens namn när du rapporterar ett problem som rör enhetsfel eller distribution av en uppdatering.

IoT Hub-namnet väljs av användaren när det först skapas.

Namn på enhetsuppdateringskonto

Du kan bli ombedd att ange namnet på ditt enhetsuppdateringskonto när du rapporterar ett problem som rör import av en uppdatering, enhetsfel eller distribution av en uppdatering.

Namnet på enhetsuppdateringskontot väljs av användaren när du först registrerar dig för tjänsten. Mer information finns i dokumentationen Enhetsuppdateringsresurser.

Namn på enhetsuppdateringsinstans

Du kan bli ombedd att ange namnet på enhetsuppdateringsinstansen när du rapporterar ett problem som rör import av en uppdatering, enhetsfel eller distribution av en uppdatering.

Namnet på enhetsuppdateringsinstansen väljs av användaren när den först etableras. Mer information finns i dokumentationen Enhetsuppdateringsresurser.

Enhets-ID

Du kan bli ombedd att ange ett enhets-ID när du rapporterar ett problem som rör enhetsfel eller distribution av en uppdatering.

Enhets-ID:t definieras av kunden när enheten konfigureras första gången. Den kan också hämtas från enhetens Device Twin.

Uppdaterings-ID

Du kan bli ombedd att ange ett uppdaterings-ID när du rapporterar ett problem som rör distribution av en uppdatering.

Uppdaterings-ID:t definieras av kunden när en distribution initieras.

Nginx-loggar

Du kan bli ombedd att ange Nginx-loggar när du rapporterar ett problem som rör Microsoft Connected Cache.

ADU-conf.txt

Du kan bli ombedd att ange konfigurationsfilen för enhetsuppdatering ("adu-conf.txt") när du rapporterar ett problem som rör distribution av en uppdatering.

Konfigurationsfilen är valfri och skapas av användaren enligt anvisningarna i Konfiguration av enhetsuppdatering dokumentation.

Importmanifest

Du kan bli ombedd att ange din importmanifestfil när du rapporterar ett problem som rör import eller distribution av en uppdatering.

Importmanifestet är en fil som skapats av kunden när du importerar uppdateringsinnehåll till enhetsuppdateringstjänsten.

nästa steg: Läs mer om felkoder för enhetsuppdatering