Eszközök és csoportok áttelepítése az IoT Hub legújabb eszközfrissítésére

Cikk
11/08/2023

Mivel az IoT Hub eszközfrissítése új verziókat ad ki, frissítenie kell az eszközöket a legújabb funkciókhoz és biztonsági fejlesztésekhez. Ez a cikk tájékoztatást nyújt arról, hogyan migrálhat a [Nyilvános előzetes frissítés (PPR) kiadásból az aktuális, GA kiadásba. Ez a cikk azt is ismerteti, hogy a csoport és az UX hogyan viselkedik ezeken a kiadásokon. Ha nem rendelkezik olyan eszközökkel, csoportokkal és központi telepítésekkel, amelyek a nyilvános előzetes verzió frissítési kiadását használják, figyelmen kívül hagyhatja ezt a lapot.

A sikeres migráláshoz frissítenie kell az eszközökön futó DU-ügynököt. Vegye figyelembe, hogy mivel a GA-kiadásban jelentős változások történtek, javasoljuk, hogy kövesse az utasításokat a hibák elkerülése érdekében.

Megjegyzés:

Az összes létrehozott PPR-eszközcsoport automatikusan ga-csoportokra változik. A csoportok és eszközök a migrálás után lesznek elérhetők. Az üzembe helyezési előzmények nem lesznek átadva a frissített GA-csoportoknak.

Az Eszközfrissítési ügynök frissítése

A GA-kiadás esetében az Eszközfrissítési ügynök manuálisan vagy az Eszközfrissítési szolgáltatás használatával frissíthető az apt jegyzék- vagy képfrissítések használatával. Ha képfrissítéseket használ, a GA eszközfrissítési ügynököt is belefoglalhatja a frissítésbe.

Manuális DU-ügynökfrissítés

Az eszköz frissítése előtt az eszköz attribútumai tartalmazzák a PPR PnP-modell részleteit. A szerződésmodell neve megjeleníti az eszközfrissítési modell V1-jét , a szerződésmodell azonosítója pedig a dtmi:azure:iot:deviceUpdateContractModel; 1.

SSH-t az eszközre, és frissítse az Eszközfrissítési ügynököt.

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

Ellenőrizze, hogy a DU-ügynök megfelelően fut-e. Keresse meg a "HealthCheck passed" (Átadott állapot ellenőrzése) jelölőnégyzetet
```
sudo -u adu /usr/bin/AducIotAgent -h  
```
Tekintse meg a frissített eszközt az Eszközfrissítés portálon. Az eszközattribútumok mostantól megjelenítik a PnP-modell frissített részleteit. A szerződésmodell neve megjeleníti az eszközfrissítési modell V2-jét , a szerződésmodell azonosítója pedig a dtmi:azure:iot:deviceUpdateContractModel; 2.

AZ OTA DU-ügynök frissítése az APT-jegyzékben

Az eszközök frissítése előtt az eszközattribútumok tartalmazzák a PPR PnP-modell részleteit. A szerződésmodell neve megjeleníti az eszközfrissítési modell V1-jét , a szerződésmodell azonosítója pedig a dtmi:azure:iot:deviceUpdateContractModel; 1.

Az eszközfrissítési ügynök frissítésének hozzáadása a frissítés utolsó lépéseként. Az importálási jegyzékverziónak "4.0"-nak kell lennie ahhoz, hogy a megfelelő eszközökre irányuljon. Lásd alább az importálási jegyzékmintát és az APT-jegyzékfájlt:

Példa importálási jegyzékfájlra

{
   "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"
 }

Példa APT-jegyzék

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

Megjegyzés:

Ahhoz, hogy az ügynök frissítése legyen az utolsó lépés. Előfordulhat, hogy az ügynök frissítése előtt további lépéseket kell végrehajtania. Az ügynökfrissítés után hozzáadott lépések végrehajtása és helyes jelentése nem történik meg, mivel az eszköz újra csatlakozik a DU szolgáltatáshoz.

Telepítse a frissítést.
A frissítés sikeres üzembe helyezése után az eszközattribútumok mostantól megjelenítik a frissített PnP-modell részleteit. A szerződésmodell neve megjeleníti az eszközfrissítési modell V2-jét , a szerződésmodell azonosítója pedig a dtmi:azure:iot:deviceUpdateContractModel; 2.

A kiadások csoportosítási és üzembe helyezési viselkedése

A nyilvános előzetes frissítési DU-ügynökkel (0.8.x) és a GA DU-ügynökkel (1.0.x) rendelkező eszköz az Eszközfrissítési portálon keresztül kezelhető.
A régebbi ügynökökkel (0.7.0/0.6.0) rendelkező eszközök nem vehetők fel ezekhez a csoportokhoz.

Következő lépések

Az Eszközfrissítési ügynök konfigurációs fájljának ismertetése

Az IoT Hub eszközfrissítésének egyszerű bemutatásához az alábbi oktatóanyagokat használhatja:

Megosztás a következőn keresztül: