Bereitstellen des Geräte-Update-Agents

  • Artikel

Der Modul-Agent für Geräte-Updates kann zusammen mit anderen Systemprozessen und IOT Edge Modulen ausgeführt werden, die eine Verbindung mit Ihrem IOT Hub als Teil desselben logischen Geräts herstellen. In diesem Abschnitt wird beschrieben, wie Sie den Geräte-Update-Agent als Modulkennung bereitstellen.

Änderungen am Device Update-Agent im GA-Release

Wenn Sie Device Update-Agent-Versionen verwenden, migrieren Sie zur neuesten Agent-Version 1.0.0. Weitere Informationen finden Sie unter Migrieren von Geräten und Gruppen zum neuesten Device Update for IoT Hub-Release.

Sie können die installierte Version des Device Update-Agents und des Übermittlungsoptimierungs-Agents im Abschnitt „Device Properties“ (Geräteeigenschaften) Ihres IoT-Gerätezwillings überprüfen. Weitere Informationen zu Geräteeigenschaften finden Sie unter ADU Core-Schnittstelle.

Modulkennung im Vergleich zur Geräteidentität

In IoT Hub können unter jeder Geräteidentität bis zu 50 Modulidentitäten erstellt werden. Jede Modulidentität generiert implizit einen Modulzwilling. Auf der Geräteseite können Sie mithilfe der IoT Hub-Geräte-SDKs Module erstellen, die jeweils eine unabhängige Verbindung mit IoT Hub herstellen. Modulidentität und Modulzwilling bieten die gleichen Funktionen wie Geräteidentität und Gerätezwilling, aber mit einer höheren Granularität. Erfahren Sie mehr über Modulidentitäten in Azure IoT Hub

Wenn Sie von einem Agent auf Geräteebene migrieren, um den Agent als Modulidentität auf dem Gerät hinzuzufügen, entfernen Sie den älteren Agent, der über den Gerätezwilling kommuniziert hat. Wenn Sie den Geräteupdate-Agent als Modulidentität bereitstellen, 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.

Unterstützung für Geräteobjekte

Die folgenden Arten von Over-the-Air-Updates für IoT-Geräte werden derzeit von der Geräteaktualisierung unterstützt:

Voraussetzungen

Wenn Sie das IOT-Gerät/IOT Edge Gerät für paketbasierte Updateseinrichten, fügen Sie Packages.Microsoft.com den Depots Ihres Computers hinzu, indem Sie die folgenden Schritte ausführen:

  1. Melden Sie sich auf dem Computer oder dem IOT-Gerät an, auf dem Sie den Agent für die Geräteaktualisierung installieren möchten.

  2. Öffnen Sie ein Terminalfenster.

  3. Installieren Sie die zum Betriebssystem Ihres Geräts passende Repositorykonfiguration.

    curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list

  4. Kopieren Sie die generierte Liste in das Verzeichnis „sources.list.d“.

    sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/

  5. Installieren Sie den öffentlichen Schlüssel von Microsoft GPG.

    curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg

    sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/

So stellen Sie den Geräte-Update-Agenten als Modulkennung bereit

In diesem Abschnitt wird beschrieben, wie Sie den Device Update-Agent als Modulkennung auf folgenden Geräten bereitstellen:

  • IoT Edge-fähige Geräte
  • Geräte ohne Edge IoT
  • andere IoT-Geräte

Anweisungen zur Überprüfung, ob IoT Edge auf dem Gerät aktiviert ist, finden Sie unter den Installationsanweisungen für IoT Edge.

Führen Sie die Schritte in allen oder einigen der folgenden Abschnitte aus, um den Device Update-Agent basierend auf dem Typ des von Ihnen verwalteten IoT-Geräts hinzuzufügen.

Auf IOT Edge aktivierten Geräten

Befolgen Sie diese Anweisungen, um den Geräte-Update-Agent auf IOT Edge aktivierten Gerätenbereitzustellen.

  1. Führen Sie die Schritte unter Manuelles Bereitstellen eines einzelnen Linux-IoT Edge-Geräts aus.

  2. Installieren Sie den Device Update-Agent für Imageupdates.

    Beispielimages finden Sie im Repository Ressourcen hier. Die Datei vom Typ „swUpdate“ ist das Basisimage, das Sie auf eine Raspberry Pi B3+-Platine einspielen können. Die GZ-Datei ist das Update, das Sie über Device Update for IoT Hub importieren. Ein Beispiel finden Sie unter Einspielen des Images auf die SD-Karte.

  3. Installieren Sie den Device Update-Agent für Paketupdates.

    • Für die aktuellen Agent-Versionen von packages.microsoft.com: Aktualisieren Sie Paketlisten auf Ihrem Gerät, und installieren Sie das Device Update-Agent-Paket und seine Abhängigkeiten mit:

      sudo apt-get update

      sudo apt-get install deviceupdate-agent

    • Für alle Release Candidate-Agent-Versionen (‚rc‘) von Artifacts: Laden Sie die DEB-Datei auf den Computer herunter, auf dem Sie den Device Update-Agent installieren möchten, und dann:

      sudo apt-get install -y ./"<PATH TO FILE>"/"<.DEB FILE NAME>"

    • Wenn Sie MCC für ein Szenario mit getrennten Geräten einrichten, installieren Sie das Delivery Optimization APT-Plug-In:

      sudo apt-get install deliveryoptimization-plugin-apt

  4. Nachdem Sie den Device Update-Agent installiert haben, müssen Sie die Konfigurationsdatei für Device Update bearbeiten, indem Sie den folgenden Befehl ausführen.

    sudo nano /etc/adu/du-config.json

    Ändern Sie für Agents, die den IoT-Identitätsdienst für die Bereitstellung verwenden, den connectionType in „AIS“. Das Feld „ConnectionData“ muss eine leere Zeichenfolge sein. Bitte beachten Sie, dass alle Werte mit dem Tag „Wert hier platzieren“ festgelegt werden müssen. Weitere Informationen finden Sie unter Konfigurieren eines DU-Agents.

  5. Nun können Sie den Device Update-Agent auf dem IoT-Gerät starten.

Auf IoT-Linux-Geräten ohne IoT Edge-Installation

Befolgen Sie diese Anweisungen, um den Geräte-Update-Agent auf IOT Edge aktivierten Geräten bereitzustellen.

  1. Installieren Sie den IoT-Identitätsdienst, und fügen Sie auf Ihrem IoT-Gerät die neueste Version hinzu, indem Sie die Anweisungen zum Installieren des Azure IoT-Identitätsdiensts befolgen.

  2. Konfigurieren Sie den IoT-Identitätsdienst gemäß den Anweisungen zum Konfigurieren des Azure IoT-Identitätsdiensts.

  3. Installieren Sie schließlich den Device Update-Agent. Beispielimages werden in Ressourcen hier bereitgestellt, die Datei vom Typ „swUpdate“ ist das Basisimage, das Sie auf ein Raspberry Pi B3+-Board einspielen können, und die GZ-Datei ist das Update, das Sie über Device Update for IoT Hub importieren können. Sehen Sie sich ein Beispiel für das Einspielen des Images auf Ihrem IoT Hub-Gerät an.

  4. Nachdem Sie den Device Update-Agent installiert haben, müssen Sie die Konfigurationsdatei für Device Update bearbeiten, indem Sie den folgenden Befehl ausführen.

    sudo nano /etc/adu/du-config.json

    Ändern Sie für Agents, die den IoT-Identitätsdienst für die Bereitstellung verwenden, den connectionType in „AIS“. Das Feld „ConnectionData“ muss eine leere Zeichenfolge sein. Bitte beachten Sie, dass alle Werte mit dem Tag „Wert hier platzieren“ festgelegt werden müssen. Weitere Informationen finden Sie unter Konfigurieren eines DU-Agents.

  5. Nun können Sie den Device Update-Agent auf dem IoT-Gerät starten.

Andere IOT-Geräte

Der Agent für die Geräteaktualisierung kann auch ohne den IOT-Identitätsdienst zum Testen oder für eingeschränkte Geräte konfiguriert werden. Führen Sie die folgenden Schritte aus, um den Geräte-Update-Agent mithilfe einer Verbindungszeichenfolge (vom Modul oder Gerät) bereitzustellen.

  1. Beispielimages finden Sie im Repository Ressourcen hier. Die Datei vom Typ „swUpdate“ ist das Basisimage, das Sie auf eine Raspberry Pi B3+-Platine einspielen können. Die GZ-Datei ist das Update, das Sie über Device Update for IoT Hub importieren. Ein Beispiel finden Sie unter Einspielen des Images auf die SD-Karte.

  2. Melden Sie sich auf dem Computer oder IOT Edge Gerät/IOT-Gerät an.

  3. Öffnen Sie ein Terminalfenster.

  4. Fügen Sie die Verbindungszeichenfolge zur Konfigurationsdatei des Geräte-Updates hinzu:

    1. Geben Sie Folgendes in das Terminalfenster ein:

    2. Kopieren Sie die primäre Verbindungszeichenfolge.

      • Wenn der Geräteupdate-Agent als Modul konfiguriert ist, kopieren Sie die primäre Verbindungszeichenfolge des Moduls.
      • Kopieren Sie andernfalls die primäre Verbindungszeichenfolge des Geräts.

    3. Geben Sie die kopierte primäre Verbindungszeichenfolge in den Wert des Felds „connectionData“ in der Datei „du-config.json“ ein. Bitte beachten Sie, dass alle Werte mit dem Tag „Wert hier platzieren“ festgelegt werden müssen. Weitere Informationen finden Sie unter Konfigurieren eines DU-Agents.

  5. Nun können Sie den Device Update-Agent auf dem IoT-Gerät starten.

Starten des Geräte-Update-Agents

In diesem Abschnitt wird beschrieben, wie Sie den Geräte-Update-Agent als Modulkennung starten und überprüfen, die auf Ihrem IOT-Gerät erfolgreich ausgeführt wird.

  1. Melden Sie sich bei dem Computer oder Gerät an, auf dem der Geräte-Update-Agent installiert ist.

  2. Öffnen Sie ein Terminal-Fenster, und geben Sie den folgenden Befehl ein.

    sudo systemctl restart deviceupdate-agent

  3. Sie können den Status des Agenten mit dem folgenden Befehl überprüfen. Wenn Probleme auftreten, finden Sie weitere Informationen in diesem Handbuch zur Problembehandlung.

    sudo systemctl status deviceupdate-agent

    Als Status sollte angezeigt werden.

  4. Navigieren Sie im IOT Hub-Portal zu „IOT-Gerät“ oder „IOT Edge-Geräte“, um das Gerät zu finden, das Sie mit dem Geräte-Update-Agent konfiguriert haben. Dort sehen Sie, dass der Device-Update-Agent als Modul ausgeführt wird. Beispiel:

    Diagramm des Modulnamens des Geräte-Updates.

Erstellen und Ausführen des Geräte-Update-Agents

Sie können auch ihren eigenen Geräte-Update-Agent für Kunden erstellen und ändern. Befolgen Sie die Anweisungen, um den Device Update-Agent aus der Quelle zu erstellen.

Nachdem der Agent erfolgreich erstellt wurde, ist es an der Zeit, ihn auszuführen. Nehmen Sie nun die Änderungen vor, die für die Einbindung des Agents in Ihr Image erforderlich sind. Anleitungen finden Sie unter der Vorgehensweise zum Ändern des Device Update-Agents.

Handbuch zur Problembehandlung

Wenn Probleme auftreten, lesen Sie den Leitfaden zur Problembehandlung für Device Update for IoT Hub, um mögliche Probleme zu beheben und die erforderlichen Informationen für Microsoft zu erfassen.

Nächste Schritte

In den folgenden Tutorials finden Sie eine einfache Demonstration des Geräteupdates für IoT Hub: