Freigeben über

Migrieren von Geräten und Gruppen von Public Preview zur aktualisierten Public Preview

  • 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 Public Preview-Release zum aktuellen PPR-Release (Public Preview Refresh) 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-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. Außerdem müssen Sie neue Gerätegruppen erstellen, um Updates bereitzustellen und zu verwalten. Beachten Sie, dass es beim PPR-Release wichtige Änderungen gibt. Befolgen Sie die Anweisungen genau, um Fehler zu vermeiden.

Aktualisieren des Device Update-Agents

Für das PPR-Release muss der Device Update-Agent wie unten beschrieben manuell aktualisiert werden. Das Aktualisieren des Agents über eine Device Update-Bereitstellung wird aufgrund größerer Änderungen im Public Preview- und PPR-Release nicht unterstützt.

  1. Navigieren Sie zum Anzeigen von Geräten mit älteren Agents (Versionen 0.7.0/0.6.0) und Gruppen, die vor dem 03.02.2022 erstellt wurden, zum Public Preview-Portal, auf das Sie über das Banner zugreifen können.

    Screenshot des Banners.

  2. Erstellen Sie ein neues IoT-/IoT Edge-Gerät im Azure-Portal. Kopieren Sie die primäre Verbindungszeichenfolge für das Gerät zur späteren Verwendung aus der Geräteansicht. Weitere Informationen finden Sie im Abschnitt Hinzufügen eines Geräts zu Azure IoT Hub.

  3. Stellen Sie dann eine SSH-Verbindung mit Ihrem Gerät her, und entfernen Sie alle alten Device Update-Agents.

    sudo apt remove deviceupdate-agent 
sudo apt remove adu-agent

  4. Entfernen Sie die alte Konfigurationsdatei.

    sudo rm -f /etc/adu/adu-conf.txt

  5. Installieren Sie den neuen Agent.

    sudo apt-get install deviceupdate-agent

    Alternativ können Sie das DEB-Asset von GitHub laden und den Agent installieren.

    sudo apt install <file>.deb

    Der Versuch, den Device Update-Agent zu aktualisieren, ohne den alten Agent und die Konfigurationsdateien zu entfernen, führt zu dem unten gezeigten Fehler.

    Screenshot des Updatefehlers.

  6. Geben Sie die primäre Verbindungszeichenfolge Ihres IoT-Geräts (oder Moduls, je nachdem, wie Sie das Gerät mit Device Update bereitgestellt haben) in die Konfigurationsdatei ein, indem Sie den folgenden Befehl ausführen.

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

  7. Fügen Sie Ihr Modell, den Hersteller, den Agentnamen, den Verbindungstyp und weitere Details in der Konfigurationsdatei hinzu.

  8. Löschen Sie das alte IoT-/IoT Edge-Gerät aus dem Public Preview-Portal.

Hinweis

Der Versuch, den Agent über eine DU-Bereitstellung zu aktualisieren, führt dazu, dass das Gerät nicht mehr von Device Update verwaltet werden kann. Das Gerät muss erneut bereitgestellt werden, um über Device Update verwaltet zu werden.

Migrieren von Gruppen zu Public Preview Refresh

  1. Wenn Ihre Geräte die Device Update-Agent-Versionen 0.6.0 oder 0.7.0 verwenden, führen Sie ein Upgrade auf die neueste Agent-Version 0.8.0 durch, indem Sie die oben genannten Schritte ausführen.

  2. Löschen Sie die vorhandenen Gruppen im Public Preview-Portal, indem Sie durch das Banner navigieren.

  3. Fügen Sie dem Gerätezwilling für die aktualisierten Geräte ein Gruppentag hinzu. Weitere Informationen finden Sie im Abschnitt Hinzufügen eines Geräts zu Azure IoT Hub.

  4. Erstellen Sie die Gruppen im PPR-Portal neu, indem Sie zu „Gruppen hinzufügen“ gehen und das entsprechende Gruppentag aus der Dropdownliste auswählen.

  5. Beachten Sie, dass eine Gruppe mit demselben Namen nicht im PPR-Portal erstellt werden kann, wenn die Gruppe nicht im Public Preview-Portal gelöscht wird.

Releaseübergreifendes Gruppen- und Bereitstellungsverhalten

  • Gruppen, die im PPR-Releaseportal erstellt wurden, lassen nur die Addition von Geräten mit dem neuesten Device Update-Agent (0.8.0) zu. Geräte mit älteren Agents (0.7.0/0.6.0) können diesen Gruppen nicht hinzugefügt werden.

  • Alle neuen Geräte, die den neuesten Agent verwenden, werden automatisch auf der Registerkarte „Gruppen und Bereitstellungen“ einer Standard-DeviceClass-Gruppe hinzugefügt. Wenn den Geräteeigenschaften ein Gruppentag hinzugefügt wird, wird das Gerät dieser Gruppe hinzugefügt, wenn eine Gruppe für dieses Tag vorhanden ist.

  • Wenn für das Gerät, das den neuesten Agent verwendet, den Geräteeigenschaften ein Gruppentag hinzugefügt wird, die entsprechende Gruppe aber noch nicht erstellt wurde, wird das Gerät nicht auf der Registerkarte „Gruppen und Bereitstellungen“ angezeigt.

  • Geräte, die die älteren Agents verwenden, werden im alten Portal als nicht gruppiert angezeigt, wenn das Gruppentag nicht hinzugefügt wird.

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: