Průvodce odstraňováním potíží s aktualizací zařízení pro IoT Hub

Tento dokument obsahuje některé běžné otázky a problémy, které uživatelé služby Device Update nahlásili. Pokud narazíte na problém, který se v tomto průvodci odstraňováním potíží nezobrazuje, podívejte se do části Kontaktování podpora Microsoftu a zdokumentujte svou situaci.

Import aktualizací

Otázka: Mám potíže s připojením instance služby Device Update k instanci IoT Hub

Ujistěte se, že jsou správně nakonfigurované trasy zpráv IoT Hub podle dokumentace k prostředkům služby Device Update.

Otázka: Dochází k chybě související s rolí (chybová zpráva v Azure Portal nebo chyba rozhraní API 403)

Možná nemáte správně nakonfigurovaná přístupová oprávnění. Ujistěte se, že máte správně nakonfigurovaná přístupová oprávnění podle dokumentace k řízení přístupu k aktualizaci zařízení .

Otázka: Při importu obsahu do služby Device Update dochází k chybě typu 500

Kód chyby v rozsahu 500 může indikovat problém se službou Device Update. Počkejte prosím 5 minut a pak to zkuste znovu. Pokud stejná chyba přetrvává, postupujte podle pokynů v části Kontaktování podpora Microsoftu a odešlete žádost o podporu společnosti Microsoft.

Otázka: Chci zachovat stejné vlastnosti kompatibility (cílit aktualizaci na stejný typ zařízení), ale změnit zprostředkovatele nebo název v manifestu importu. Když to ale udělám, zobrazí se chyba "Selhání: chyba při importu aktualizace kvůli překročení limitu".

Stejnou přesnou sadu vlastností kompatibility nelze použít s více než jednou kombinací zprostředkovatele aktualizace a názvu. Díky tomu může služba Device Update s jistotou určit, které aktualizace by měly být k dispozici pro nasazení na dané zařízení. Pokud potřebujete aktualizovat více komponent nebo oddílů na jednom zařízení, funkce aktualizací proxy serveru tuto funkci poskytuje.

Otázka: Při importu obsahu se mi zobrazuje chybová zpráva a chci o ní vědět víc

Podrobnější informace o chybových zprávách souvisejících s importem najdete v dokumentaci k kódům chyb aktualizace zařízení .

Selhání zařízení

Otázka: Jak zajistím, že je moje zařízení připojené ke službě Device Update pro IoT Hub?

Pokud chcete ověřit, že je vaše zařízení připojené ke službě Device Update, zkontrolujte, jestli se zobrazuje v části Neseskupené zařízení v zobrazení dodržování předpisů Azure Portal.

Otázka: Nejméně jedno zařízení se nedaří aktualizovat

Selhání aktualizace zařízení může mít mnoho původních příčin. Ověřte, že je zařízení: 1) připojené k vaší instanci IoT Hub, 2) připojené k instanci aktualizace zařízení a 3) je spuštěná služba Optimalizace doručení (DO). Pokud jsou pro vaše zařízení splněné všechny tři podmínky, postupujte podle pokynů v části Kontaktování podpora Microsoftu a podejte žádost o podporu společnosti Microsoft.

Otázka: Agenta aktualizace zařízení se nedaří spustit

Jedním z nejběžnějších důvodů selhání spuštění agenta aktualizace zařízení je poškozený konfigurační soubor (du-config.json). Projděte si dokumentaci ke konfiguračnímu souboru a ujistěte se, že je agent správně nakonfigurovaný. Všimněte si, že všechny hodnoty v konfiguračním souboru musí používat dvojité uvozovky.

Nasazení aktualizace

Otázka: Nasadil(a) jsem aktualizaci do svých zařízení, ale stav dodržování předpisů říká, že není v nejnovější aktualizaci. Co bych měl/a dělat?

Aktualizace stavu dodržování předpisů zařízením může trvat až 5 minut. Počkejte prosím a zkontrolujte to znovu.

Otázka: Stav nasazení mého zařízení se zobrazuje jako nekompatibilní. Co mám dělat?

Po připojení zařízení k IoT Hub mohlo dojít ke změně vlastností výrobce a modelu cílového zařízení, což způsobilo, že zařízení je nyní považováno za nekompatibilní s obsahem aktualizace aktuálního nasazení.

Zkontrolujte základní rozhraní ADU , abyste zjistili, jakého výrobce a model vaše zařízení hlásí službě Device Update, a ujistěte se, že odpovídají výrobci a modelu, který jste zadali v manifestu importu nasazovaného obsahu aktualizace. Tyto vlastnosti pro dané zařízení můžete změnit pomocí konfiguračního souboru aktualizace zařízení.

Otázka: Vidím, že moje nasazení je ve fázi Aktivní, ale žádné z mých zařízení s aktualizací neprobíhá. Co bych měl/a dělat?

Ujistěte se, že vaše počáteční datum nasazení není nastavené v budoucnu. Když vytvoříte nové nasazení, počáteční datum nasazení se jako ochrana nastaví na následující den, pokud ho explicitně nezměníte. Můžete počkat, až nastane počáteční datum nasazení, nebo můžete probíhající nasazení zrušit a vytvořit nové nasazení s požadovaným počátečním datem.

Otázka: Pokouším se seskupit svá zařízení, ale při vytváření skupiny nevidím značku v rozevíracím seznamu

Ujistěte se, že jste správně nakonfigurovali trasy zpráv v IoT Hub podle dokumentace k prostředkům služby Device Update. Po konfiguraci trasy budete muset zařízení znovu označit.

Další původní příčinou může být, že jste značku použili před připojením zařízení ke službě Device Update pro IoT Hub. Ujistěte se, že je vaše zařízení už připojené ke službě Device Update. Pokud chcete ověřit, že je vaše zařízení připojené ke službě Device Update pro IoT Hub, zkontrolujte, jestli se v zobrazení dodržování předpisů zobrazuje v části Neseskupené zařízení. Dočasně přidejte značku jiné hodnoty a po připojení zařízení znovu přidejte požadovanou značku.

Pokud používáte službu Device Provisioning Service (DPS), ujistěte se, že zařízení označíte po jejich zřízení, a ne během procesu vytváření zařízení. Pokud jste už zařízení označili během kroku Vytvoření zařízení, budete muset po zřízení zařízení dočasně označit jinou hodnotou a potom znovu přidat zamýšlenou značku.

Otázka: Nasazení se úspěšně dokončilo, ale některá zařízení se nepodařilo aktualizovat.

Příčinou mohla být chyba na straně klienta na neúspěšných zařízeních. Projděte si část Selhání zařízení v tomto průvodci odstraňováním potíží.

Otázka: Při pokusu o zahájení nasazení došlo v uživatelském prostředí k chybě

Příčinou může být chyba služby nebo uživatelského prostředí nebo problém s oprávněními rozhraní API. Pokud chcete podat žádost o podporu společnosti Microsoft, postupujte podle pokynů v části Kontaktování podpora Microsoftu.

Otázka: Spustil(a) jsem nasazení, ale nedosahuje koncového stavu

Příčinou může být problém s výkonem služby, chyba služby nebo chyba klienta. Zkuste nasazení zopakovat po 10 minutách. Pokud narazíte na stejný problém, stáhněte si protokoly zařízení a projděte si část Selhání zařízení v tomto průvodci odstraňováním potíží. Pokud stejný problém přetrvává, postupujte podle pokynů v části Kontaktování podpora Microsoftu a odešlete žádost o podporu u Microsoftu.

Otázka: Migroval(a) jsem z agenta na úrovni zařízení na přidání agenta jako identity modulu na zařízení a aktualizace se zobrazuje jako probíhající, i když se na zařízení použila.

Příčinou mohlo být, že jste neodebrali staršího agenta, který komunikoval přes dvojče zařízení. Když zřídíte agenta aktualizace zařízení jako modul (podívejte se, jak na to), veškerá komunikace mezi zařízením a službou Device Update probíhá přes dvojče modulu, takže nezapomeňte při vytváření skupin označit dvojče modulu zařízení a veškerá komunikace musí probíhat přes dvojče modulu.

Stahování aktualizací do zařízení

Otázka: Návody obnovit stahování, když se zařízení po určité době odpojení znovu připojí?

Při obnovení připojení během 24 hodin se stahování samo obnoví. Po 24 hodinách bude muset uživatel znovu zahájit stahování.

Použití služby Microsoft Connected Cache (MCC)

Otázka: Při pokusu o nasazení modulu MCC na IoT Edge zařízení dochází k problému

Informace o nasazení modulů Edge do IoT Edge zařízení najdete v dokumentaci k IoT Edge. Pokud chcete zkontrolovat, jestli je modul MCC na vašem IoT Edge zařízení úspěšně spuštěný, přejděte nahttp://localhost:5100/Summary.

Otázka: Jedno ze zařízení IoT se pokouší stáhnout aktualizaci prostřednictvím MCC, ale selhává

Existuje několik problémů, které můžou způsobovat selhání připojení zařízení IoT k MCC. Pokud chcete diagnostikovat problém, shromážděte z neúspěšného zařízení protokoly klienta DO a Nginx (pokyny ke shromažďování protokolů klientů najdete v části Kontaktování podpora Microsoftu).

Může se stát, že se vašemu zařízení nedaří vyžádat si obsah z internetu a předat ho do modulu MCC, protože adresa URL, která používá, není povolená. Pokud chcete zjistit, jestli ano, budete muset zkontrolovat proměnné prostředí IoT Edge v Azure Portal.

Řešení potíží s chybějící instancí v Azure Portal

Otázka: Při výběru ikony ozubeného kola se nezobrazuje instance aktualizace zařízení pro IoT Hub

Existuje několik možných příčin tohoto problému. Postup řešení potíží najdete níže.

Instance služby Device Update musí být přidružená ke službě Azure IoT Hub ve stejné skupině prostředků a předplatném. Pokud jste přesunuli instanci služby Device Update nebo centrum do jiné skupiny prostředků nebo jiného předplatného, je možné, že se vaše instance v Azure Portal nezobrazí. Abyste mohli dál používat službu Device Update pro IoT Hub, budete muset provést jeden z následujících kroků:

• Vraťte přesunuté položky do původní konfigurace.
• Pokud jste přesunuli centrum IoT jenom z jedné skupiny prostředků do jiné, upravte instanci služby Device Update s novým id prostředku služby IoT Hub.
• Pokud jste přesunuli položky z jednoho předplatného do jiného, ujistěte se, že se účet Device Update a IoT Hub nacházejí ve stejném předplatném, a pak upravte instanci služby Device Update s novým id prostředku centra IoT.

Aby bylo možné získat přístup k funkcím Aktualizace zařízení prostřednictvím prostředí IoT Hub v Azure Portal, potřebujete alespoň oprávnění na úrovni čtení pro váš účet IoT Hub i účet Device Update pro IoT Hub.

• Správa oprávnění pro IoT Hub:
  • V Azure Portal vyberte centrum.
  • Na levém navigačním panelu vyberte Řízení přístupu (IAM).
  • Vyberte Přidat přiřazení role.
  • Vyberte roli s alespoň oprávněním pro čtení a vyberte Další.
  • Vedle položky Členové vyberte +Vybrat členy.
  • Přidejte svůj účet do kontextové nabídky vpravo a vyberte tlačítko Vybrat.
  • Vyberte Zkontrolovat a přiřadit.
• Pokud chcete spravovat oprávnění pro účet služby Device Update pro IoT Hub, požádejte vlastníka účtu, aby provedl tyto kroky:
  • V Azure Portal vyberte svůj účet služby Device Update.
  • Na levém navigačním panelu vyberte Řízení přístupu (IAM).
  • Vyberte Přidat přiřazení role.
  • Vyberte roli Čtenář (nebo roli s ekvivalentními oprávněními).
  • Vedle položky Členové vyberte +Vybrat členy.
  • Přidejte svůj účet do kontextové nabídky vpravo a vyberte tlačítko Vybrat.
  • Vyberte Zkontrolovat a přiřadit.

Přečtěte si další informace o řízení přístupu na základě role pro službu Device Update.

Kontaktování oddělení podpory společnosti Microsoft

Pokud narazíte na problémy, které se nedají vyřešit pomocí výše uvedených nejčastějších dotazů, můžete podat žádost o podporu s podpora Microsoftu prostřednictvím rozhraní Azure Portal. V závislosti na tom, do které kategorie váš problém patří, můžete být požádáni o shromáždění a sdílení dalších dat, která podpora Microsoftu vašemu problému pomohou prošetřit.

Pokyny ke shromáždění jednotlivých datových typů najdete níže.

Pomocí příkazu getDevice můžete zkontrolovat další informace v odpovědi na datovou část rozhraní API.

Kromě toho mohou být následující informace užitečné pro zúžení původní příčiny vašeho problému:

• Jaký typ zařízení se pokoušíte aktualizovat (IoT Edge Gateway, jiné)
• Jaký typ klienta služby Device Update používáte (na základě image, balíčku, simulátoru)
• Jaký operační systém vaše zařízení používá
• Podrobnosti o architektuře vašeho zařízení
• Zda jste dříve úspěšně použili aktualizaci zařízení k aktualizaci zařízení

Pokud máte k dispozici některé z výše uvedených informací, uveďte je v popisu problému.

Shromažďování protokolů klientů

• Na zařízení Raspberry Pi jsou dvě sady protokolů, které najdete tady:

  /adu/logs
  

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

• Protokoly zabaleného klienta najdete tady:

  /var/log/adu
  

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

• Protokoly simulátoru najdete tady:

  /tmp/aduc-logs
  

Kódy chyb

Při hlášení problému souvisejícího s importem aktualizace, selháním zařízení nebo nasazením aktualizace se může zobrazit výzva k zadání kódů chyb.

Kódy chyb můžete získat v rozhraní ADUCoreInterface . Informace o tom, jak analyzovat kódy chyb pro účely autodiagnostiky a řešení potíží, najdete v dokumentaci ke kódům chyb služby Device Update .

ID trasování

Při hlášení problému souvisejícího s importem nebo nasazením aktualizace se může zobrazit výzva k zadání ID trasování.

ID trasování pro danou akci uživatele najdete v odpovědi rozhraní API nebo v části Historie importu uživatelského rozhraní Azure Portal.

V současné době jsou ID trasování pro akce nasazení přístupná pouze prostřednictvím odpovědi rozhraní API.

ID nasazení

Při hlášení problému souvisejícího s nasazením aktualizace se může zobrazit výzva k zadání ID nasazení.

ID nasazení vytvoří uživatel při volání rozhraní API k zahájení nasazení.

V současné době se ID nasazení pro nasazení zahájená z Azure Portal uživatelského rozhraní vygenerují automaticky a uživateli se nezobrazí.

IoT Hub název instance

Při hlášení problému souvisejícího se selháním zařízení nebo nasazením aktualizace se může zobrazit výzva k zadání názvu instance IoT Hub.

Název IoT Hub zvolí uživatel při prvním zřízení.

Název účtu služby Device Update

Při hlášení problému souvisejícího s importem aktualizace, selháním zařízení nebo nasazením aktualizace se může zobrazit výzva k zadání názvu účtu služby Device Update.

Název účtu služby Device Update zvolí uživatel při první registraci ke službě. Další informace najdete v dokumentaci k prostředkům služby Device Update .

Název instance služby Device Update

Při hlášení problému souvisejícího s importem aktualizace, selháním zařízení nebo nasazením aktualizace můžete být požádáni o zadání názvu vaší instance služby Device Update.

Název instance služby Device Update zvolí uživatel při prvním zřízení. Další informace najdete v dokumentaci k prostředkům služby Device Update .

ID zařízení

Při hlášení problému souvisejícího se selháním zařízení nebo nasazení aktualizace se může zobrazit výzva k zadání ID zařízení.

ID zařízení definuje zákazník při prvním zřízení zařízení. Dá se také načíst z dvojčete zařízení.

ID aktualizace

Při hlášení problému souvisejícího s nasazením aktualizace se může zobrazit výzva k zadání ID aktualizace.

ID aktualizace definuje zákazník při zahájení nasazení.

Protokoly Nginx

Při hlášení problému souvisejícího s připojenou mezipamětí Microsoftu se může zobrazit výzva k poskytnutí protokolů Nginx.

ADU-conf.txt

Při hlášení problému souvisejícího s nasazením aktualizace se může zobrazit výzva k zadání konfiguračního souboru služby Device Update ("adu-conf.txt").

Konfigurační soubor je volitelný a uživatel ho vytvořil podle pokynů v dokumentaci ke konfiguraci služby Device Update .

Import manifestu

Při hlášení problému souvisejícího s importem nebo nasazením aktualizace se může zobrazit výzva k zadání souboru manifestu importu.

Manifest importu je soubor vytvořený zákazníkem při importu obsahu aktualizace do služby Device Update.

Další kroky

Další informace o kódech chyb služby Device Update