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

In diesem Dokument werden einige häufig gestellte Fragen und Probleme aufgeführt, die von Benutzern von Geräteaktualisierungen gemeldet wurden. 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 ein Update erfolgreich importiert, aber es wird nicht als verfügbar angezeigt, um es auf Geräten bereitzustellen, mit denen es kompatibel sein sollte.

Überprüfen Sie, ob ihr Importmanifest .json Datei keine versehentlichen Fehler aufweist, insbesondere in den Kompatibilitätsobjektwerten . Die Kompatibilitätseigenschaften im Importmanifest müssen exakt mit den von Ihren Geräten gemeldeten Eigenschaften übereinstimmen, wodurch sichergestellt wird, dass die richtigen Updates immer nur an die richtigen Geräte gesendet werden. Es kann beispielsweise ein typografischer Fehler im Importmanifest geben, der dazu führt, dass eine Kompatibilitätseigenschaft ein fehlendes, transponiertes oder zusätzliches Zeichen aufweist, verglichen mit dem, was ein Gerät meldet. Wenn ja, kann der Geräteupdate für IoT Hub-Dienst nicht mit dem Update auf diesem Gerät übereinstimmen. Wenn Sie bereits ein Update importiert haben, können Sie schnell nach Problemen mit Kompatibilitätseigenschaften suchen, indem Sie auf den Link "Details" für diese Aktualisierung klicken und dann im Kontextmenü auf "Weitere Details" klicken. Von dort aus können Sie den JSON-Inhalt des Importmanifests für diese Aktualisierung anzeigen und mögliche Fehler identifizieren.

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

Stellen Sie sicher, dass Ihre IoT Hub-Nachrichtenrouten gemäß der Dokumentation zur Geräteaktualisierung ordnungsgemäß konfiguriert sind.

F: Ich habe einen rollenbezogenen Fehler (Fehlermeldung im Azure-Portal oder einen 403-API-Fehler)

Möglicherweise verfügen Sie nicht über ordnungsgemäß konfigurierte Zugriffsberechtigungen. Stellen Sie sicher, dass Zugriffsberechtigungen gemäß der Dokumentation zur Zugriffssteuerung für Geräteupdates ordnungsgemäß konfiguriert sind.

F: Beim Importieren von Inhalten in den Geräteupdatedienst 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 die Anweisungen im Abschnitt " Kontaktieren des Microsoft-Supports ", um eine Supportanfrage bei Microsoft zu stellen.

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: 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. Diese Richtlinie ermöglicht es dem Geräteupdatedienst, sicher zu bestimmen, 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 Importfehlermeldungen finden Sie in der Dokumentation zu Fehlercodes für Geräteaktualisierungen .

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 (Do) ausgeführt wird. Wenn alle drei auf Ihr Gerät zutreffen, befolgen Sie die Anweisungen im Abschnitt " Kontaktieren des Microsoft-Supports ", um eine Supportanfrage bei Microsoft zu übermitteln.

F: Mein Geräteupdate-Agent kann nicht gestartet werden

Einer der häufigsten Gründe für einen Fehler beim Start des Geräteupdate-Agents ist eine falsch formatierte Konfigurationsdatei (du-config.json). Lesen Sie die Dokumentation zur Konfigurationsdatei , und stellen Sie sicher, dass Ihr Agent ordnungsgemäß konfiguriert ist. Alle Werte in der Konfigurationsdatei müssen doppelte Anführungszeichen verwenden.

Bereitstellen eines Updates

F: Ich habe ein Update auf meinem Gerät 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.

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 als inkompatibel mit dem Updateinhalt der aktuellen Bereitstellung betrachtet wird.

Überprüfen Sie die ADU Core Interface , um zu sehen, welcher Hersteller und Modell Ihr Gerät dem Geräteupdatedienst meldet. Stellen Sie sicher, dass sie dem Hersteller und Modell entspricht, den Sie im Importmanifest des von Ihnen bereitgestellten Updateinhalts 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 beim Erstellen einer Gruppe wird das Tag nicht in der Dropdownliste angezeigt.

Stellen Sie sicher, dass die Nachrichtenrouten in Ihrem IoT Hub gemäß der Dokumentation zu Geräteaktualisierungsressourcen ordnungsgemäß konfiguriert sind. 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 markiert haben, müssen Sie Das Gerät vorübergehend mit einem anderen Wert markieren, nachdem es bereitgestellt wurde, und dann das beabsichtigte Tag erneut hinzufügen.

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

Diese Bedingung kann durch einen clientseitigen Fehler auf den fehlgeschlagenen Geräten verursacht werden. 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.

Diese Bedingung kann durch einen Dienst-/UX-Fehler oder durch ein API-Berechtigungsproblem verursacht werden. Folgen Sie den Anweisungen im Abschnitt " Kontaktieren des Microsoft-Supports ", um eine Supportanfrage bei Microsoft zu stellen.

F: Ich habe eine Bereitstellung gestartet, erreicht aber keinen Endzustand

Diese Bedingung kann durch ein Dienstleistungsproblem, einen Dienstfehler oder einen Clientfehler verursacht werden. Wiederholen Sie die Bereitstellung nach 10 Minuten. 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 die Anweisungen im Abschnitt " Kontaktieren des Microsoft-Supports ", um eine Supportanfrage bei Microsoft zu stellen.

F: Ich habe von einem Agent auf Geräteebene migriert, um den Agent als Modulidentität auf dem Gerät hinzuzufügen. Jetzt wird mein Update als "in Bearbeitung" angezeigt, obwohl es auf das Gerät angewendet wird.

Diese Bedingung kann auftreten, wenn ein älterer Agent, der über das Gerät Twin kommuniziert, nicht entfernt wurde. Wenn Sie den Geräteaktualisierungs-Agent als Modul bereitstellen (siehe Vorgehensweise), erfolgt die gesamte Kommunikation zwischen dem Gerät und dem Geräteaktualisierungsdienst über das Modul Twin. Denken Sie daran, den Module Twin des Geräts zu markieren, wenn Sie Gruppen erstellen und alle Kommunikationen über das Modul Twin erfolgen müssen.

Herunterladen von Updates auf Geräte

F: Wie kann ich einen Download fortsetzen, wenn ein Gerät nach einem Zeitraum der Verbindung erneut verbunden wird?

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

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, ist jedoch fehlgeschlagen.

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 die DO-Client- und Nginx-Protokolle vom fehlerhaften Gerät (anweisungen zum Sammeln von Clientprotokollen finden Sie im Abschnitt zum Kontaktieren des Microsoft-Supports ).

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. Bestätigen Sie dies, indem Sie Ihre IoT Edge-Umgebungsvariablen im Azure-Portal überprüfen.

Problembehandlung bei einer fehlenden Instanz im Azure-Portal

F: Ich sehe keine Instanz des Geräteupdates für IoT Hub, wenn ich das Symbol "Zahnrad" auswählte.

Für dieses Problem gibt es einige mögliche Ursachen. Schritte zur Problembehandlung finden Sie unten.

Eine Geräteaktualisierungsinstanz muss einem Azure IoT-Hub in derselben Ressourcengruppe und demselben Abonnement zugeordnet sein. Wenn Sie entweder Ihre Geräteaktualisierungsinstanz oder Ihren Hub in eine andere Ressourcengruppe oder ein anderes Abonnement verschieben, wird Ihre Instanz möglicherweise nicht im Azure-Portal angezeigt. Führen Sie in diesem Falls eine der folgenden Schritte aus, um die Verwendung von Device Update für IoT Hub fortzusetzen:

• Gibt die verschobenen Elemente in die ursprüngliche Konfiguration zurück.

• Wenn Sie Ihren IoT-Hub nur von einer Ressourcengruppe in eine andere verschoben haben, ändern Sie Ihre Device Update-Instanz mit der neuen ResourceId des IoT-Hubs.

• Wenn Sie Elemente aus einem Abonnement in ein anderes verschoben haben, stellen Sie sicher, dass sich das Geräteaktualisierungskonto und der IoT-Hub im selben Abonnement befinden, und ändern Sie dann Ihre Device Update-Instanz mit der neuen ResourceId des IoT-Hubs.

Mindestens Berechtigungen auf Leseebene sind sowohl für Ihren IoT-Hub als auch für Ihr Geräteupdate für IoT Hub-Konto erforderlich, um über die IoT-Huboberfläche im Azure-Portal auf geräteupdate-Funktionen zuzugreifen.

• So verwalten Sie Berechtigungen für Ihren IoT Hub:
  • Wählen Sie Ihren Hub aus dem Azure-Portal aus.
  • Wählen Sie "Zugriffssteuerung (IAM) in der linken Navigationsleiste aus.
  • Wählen Sie "Rollenzuweisung hinzufügen" aus.
  • Wählen Sie eine Rolle mit mindestens Lesezugriff aus, und wählen Sie "Weiter" aus.
  • Wählen Sie neben "Mitglieder" "+Mitglieder auswählen" aus.
  • Fügen Sie Ihr Konto im rechten Flyout hinzu, und wählen Sie die Schaltfläche "Auswählen" aus.
  • Wählen Sie „Überprüfen und zuweisen“ aus.
• Um Berechtigungen für Ihr Geräteupdate für IoT Hub-Konto zu verwalten, bitten Sie den Besitzer des Kontos, die folgenden Schritte auszuführen:
  • Wählen Sie Ihr Geräteaktualisierungskonto aus dem Azure-Portal aus.
  • Wählen Sie "Zugriffssteuerung (IAM) in der linken Navigationsleiste aus.
  • Wählen Sie "Rollenzuweisung hinzufügen" aus.
  • Wählen Sie die Rolle "Leser" (oder eine mit entsprechenden Berechtigungen) aus.
  • Wählen Sie neben "Mitglieder" "+Mitglieder auswählen" aus.
  • Fügen Sie Ihr Konto im rechten Flyout hinzu, und wählen Sie die Schaltfläche "Auswählen" aus.
  • Wählen Sie „Überprüfen und zuweisen“ aus.

Erfahren Sie mehr über die rollenbasierte Zugriffssteuerung für den Geräteaktualisierungsdienst.

Kontaktaufnahme mit dem Microsoft-Support

Wenn Probleme auftreten, die nicht mithilfe des Inhalts auf dieser Seite behoben werden können, können Sie eine Supportanfrage über die Azure-Portalschnittstelle mit dem Microsoft-Support einreichen. Je nachdem, zu welcher Kategorie Sie Ihr Problem gehört, werden Sie möglicherweise aufgefordert, weitere Daten zu sammeln und zu teilen, um dem Microsoft-Support bei der Untersuchung Ihres Problems zu helfen.

Anweisungen zum Sammeln der einzelnen Datentypen finden Sie im restlichen Text in diesem Abschnitt.

Sie können getDevice verwenden, um weitere Informationen in der Nutzlastantwort der API zu überprüfen.

Schließen Sie ggf. auch die folgenden Informationen ein, da es hilfreich sein kann, die Ursache Ihres Problems einzugrenzen:

• Welche Art von Gerät Sie aktualisieren möchten (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.

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 die Protokolle hier:

/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 zum Analysieren von Fehlercodes für die Selbstdiagnose und Problembehandlung finden Sie in der Dokumentation zu Geräteupdatefehlercodes .

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ächste Schritte

Weitere Informationen zu Fehlercodes für Geräteupdates