Delen via

Probleemoplossingsgids voor Apparaatupdates voor IoT Hub

  • Artikel

Dit document bevat enkele veelgestelde vragen en problemen die gebruikers van Device Update hebben gemeld. Naarmate Device Update verder gaat met de openbare preview, wordt deze gids voor probleemoplossing regelmatig bijgewerkt met nieuwe vragen en oplossingen. 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.

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.

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 bereikt.

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. Mijn update wordt weergegeven als 'wordt uitgevoerd', ook al is deze toegepast op het apparaat.

_This 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.

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 met 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 getDevices 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 beperken:

  • Welk type apparaat u wilt bijwerken (Azure Percept, IoT Edge Gateway, overig)
  • Welk type Device Update-client u gebruikt (op basis van installatiekopieën, op basis van 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 hier de logboeken:

    /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 interface ADUCoreInterface . 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 stap: meer informatie over foutcodes voor Apparaatupdates