Freigeben über

Handbuch zur Problembehandlung beim Geräteupdate für IoT Hub

In diesem Dokument werden einige häufig gestellte Fragen und Probleme aufgeführt, die Geräteaktualisierungsbenutzer gemeldet haben. Wenn die Geräteaktualisierung über die öffentliche Vorschau fortschreitet, wird dieses Handbuch zur Problembehandlung regelmäßig mit neuen Fragen und Lösungen aktualisiert. Wenn ein Problem auftritt, das in diesem Handbuch zur Problembehandlung nicht angezeigt wird, lesen Sie den Abschnitt Kontaktieren des Microsoft-Supports, um Ihre Situation zu dokumentieren.

Importieren von Updates

F: Ich habe Probleme beim Verbinden meiner Device Update-Instanz mit meiner IoT Hub-Instanz.

Stellen Sie sicher, dass Ihre IoT Hub-Nachrichtenrouten gemäß den Geräteaktualisierungsressourcen Dokumentation ordnungsgemäß konfiguriert sind.

Möglicherweise verfügen Sie nicht über ordnungsgemäß konfigurierte Zugriffsberechtigungen. Stellen Sie sicher, dass Sie die Zugriffsberechtigungen gemäß der Geräteaktualisierungs-Zugriffssteuerung Dokumentation ordnungsgemäß konfiguriert haben.

F: Beim Importieren von Inhalten in den Geräteaktualisierungsdienst tritt ein Fehler vom Typ 500 auf.

Ein Fehlercode im Bereich von 500 kann auf ein Problem mit dem Geräteaktualisierungsdienst hinweisen. Warten Sie 5 Minuten, und versuchen Sie es dann erneut. Wenn derselbe Fehler weiterhin auftritt, befolgen Sie bitte die Anweisungen im Abschnitt Kontaktieren des Microsoft-Supports, um eine Supportanfrage bei Microsoft zu senden.

F: Ich möchte die gleichen Kompatibilitätseigenschaften beibehalten (ziele mein Update auf denselben Gerätetyp), aber den Anbieter oder Namen im Importmanifest ändern. Aber ich erhalte eine Fehlermeldung "Fehler beim Importieren der Aktualisierung aufgrund des überschrittenen Grenzwerts", wenn ich dies tue.

Der gleiche Satz von Kompatibilitätseigenschaften kann nicht mit mehreren Updateanbieter- und Namenskombinationen verwendet werden. Auf diese Weise kann der Geräteupdatedienst mit Sicherheit ermitteln, welche Updates für die Bereitstellung auf einem bestimmten Gerät verfügbar sein sollen. Wenn Sie mehrere Komponenten oder Partitionen auf einem einzelnen Gerät aktualisieren müssen, stellt das Proxyupdate-Feature diese Funktion bereit.

F: Beim Importieren von Inhalten wird eine Fehlermeldung angezeigt und möchte mehr darüber erfahren.

Ausführlichere Informationen zu importbezogenen Fehlermeldungen finden Sie in der Dokumentation zu Geräteaktualisierungsfehlercodes .

Gerätefehler

F: Wie kann ich sicherstellen, dass mein Gerät mit dem Geräteupdate für IoT Hub verbunden ist?

Sie können überprüfen, ob Ihr Gerät mit der Geräteaktualisierung verbunden ist, indem Sie überprüfen, ob es im Abschnitt "Nicht gruppierte" Geräte in der Complianceansicht des Azure-Portals angezeigt wird.

F: Mindestens ein Gerät kann nicht aktualisiert werden.

Es gibt viele mögliche Ursachen für einen Geräteupdatefehler. Überprüfen Sie, ob das Gerät: 1) mit Ihrer IoT Hub-Instanz verbunden ist, 2) mit Ihrer Device Update-Instanz verbunden ist, und 3) der Übermittlungsoptimierungsdienst (Delivery Optimization, DO) ausgeführt wird. Wenn alle drei auf Ihr Gerät zutreffen, befolgen Sie bitte die Anweisungen im Abschnitt Kontaktieren des Microsoft-Supports, um eine Supportanfrage bei Microsoft zu übermitteln.

Bereitstellen eines Updates

F: Ich habe ein Update auf meinem Gerät(n) bereitgestellt, aber der Compliancestatus besagt, dass es sich nicht um das neueste Update handelt. Was soll ich tun?

Der Gerätekonformitätsstatus kann bis zu 5 Minuten benötigen, um sich zu aktualisieren. Bitte warten Sie, und überprüfen Sie es erneut.

F: Der Bereitstellungsstatus meines Geräts wird inkompatibel angezeigt, was sollte ich tun?

Die Hersteller- und Modelleigenschaften eines Zielgeräts wurden möglicherweise geändert, nachdem das Gerät mit IoT Hub verbunden wurde, was dazu führt, dass das Gerät jetzt nicht mit dem Updateinhalt der aktuellen Bereitstellung kompatibel ist.

Überprüfen Sie die ADU Core Interface-, um zu sehen, welcher Hersteller und Modell Ihr Gerät dem Geräteupdatedienst meldet, und stellen Sie sicher, dass sie dem Hersteller und Modell entspricht, den Sie im Importmanifest der bereitgestellten Updateinhalte angegeben haben. Sie können diese Eigenschaften für ein bestimmtes Gerät mithilfe der konfigurationsdatei Device Updateändern.

F: Ich sehe, dass sich meine Bereitstellung im Status "Aktiv" befindet, aber kein meiner Geräte ist "In Bearbeitung" mit dem Update. Was soll ich tun?

Stellen Sie sicher, dass ihr Bereitstellungsanfangsdatum in Zukunft nicht festgelegt ist. Wenn Sie eine neue Bereitstellung erstellen, wird der Starttermin der Bereitstellung standardmäßig am nächsten Tag als Sicherheit festgelegt, es sei denn, Sie ändern sie explizit. Sie können entweder warten, bis das Startdatum für die Bereitstellung erreicht ist, oder die laufende Bereitstellung abbrechen und eine neue Bereitstellung mit dem gewünschten Startdatum erstellen.

F: Ich versuche, meine Geräte zu gruppieren, aber der Tag wird beim Erstellen einer Gruppe nicht im Dropdown-Menü angezeigt.

Stellen Sie sicher, dass Sie die Nachrichtenrouten in Ihrem IoT Hub gemäß den Geräteaktualisierungsressourcen Dokumentation ordnungsgemäß konfiguriert haben. Sie müssen Ihr Gerät nach der Konfiguration der Route erneut markieren.

Eine weitere Ursache könnte sein, dass Sie das Tag angewendet haben, bevor Sie Ihr Gerät an Device Update für IoT Hub angeschlossen haben. Stellen Sie sicher, dass Ihr Gerät bereits mit dem Geräteupdate verbunden ist. Sie können überprüfen, ob Ihr Gerät mit dem Geräteupdate für IoT Hub verbunden ist, indem Sie überprüfen, ob es in der Complianceansicht unter "Nicht gruppierte" Geräte angezeigt wird. Fügen Sie vorübergehend ein Tag mit einem anderen Wert hinzu, und fügen Sie Ihr beabsichtigtes Tag dann erneut hinzu, sobald das Gerät verbunden ist.

Wenn Sie den Device Provisioning Service (DPS) verwenden, stellen Sie sicher, dass Sie Ihre Geräte nach der Bereitstellung markieren und nicht während des Geräteerstellungsprozesses. Wenn Sie Ihr Gerät bereits während des Geräteerstellungsschritts getaggt haben, müssen Sie das Gerät vorübergehend mit einem anderen Wert taggen, nachdem es bereitgestellt ist, und dann den beabsichtigten Tag erneut hinzufügen.

F: Meine Bereitstellung wurde erfolgreich abgeschlossen, aber einige Geräte konnten nicht aktualisiert werden.

Dies wurde möglicherweise durch einen clientseitigen Fehler auf den fehlgeschlagenen Geräten verursacht. Weitere Informationen finden Sie im Abschnitt "Gerätefehler" dieses Handbuchs zur Problembehandlung.

F: Beim Versuch, eine Bereitstellung zu initiieren, ist ein Fehler in der UX aufgetreten.

Dies wurde möglicherweise durch einen Dienst-/UX-Fehler oder durch ein API-Berechtigungsproblem verursacht. Befolgen Sie die Anweisungen im Abschnitt Kontaktieren des Microsoft-Supports, um eine Supportanfrage bei Microsoft zu senden.

F: Ich habe eine Bereitstellung gestartet, aber sie gelangt nicht in einen Endzustand.

Dies kann durch ein Dienstleistungsproblem, einen Dienstfehler oder einen Clientfehler verursacht worden sein. Versuchen Sie die Bereitstellung nach 10 Minuten erneut. Wenn Sie auf dasselbe Problem stoßen, holen Sie sich bitte die Geräteprotokolle, und schauen Sie in den Abschnitt "Gerätefehler" dieses Leitfadens zur Problembehandlung. Wenn dasselbe Problem weiterhin besteht, befolgen Sie bitte die Anweisungen im Abschnitt Kontaktieren des Microsoft-Supports, um eine Supportanfrage bei Microsoft zu senden.

F: Ich bin von einem Agenten auf Geräteebene dazu übergegangen, den Agenten als Modulidentität auf dem Gerät hinzuzufügen, und mein Update wird als "in Bearbeitung" angezeigt, obwohl es bereits auf das Gerät angewendet wurde.

_Dies könnte verursacht worden sein, wenn Sie nicht den älteren Agenten entfernt haben, der über den Gerätezwilling kommunizierte. Wenn Sie den Agent für Geräteaktualisierungen als Modul bereitstellen (siehe , wie Sie), erfolgen alle Kommunikationen zwischen dem Gerät und dem Geräteaktualisierungsdienst über den Modul-Zwilling. Denken Sie daran, den Modul-Zwilling des Geräts zu kennzeichnen, wenn Sie Gruppen erstellen und alle Kommunikationen müssen über den Modul-Zwilling erfolgen.

Herunterladen von Updates auf Geräte

F: Wie kann ich einen Download fortsetzen, wenn ein Gerät nach einer Trennung wiederverbindet?

Der Download wird automatisch fortgesetzt, wenn die Verbindung innerhalb eines Zeitraums von 24 Stunden wiederhergestellt wird. Nach 24 Stunden muss der Download vom Benutzer erneut gestartet werden.

Verwendung von Microsoft Connected Cache (MCC)

F: Beim Versuch, das MCC-Modul auf meinem IoT Edge-Gerät bereitzustellen, tritt ein Problem auf.

In der IoT Edge-Dokumentation finden Sie Informationen zur Bereitstellung von Edge-Modulen auf IoT Edge-Geräten. Sie können überprüfen, ob das MCC-Modul erfolgreich auf Ihrem IoT Edge-Gerät läuft, indem Sie zu http://localhost:5100/Summary. navigieren.

F: Eines meiner IoT-Geräte versucht, ein Update über MCC herunterzuladen, aber fehlschlägt.

Es gibt mehrere Probleme, die dazu führen können, dass ein IoT-Gerät bei der Verbindung mit MCC fehlschlägt. Um das Problem zu diagnostizieren, sammeln Sie bitte die DO-Client- und Nginx-Protokolle vom fehlerhaften Gerät (siehe Kontakt mit dem Microsoft-Support Abschnitt für Anweisungen zum Sammeln von Clientprotokollen).

Ihr Gerät kann keine Inhalte aus dem Internet abrufen, um an das MCC-Modul zu übergeben, da die verwendete URL nicht zulässig ist. Um festzustellen, ob dies der Fall ist, müssen Sie die IoT Edge-Umgebungsvariablen im Azure-Portal überprüfen.

Kontaktaufnahme mit dem Microsoft-Support

Wenn Probleme auftreten, die mithilfe der oben genannten HÄUFIG gestellten Fragen nicht behoben werden können, können Sie eine Supportanfrage über die Azure-Portalschnittstelle mit dem Microsoft-Support einreichen. Je nachdem, zu welcher Kategorie Ihr Problem gehört, werden Sie möglicherweise aufgefordert, zusätzliche Daten zu sammeln und zu teilen, um microsoft Support bei der Untersuchung Ihres Problems zu unterstützen.

Anweisungen zum Sammeln der einzelnen Datentypen finden Sie unten. Sie können getDevices- verwenden, um in der Nutzlastantwort der API nach zusätzlichen Informationen zu suchen.

Darüber hinaus können die folgenden Informationen hilfreich sein, um die Ursache Ihres Problems einzugrenzen:

  • Welche Art von Gerät Sie aktualisieren möchten (Azure Percept, IoT Edge Gateway, andere)
  • Welchen Geräteupdate-Clienttyp Sie verwenden (Image-based, Package-based, Simulator)
  • Das Betriebssystem, auf dem Ihr Gerät ausgeführt wird
  • Details zur Architektur Ihres Geräts
  • Gibt an, ob Sie Geräteupdate verwendet haben, um ein Gerät zuvor erfolgreich zu aktualisieren.

Wenn Sie über eine der oben genannten Informationen verfügen, fügen Sie sie bitte in Ihre Beschreibung des Problems ein.

Sammeln von Clientprotokollen

  • Auf dem Raspberry Pi-Gerät gibt es hier zwei Protokolle:

    /adu/logs

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

  • Für den verpackten Client finden Sie hier die Protokolle:

    /var/log/adu

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

  • Für den Simulator finden Sie die Protokolle hier:

    /tmp/aduc-logs

Fehlercodes

Möglicherweise werden Sie aufgefordert, Fehlercodes anzugeben, wenn ein Problem beim Importieren eines Updates, eines Gerätefehlers oder beim Bereitstellen eines Updates gemeldet wird.

Fehlercodes können abgerufen werden, indem die ADUCoreInterface Schnittstelle betrachtet wird. Informationen darüber, wie Fehlercodes für die Selbstdiagnose und Fehlerbehebung analysiert werden können, finden Sie in der Dokumentation zu Gerät-Update-Fehlercodes.

Trace-ID

Möglicherweise werden Sie aufgefordert, eine Protokoll-ID anzugeben, wenn Sie ein Problem im Zusammenhang mit dem Importieren oder Bereitstellen eines Updates melden.

Die Ablaufverfolgungs-ID für eine bestimmte Benutzeraktion kann in der API-Antwort oder im Abschnitt "Importverlauf" der Azure-Portal-Benutzeroberfläche gefunden werden.

Derzeit sind Trace-IDs für Bereitstellungsaktionen nur über die API-Antwort verfügbar.

Bereitstellungs-ID

Möglicherweise werden Sie aufgefordert, eine Bereitstellungs-ID anzugeben, wenn ein Problem im Zusammenhang mit der Bereitstellung eines Updates gemeldet wird.

Die Bereitstellungs-ID wird vom Benutzer beim Aufrufen der API erstellt, um eine Bereitstellung zu initiieren.

Derzeit werden Bereitstellungs-IDs für Bereitstellungen, die über die Azure-Portal-Benutzeroberfläche initiiert werden, automatisch generiert und nicht für den Benutzer angezeigt.

IoT Hub-Instanzname

Möglicherweise werden Sie aufgefordert, den Namen Ihrer IoT Hub-Instanz anzugeben, wenn ein Problem im Zusammenhang mit Gerätefehlern oder beim Bereitstellen eines Updates gemeldet wird.

Der IoT Hub-Name wird vom Benutzer bei der ersten Bereitstellung ausgewählt.

Name des Geräteaktualisierungskontos

Möglicherweise werden Sie aufgefordert, den Namen Ihres Geräteupdatekontos anzugeben, wenn ein Problem beim Importieren eines Updates, Gerätefehlers oder beim Bereitstellen eines Updates gemeldet wird.

Der Name des Geräteaktualisierungskontos wird vom Benutzer ausgewählt, wenn er sich zum ersten Mal für den Dienst anmeldet. Weitere Informationen finden Sie in der Geräteaktualisierungsressourcen Dokumentation.

Name der Geräteaktualisierungsinstanz

Möglicherweise werden Sie aufgefordert, den Namen Ihrer Geräteaktualisierungsinstanz anzugeben, wenn ein Problem beim Importieren eines Updates, Gerätefehlers oder beim Bereitstellen eines Updates gemeldet wird.

Der Name der Geräteaktualisierungsinstanz wird vom Benutzer bei der ersten Bereitstellung ausgewählt. Weitere Informationen finden Sie in der Geräteaktualisierungsressourcen Dokumentation.

Geräte-ID

Möglicherweise werden Sie aufgefordert, eine Geräte-ID anzugeben, wenn ein Problem im Zusammenhang mit Gerätefehlern oder beim Bereitstellen eines Updates gemeldet wird.

Die Geräte-ID wird vom Kunden definiert, wenn das Gerät zum ersten Mal bereitgestellt wird. Sie kann auch vom Device Twin des Geräts abgerufen werden.

Update-Kennung

Möglicherweise werden Sie aufgefordert, eine Update-ID anzugeben, wenn ein Problem im Zusammenhang mit der Bereitstellung eines Updates gemeldet wird.

Die Update-ID wird vom Kunden beim Initiieren einer Bereitstellung definiert.

Nginx-Protokolle

Möglicherweise werden Sie aufgefordert, Nginx-Protokolle bereitzustellen, wenn ein Problem im Zusammenhang mit microsoft Connected Cache gemeldet wird.

ADU-conf.txt

Möglicherweise werden Sie aufgefordert, die Geräteupdate-Konfigurationsdatei ("adu-conf.txt") bereitzustellen, wenn ein Problem im Zusammenhang mit der Bereitstellung eines Updates gemeldet wird.

Die Konfigurationsdatei ist optional und wird vom Benutzer nach den Anweisungen in der Geräteaktualisierungskonfiguration Dokumentation erstellt.

Importmanifest

Möglicherweise werden Sie aufgefordert, Ihre Importmanifestdatei anzugeben, wenn ein Problem im Zusammenhang mit dem Importieren oder Bereitstellen eines Updates gemeldet wird.

Das Importmanifest ist eine Datei, die vom Kunden beim Importieren von Updateinhalten in den Geräteaktualisierungsdienst erstellt wird.

Nächster Schritt: Weitere Informationen zu Fehlercodes für Geräteupdates

  • Last updated on