Etablering av enhetsuppdateringsagent

  • Artikel

Agenten för enhetsuppdateringsmodulen kan köras tillsammans med andra systemprocesser och IoT Edge-moduler som ansluter till din IoT Hub som en del av samma logiska enhet. I det här avsnittet beskrivs hur du etablerar enhetsuppdateringsagenten som en modulidentitet.

Ändringar i enhetsuppdateringsagenten i GA-versionen

Om du använder enhetsuppdateringsagentversionerna migrerar du till den senaste agentversion 1.0.0 som är ga-versionen. Se GA-agenten för ändringar och hur du uppgraderar

Du kan kontrollera den installerade versionen av enhetsuppdateringsagenten och leveransoptimeringsagenten i avsnittet Enhetsegenskaper i din IoT-enhetstvilling. Läs mer om enhetsegenskaper under ADU Core Interface.

Modulidentitet jämfört med enhetsidentitet

Under varje enhetsidentitet i IoT Hub kan du skapa upp till 50 modulidentiteter. Varje modulidentitet genererar implicit en modultvilling. På enhetssidan gör IoT Hub-enhets-SDK:er att du kan skapa moduler där var och en öppnar en oberoende anslutning till IoT Hub. Modulidentitet och modultvilling ger liknande funktioner som enhetsidentitet och enhetstvilling, men med en finare kornighet. Läs mer om modulidentiteter i IoT Hub

Om du migrerar från en enhetsnivåagent till att lägga till agenten som en modulidentitet på enheten tar du bort den äldre agenten som kommunicerade via Enhetstvillingen. När du etablerar enhetsuppdateringsagenten som en modulidentitet sker all kommunikation mellan enheten och enhetsuppdateringstjänsten via modultvillingen, så kom ihåg att tagga enhetens modultvilling när du skapar grupper och all kommunikation måste ske via modultvillingen.

Stöd för enhetsuppdatering

Följande IoT-enhet via luftuppdateringstyper stöds för närvarande med Enhetsuppdatering:

Förutsättningar

Om du konfigurerar IoT-enheten/IoT Edge-enheten för paketbaserade uppdateringar lägger du till packages.microsoft.com till datorns lagringsplatser genom att följa dessa steg:

  1. Logga in på den dator eller IoT-enhet där du tänker installera enhetsuppdateringsagenten.

  2. Öppna ett terminalfönster.

  3. Installera lagringsplatsens konfiguration som matchar enhetens operativsystem.

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

  4. Kopiera den genererade listan till katalogen sources.list.d.

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

  5. Installera den offentliga Microsoft GPG-nyckeln.

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

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

Så här etablerar du enhetsuppdateringsagenten som en modulidentitet

I det här avsnittet beskrivs hur du etablerar enhetsuppdateringsagenten som en modulidentitet på

  • IoT Edge-aktiverade enheter, eller
  • IoT-enheter som inte är Edge-enheter eller
  • Andra IoT-enheter.

Om du vill kontrollera om IoT Edge är aktiverat på enheten kan du läsa installationsanvisningarna för IoT Edge.

Följ alla eller något av avsnitten nedan för att lägga till enhetsuppdateringsagenten baserat på vilken typ av IoT-enhet du hanterar.

På IoT Edge-aktiverade enheter

Följ de här anvisningarna för att etablera enhetsuppdateringsagenten på IoT Edge-aktiverade enheter.

  1. Följ anvisningarna för att etablera en enskild Linux IoT Edge-enhet manuellt.

  2. Installera avbildningsuppdateringsagenten för enhetsuppdatering.

    Vi tillhandahåller exempelbilder på lagringsplatsen Tillgångar här . SwUpdate-filen är basavbildningen som du kan flasha på en Raspberry Pi B3+-tavla. Filen .gz är uppdateringen som du importerar via Enhetsuppdatering för IoT Hub. Ett exempel finns i Så här blinkar du bilden till din IoT Hub-enhet.

  3. Installera uppdateringsagenten för enhetsuppdateringspaketet.

    • För de senaste agentversionerna från packages.microsoft.com: Uppdatera paketlistor på enheten och installera enhetsuppdateringsagentpaketet och dess beroenden med hjälp av:

      sudo apt-get update

      sudo apt-get install deviceupdate-agent

    • För alla "rc" d.v.s. release candidate agent versions from Artifacts : Download the .deb file to the machine you want to install the Device Update agent on, then:

      sudo apt-get install -y ./"<PATH TO FILE>"/"<.DEB FILE NAME>"

    • Om du konfigurerar en MCC för ett frånkopplat enhetsscenario installerar du plugin-programmet Leveransoptimering APT:

      sudo apt-get install deliveryoptimization-plugin-apt

  4. När du har installerat enhetsuppdateringsagenten måste du redigera konfigurationsfilen för Enhetsuppdatering genom att köra kommandot nedan.

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

    Ändra connectionType till "AIS" för agenter som ska använda IoT Identity Service för etablering. Fältet Anslut ionData måste vara en tom sträng. Observera att alla värden med taggen "Placera värde här" måste anges. Se Konfigurera en DU-agent.

  5. Nu är du redo att starta enhetsuppdateringsagenten på din IoT-enhet.

På Iot Linux-enheter utan IoT Edge installerat

Följ de här anvisningarna för att etablera enhetsuppdateringsagenten på dina IoT Linux-enheter.

  1. Installera IoT Identity Service och lägg till den senaste versionen till din IoT-enhet genom att följa anvisningarna i Installera Azure IoT Identity Service.

  2. Konfigurera IoT Identity Service genom att följa anvisningarna i Konfigurera Azure IoT Identity Service.

  3. Installera slutligen enhetsuppdateringsagenten. Vi tillhandahåller exempelbilder i Tillgångar här, swUpdate-filen är basavbildningen som du kan flasha till en Raspberry Pi B3+-tavla och .gz filen är den uppdatering som du skulle importera via Enhetsuppdatering för IoT Hub. Se exempel på hur du blinkar bilden till din IoT Hub-enhet.

  4. När du har installerat enhetsuppdateringsagenten måste du redigera konfigurationsfilen för Enhetsuppdatering genom att köra kommandot nedan.

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

    Ändra connectionType till "AIS" för agenter som ska använda IoT Identity Service för etablering. Fältet Anslut ionData måste vara en tom sträng. Observera att alla värden med taggen "Placera värde här" måste anges. Se Konfigurera en DU-agent.

  5. Nu är du redo att starta enhetsuppdateringsagenten på din IoT-enhet.

Andra IoT-enheter

Enhetsuppdateringsagenten kan också konfigureras utan IoT Identity-tjänsten för testning eller på begränsade enheter. Följ stegen nedan för att etablera enhetsuppdateringsagenten med hjälp av en anslutningssträng (från modulen eller enheten).

  1. Vi tillhandahåller exempelbilder på lagringsplatsen Tillgångar här . SwUpdate-filen är basavbildningen som du kan flasha på en Raspberry Pi B3+-tavla. Filen .gz är uppdateringen som du importerar via Enhetsuppdatering för IoT Hub. Ett exempel finns i Så här blinkar du bilden till din IoT Hub-enhet.

  2. Logga in på datorn eller IoT Edge-enheten/IoT-enheten.

  3. Öppna ett terminalfönster.

  4. Lägg till anslutningssträng i konfigurationsfilen för enhetsuppdatering:

    1. Ange nedanstående i terminalfönstret:

    2. Kopiera den primära anslutningssträng

      • Om enhetsuppdateringsagenten har konfigurerats som en modul kopierar du modulens primära anslutningssträng.
      • Annars kopierar du enhetens primära anslutningssträng.

    3. Ange den kopierade primära anslutningssträng till fältet "connectionData" i filen du-config.json. Observera att alla värden med taggen "Placera värde här" måste anges. Se Konfigurera en DU-agent

  5. Nu är du redo att starta enhetsuppdateringsagenten på din IoT-enhet.

Så här startar du enhetsuppdateringsagenten

I det här avsnittet beskrivs hur du startar och verifierar enhetsuppdateringsagenten som en modulidentitet som körs på din IoT-enhet.

  1. Logga in på den dator eller enhet som har enhetsuppdateringsagenten installerad.

  2. Öppna ett terminalfönster och ange kommandot nedan.

    sudo systemctl restart deviceupdate-agent

  3. Du kan kontrollera statusen för agenten med hjälp av kommandot nedan. Om du ser några problem kan du läsa den här felsökningsguiden.

    sudo systemctl status deviceupdate-agent

    Du bör se statusEN OK.

  4. På IoT Hub-portalen går du till IoT-enhet eller IoT Edge-enheter för att hitta den enhet som du har konfigurerat med enhetsuppdateringsagenten. Där visas enhetsuppdateringsagenten som körs som en modul. Till exempel:

    Diagram över enhetsuppdateringsmodulens namn.

Så här skapar och kör du enhetsuppdateringsagenten

Du kan också skapa och ändra din egen kundenhetsuppdateringsagent. Följ anvisningarna för att skapa enhetsuppdateringsagenten från källan.

När agenten har skapats är det dags att köra agenten. Gör nu de ändringar som krävs för att införliva agenten i avbildningen. Se hur du ändrar enhetsuppdateringsagenten för vägledning.

Felsökningsguide

Om du stöter på problem kan du läsa felsökningsguiden för enhetsuppdatering för IoT Hub för att avblockera eventuella problem och samla in nödvändig information som ska tillhandahållas Microsoft.

Nästa steg

Du kan använda följande självstudier för en enkel demonstration av Enhetsuppdatering för IoT Hub: