Dela via

Migrera enheter och grupper från offentlig förhandsversion till offentlig förhandsversionsuppdatering

När enhetsuppdateringen för IoT Hub-tjänsten släpper nya versioner vill du uppdatera dina enheter för de senaste funktionerna och säkerhetsförbättringarna. Den här artikeln innehåller information om hur du migrerar från public preview-versionen till den aktuella versionen Public Preview Refresh (PPR). I den här artikeln förklaras även grupp- och UX-beteendet i de här versionerna. Om du inte har enheter, grupper och distributioner som använder den offentliga förhandsversionen kan du ignorera den här sidan.

Om du vill migrera måste du uppgradera DU-agenten som körs på dina enheter. Du måste också skapa nya enhetsgrupper för att distribuera och hantera uppdateringar. Observera att eftersom det finns stora ändringar i PPR-versionen rekommenderar vi att du följer anvisningarna noga för att undvika fel.

Uppdatera enhetsuppdateringsagenten

För uppdateringen av den offentliga förhandsversionen måste enhetsuppdateringsagenten uppdateras manuellt enligt beskrivningen nedan. Det går inte att uppdatera agenten via en enhetsuppdateringsdistribution på grund av större ändringar i den offentliga förhandsversionen och PPR-versionen.

  1. Om du vill visa enheter med äldre agenter (version 0.7.0/0.6.0) och grupper som skapats före 2022-02-02 går du till den offentliga förhandsversionsportalen som kan nås via banderollen.

    Skärmbild av banderoll.

  2. Skapa en ny IoT/IoT Edge-enhet på Azure-portalen. Kopiera den primära anslutningssträngen för enheten från enhetsvyn för senare. Mer information finns i avsnittet Lägg till enhet i IoT Hub.

  3. SSH till enheten och ta bort alla gamla enhetsuppdateringsagenter.

    sudo apt remove deviceupdate-agent 
sudo apt remove adu-agent

  4. Ta bort den gamla konfigurationsfilen

    sudo rm -f /etc/adu/adu-conf.txt

  5. Installera den nya agenten

    sudo apt-get install deviceupdate-agent

    Du kan också hämta .deb-filen från GitHub och installera agenten

    sudo apt install <file>.deb

    Om du försöker uppgradera enhetsuppdateringsagenten utan att ta bort den gamla agenten och konfigurationsfilerna uppstår felet som visas nedan.

    Skärmbild av uppdateringsfel.

  6. Ange din IoT-enhets (eller moduls, beroende på hur du etablerat den med Enhetsuppdatering) huvudanslutningssträng i konfigurationsfilen genom att köra kommandot nedan.

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

  7. Lägg till din modell, tillverkare, agentnamn, anslutningstyp och annan information i konfigurationsfilen

  8. Ta bort den gamla IoT/IoT Edge-enheten från den offentliga förhandsversionsportalen.

Anmärkning

Om du försöker uppdatera agenten via en DU-distribution kommer enheten inte längre kunna hanteras av Device Update-tjänsten. Enheten måste konfigureras om för att kunna hanteras från Enhetsuppdatering.

Migrera grupper till uppdatering av offentlig förhandsversion

  1. Om dina enheter använder enhetsuppdateringsagentversionerna 0.6.0 eller 0.7.0 uppgraderar du till den senaste agentversionen 0.8.0 enligt stegen ovan.

  2. Ta bort befintliga grupper i portalen för offentlig förhandsversion genom att navigera genom banderollen.

  3. Lägg till en grupptagg för device twin för de uppdaterade enheterna. Mer information finns i avsnittet Lägg till en tagg i enheten.

  4. Återskapa grupperna i PPR-portalen genom att gå till Lägg till grupper och välja motsvarande grupptagg i listrutan.

  5. Observera att en grupp med samma namn inte kan skapas i PPR-portalen om gruppen i den offentliga förhandsversionsportalen inte tas bort.

Grupp- och distributionsbeteende för olika versioner

  • Grupper som skapats i versionsportalen för offentlig förhandsversion tillåter endast tillägg av enheter med den senaste enhetsuppdateringsagenten (0.8.0). Enheter med äldre agenter (0.7.0/0.6.0) kan inte läggas till i dessa grupper.

  • Alla nya enheter som använder den senaste agenten läggs automatiskt till i en standardenhetklassgrupp på fliken Grupper och distributioner. Om en grupptagg läggs till i enhetsegenskaperna läggs enheten till i gruppen om det finns en grupp för taggen.

  • För enheten som använder den senaste agenten visas inte enheten på fliken Grupper och distributioner om en grupptagg läggs till i enhetsegenskaperna, men motsvarande grupp ännu inte har skapats.

  • Enheter som använder äldre versioner av agenterna visas som ej grupperade i den gamla portalen om grupptaggen inte läggs till.

Nästa steg

Förstå konfigurationsfilen för enhetsuppdateringsagenten

Du kan använda följande handledningar för en enkel demonstration av Enhetsuppdatering för IoT Hub.