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

Tento dokument obsahuje některé běžné dotazy a problémy, které uživatelé služby Device Update nahlásili. Jak aktualizace zařízení prochází verzí Public Preview, bude se tento průvodce odstraňováním potíží pravidelně aktualizovat novými otázkami a řešeními. Pokud narazíte na problém, který se v tomto průvodci odstraňováním potíží nezobrazuje, zdokumentujte svou situaci v části Kontaktování podpora Microsoftu.

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 IoT Hub zpráv 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 jste správně nakonfigurovali přístupová oprávnění podle dokumentace k řízení přístupu ke službě Device Update .

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 značit 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 požádejte Microsoft o podporu.

Otázka: Chci zachovat stejné vlastnosti kompatibility (zací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. To umožňuje službě Device Update s jistotou určit, které aktualizace by měly být k dispozici pro nasazení do daného 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 zobrazuje chybová zpráva a chci o ní vědět více.

Podrobnější informace o chybových zprávách souvisejících s importem najdete v dokumentaci ke kódům chyb služby Device Update .

Selhání zařízení

Otázka: Jak můžu zajistit, aby bylo 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 služby Device Update a 3) služba Optimalizace doručení (DO) je spuštěná. Pokud pro vaše zařízení platí všechny tři podmínky, postupujte podle pokynů v části Kontaktování podpora Microsoftu a podejte microsoftu žádost o podporu.

Nasazení aktualizace

Otázka: Nasadil(a) jsem do svých zařízení aktualizaci, ale stav dodržování předpisů uvádí, ž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 pak to zkontrolujte 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 a zjistěte, 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 služby Device Update.

Otázka: Vidím, že nasazení je v aktivní fázi, ale žádná z mých zařízení není v průběhu aktualizace. Co bych měl/a dělat?

Ujistěte se, že počáteční datum nasazení není nastavené v budoucnu. Když vytvoříte nové nasazení, počáteční datum nasazení se jako ochranná opatření 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 zařízení, ale při vytváření skupiny se v rozevíracím seznamu nezobrazuje značka.

Ujistěte se, že jste v IoT Hub správně nakonfigurovali trasy zpráv 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, jestli 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 s jinou hodnotou 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 pak znovu přidat požadovanou značku.

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

Příčinou může být chyba na straně klienta na zařízeních, která selhala. 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. Postupujte podle pokynů v části Kontaktování podpora Microsoftu a podejte žádost o podporu u Microsoftu.

Otázka: Zahájil(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, vyžádejte si protokoly zařízení a projděte si část Selhání zařízení tohoto průvodce odstraňováním potíží. Pokud stejný problém přetrvává, podle pokynů v části Kontaktování podpora Microsoftu vytvořte žádost o podporu u Microsoftu.

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

_This mohlo dojít, pokud 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í?

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

Použití připojené mezipaměti Microsoftu (MCC)

Otázka: Při pokusu o nasazení modulu MCC na zařízení IoT Edge 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 zařízení IoT Edge ú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 protokoly klienta DO a Nginx ze zařízení, které selhává (pokyny ke shromažďování protokolů klientů najdete v části Kontaktování podpora Microsoftu).

Vašemu zařízení se možná nedaří vyžádat si obsah z internetu, který má předat 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.

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í funkce getDevices 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 (Azure Percept, 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ší krok: Další informace o kódech chyb služby Device Update