Migrera enheter och grupper till den senaste enhetsuppdateringen för IoT Hub-versionen

Artikel
11/08/2023

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 versionen [Public Preview Refresh(PPR) till den aktuella ga-versionen. 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 uppdateringen av 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. Observera att eftersom det finns stora ändringar med GA-versionen rekommenderar vi att du följer anvisningarna noga för att undvika fel.

Kommentar

Alla PPR-enhetsgrupper som skapas ändras automatiskt till GA-grupper. Grupperna och enheterna kommer att vara tillgängliga efter migreringen. Distributionshistoriken överförs inte till de uppdaterade GA-grupperna.

Uppdatera enhetsuppdateringsagenten

För GA-versionen kan enhetsuppdateringsagenten uppdateras manuellt eller med hjälp av enhetsuppdateringstjänsten med hjälp av apt-manifest eller avbildningsuppdateringar. Om du använder avbildningsuppdateringar kan du inkludera GA Device Update-agenten i uppdateringen.

Manuell UPPGRADERING av DU-agent

Innan du uppdaterar enheten innehåller enhetsattributen PPR PnP-modellinformation. Namnet på kontraktsmodellen visar enhetsuppdateringsmodellen V1 och kontraktsmodell-ID :t visar dtmi:azure:iot:deviceUpdateContractModel; 1.

SSH till enheten och uppdatera enhetsuppdateringsagenten.

sudo apt install deviceupdate-agent
sudo systemctl restart deviceupdate-agent
sudo systemctl status deviceupdate-agent

Bekräfta att DU-agenten körs korrekt. Leta efter "HealthCheck har godkänts"
```
sudo -u adu /usr/bin/AducIotAgent -h  
```
Se den uppdaterade enheten i enhetsuppdateringsportalen. Enhetsattributen visar nu uppdaterad PnP-modellinformation. Kontraktmodellnamnet visar enhetsuppdateringsmodellen V2 och kontraktmodell-ID:t visar dtmi:azure:iot:deviceUpdateContractModel; 2.

OTA DU-agentuppgradering via APT-manifest

Innan du uppdaterar dina enheter innehåller enhetsattributen PPR PnP-modellinformation. Namnet på kontraktsmodellen visar enhetsuppdateringsmodellen V1 och kontraktsmodell-ID :t visar dtmi:azure:iot:deviceUpdateContractModel; 1.

Lägg till uppgradering av enhetsuppdateringsagenten som det sista steget i uppdateringen. Importmanifestversionen måste vara "4.0" för att säkerställa att den är riktad till rätt enheter. Se nedan ett exempel på ett importmanifest och APT-manifest:

Exempel på importmanifest

{
   "manifestVersion": "4",
   "updateId": {
     "provider": "Contoso",
     "name": "Sensor",
     "version": "1.0"
   },
   "compatibility": [
     {
       "manufacturer": "Contoso",
       "model": "Sensor"
     }
   ],
   "instructions": {
     "steps": [
       {
     "handler": "microsoft/apt:1",
     "handlerProperties": {
       "installedCriteria": "1.0"
     },
     "files": [
       "fileId0"
     ]
       }
     ]
   },
   "files": {
     "fileId0": {
       "filename": "sample-upgrade-apt-manifest.json",
       "sizeInBytes": 210,
       "hashes": {
     "sha256": "mcB5SexMU4JOOzqmlJqKbue9qMskWY3EI/iVjJxCtAs="
       }
     }
   },
   "createdDateTime": "2022-08-20T18:32:01.8404544Z"
 }

Exempel på APT-manifest

  {
    "name": "Sample DU agent upgrade update",
    "version": "1.0.0",
    "packages": [
    {
        "name": "deviceupdate-agent"
    }
    ]
}

Kommentar

Det krävs för att agentuppgradering ska vara det sista steget. Du kan ha andra steg innan agenten uppgraderas. Alla steg som läggs till efter agentuppgradningen kommer inte att köras och rapporteras korrekt när enheten återansluter till DU-tjänsten.

Distribuera uppdateringen.
När uppdateringen har distribuerats visar enhetsattributen nu den uppdaterade PnP-modellinformationen. Kontraktmodellnamnet visar enhetsuppdateringsmodellen V2 och kontraktmodell-ID:t visar dtmi:azure:iot:deviceUpdateContractModel; 2.

Grupp- och distributionsbeteende för olika versioner

Enheten med DU-agenten för offentlig förhandsversionsuppdatering ( 0.8.x) och GA DU-agenten (1.0.x) kan hanteras via portalen för enhetsuppdatering.
Enheter med äldre agenter (0.7.0/0.6.0) kan inte läggas till i dessa grupper.

Nästa steg

Förstå konfigurationsfilen för enhetsuppdateringsagenten

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

Dela via