Dela via

Etablering av enhetsuppdateringsagent

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 vid uppdatering av offentlig förhandsversion

Vi har lagt till många nya funktioner i enhetsuppdateringsagenten i den senaste offentliga förhandsversionsuppdateringsagenten (version 0.8.0). Mer information finns i listan över nya funktioner .

Om du använder enhetsuppdateringsagentversionerna 0.6.0 eller 0.7.0 migrerar du till den senaste agentversionen 0.8.0. Se Förhandsversionsagent för allmän granskning 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 erbjuder liknande funktioner som enhetsidentitet och enhetstvilling, men med en finare detaljeringsgrad. 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-enhetstypers uppdateringar över luften stöds för närvarande av 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 uppdateringsagenten för enhetsavbildning.

    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.miscrosoft.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 deliveryoptimization-plugin-apt

    • För alla "rc", det vill säga release candidate agentversioner från Artifacts: Ladda ner .deb-filen till den maskin där du vill installera Device Update agenten och sedan:

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

  4. Nu är du redo att starta enhetsuppdateringsagenten på din IoT Edge-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 stegen 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 exempelavbildningar i Tillgångar här, swUpdate-filen är basavbildningen som du kan flasha till en Raspberry Pi B3+-tavla och filen .gz ä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 kommer att använda IoT Identity Service för tillhandahållande. Fältet ConnectionData måste vara en tom sträng

  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ängen i konfigurationsfilen för enhetsuppdatering:

    1. Ange nedanstående i terminalfönstret:

    2. Kopiera den primära anslutningssträngen

      • 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ängen till fältet "connectionData" i filen du-config.json. Spara sedan och stäng filen.

  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 adu-agent

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

    sudo systemctl status adu-agent

    Du bör se status 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 modifiera en egen agent för enhetsuppdateringar.

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 handledningar för en enkel demonstration av Enhetsuppdatering för IoT Hub.