Oktatóanyag: Proxyfrissítés befejezése a Azure IoT Hub eszközfrissítésével

Cikk
03/24/2023

Ha még nem tette meg, tekintse át a Proxyfrissítések használata az eszközfrissítéssel Azure IoT Hub című cikket.

Teszteszköz vagy virtuális gép beállítása

Ez az oktatóanyag egy Ubuntu Server 18.04 LTS virtuális gépet (VM) használ példaként.

Az eszközfrissítési ügynök és függőségek telepítése

Regisztráljon packages.microsoft.com egy APT-csomagtárban:

sudo apt-get update

sudo apt install curl

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

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

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

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

sudo apt-get update

Telepítse a deviceupdate-agent eszközt az IoT-eszközön . Töltse le a legújabb Eszközfrissítés Debian-fájlt a packages.microsoft.com:
```
sudo apt-get install deviceupdate-agent
```
Másik lehetőségként másolja a letöltött Debian-fájlt a teszt virtuális gépre. Ha PowerShellt használ a számítógépén, futtassa a következő rendszerhéjparancsot:
```
scp <path to the .deb file> tester@<your vm's ip address>:~
```
Ezután távolról lépjen a virtuális gépre, és futtassa a következő rendszerhéjparancsot a kezdőmappában :
```
#go to home folder 
cd ~
#install latest Device Update agent
sudo apt-get install ./<debian file name from the previous step>
```
Lépjen Azure IoT Hub, és másolja ki az IoT-eszköz Eszközfrissítés moduljának elsődleges kapcsolati sztring. Cserélje le a connectionData mező alapértelmezett értékét a du-config.json fájlban lévő elsődleges kapcsolati sztring:
```
sudo nano /etc/adu/du-config.json  
```
Megjegyzés

Ehelyett másolhatja az eszköz elsődleges kapcsolati sztring, de azt javasoljuk, hogy használja az Eszközfrissítés modul sztringét. A modul beállításával kapcsolatos információkért lásd: Eszközfrissítési ügynök kiépítése.

Győződjön meg arról, hogy az /etc/adu/du-diagnostics-config.json tartalmazza a naplógyűjtés megfelelő beállításait. Például:

{
  "logComponents":[
    {
      "componentName":"adu",
       "logPath":"/var/log/adu/"
    },
    {
      "componentName":"do",
      "logPath":"/var/log/deliveryoptimization-agent/"
    }
  ],
  "maxKilobytesToUploadPerLogPath":50
}

Indítsa újra az eszközfrissítési ügynököt:
```
sudo systemctl restart deviceupdate-agent
```

Modellösszetevők beállítása

Tesztelési és bemutatási célokra a következő utánzat-összetevőket hozjuk létre az eszközön:

Három motor
Két kamera
"hostfs"
"rootfs"

Fontos

Az előző összetevő-konfiguráció egy libcontoso-component-enumerator.so nevű példaösszetevő-enumerátorbővítmény implementálásán alapul. Ehhez a modellösszetevő leltáradatfájlja is szükséges: /usr/local/contoso-devices/components-inventory.json.

Másolja a bemutató mappát a teszt virtuális gép kezdőkönyvtárába. Ezután futtassa a következő parancsot a szükséges fájlok megfelelő helyekre másolásához:
```
`~/demo/tools/reset-demo-components.sh` 
```
A reset-demo-components.sh parancs a következő lépéseket végzi el az Ön nevében:
- Átmásolja az components-inventory.json fájlt, és hozzáadja az /usr/local/contoso-devices mappához.
- Átmásolja a Contoso összetevő enumerátorbővítményét (libcontoso-component-enumerator.so) az Assets mappából , és hozzáadja a /var/lib/adu/extensions/sources mappához.
- Regisztrálja a bővítményt:
```
sudo /usr/bin/AducIotAgent -E /var/lib/adu/extensions/sources/libcontoso-component-enumerator.so
```

Példafrissítés importálása

Ha még nem tette meg, hozzon létre egy eszközfrissítési fiókot és -példányt, beleértve az IoT Hub konfigurálását is. Ezután indítsa el a következő eljárást.

Az Eszközfrissítés legújabb kiadásában, az Eszközök területen töltse le a proxyfrissítések importálási jegyzékfájlját és rendszerképeit.
Jelentkezzen be a Azure Portal, és lépjen az IoT Hubra az eszközfrissítéssel. A bal oldali panelen válassza a Eszközkezelés>Frissítések lehetőséget.
Válassza a Frissítések lapot.
Válassza az + Új frissítés importálása lehetőséget.
Válassza a + Kiválasztás a tárolóból lehetőséget, majd válassza ki a tárfiókot és a tárolót.
Válassza a Feltöltés lehetőséget az 1. lépésben letöltött fájlok hozzáadásához.
Töltse fel a szülőimportálási jegyzékfájlt, a gyermekimportálási jegyzékfájlt és a hasznos adatfájlokat a tárolóba.

Az alábbi példa egy intelligens porszívó eszközhöz csatlakoztatott kamerák frissítéséhez feltöltött mintafájlokat mutatja be. Egy telepítés előtti szkriptet is tartalmaz, amely kikapcsolja a kamerákat a levegőn keresztüli frissítés előtt.

A példában a szülőimportálási jegyzékfájl a contoso. Virtual-Vacuum-virtual-camera.1.4.importmanifest.json. A kamera frissítésének részleteit tartalmazó gyermekimportálási jegyzékfájl a Contoso.Virtual-Vacuum.3.3.importmanifest.json. Mindkét jegyzékfájlnév a szükséges formátumot követi, és .importmanifest.json végződésű.
Válassza a Kiválasztás lehetőséget
A felhasználói felületen megjelenik az eszközfrissítésbe importálandó fájlok listája. Válassza a Frissítés importálása lehetőséget.
Megkezdődik az importálási folyamat, és a képernyő az Importálási előzmények szakaszra változik. Válassza a Frissítés lehetőséget az importálási folyamat befejezéséig tartó állapot megtekintéséhez. A frissítés méretétől függően az importálás néhány percen belül befejeződhet, vagy tovább tarthat.
Ha az Állapot oszlop azt jelzi, hogy az importálás sikeres volt, válassza az Elérhető Frissítések lapot. Ekkor megjelenik az importált frissítés a listában.

Az importálási folyamatról további információt a Frissítés importálása az eszközfrissítésbe című témakörben talál.

Eszközcsoportok megtekintése

Az Eszközfrissítés csoportok használatával rendszerezi az eszközöket. Az Eszközfrissítés automatikusan csoportokba rendezi az eszközöket a hozzájuk rendelt címkék és kompatibilitási tulajdonságok alapján. Minden eszköz csak egy csoporthoz tartozik, de a csoportok több alcsoporttal is rendelkezhetnek a különböző eszközosztályok rendezéséhez.

Lépjen a lap tetején található Csoportok és üzemelő példányok lapra.
Tekintse meg a csoportok listáját és a frissítési megfelelőségi diagramot. A frissítésmegfelelés diagramja a különböző megfelelőségi állapotokban lévő eszközök számát mutatja: A legújabb frissítés,az Elérhető új frissítések és a folyamatban lévő Frissítések. Tudnivalók a frissítési megfelelőségről.
Látnia kell egy eszközcsoportot, amely tartalmazza az oktatóanyagban beállított szimulált eszközt, valamint az új csoportban lévő eszközök elérhető frissítéseit. Ha vannak olyan eszközök, amelyek nem felelnek meg a csoport eszközosztály-követelményeinek, akkor a megfelelő érvénytelen csoportban jelennek meg. Ha ebből a nézetből szeretné telepíteni a legjobban elérhető frissítést az új felhasználó által definiált csoportra, válassza a csoport melletti Üzembe helyezés lehetőséget.

További információ a címkékről és csoportokról: Eszközcsoportok kezelése.

Frissítés üzembe helyezése

A csoport létrehozása után látnia kell egy új frissítést, amely elérhető az eszközcsoport számára, a frissítésre mutató hivatkozással a Legjobb frissítés területen (előfordulhat, hogy egyszer kell frissítenie).

A megfelelőségről további információt az Eszközfrissítés megfelelősége című témakörben talál.
Válassza ki a célcsoportot a csoport nevére kattintva. A csoport részleteire a Csoport alapjai területen lesz átirányítva.
Az üzembe helyezés elindításához lépjen az Aktuális üzembe helyezés lapra. Válassza a kívánt frissítés melletti üzembe helyezési hivatkozást az Elérhető frissítések szakaszban. Az adott csoporthoz elérhető legjobb, elérhető frissítés a "Legjobb" kiemeléssel lesz jelölve.
Ütemezze az üzembe helyezést, hogy azonnal vagy a jövőben elinduljon, majd válassza a Létrehozás lehetőséget.
Az Üzembe helyezés részletei területen lévő állapotnak Aktív értékre kell fordulnia, és az üzembe helyezett frissítést "(üzembe helyezés)" címkével kell megjelölni.
Tekintse meg a megfelelőségi diagramot. Látnia kell, hogy a frissítés folyamatban van.
Az eszköz sikeres frissítése után látnia kell a megfelelőségi diagramot, és az üzembehelyezési adatok is frissülnek, hogy azok tükrözzék azokat.