Sdílet prostřednictvím

Průvodce odstraňováním potíží se službou Device Update for IoT Hub

Tento dokument uvádí některé běžné dotazy a problémy, které uživatelé služby Device Update nahlásili. Vzhledem k tomu, že aktualizace zařízení postupuje ve verzi Public Preview, bude se tento průvodce odstraňováním potíží pravidelně aktualizovat novými dotazy a řešeními. Pokud narazíte na problém, který se nezobrazuje v tomto průvodci odstraňováním potíží, projděte si část Kontaktování podpory Microsoftu a zdokumentujte svou situaci.

Import aktualizací

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

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

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 znamenat problém se službou Device Update. Počkejte prosím 5 minut a zkuste to znovu. Pokud stejná chyba přetrvává, postupujte podle pokynů v části Kontaktování podpory Microsoftu a vytvořte žádost o podporu s Microsoftem.

Otázka: Chci zachovat stejné vlastnosti kompatibility (cílit na aktualizaci stejného typu zařízení), ale změnit zprostředkovatele nebo název v manifestu importu. Při pokusu o import aktualizace se však zobrazí chyba: "Selhání: chyba při importu aktualizace z důvodu překročení limitu."

Stejnou 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 určit s jistotou, 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 dochází k chybové zprávě a chci o ní získat další informace.

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

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, jestli je vaše zařízení připojené ke službě Device Update, zkontrolujte, jestli se zobrazí v části Neseskupené zařízení v zobrazení dodržování předpisů na webu Azure Portal.

Otázka: Některé moje zařízení se nedaří aktualizovat.

Při selhání aktualizace zařízení existuje mnoho možných původních příčin. Ověřte, že je zařízení: 1) připojené k vaší instanci služby IoT Hub, 2) připojené k vaší instanci služby Device Update 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í podpory Microsoftu a vytvořte žádost o podporu s Microsoftem.

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 mám dělat?

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

Otázka: Stav nasazení mého zařízení je neslučitelný, jak mám postupovat?

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

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

Otázka: Moje nasazení je ve fázi Aktivní, ale žádné z mých zařízení není ve stavu "probíhá" s aktualizací. Co mám dělat?

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

Ujistěte se, že jste ve službě 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ší hlavní příčinou může být použití značky 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 jiné hodnoty a po připojení zařízení znovu přidejte zamýšlenou značku.

Pokud používáte službu Device Provisioning Service (DPS), ujistěte se, že zařízení po zřízení označíte a ne během procesu vytváření zařízení. Pokud jste zařízení už označili během kroku vytvoření zařízení, budete muset zařízení po zřízení dočasně označit jinou hodnotou a pak 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 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 k chybě v uživatelském prostředí.

Příčinou může být chyba služby nebo uživatelského rozhraní nebo problém s oprávněními rozhraní API. Pokud chcete podat žádost o podporu s Microsoftem, postupujte podle pokynů v části Kontaktování podpory 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, vyžádejte 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í podpory Microsoftu a vytvořte žádost o podporu s Microsoftem.

Otázka: Migroval(a) jsem z agenta na úrovni zařízení na použití agenta jako identitu modulu na zařízení a aktualizace se zobrazuje jako probíhající, i když již byla na zařízení aplikována.

_Toto se mohlo stát, pokud jste neodebrali staršího agenta, který komunikoval přes Device Twin. Když zřídíte agenta Device Update jako modul (zjistěte , jak), veškerá komunikace mezi zařízením a službou Device Update probíhá přes dvojče modulu. Nezapomeňte označit dvojče modulu zařízení při vytváření skupin. Veškerá komunikace musí probíhat přes dvojče modulu.

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

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

Stažení se obnoví, když se připojení obnoví během 24hodinového období. Po 24 hodinách bude nutné stahování znovu zahájit uživatelem.

Použití služby Microsoft Connected Cache (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 zařízení IoT Edge najdete v dokumentaci k IoT Edge . Pokud chcete zkontrolovat, jestli se modul MCC na zařízení IoT Edge úspěšně spouští, přejděte na http://localhost:5100/Summary.

Otázka: Jedno z mých zařízení IoT se pokouší stáhnout aktualizaci prostřednictvím MCC, ale nedaří se.

Při připojování k MCC může docházet k několika problémům, které můžou způsobovat selhání zařízení IoT. Pokud chcete problém diagnostikovat, shromážděte z zařízení, které selhává, protokoly DO a Nginx (pokyny ke shromažďování protokolů klientů najdete v části Kontaktování podpory Microsoftu ).

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

Kontaktování podpory Microsoftu

Pokud narazíte na problémy, které nejde vyřešit pomocí výše uvedených nejčastějších dotazů, můžete žádost o podporu podat s podporou Microsoftu prostřednictvím rozhraní webu Azure Portal. V závislosti na kategorii, do které značíte váš problém, můžete být požádáni, abyste shromáždili a sdíleli další data, která podpoře Microsoftu pomůžou váš problém prošetřit.

Pokyny ke shromažďování jednotlivých datových typů najdete níže. Pomocí getDevices můžete zkontrolovat další informace v odpovědi datové části rozhraní API.

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

  • Jaký typ zařízení se pokoušíte aktualizovat (Azure Percept, brána IoT Edge, jiné)
  • Jaký typ klienta služby Device Update používáte (založené na obrazech, založené na balíčcích, simulátor)
  • Na kterém operačním systému je vaše zařízení spuštěné
  • Podrobnosti týkající se architektury vašeho zařízení
  • Jestli jste úspěšně použili službu Device Update k aktualizaci zařízení před

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

Shromažďování protokolů klienta

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

    /adu/logs

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

  • Pro zabaleného klienta se protokoly nacházejí tady:

    /var/log/adu

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

  • V simulátoru jsou protokoly nalezeny tady:

    /tmp/aduc-logs

Kódy chyb

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

Kódy chyb lze získat pomocí rozhraní ADUCoreInterface . Informace o tom, jak analyzovat kódy chyb pro autodiagnostiku a řešení problémů, najdete v dokumentaci k chybovým kódům aktualizací zařízení .

ID sledová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í webu Azure Portal.

V současné době jsou sledovací ID 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, aby zahájil nasazení.

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

Název instance IoT Hubu

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

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

Název účtu aktualizace zařízení

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 služby. Další informace najdete v dokumentaci k prostředkům služby Device Update .

Název instance služby Device Update

Může se zobrazit výzva k zadání názvu 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.

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ím 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 můžete být požádáni o 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 vytvořený uživatelem podle pokynů v dokumentaci ke konfiguraci služby Device Update .

Manifest importu

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

  • Last updated on