Device Update für IoT Hub – Handbuch zur Problembehandlung

Dieses Dokument enthält einige häufig gestellte Fragen und Probleme, die von Device Update-Benutzern gemeldet wurden. Wenn bei Ihnen ein Problem auftritt, das in diesem Handbuch zur Problembehandlung nicht zu finden ist, lesen Sie den Abschnitt Kontaktaufnahme mit dem Microsoft-Support, um Ihre Situation zu dokumentieren.

Importieren von Updates

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

Bitte sorgen Sie dafür, dass Ihre IoT Hub-Nachrichtenrouten anhand der Dokumentation Device Update-Ressourcen richtig konfiguriert werden.

F: Bei mir ist ein rollenbezogener Fehler aufgetreten (eine Fehlermeldung im Azure-Portal oder ein API-Fehler 403).

Möglicherweise sind die Zugriffsberechtigungen nicht korrekt konfiguriert. Bitte stellen Sie sicher, dass Sie die Zugriffsrechte gemäß der Dokumentation Zugriffskontrolle für Geräte-Updates korrekt konfiguriert haben.

F: Beim Importieren von Inhalten in den Device Update-Dienst ist ein Fehler vom Typ „500“ aufgetreten.

Ein Fehlercode im Bereich 500 kann auf ein Problem mit dem Geräteaktualisierungsdienst hinweisen. Bitte warten Sie 5 Minuten, und versuchen Sie es dann erneut. Wenn derselbe Fehler weiterhin auftritt, folgen Sie bitte den Anweisungen im Abschnitt Kontaktierung des Microsoft-Support, um eine Support-Anfrage an Microsoft zu stellen.

F: Ich möchte dieselben Kompatibilitätseigenschaften beibehalten (Ziel: mein Update auf denselben Gerätetyp), doch den Anbieter oder Namen im Importmanifest ändern. Ich erhalte aber die Fehlermeldung „Fehler: Fehler beim Importieren des Updates aufgrund einer Überschreitung des Grenzwerts“, wenn ich so vorgehe.

Derselbe Satz von Kompatibilitätseigenschaften kann nicht bei mehreren Kombinationen aus Updateanbieter und Name 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 sollten. Wenn Sie mehrere Komponenten oder Partitionen auf einem einzelnen Gerät aktualisieren müssen, stellt das Feature Proxyupdates diese Funktion bereit.

F: Beim Importieren von Inhalten tritt eine Fehlermeldung auf, über die ich mehr erfahren möchte.

Ausführlichere Informationen zu importbezogenen Fehlermeldungen finden Sie in der Dokumentation zu Device Update-Fehlercodes.

Gerätefehler

F: Wie kann ich mich vergewissern, dass mein Gerät mit Device Update für IoT Hub verbunden ist?

Sie können sich vergewissern, dass Ihr Gerät mit Device Update verbunden ist, indem Sie überprüfen, ob es in der Konformitätsansicht des Azure-Portals im Abschnitt „Nicht gruppierte Geräte“ angezeigt wird.

F: Mindestens eines meiner Geräte wird nicht aktualisiert.

Es gibt viele mögliche Ursachen für ein fehlgeschlagenes Geräteupdate. Bitte überprüfen Sie, ob folgende Punkte zutreffen: 1) Das Gerät ist mit Ihrer IoT Hub-Instanz verbunden. 2) Das Gerät ist mit Ihrer Device Update-Instanz verbunden. 3) Der DO-Dienst (Delivery Optimization, Übermittlungsoptimierung) wird ausgeführt. Wenn alle drei Punkte auf Ihr Gerät zutreffen, folgen Sie bitte den Anweisungen im Abschnitt Kontaktierung des Microsoft-Support, um eine Support-Anfrage an Microsoft zu stellen.

F: Mein Device Update-Agent wird nicht gestartet.

Einer der häufigsten Gründe für einen Fehler beim Starten des Device Update-Agents ist eine nicht wohlgeformte Konfigurationsdatei („du-config.json“). Lesen Sie die Dokumentation zur Konfigurationsdatei, und stellen Sie sicher, dass Ihr Agent ordnungsgemäß konfiguriert ist. Beachten Sie, dass alle Werte in der Konfigurationsdatei in doppelte Anführungszeichen eingeschlossen werden müssen.

Bereitstellen eines Updates

F: Ich habe ein Update für mein(e) Gerät(e) bereitgestellt, aber für den Konformitätsstatus wird angezeigt, dass dies nicht das neueste Update ist. Wie sollte ich vorgehen?

Es kann bis zu 5 Minuten dauern, bis der Status der Gerätekonformität aktualisiert wird. Bitte warten Sie und prüfen Sie dann erneut.

F: Für den Bereitstellungsstatus meines Geräts wird „inkompatibel“ angezeigt. Wie sollte ich jetzt vorgehen?

Die Hersteller- und Modelleigenschaften eines Zielgeräts wurden möglicherweise geändert, nachdem das Gerät mit IoT Hub verbunden wurde. Dies hat dazu geführt, dass das Gerät jetzt als inkompatibel mit dem Updateinhalt der aktuellen Bereitstellung betrachtet wird.

Überprüfen Sie die ADU-Kernschnittstelle, um zu sehen, welchen Hersteller und welches Modell Ihr Gerät an den Geräteaktualisierungsdienst meldet, und stellen Sie sicher, dass es mit dem Hersteller und Modell übereinstimmt, das Sie im Importmanifest des bereitgestellten Aktualisierungsinhalts angegeben haben. Sie können diese Eigenschaften für ein bestimmtes Gerät mithilfe der Konfigurationsdatei Device Update ändern.

F: Ich sehe, dass meine Bereitstellung in der Phase „Aktiv“ ist, aber für keines meiner Geräte wird beim Update „In Bearbeitung“ angezeigt. Wie sollte ich vorgehen?

Vergewissern Sie sich, dass das Datum für den Beginn Ihres Bereitstellung nicht in der Zukunft liegt. Wenn Sie eine neue Bereitstellung erstellen, wird als Startdatum dafür standardmäßig sicherheitshalber der nächste Tag festgelegt, wenn Sie dies nicht explizit ändern. 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 im Dropdown nicht angezeigt.

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

Eine andere Ursache könnte sein, dass Sie das Tag angewendet haben, bevor Sie Ihr Gerät mit Device Update for IoT Hub verbunden haben. Vergewissern Sie sich, das Ihr Gerät bereits mit Device Update verbunden ist. Sie können sich vergewissern, dass Ihr Gerät mit Device Update für IoT Hub verbunden ist, indem Sie überprüfen, ob es in der Konformitätsansicht unter „Nicht gruppierte Geräte“ angezeigt wird. Fügen Sie vorübergehend eine Kennzeichnung mit einem anderen Wert hinzu, und fügen Sie die gewünschte Kennzeichnung erneut hinzu, sobald das Gerät angeschlossen ist.

Wenn Sie den Gerätebereitstellung Service (DPS) verwenden, stellen Sie sicher, dass Sie Ihre Geräte nach der Bereitstellung kennzeichnen und nicht während der Geräteerstellung. Wenn Sie Ihr Gerät bereits während des Schritts "Geräteerstellung" gekennzeichnet haben, müssen Sie es nach der Bereitstellung vorübergehend mit einem anderen Wert kennzeichnen und dann die gewünschte Kennzeichnung erneut hinzufügen.

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

Dies kann durch einen clientseitigen Fehler auf den ausgefallenen Geräten verursacht worden sein. Bitte lesen Sie den Abschnitt Geräteausfälle in dieser Anleitung zur Fehlerbehebung.

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

Dies kann durch einen Dienst-/UX-Fehler oder ein API-Berechtigungsproblem verursacht worden sein. Bitte folgen Sie den Anweisungen im Abschnitt Kontaktaufnahme mit dem Microsoft-Support, um eine Support- Anforderung an Microsoft zu stellen.

F: Ich habe eine Bereitstellung gestartet, doch sie erreicht keinen Endzustand.

Dies kann durch ein Leistungsproblem des Dienstes, einen Fehler des Dienstes oder einen Fehler des Clients verursacht worden sein. Bitte wiederholen Sie Ihre Bereitstellung nach 10 Minuten. Wenn dasselbe Problem auftritt, pullen Sie bitte Ihre Geräteprotokolle, und lesen Sie in diesem Handbuch zur Problembehandlung den Abschnitt „Gerätefehler“. Wenn das Problem weiterhin besteht, folgen Sie bitte den Anweisungen im Abschnitt Kontaktierung des Microsoft-Support, um eine Support-Anfrage an Microsoft zu stellen.

F: Ich bin von einem Agent auf Geräteebene migriert, um ihn als Modulidentität auf dem Gerät hinzuzufügen, und mein Update wird als „in Bearbeitung“ angezeigt, obwohl es auf das Gerät angewendet wurde.

Der mögliche Grund für diese Meldung: Sie haben den älteren Agent, der über den Gerätezwilling kommuniziert hat, nicht entfernt. Wenn Sie den Geräteupdate-Agent als Modul bereitstellen (siehe Vorgehensweise), erfolgt die gesamte Kommunikation zwischen dem Gerät und dem Geräteupdatedienst über den Modulzwilling. Denken Sie also daran: Der Modulzwilling des Geräts muss beim Erstellen von Gruppen markiert werden und die gesamte Kommunikation über den Modulzwilling erfolgen.

Herunterladen von Updates auf Geräte

F: Wie kann ich einen Download fortsetzen, wenn ein Gerät nach einer Phase der Verbindungstrennung erneut verbunden wurde?

Der Download wird automatisch fortgesetzt, wenn die Verbindung innerhalb von 24 Stunden wiederhergestellt ist. Nach 24 Stunden muss der Nutzer den Download erneut initiieren.

Verwendung von Microsoft Connected Cache (MCC)

F: Wenn ich versuche, das MCC-Modul auf meinem IoT Edge-Gerät bereitzustellen, tritt ein Problem auf.

Siehe die IoT Edge-Dokumentation für die 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 ausgeführt wird, indem Sie zu http://localhost:5100/Summary. navigieren

F: Eines meiner IoT-Geräte versucht, ein Update über MCC herunterzuladen, doch das gelingt nicht.

Es gibt mehrere Gründe, die dazu führen können, dass ein IoT-Gerät keine Verbindung zu MCC herstellen kann. Um das Problem zu diagnostizieren, sammeln Sie bitte die DO-Client- und Nginx-Protokolle des fehlerhaften Geräts (Anweisungen zum Sammeln von Client-Protokollen finden Sie im Abschnitt Kontakt mit dem Microsoft-Support).

Möglicherweise kann Ihr Gerät keine Inhalte aus dem Internet zur Übergabe an sein MCC-Modul pullen, weil die von ihm verwendete URL nicht zulässig ist. Um festzustellen, ob dies der Fall ist, müssen Sie Ihre IoT Edge-Umgebungsvariablen im Azure-Portal überprüfen.

Problembehandlung für eine fehlende Instanz im Azure-Portal

F: Ich sehe keine Instanz von Device Update for IoT Hub, wenn ich das Zahnradsymbol auswählte.

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

Eine Device Update-Instanz muss einem Azure IoT Hub in derselben Ressourcengruppe und demselben Abonnement zugeordnet sein. Wenn Sie Ihre Device Update-Instanz oder Ihren Hub in eine andere Ressourcengruppe oder ein anderes Abonnement verschoben haben, wird Ihre Instanz möglicherweise nicht im Azure-Portal angezeigt. Sie müssen einen der folgenden Schritte ausführen, um Device Update for IoT Hub weiterhin verwenden zu können:

• Stellen Sie die ursprüngliche Konfiguration für die verschobenen Elemente wieder her.
• 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 Device Update-Konto und der IoT-Hub im selben Abonnement befinden, und ändern Sie dann Ihre Device Update-Instanz mit der neuen resourceId des IoT-Hubs.

Es sind mindestens Berechtigungen auf Leseebene sowohl für Ihren IoT-Hub als auch für Ihr Device Update for IoT Hub-Konto erforderlich, um über die IoT-Hub-Benutzeroberfläche im Azure-Portal auf die Device Update-Funktionalität zuzugreifen.

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

Weitere Informationen zur rollenbasierten Zugriffssteuerung für den Device Update-Dienst.

Kontaktaufnahme mit dem Microsoft-Support

Wenn Probleme auftreten, die sich mithilfe der oben aufgeführten FAQs (Häufig gestellte Fragen) nicht lösen lassen, können Sie über die Benutzeroberfläche des Azure-Portals eine Supportanfrage beim Microsoft-Support einreichen. Je nach der Kategorie, zu der Ihr Problem entsprechend Ihrer Angabe gehört, werden Sie möglicherweise aufgefordert, zusätzliche Daten zu erfassen und freizugeben, damit der Microsoft-Support Ihr Problem untersuchen kann.

Anleitungen zum Erfassen der einzelnen Datentypen finden Sie weiter unten.

Mithilfe von getDevice können Sie überprüfen, ob die Nutzdatenantwort der API zusätzliche Informationen enthält.

Außerdem können die folgenden Informationen hilfreich sein, um die Grundursache Ihres Problems einzugrenzen:

• Der Typ des Geräts, das Sie zu aktualisieren versuchen (IoT Edge Gateway, anderes)
• Der verwendete Device Update-Clienttyp (imagebasiert, paketbasiert, Simulator)
• Das Betriebssystem Ihres Geräts
• Details zur Architektur Ihres Geräts
• Die Mitteilung, ob Sie Device Update zum Aktualisieren eines Geräts vorher erfolgreich verwendet haben

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

Sammeln von Clientprotokollen

• Auf dem Raspberry Pi-Gerät finden Sie hier zwei Sätze von Protokollen:

  /adu/logs
  

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

• Die Protokolle für das Clientpaket finden Sie hier:

  /var/log/adu
  

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

• Die Protokolle für den Simulator finden Sie hier:

  /tmp/aduc-logs
  

Fehlercodes

Möglicherweise werden Sie zur Angabe von Fehlercodes aufgefordert, wenn Sie ein Problem im Zusammenhang mit dem Importieren eines Updates, einem Gerätefehler oder der Bereitstellung eines Updates melden.

Fehlercodes können über die Schnittstelle ADUCoreInterface abgerufen werden. Informationen zum Analysieren von Fehlercodes für Selbstdiagnose und Problembehandlung finden Sie in der Dokumentation zu den Device Update-Fehlercodes.

Ablaufverfolgungs-ID

Möglicherweise werden Sie zur Angabe einer Ablaufverfolgungs-ID aufgefordert, wenn Sie ein Problem im Zusammenhang mit dem Importieren oder der Bereitstellung eines Updates melden.

Die Ablaufverfolgungs-ID für eine bestimmte Benutzeraktion finden Sie in der API-Antwort oder im Abschnitt „Import History“ (Importverlauf) der Benutzeroberfläche des Azure-Portals.

Zurzeit kann auf Ablaufverfolgungs-IDs für Bereitstellungsaktionen nur über die API-Antwort zugegriffen werden.

Bereitstellungs-ID

Möglicherweise werden Sie zur Angabe einer Bereitstellungs-ID aufgefordert, wenn Sie ein Problem im Zusammenhang mit der Bereitstellung eines Updates melden.

Die Bereitstellungs-ID wird vom Benutzer erstellt, wenn er die API zum Initiieren einer Bereitstellung aufruft.

Zurzeit werden Bereitstellungs-IDs für Bereitstellungen, die über die Benutzeroberfläche des Azure-Portals initiiert werden, automatisch generiert und dem Benutzer nicht angezeigt.

IoT Hub-Instanzname

Möglicherweise werden Sie zur Angabe Ihres IoT Hub-Instanznamens aufgefordert, wenn Sie ein Problem im Zusammenhang mit Gerätefehlern oder der Bereitstellung eines Updates melden.

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

Device Update-Kontoname

Möglicherweise werden Sie zur Angabe Ihres Device Update-Kontonamens aufgefordert, wenn Sie ein Problem im Zusammenhang mit dem Importieren eines Updates, Gerätefehlern oder der Bereitstellung eines Updates melden.

Der Device Update-Kontoname wird vom Benutzer ausgewählt, wenn er sich zum ersten Mal bei dem Dienst anmeldet. Weitere Informationen finden Sie in der Dokumentation zu Device Update-Ressourcen.

Device Update-Instanzname

Möglicherweise werden Sie zur Angabe Ihres Device Update-Instanznamens aufgefordert, wenn Sie ein Problem im Zusammenhang mit dem Importieren eines Updates, Gerätefehlern oder der Bereitstellung eines Updates melden.

Der Device Update-Instanzname wird vom Benutzer bei der ersten Bereitstellung ausgewählt. Weitere Informationen finden Sie in der Dokumentation zu Device Update-Ressourcen.

Geräte-ID

Möglicherweise werden Sie zur Angabe einer Geräte-ID aufgefordert, wenn Sie ein Problem im Zusammenhang mit Gerätefehlern oder der Bereitstellung eines Updates melden.

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

Update-ID

Möglicherweise werden Sie zur Angabe einer Update-ID aufgefordert, wenn Sie ein Problem im Zusammenhang mit der Bereitstellung eines Updates melden.

Die Update-ID wird vom Kunden definiert, wenn er eine Bereitstellung initiiert.

Nginx-Protokolle

Möglicherweise werden Sie zur Angabe von Nginx-Protokollen aufgefordert, wenn Sie ein Problem im Zusammenhang mit Microsoft Connected Cache melden.

ADU-conf.txt

Möglicherweise werden Sie zur Angabe der Device Update-Konfigurationsdatei („adu-conf.txt“) aufgefordert, wenn Sie ein Problem im Zusammenhang mit der Bereitstellung eines Updates melden.

Die Konfigurationsdatei ist optional und wird vom Benutzer anhand der Anleitungen in der Dokumentation zur Device Update-Aktualisierung erstellt.

Importmanifest

Möglicherweise werden Sie zur Angabe Ihrer Importmanifestdatei aufgefordert, wenn Sie ein Problem im Zusammenhang mit dem Importieren oder der Bereitstellung eines Updates melden.

Das Importmanifest ist eine Datei, die vom Kunden beim Importieren von Updateinhalten in den Device Update-Dienst erstellt wird.

Nächste Schritte

Weitere Informationen zu Device Update-Fehlercodes