Migrieren von Geräten und Gruppen zum neuesten Release von Device Update for IoT Hub

  • Artikel

Wenn neue Versionen des Diensts Device Update for IoT Hub veröffentlicht werden, sollten Sie Ihre Geräte aktualisieren, damit sie über die neuesten Funktionen und Sicherheitsverbesserungen verfügen. In diesem Artikel erfahren Sie, wie Sie vom PPR-Release (Public Preview Refresh) zum aktuellen GA-Release migrieren. In diesem Artikel wird auch das Verhalten von Gruppen und Benutzeroberflächen in diesen Releases erläutert. Wenn Sie nicht über Geräte, Gruppen und Bereitstellungen verfügen, die das Public Preview Refresh-Release verwenden, können Sie diese Seite ignorieren.

Für eine erfolgreiche Migration müssen Sie den DU-Agent aktualisieren, der auf Ihren Geräten ausgeführt wird. Beachten Sie, dass es beim GA-Release wichtige Änderungen gibt. Befolgen Sie die Anweisungen genau, um Fehler zu vermeiden.

Hinweis

Alle erstellten PPR-Gerätegruppen werden automatisch in GA-Gruppen geändert. Die Gruppen und Geräte sind nach der Migration verfügbar. Der Bereitstellungsverlauf wird nicht auf die aktualisierten GA-Gruppen übertragen.

Aktualisieren des Device Update-Agents

Für das GA-Release kann der Device Update-Agent manuell aktualisiert werden oder mit dem Device Update-Dienst mithilfe des apt-Manifests oder Imageupdates. Wenn Sie Imageupdates verwenden, können Sie den GA-Device Update-Agent in Ihr Update einschließen.

Manuelles DU-Agent-Upgrade

  1. Bevor Sie Ihr Gerät aktualisieren, enthalten die Geräteattribute die Details des PPR-PnP-Modells. Der Vertragsmodellname zeigt das Geräteupdatemodell V1 an und die Vertragsmodell-ID die Angabe dtmi:azure:iot:deviceUpdateContractModel;1.

  2. Stellen Sie eine SSH-Verbindung mit Ihrem Gerät her, und aktualisieren Sie den Device Update-Agent.

    sudo apt install deviceupdate-agent
sudo systemctl restart deviceupdate-agent
sudo systemctl status deviceupdate-agent

  3. Vergewissern Sie sich, dass der DU-Agent ordnungsgemäß ausgeführt wird. Suchen nach „HealthCheck bestanden“

    sudo -u adu /usr/bin/AducIotAgent -h

  4. Zeigen Sie das aktualisierte Gerät im Device Update-Portal an. Die Geräteattribute zeigen nun die aktualisierten PnP-Modelldetails an. Der Name des Vertragsmodells zeigt Device Update-Modell V2 und die Vertragsmodell-ID die Angabe dtmi:azure:iot:deviceUpdateContractModel;2 an.

Upgrade des OTA DU-Agents über das APT-Manifest

  1. Bevor Sie Ihre Geräte aktualisieren, enthalten die Geräteattribute die Details des PPR-PnP-Modells. Der Vertragsmodellname zeigt das Geräteupdatemodell V1 an und die Vertragsmodell-ID die Angabe dtmi:azure:iot:deviceUpdateContractModel;1.

  2. Fügen Sie das Upgrade des Device Upgrade-Agents als letzten Schritt in Ihrem Update hinzu. Die Importmanifestversion muss „4.0“ sein, um sicherzustellen, dass sie auf die richtigen Geräte ausgerichtet ist. Nachfolgend finden Sie ein Beispielimportmanifest und APT-Beispielmanifest:

    Beispielimportmanifest

    {
   "manifestVersion": "4",
   "updateId": {
     "provider": "Contoso",
     "name": "Sensor",
     "version": "1.0"
   },
   "compatibility": [
     {
       "manufacturer": "Contoso",
       "model": "Sensor"
     }
   ],
   "instructions": {
     "steps": [
       {
     "handler": "microsoft/apt:1",
     "handlerProperties": {
       "installedCriteria": "1.0"
     },
     "files": [
       "fileId0"
     ]
       }
     ]
   },
   "files": {
     "fileId0": {
       "filename": "sample-upgrade-apt-manifest.json",
       "sizeInBytes": 210,
       "hashes": {
     "sha256": "mcB5SexMU4JOOzqmlJqKbue9qMskWY3EI/iVjJxCtAs="
       }
     }
   },
   "createdDateTime": "2022-08-20T18:32:01.8404544Z"
 }

    APT-Beispielmanifest

      {
    "name": "Sample DU agent upgrade update",
    "version": "1.0.0",
    "packages": [
    {
        "name": "deviceupdate-agent"
    }
    ]
}

Hinweis

Es ist erforderlich, dass das Agent-Upgrade der letzte Schritt ist. Vor dem Agent-Upgrade können weitere Schritte ausgeführt werden. Alle nach dem Agent-Upgrade hinzugefügten Schritte werden nicht ausgeführt und nicht ordnungsgemäß gemeldet, wenn das Gerät erneut eine Verbindung mit dem DU-Dienst herstellt.

  1. Bereitstellen des Updates.

  2. Nachdem das Update bereitgestellt wurde, zeigen die Geräteattribute nun die aktualisierten PnP-Modelldetails an. Der Name des Vertragsmodells zeigt Device Update-Modell V2 und die Vertragsmodell-ID die Angabe dtmi:azure:iot:deviceUpdateContractModel;2 an.

Releaseübergreifendes Gruppen- und Bereitstellungsverhalten

  • Ein Gerät mit dem Public Preview Refreh-DU-Agent (0.8.x) und dem GA-DU-Agent (1.0.x) kann über das Device Update-Portal verwaltet werden.

  • Geräte mit älteren Agents (0.7.0/0.6.0) können diesen Gruppen nicht hinzugefügt werden.

Nächste Schritte

Grundlegendes zur Konfigurationsdatei des Device Update-Agents

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