Probleemoplossingsgids voor Apparaatupdates voor IoT Hub

Dit document bevat enkele veelgestelde vragen en problemen die gebruikers van Device Update hebben gemeld. Als u een probleem ondervindt dat niet wordt weergegeven in deze gids voor probleemoplossing, raadpleegt u de sectie Contact opnemen met Microsoft Ondersteuning om uw situatie vast te leggen.

Updates importeren

V: Ik ondervind problemen bij het verbinden van mijn Device Update-exemplaar met mijn IoT Hub-exemplaar

Zorg ervoor dat uw IoT Hub berichtroutes correct zijn geconfigureerd, volgens de documentatie over Device Update-resources.

V: Ik krijg een fout met betrekking tot rollen (foutbericht in Azure Portal of een 403-API-fout)

Mogelijk zijn de toegangsmachtigingen niet juist geconfigureerd. Zorg ervoor dat u de toegangsmachtigingen correct hebt geconfigureerd volgens de documentatie voor toegangsbeheer voor Apparaatupdates .

V: Er treedt een fout van het type 500 op bij het importeren van inhoud in de Device Update-service

Een foutcode in het 500-bereik kan duiden op een probleem met de Device Update-service. Wacht 5 minuten en probeer het opnieuw. Als dezelfde fout zich blijft voordoen, volgt u de instructies in de sectie Contact opnemen met Microsoft Ondersteuning om een ondersteuningsaanvraag in te dienen bij Microsoft.

V: Ik wil dezelfde compatibiliteitseigenschappen behouden (gericht op mijn update naar hetzelfde apparaattype), maar de provider of naam wijzigen in het importmanifest. Maar ik krijg de foutmelding 'Mislukt: fout bij het importeren van update vanwege overschreden limiet' wanneer ik dit doe

Dezelfde exacte set compatibiliteitseigenschappen kan niet worden gebruikt met meer dan één combinatie van updateprovider en naam. Hierdoor kan de Device Update-service met zekerheid bepalen welke updates beschikbaar moeten zijn voor implementatie op een bepaald apparaat. Als u meerdere onderdelen of partities op één apparaat moet bijwerken, biedt de functie voor proxy-updates die mogelijkheid.

V: Er wordt een foutbericht weergegeven bij het importeren van inhoud en ik wil er graag meer over weten

Raadpleeg de documentatie over foutcodes voor apparaatupdates voor meer gedetailleerde informatie over foutberichten met betrekking tot importeren.

Apparaatfouten

V: Hoe kan ik ervoor zorgen dat mijn apparaat is verbonden met Device Update voor IoT Hub?

U kunt controleren of uw apparaat is verbonden met Device Update door te controleren of het wordt weergegeven in de sectie Niet-gegroepeerde apparaten in de nalevingsweergave van Azure Portal.

V: Een of meer van mijn apparaten kunnen niet worden bijgewerkt

Er zijn veel mogelijke hoofdoorzaken voor een fout bij het bijwerken van een apparaat. Controleer of het apparaat: 1) is verbonden met uw IoT Hub-exemplaar, 2) verbonden met uw Device Update-exemplaar en 3) de Delivery Optimization-service (DO) wordt uitgevoerd. Als alle drie waar zijn voor uw apparaat, volgt u de instructies in de sectie Contact opnemen met Microsoft Ondersteuning om een ondersteuningsaanvraag in te dienen bij Microsoft.

V: My Device Update-agent kan niet worden opgestart

Een van de meest voorkomende redenen voor een fout in het opstarten van de Device Update-agent is een onjuist configuratiebestand (du-config.json). Raadpleeg de documentatie voor het configuratiebestand en controleer of uw agent correct is geconfigureerd. Houd er rekening mee dat voor alle waarden in het configuratiebestand dubbele aanhalingstekens moeten worden gebruikt.

Een update implementeren

V: Ik heb een update geïmplementeerd op mijn apparaat(en), maar de nalevingsstatus geeft aan dat deze niet van de meest recente update is. Wat moet ik doen?

Het kan tot 5 minuten duren voordat de nalevingsstatus van het apparaat is vernieuwd. Een ogenblik geduld en controleer het opnieuw.

V: De implementatiestatus van mijn apparaat is incompatibel. Wat moet ik doen?

De eigenschappen van de fabrikant en het model van een doelapparaat zijn mogelijk gewijzigd nadat het apparaat is verbonden met IoT Hub, waardoor het apparaat nu als niet compatibel wordt beschouwd met de update-inhoud van de huidige implementatie.

Controleer de ADU Core Interface om te zien welke fabrikant en welk model uw apparaat rapporteert aan de Device Update-service en zorg ervoor dat deze overeenkomt met de fabrikant en het model dat u hebt opgegeven in het importmanifest van de update-inhoud die wordt geïmplementeerd. U kunt deze eigenschappen voor een bepaald apparaat wijzigen met behulp van het configuratiebestand Device Update.

V: Ik zie dat mijn implementatie zich in de fase Actief bevindt, maar geen van mijn apparaten wordt uitgevoerd met de update. Wat moet ik doen?

Zorg ervoor dat de begindatum van uw implementatie niet in de toekomst is ingesteld. Wanneer u een nieuwe implementatie maakt, wordt de begindatum van de implementatie standaard ingesteld op de volgende dag, tenzij u deze expliciet wijzigt. U kunt wachten tot de startdatum van de implementatie is bereikt, of de doorlopende implementatie annuleren en een nieuwe implementatie met de gewenste begindatum maken.

V: Ik probeer mijn apparaten te groeperen, maar ik zie de tag niet in de vervolgkeuzelijst bij het maken van een groep

Zorg ervoor dat u de berichtroutes in uw IoT Hub correct hebt geconfigureerd volgens de documentatie over Device Update-resources. U moet uw apparaat opnieuw taggen nadat u de route hebt geconfigureerd.

Een andere hoofdoorzaak kan zijn dat u de tag hebt toegepast voordat u uw apparaat verbindt met Device Update voor IoT Hub. Zorg ervoor dat uw apparaat al is verbonden met Device Update. U kunt controleren of uw apparaat is verbonden met Device Update voor IoT Hub door te controleren of het wordt weergegeven onder 'Niet-gegroepeerde' apparaten in de nalevingsweergave. Voeg tijdelijk een tag met een andere waarde toe en voeg vervolgens de beoogde tag opnieuw toe zodra het apparaat is verbonden.

Als u Device Provisioning Service (DPS) gebruikt, moet u ervoor zorgen dat u uw apparaten tagt nadat ze zijn ingericht en niet tijdens het maken van het apparaat. Als u uw apparaat al hebt getagd tijdens de stap voor het maken van het apparaat, moet u uw apparaat tijdelijk taggen met een andere waarde nadat het is ingericht en vervolgens de beoogde tag opnieuw toevoegen.

V: Mijn implementatie is voltooid, maar sommige apparaten zijn niet bijgewerkt

Dit is mogelijk veroorzaakt door een fout aan de clientzijde op de mislukte apparaten. Raadpleeg de sectie Apparaatfouten van deze gids voor probleemoplossing.

V: Er is een fout opgetreden in de UX bij het initiëren van een implementatie

Dit kan zijn veroorzaakt door een service-/UX-fout of door een probleem met API-machtigingen. Volg de instructies in de sectie Contact opnemen met Microsoft Ondersteuning om een ondersteuningsaanvraag in te dienen bij Microsoft.

V: Ik heb een implementatie gestart, maar deze heeft geen eindstatus

Dit kan zijn veroorzaakt door een prestatieprobleem met de service, een servicefout of een clientfout. Voer de implementatie na 10 minuten opnieuw uit. Als u hetzelfde probleem ondervindt, haalt u uw apparaatlogboeken op en raadpleegt u de sectie Apparaatfouten van deze gids voor probleemoplossing. Als hetzelfde probleem zich blijft voordoen, volgt u de instructies in de sectie Contact opnemen met Microsoft Ondersteuning om een ondersteuningsaanvraag in te dienen bij Microsoft.

V: Ik ben gemigreerd van een agent op apparaatniveau naar het toevoegen van de agent als module-id op het apparaat, en mijn update wordt weergegeven als 'in uitvoering', ook al is deze toegepast op het apparaat

Dit kan zijn veroorzaakt als u de oudere agent die communiceerde via de apparaatdubbel niet hebt verwijderd. Wanneer u de Device Update-agent inricht als een module (zie procedure), vindt alle communicatie tussen het apparaat en de Device Update-service plaats via de moduledubbel. Vergeet dus niet om de moduledubbel van het apparaat te taggen bij het maken van groepen . Alle communicatie moet plaatsvinden via de moduledubbel.

Updates downloaden naar apparaten

V: Hoe kan ik een download hervatten wanneer een apparaat opnieuw verbinding heeft gemaakt na een periode waarin de verbinding is verbroken?

De download wordt automatisch hervat wanneer de verbinding binnen een periode van 24 uur wordt hersteld. Na 24 uur moet de download opnieuw worden geïnitieerd door de gebruiker.

Microsoft Connected Cache (MCC) gebruiken

V: Ik ondervind een probleem bij het implementeren van de MCC-module op mijn IoT Edge-apparaat

Raadpleeg de IoT Edge documentatie voor het implementeren van Edge-modules op IoT Edge apparaten. U kunt controleren of de MCC-module wordt uitgevoerd op uw IoT Edge-apparaat door te navigeren naarhttp://localhost:5100/Summary.

V: Een van mijn IoT-apparaten probeert een update te downloaden via MCC, maar mislukt

Er zijn verschillende problemen die ertoe kunnen leiden dat een IoT-apparaat geen verbinding kan maken met MCC. Als u het probleem wilt diagnosticeren, verzamelt u de DO-client- en Nginx-logboeken van het defecte apparaat (zie de sectie Contact opnemen met Microsoft Ondersteuning voor instructies over het verzamelen van clientlogboeken).

Uw apparaat kan mogelijk geen inhoud van internet ophalen om door te geven aan de MCC-module, omdat de URL die wordt gebruikt, niet is toegestaan. Om te bepalen of dat het zo is, moet u uw IoT Edge omgevingsvariabelen in Azure Portal controleren.

Problemen met een ontbrekend exemplaar in de Azure Portal oplossen

V: Ik zie geen exemplaar van Device Update voor IoT Hub wanneer ik het tandwielpictogram selecteer

Er zijn enkele mogelijke oorzaken voor dit probleem. Zie hieronder voor stappen voor probleemoplossing.

Een Device Update-exemplaar moet worden gekoppeld aan een Azure IoT-hub in dezelfde resourcegroep en hetzelfde abonnement. Als u uw Device Update-exemplaar of uw hub hebt verplaatst naar een andere resourcegroep of een ander abonnement, ziet u uw exemplaar mogelijk niet in de Azure Portal. U moet een van de volgende stappen uitvoeren om Device Update voor IoT Hub te blijven gebruiken:

• De verplaatste items terugzetten naar hun oorspronkelijke configuratie.
• Als u uw IoT-hub alleen van de ene resourcegroep naar een andere hebt verplaatst, wijzigt u uw Device Update-exemplaar met de nieuwe resourceId van de IoT-hub.
• Als u item(s) van het ene abonnement naar het andere hebt verplaatst, controleert u of het Device Update-account en de IoT-hub zich in hetzelfde abonnement bevinden en wijzigt u vervolgens uw Device Update-exemplaar met de nieuwe resource-id van de IoT-hub.

Er zijn ten minste machtigingen op leesniveau nodig voor zowel uw IoT-hub als uw Device Update voor IoT Hub-account om toegang te krijgen tot de functionaliteit van Device Update via de IoT Hub-ervaring in de Azure Portal.

• Machtigingen voor uw IoT Hub beheren:
  • Selecteer uw hub in de Azure Portal
  • Selecteer Toegangsbeheer (IAM) in de navigatiebalk aan de linkerkant.
  • Selecteer 'Roltoewijzing toevoegen'.
  • Selecteer een rol met ten minste leestoegang en selecteer Volgende.
  • Selecteer naast 'Leden' de optie '+Leden selecteren'.
  • Voeg uw account toe in de flyout aan de rechterkant en selecteer de knop Selecteren.
  • Selecteer 'Beoordelen en toewijzen'.
• Als u machtigingen voor uw Device Update voor IoT Hub-account wilt beheren, vraagt u de eigenaar van het account om de volgende stappen uit te voeren:
  • Selecteer uw Device Update-account in de Azure Portal.
  • Selecteer Toegangsbeheer (IAM) in de navigatiebalk aan de linkerkant.
  • Selecteer Roltoewijzing toevoegen.
  • Selecteer de rol Lezer (of een rol met gelijkwaardige machtigingen).
  • Selecteer naast Leden de optie +Leden selecteren.
  • Voeg uw account toe in de flyout aan de rechterkant en selecteer de knop Selecteren.
  • Selecteer 'Beoordelen en toewijzen'.

Meer informatie over op rollen gebaseerd toegangsbeheer voor de Device Update-service .

Contact opnemen met Microsoft-ondersteuning

Als u problemen ondervindt die niet kunnen worden opgelost met behulp van de bovenstaande veelgestelde vragen, kunt u een ondersteuningsaanvraag indienen bij Microsoft Ondersteuning via de Azure Portal-interface. Afhankelijk van de categorie waartoe u aangeeft dat uw probleem behoort, wordt u mogelijk gevraagd aanvullende gegevens te verzamelen en te delen om Microsoft Ondersteuning uw probleem te onderzoeken.

Hieronder vindt u instructies voor het verzamelen van elk gegevenstype.

U kunt getDevice gebruiken om te controleren op aanvullende informatie in het nettoladingantwoord van de API.

Daarnaast kan de volgende informatie nuttig zijn om de hoofdoorzaak van het probleem te achterhalen:

• Welk type apparaat u probeert bij te werken (IoT Edge Gateway, overig)
• Welk type Device Update-client u gebruikt (op basis van installatiekopieën, pakketten, simulator)
• Welk besturingssysteem op uw apparaat wordt uitgevoerd
• Details met betrekking tot de architectuur van uw apparaat
• Of u Device Update eerder hebt gebruikt om een apparaat bij te werken

Als u een van de bovenstaande informatie beschikbaar hebt, neemt u deze op in uw beschrijving van het probleem.

Clientlogboeken verzamelen

• Op het Raspberry Pi-apparaat vindt u hier twee sets logboeken:

  /adu/logs
  

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

• Voor de verpakte client vindt u hier de logboeken:

  /var/log/adu
  

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

• Voor de simulator vindt u de logboeken hier:

  /tmp/aduc-logs
  

Foutcodes

Mogelijk wordt u gevraagd om foutcodes op te geven bij het melden van een probleem met betrekking tot het importeren van een update, een apparaatfout of het implementeren van een update.

Foutcodes kunnen worden verkregen door te kijken naar de ADUCoreInterface-interface . Raadpleeg de documentatie over foutcodes voor apparaatupdates voor informatie over het parseren van foutcodes voor zelfdiagnose en probleemoplossing.

Tracerings-id

Mogelijk wordt u gevraagd om een tracerings-id op te geven bij het melden van een probleem met betrekking tot het importeren of implementeren van een update.

De tracerings-id voor een bepaalde gebruikersactie vindt u in het API-antwoord of in de sectie Importgeschiedenis van de gebruikersinterface Azure Portal.

Momenteel zijn tracerings-id's voor implementatieacties alleen toegankelijk via het API-antwoord.

Implementatie-id

Mogelijk wordt u gevraagd om een implementatie-id op te geven wanneer u een probleem rapporteert met betrekking tot het implementeren van een update.

De implementatie-id wordt door de gebruiker gemaakt bij het aanroepen van de API om een implementatie te initiëren.

Momenteel worden implementatie-id's voor implementaties die zijn geïnitieerd vanuit de Azure Portal gebruikersinterface automatisch gegenereerd en niet voor de gebruiker weergegeven.

naam van IoT Hub exemplaar

Mogelijk wordt u gevraagd de naam van uw IoT Hub-exemplaar op te geven wanneer u een probleem rapporteert met betrekking tot apparaatfouten of bij het implementeren van een update.

De IoT Hub naam wordt gekozen door de gebruiker wanneer deze voor het eerst wordt ingericht.

Accountnaam voor Apparaatupdate

Mogelijk wordt u gevraagd de naam van uw Device Update-account op te geven wanneer u een probleem rapporteert met betrekking tot het importeren van een update, apparaatfouten of het implementeren van een update.

De naam van het Device Update-account wordt door de gebruiker gekozen wanneer deze zich voor het eerst registreert voor de service. Meer informatie vindt u in de documentatie over Device Update-resources .

Naam van device update-exemplaar

Mogelijk wordt u gevraagd de naam van uw Device Update-exemplaar op te geven wanneer u een probleem rapporteert met betrekking tot het importeren van een update, apparaatfouten of het implementeren van een update.

De naam van het Device Update-exemplaar wordt gekozen door de gebruiker wanneer deze voor het eerst wordt ingericht. Meer informatie vindt u in de documentatie over Device Update-resources .

Apparaat-ID

Mogelijk wordt u gevraagd om een apparaat-id op te geven bij het melden van een probleem met betrekking tot apparaatfouten of het implementeren van een update.

De apparaat-id wordt gedefinieerd door de klant wanneer het apparaat voor het eerst wordt ingericht. Deze kan ook worden opgehaald uit de apparaatdubbel van het apparaat.

Id bijwerken

Mogelijk wordt u gevraagd om een update-id op te geven wanneer u een probleem rapporteert met betrekking tot het implementeren van een update.

De update-id wordt gedefinieerd door de klant bij het initiëren van een implementatie.

Nginx-logboeken

Mogelijk wordt u gevraagd om Nginx-logboeken op te geven bij het melden van een probleem met betrekking tot Microsoft Connected Cache.

ADU-conf.txt

Mogelijk wordt u gevraagd om het configuratiebestand voor apparaatupdates ('adu-conf.txt') op te geven bij het melden van een probleem met betrekking tot het implementeren van een update.

Het configuratiebestand is optioneel en wordt door de gebruiker gemaakt volgens de instructies in de configuratiedocumentatie voor Device Update .

Manifest importeren

Mogelijk wordt u gevraagd om uw manifestbestand voor importeren op te geven wanneer u een probleem rapporteert met betrekking tot het importeren of implementeren van een update.

Het importmanifest is een bestand dat door de klant is gemaakt bij het importeren van update-inhoud in de Device Update-service.

Volgende stappen

Meer informatie over foutcodes voor Device Update