Eszközfrissítés IoT Hub hibaelhárítási útmutatóhoz

Cikk
05/24/2023

Ez a dokumentum felsorol néhány gyakori kérdést és problémát, amelyeket az eszközfrissítés felhasználói jelentettek. Ha olyan problémát tapasztal, amely nem jelenik meg ebben a hibaelhárítási útmutatóban, a helyzet dokumentálásához tekintse meg a Kapcsolatfelvétel Microsoft ügyfélszolgálata szakaszt.

Frissítések importálása

K: Nem sikerül csatlakoztatni az Eszközfrissítési példányt a IoT Hub-példányomhoz

Győződjön meg arról, hogy a IoT Hub üzenetútvonalak megfelelően vannak konfigurálva az Eszközfrissítési erőforrások dokumentációjának megfelelően.

Előfordulhat, hogy nem rendelkezik megfelelően konfigurált hozzáférési engedélyekkel. Győződjön meg arról, hogy megfelelően konfigurálta a hozzáférési engedélyeket az Eszközfrissítés hozzáférés-vezérlés dokumentációjának megfelelően.

K: 500-es típusú hibát tapasztalok, amikor tartalmat importálok az eszközfrissítési szolgáltatásba

Az 500-ra vonatkozó hibakód az eszközfrissítési szolgáltatással kapcsolatos problémát jelezhet. Várjon 5 percet, majd próbálkozzon újra. Ha ugyanaz a hiba továbbra is fennáll, kövesse a Kapcsolatfelvétel Microsoft ügyfélszolgálata szakaszban található utasításokat, és küldjön támogatási kérést a Microsoftnak.

K: Ugyanazokat a kompatibilitási tulajdonságokat szeretném megőrizni (a frissítésemet ugyanarra az eszköztípusra célozom), de az importálási jegyzékben módosítani szeretném a Szolgáltatót vagy a Nevet. De a következő hibaüzenet jelenik meg: "Sikertelen: hiba történt a frissítés importálása a korlát túllépése miatt" hibaüzenet jelenik meg, amikor ezt csinálom

Ugyanaz a kompatibilitási tulajdonságkészlet nem használható egynél több frissítésszolgáltatóval és névkombinációval. Ez lehetővé teszi az eszközfrissítési szolgáltatás számára, hogy biztosan megállapítsa, mely frissítések legyenek elérhetők az adott eszközön való üzembe helyezéshez. Ha egyetlen eszközön több összetevőt vagy partíciót kell frissítenie, a proxyfrissítési funkció biztosítja ezt a képességet.

K: Hibaüzenet jelenik meg a tartalom importálásakor, és szeretnék többet megtudni róla

Az importálással kapcsolatos hibaüzenetekről további információt az Eszközfrissítési hibakódok dokumentációjában talál.

Eszközhibák

K: Hogyan biztosíthatom, hogy az eszközöm csatlakozik az eszközfrissítéshez IoT Hub?

A Azure Portal megfelelőségi nézetének "Nem csoportosított" eszközei szakaszában ellenőrizheti, hogy az eszköz csatlakozik-e az Eszközfrissítéshez.

K: Egy vagy több eszközöm nem frissül

Az eszközfrissítési hibáknak számos kiváltó oka lehet. Győződjön meg arról, hogy az eszköz a következő: 1) csatlakoztatva van a IoT Hub példányhoz, 2) csatlakozik az Eszközfrissítési példányhoz, 3) a Kézbesítésoptimalizálás (DO) szolgáltatás fut. Ha mindhárom igaz az eszközére, kövesse a Kapcsolatfelvétel Microsoft ügyfélszolgálata szakaszban található utasításokat, és küldjön támogatási kérést a Microsoftnak.

K: Az eszközfrissítési ügynök nem indul el

Az eszközfrissítési ügynök indítási hibájának egyik leggyakoribb oka egy helytelen konfigurációs fájl (du-config.json). Tekintse meg a konfigurációs fájl dokumentációját , és győződjön meg arról, hogy az ügynök megfelelően van konfigurálva. Vegye figyelembe, hogy a konfigurációs fájlban lévő összes értéknek dupla idézőjeleket kell használnia.

Frissítés üzembe helyezése

K: Telepítettem egy frissítést az eszköz(ek)en, de a megfelelőségi állapot azt jelzi, hogy nem a legújabb frissítésen van. Mit tegyek?

Az eszközmegfeleltségi állapot frissítése akár 5 percet is igénybe vehet. Várjon, majd ellenőrizze újra.

K: Az eszköz üzembehelyezési állapota nem kompatibilis. Mit tegyek?

Előfordulhat, hogy a megcélzott eszköz gyártói és modelltulajdonságai módosultak az eszköz IoT Hub való csatlakoztatása után, ami miatt az eszköz most már nem kompatibilis az aktuális üzemelő példány frissítési tartalmával.

Ellenőrizze az ADU Core felületét , hogy az eszköz milyen gyártót és modellt jelent az Eszközfrissítés szolgáltatásnak, és győződjön meg arról, hogy az megfelel az üzembe helyezett frissítési tartalom importálási jegyzékében megadott gyártónak és modellnek. Ezeket a tulajdonságokat egy adott eszközhöz az Eszközfrissítés konfigurációs fájl használatával módosíthatja.

K: Látom, hogy az üzembe helyezés "Aktív" fázisban van, de egyik eszközöm sem "Folyamatban" van a frissítéssel. Mit tegyek?

Győződjön meg arról, hogy az üzembe helyezés kezdési dátuma nem lesz beállítva a jövőben. Amikor új üzembe helyezést hoz létre, az üzembe helyezés kezdő dátuma alapértelmezés szerint a következő napra kerül biztosítékként, hacsak nem módosítja explicit módon. Megvárhatja az üzembe helyezés kezdési dátumát, vagy megszakíthatja a folyamatban lévő üzembe helyezést, és létrehozhat egy újat a kívánt kezdési dátummal.

K: Próbálom csoportosítani az eszközeimet, de nem látom a címkét a legördülő menüben egy csoport létrehozásakor

Győződjön meg arról, hogy megfelelően konfigurálta az üzenetútvonalakat a IoT Hub az Eszközfrissítési erőforrások dokumentációjának megfelelően. Az útvonal konfigurálása után újra fel kell címkéznie az eszközt.

Egy másik alapvető ok lehet, hogy a címkét alkalmazta, mielőtt csatlakoztatta az eszközt IoT Hub eszközfrissítéshez. Győződjön meg arról, hogy az eszköz már csatlakoztatva van az Eszközfrissítéshez. Ha ellenőrizni szeretné, hogy az eszköz csatlakozik-e az Eszközfrissítéshez IoT Hub, ellenőrizze, hogy megjelenik-e a megfelelőségi nézetben a "Nem csoportosított" eszközök területen. Ideiglenesen adjon hozzá egy másik értékű címkét, majd az eszköz csatlakoztatása után ismét adja hozzá a kívánt címkét.

Ha eszközkiépítési szolgáltatást (DPS) használ, győződjön meg arról, hogy az eszközök kiépítésük után címkézve vannak, nem pedig az eszközlétrehozási folyamat során. Ha már megjelölte az eszközt az Eszközlétrehozási lépés során, akkor ideiglenesen fel kell címkéznie az eszközt egy másik értékkel a kiépítés után, majd újra fel kell adnia a kívánt címkét.

K: Az üzembe helyezés sikeresen befejeződött, de egyes eszközök frissítése sikertelen volt

Ezt az ügyféloldali hiba okozhatta a sikertelen eszközökön. Tekintse meg a hibaelhárítási útmutató Eszközhibák szakaszát.

K: Hiba történt a felhasználói felületen az üzembe helyezés indításakor

Ezt egy szolgáltatás-/UX-hiba vagy egy API-engedélyekkel kapcsolatos probléma okozhatta. Kérjük, kövesse a Kapcsolatfelvétel Microsoft ügyfélszolgálata szakaszban található utasításokat, és küldjön támogatási kérést a Microsoftnak.

K: Elindítottam egy üzembe helyezést, de nem éri el a befejezési állapotot

Ezt okozhatta szolgáltatásteljesítmény-probléma, szolgáltatáshiba vagy ügyfélhiba. Próbálkozzon újra az üzembe helyezéssel 10 perc elteltével. Ha ugyanezt a problémát tapasztalja, kérje le az eszköznaplókat, és tekintse meg a hibaelhárítási útmutató Eszközhibák szakaszát. Ha ugyanaz a probléma továbbra is fennáll, kövesse a Kapcsolatfelvétel Microsoft ügyfélszolgálata szakaszban található utasításokat, és küldjön támogatási kérést a Microsoftnak.

K: Eszközszintű ügynökről migráltam, hogy moduli identitásként adjam hozzá az ügynököt az eszközön, és a frissítés "folyamatban" állapotúként jelenik meg, annak ellenére, hogy az eszközre alkalmazták

Ezt akkor okozhatta, ha nem távolította el a Device Twin-en keresztül kommunikáló régebbi ügynököt. Amikor modulként építi ki az Eszközfrissítési ügynököt (lásd a módját), az eszköz és az Eszközfrissítési szolgáltatás közötti kommunikáció az ikermodulon keresztül történik, ezért ne felejtse el címkézni az eszköz ikermodulját csoportok létrehozásakor, és minden kommunikációnak a modul ikerpéldányán keresztül kell történnie.

Frissítések letöltése eszközökre

K: Hogyan folytathatja a letöltést, ha egy eszköz újracsatlakozott a kapcsolat megszakadása után?

A letöltés automatikusan folytatódik, ha a kapcsolat 24 órán belül helyreáll. 24 óra elteltével a letöltést újra el kell helyeznie a felhasználónak.

A Microsoft Connected Cache (MCC) használata

K: Problémát tapasztalok, amikor az MCC modult az IoT Edge eszközömön próbálom üzembe helyezni

Tekintse meg az Edge-modulok IoT Edge eszközökre való üzembe helyezésének IoT Edge dokumentációját. Ellenőrizze, hogy az MCC-modul sikeresen fut-e az IoT Edge eszközön a következő lépéssel:http://localhost:5100/Summary.

K: Az egyik IoT-eszközöm megpróbál letölteni egy frissítést az MCC-ben, de sikertelen

Számos probléma okozhatja, hogy egy IoT-eszköz nem tud csatlakozni az MCC-hez. A probléma diagnosztizálásához gyűjtse össze a DO-ügyfél- és Nginx-naplókat a meghibásodott eszközről (az ügyfélnaplók gyűjtésére vonatkozó utasításokért tekintse meg a Kapcsolatfelvétel Microsoft ügyfélszolgálata szakaszt).

Előfordulhat, hogy az eszköz nem tud tartalmat lekérni az internetről az MCC-modulnak való továbbításhoz, mert az általa használt URL-cím nem engedélyezett. Annak megállapításához, hogy így van-e, ellenőriznie kell a IoT Edge környezeti változóit a Azure Portal.

Hiányzó példány hibaelhárítása a Azure Portal

K: Nem látok eszközfrissítési példányt IoT Hub, amikor a "fogaskerék" ikont választom

Ennek a problémának néhány lehetséges oka lehet. A hibaelhárítási lépésekért lásd alább.

Az eszközfrissítési példányokat ugyanabban az erőforráscsoportban és előfizetésben lévő Azure IoT Hubhoz kell társítani. Ha az eszközfrissítési példányt vagy a központot egy másik erőforráscsoportba vagy előfizetésbe helyezte át, előfordulhat, hogy a példány nem jelenik meg a Azure Portal. Az eszközfrissítés IoT Hub való használatának folytatásához az alábbi lépések egyikét kell elvégeznie:

Adja vissza az áthelyezett elemeket az eredeti konfigurációjukba.
Ha az IoT Hubot csak az egyik erőforráscsoportból a másikba helyezte át, módosítsa az eszközfrissítési példányt az IoT Hub új resourceId azonosítójával.
Ha elemeket helyezett át egyik előfizetésből a másikba, győződjön meg arról, hogy az Eszközfrissítés fiók és az IoT Hub ugyanabban az előfizetésben van, majd módosítsa az Eszközfrissítési példányt az IoT Hub új erőforrás-azonosítójával.

Legalább olvasási szintű engedélyekre van szükség mind az IoT Hubhoz, mind az eszközfrissítéshez IoT Hub-fiókhoz ahhoz, hogy az eszközfrissítési funkciókat az Azure Portal IoT Hub-élményén keresztül érhesse el.

A IoT Hub engedélyeinek kezelése:
- Válassza ki a központot a Azure Portal
- Válassza a "Hozzáférés-vezérlés (IAM) lehetőséget a bal oldali navigációs sávon.
- Válassza a "Szerepkör-hozzárendelés hozzáadása" lehetőséget.
- Válasszon ki egy legalább Olvasási hozzáféréssel rendelkező szerepkört, és válassza a Tovább gombot.
- A "Tagok" elem mellett válassza a "+Tagok kiválasztása" lehetőséget.
- Vegye fel a fiókját a jobb oldali úszó panelre, és válassza a "Kiválasztás" gombot.
- Válassza a "Véleményezés + hozzárendelés" lehetőséget.
Ha IoT Hub fiók eszközfrissítéséhez szükséges engedélyeket szeretné kezelni, kérje meg a fiók tulajdonosát, hogy végezze el az alábbi lépéseket:
- Válassza ki eszközfrissítési fiókját a Azure Portal.
- Válassza a "Hozzáférés-vezérlés (IAM) lehetőséget a bal oldali navigációs sávon.
- Válassza a "Szerepkör-hozzárendelés hozzáadása" lehetőséget.
- Válassza ki az Olvasó szerepkört (vagy az azzal egyenértékű engedélyekkel rendelkezőt).
- A "Tagok" elem mellett válassza a "+Tagok kiválasztása" lehetőséget.
- Vegye fel a fiókját a jobb oldali úszó panelre, és válassza a "Kiválasztás" gombot.
- Válassza a "Véleményezés + hozzárendelés" lehetőséget.

További információ az eszközfrissítési szolgáltatás szerepköralapú hozzáférés-vezérléséről .

Kapcsolatfelvétel a Microsoft támogatási szolgálatával

Ha olyan problémákba ütközik, amelyek nem oldhatók meg a fenti gyakori kérdések segítségével, a Azure Portal felületen keresztül nyújthat be támogatási kérést Microsoft ügyfélszolgálata. Attól függően, hogy melyik kategóriához tartozik a probléma, előfordulhat, hogy további adatokat kell összegyűjtenie és megosztania, hogy segítsen Microsoft ügyfélszolgálata a probléma kivizsgálásában.

Az egyes adattípusok gyűjtésére vonatkozó utasításokat alább találja.

A getDevice használatával további információkat kereshet az API hasznos adatokra adott válaszában.

Emellett a következő információk hasznosak lehetnek a probléma kiváltó okának szűkítésében:

A frissíteni kívánt eszköz típusa (IoT Edge átjáró, egyéb)
Milyen eszközfrissítési ügyféltípust használ (képalapú, csomagalapú, szimulátor)
Milyen operációs rendszert futtat az eszköz?
Az eszköz architektúrájával kapcsolatos részletek
Azt jelzi, hogy sikeresen használta-e az Eszközfrissítést az eszköz frissítéséhez

Ha a fenti információk bármelyike elérhető, kérjük, adja meg a probléma leírásában.

Ügyfélnaplók gyűjtése

A Raspberry Pi-eszközön két naplókészlet található:
```
/adu/logs
```
```
/var/cache/do-client-lite/log
```
A csomagolt ügyfél esetében a naplók itt találhatók:
```
/var/log/adu
```
```
/var/cache/do-client-lite/log
```
A szimulátor esetében a naplók itt találhatók:
```
/tmp/aduc-logs
```

Hibakódok

Előfordulhat, hogy hibakódokat kell megadnia a frissítés importálásával, az eszközhibával vagy a frissítés üzembe helyezésével kapcsolatos probléma bejelentésekor.

A hibakódok az ADUCoreInterface felületének megtekintésével szerezhetők be. Az öndiagnosztika és a hibaelhárítás hibakódjainak elemzésével kapcsolatos információkért tekintse meg az Eszközfrissítés hibakódok dokumentációját.

Nyomkövetési azonosító

Előfordulhat, hogy a rendszer egy frissítés importálásával vagy üzembe helyezésével kapcsolatos probléma bejelentésekor egy nyomkövetési azonosító megadását kéri.

Az adott felhasználói művelet nyomkövetési azonosítója az API-válaszban vagy a Azure Portal felhasználói felület Importálási előzmények szakaszában található.

Az üzembehelyezési műveletek nyomkövetési azonosítói jelenleg csak az API-válaszon keresztül érhetők el.

Üzembehelyezési azonosító

Előfordulhat, hogy a rendszer megkéri, hogy adjon meg egy üzembehelyezési azonosítót a frissítés üzembe helyezésével kapcsolatos probléma bejelentésekor.

Az üzembehelyezési azonosítót a felhasználó hozza létre, amikor meghívja az API-t az üzembe helyezés elindításához.

Jelenleg a Azure Portal felhasználói felületről indított üzembehelyezési azonosítók automatikusan létrejönnek, és nem jelennek meg a felhasználó számára.

IoT Hub példány neve

Előfordulhat, hogy a rendszer megkéri, hogy adja meg IoT Hub példány nevét az eszközhibákkal vagy egy frissítés üzembe helyezésével kapcsolatos probléma bejelentésekor.

A IoT Hub nevét a felhasználó választja ki az első üzembe helyezéskor.

Eszközfrissítési fiók neve

Előfordulhat, hogy a rendszer megkéri, hogy adja meg az eszközfrissítési fiók nevét egy frissítés importálásával, az eszközhibákkal vagy egy frissítés üzembe helyezésével kapcsolatos probléma bejelentésekor.

Az eszközfrissítési fiók nevét a felhasználó választja ki, amikor először regisztrál a szolgáltatásra. További információt az Eszközfrissítési erőforrások dokumentációjában talál.

Eszközfrissítési példány neve

Előfordulhat, hogy a rendszer megkéri, hogy adja meg az eszközfrissítési példány nevét egy frissítés importálásával, az eszközhibákkal vagy egy frissítés üzembe helyezésével kapcsolatos probléma bejelentésekor.

Az Eszközfrissítés példány nevét a felhasználó választja ki az első üzembe helyezéskor. További információt az Eszközfrissítési erőforrások dokumentációjában talál.

Eszközazonosító

Előfordulhat, hogy az eszközhibákkal vagy egy frissítés üzembe helyezésével kapcsolatos probléma bejelentésekor meg kell adnia egy eszközazonosítót.

Az eszközazonosítót az ügyfél határozza meg az eszköz első üzembe helyezésekor. Az eszköz ikereszközéről is lekérhető.

Frissítés azonosítója

Előfordulhat, hogy egy frissítés üzembe helyezésével kapcsolatos probléma bejelentésekor meg kell adnia a frissítésazonosítót.

A frissítési azonosítót az ügyfél határozza meg az üzembe helyezés indításakor.

Nginx-naplók

Előfordulhat, hogy az Nginx-naplók megadására van szükség a Microsoft Connected Cache-hez kapcsolódó probléma bejelentésekor.

ADU-conf.txt

Előfordulhat, hogy a rendszer megkéri, hogy adja meg az eszközfrissítés konfigurációs fájlját ("adu-conf.txt") a frissítés üzembe helyezésével kapcsolatos probléma bejelentésekor.

A konfigurációs fájl nem kötelező, és a felhasználó hozza létre az Eszközfrissítés konfigurációs dokumentációjának utasításait követve.

Jegyzékfájl importálása

Előfordulhat, hogy egy frissítés importálásával vagy üzembe helyezésével kapcsolatos probléma bejelentésekor meg kell adnia az importálási jegyzékfájlt.

Az importálási jegyzékfájl az ügyfél által a frissítési tartalom eszközfrissítési szolgáltatásba való importálásakor létrehozott fájl.

Következő lépések

További információ az eszközfrissítési hibakódokról