Självstudie: Slutför en proxyuppdatering med enhetsuppdatering för Azure IoT Hub

Artikel
03/24/2023

Om du inte redan har gjort det kan du läsa Använda proxyuppdateringar med enhetsuppdatering för Azure IoT Hub.

Konfigurera en testenhet eller virtuell dator

I den här självstudien används en virtuell Ubuntu Server 18.04 LTS-dator (VM) som exempel.

Installera enhetsuppdateringsagenten och beroenden

Registrera packages.microsoft.com i en APT-paketlagringsplats:

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

Installera deviceupdate-agent på IoT-enheten . Ladda ned den senaste Debian-filen för enhetsuppdatering från packages.microsoft.com:
```
sudo apt-get install deviceupdate-agent
```
Du kan också kopiera den nedladdade Debian-filen till den virtuella testdatorn. Om du använder PowerShell på datorn kör du följande kommando för gränssnittet:
```
scp <path to the .deb file> tester@<your vm's ip address>:~
```
Fjärranslut sedan till den virtuella datorn och kör följande kommando i startmappen :
```
#go to home folder 
cd ~
#install latest Device Update agent
sudo apt-get install ./<debian file name from the previous step>
```
Gå till Azure IoT Hub och kopiera den primära anslutningssträngen för IoT-enhetens enhetsuppdateringsmodul. Ersätt alla standardvärden för connectionData fältet med den primära anslutningssträngen i filen du-config.json :
```
sudo nano /etc/adu/du-config.json  
```
Anteckning

Du kan kopiera den primära anslutningssträngen för enheten i stället, men vi rekommenderar att du använder strängen för enhetsuppdateringsmodulen. Information om hur du konfigurerar modulen finns i Etablering av enhetsuppdateringsagent.

Kontrollera att /etc/adu/du-diagnostics-config.json innehåller rätt inställningar för logginsamling. Exempel:

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

Starta om enhetsuppdateringsagenten:

sudo systemctl restart deviceupdate-agent

Konfigurera simulerade komponenter

I test- och demonstrationssyfte skapar vi följande simulerade komponenter på enheten:

Tre motorer
Två kameror
"hostfs"
"rootfs"

Viktigt

Den föregående komponentkonfigurationen baseras på implementeringen av ett exempel på ett komponentuppräkningstillägg som kallas libcontoso-component-enumerator.so. Den kräver också den här modellkomponentens inventeringsdatafil: /usr/local/contoso-devices/components-inventory.json.

Kopiera demomappen till din hemkatalog på den virtuella testdatorn. Kör sedan följande kommando för att kopiera nödvändiga filer till rätt platser:
```
`~/demo/tools/reset-demo-components.sh` 
```
Kommandot reset-demo-components.sh utför följande steg för din räkning:
- Den kopierar components-inventory.json och lägger till den i mappen /usr/local/contoso-devices .
- Den kopierar Contoso-komponentuppräkningstillägget (libcontoso-component-enumerator.so) från mappen Assets och lägger till det i mappen /var/lib/adu/extensions/sources .
- Tillägget registreras:
```
sudo /usr/bin/AducIotAgent -E /var/lib/adu/extensions/sources/libcontoso-component-enumerator.so
```

Importera en exempeluppdatering

Om du inte redan har gjort det skapar du ett konto och en instans för enhetsuppdatering, inklusive att konfigurera en IoT-hubb. Starta sedan följande procedur.

Från den senaste versionen av enhetsuppdateringen, under Tillgångar, laddar du ned importmanifest och avbildningar för proxyuppdateringar.
Logga in på Azure Portal och gå till din IoT-hubb med Enhetsuppdatering. I den vänstra rutan väljer du Enhetshantering>Uppdateringar.
Välj fliken Uppdateringar.
Välj + Importera ny uppdatering.
Välj + Välj från lagringscontainer och välj sedan ditt lagringskonto och din container.
Välj Ladda upp för att lägga till de filer som du laddade ned i steg 1.
Ladda upp det överordnade importmanifestet, det underordnade importmanifestet och nyttolastfilerna till containern.

I följande exempel visas exempelfiler som laddats upp för att uppdatera kameror som är anslutna till en smart dammsugare. Det innehåller också ett förinstallationsskript för att stänga av kamerorna före den trådlösa uppdateringen.

I exemplet är det överordnade importmanifestet contoso. Virtual-Vacuum-virtual-camera.1.4.importmanifest.json. Det underordnade importmanifestet med information om att uppdatera kameran är Contoso.Virtual-Vacuum.3.3.importmanifest.json. Båda manifestfilnamnen följer det format som krävs och slutar med .importmanifest.json.
Välj Välj.
Användargränssnittet visar nu listan över filer som ska importeras till Enhetsuppdatering. Välj Importera uppdatering.
Importen börjar och skärmen ändras till avsnittet Importhistorik . Välj Uppdatera för att visa förloppet tills importen har slutförts. Beroende på uppdateringens storlek kan importen slutföras om några minuter eller ta längre tid.
När kolumnen Status anger att importen har slutförts väljer du fliken Tillgänglig Uppdateringar. Du bör nu se den importerade uppdateringen i listan.

Mer information om importprocessen finns i Importera en uppdatering till enhetsuppdatering.

Visa enhetsgrupper

Enhetsuppdatering använder grupper för att organisera enheter. Enhetsuppdatering sorterar automatiskt enheter i grupper baserat på deras tilldelade taggar och kompatibilitetsegenskaper. Varje enhet tillhör bara en grupp, men grupper kan ha flera undergrupper för att sortera olika enhetsklasser.

Gå till fliken Grupper och distributioner överst på sidan.
Visa listan över grupper och diagrammet för uppdateringsefterlevnad. Diagrammet för uppdateringsefterlevnad visar antalet enheter i olika efterlevnadstillstånd: Vid den senaste uppdateringen, Nya uppdateringar tillgängliga och Uppdateringar pågår. Läs mer om uppdateringsefterlevnad.
Du bör se en enhetsgrupp som innehåller den simulerade enhet som du konfigurerade i den här självstudien tillsammans med eventuella tillgängliga uppdateringar för enheterna i den nya gruppen. Om det finns enheter som inte uppfyller enhetens klasskrav för gruppen visas de i en motsvarande ogiltig grupp. Om du vill distribuera den bästa tillgängliga uppdateringen till den nya användardefinierade gruppen från den här vyn väljer du Distribuera bredvid gruppen.

Mer information om taggar och grupper finns i Hantera enhetsgrupper.

Distribuera uppdatering

När gruppen har skapats bör du se en ny uppdatering som är tillgänglig för din enhetsgrupp, med en länk till uppdateringen under Bästa uppdatering (du kan behöva uppdatera en gång).

Mer information om efterlevnad finns i Enhetsuppdateringsefterlevnad.
Välj målgruppen genom att klicka på gruppnamnet. Du dirigeras till gruppinformationen under Grundläggande om grupp.
Om du vill starta distributionen går du till fliken Aktuell distribution. Välj distributionslänken bredvid önskad uppdatering i avsnittet Tillgängliga uppdateringar. Den bästa, tillgängliga uppdateringen för en viss grupp betecknas med en "Bästa" markering.
Schemalägg distributionen så att den startar omedelbart eller i framtiden och välj sedan Skapa.
Status under Distributionsinformation ska vara Aktiv och den distribuerade uppdateringen ska markeras med "(distribuerar)".
Visa efterlevnadsdiagrammet. Du bör se att uppdateringen pågår.
När enheten har uppdaterats bör du se att efterlevnadsdiagrammet och distributionsinformationen uppdateras för att återspegla samma sak.