Apparaten en groepen migreren naar de nieuwste apparaatupdate voor IoT Hub-release

Artikel
11/08/2023

Wanneer de Device Update voor IoT Hub-service nieuwe versies publiceert, wilt u uw apparaten bijwerken voor de nieuwste functies en beveiligingsverbeteringen. In dit artikel vindt u informatie over het migreren van de release [Public Preview Refresh(PPR) naar de huidige GA-release. In dit artikel worden ook de groeps- en UX-werking in deze releases uitgelegd. Als u geen apparaten, groepen en implementaties hebt die gebruikmaken van de release Openbare preview vernieuwen, kunt u deze pagina negeren.

Als u wilt migreren, moet u de DU-agent bijwerken die op uw apparaten wordt uitgevoerd. Houd er rekening mee dat, omdat er grote wijzigingen zijn in de algemene beschikbaarheidsrelease, u wordt aangeraden de instructies nauwkeurig te volgen om fouten te voorkomen.

Notitie

Alle PPR-apparaatgroepen die worden gemaakt, worden automatisch gewijzigd in GA-groepen. De groepen en apparaten zijn na de migratie beschikbaar. De implementatiegeschiedenis wordt niet overgedragen naar de bijgewerkte GA-groepen.

De Device Update-agent bijwerken

Voor de GA-release kan de Device Update-agent handmatig worden bijgewerkt of met behulp van de Device Update Service met behulp van apt manifest- of installatiekopieënupdates. Als u installatiekopieënupdates gebruikt, kunt u de GA Device Update-agent opnemen in de update.

Handmatige upgrade van DU-agent

Voordat u uw apparaat bijwerkt, bevatten de apparaatkenmerken de details van het PPR PnP-model. De naam van het contractmodel toont apparaatupdatemodel V1 en contractmodel-id toont dtmi:azure:iot:deviceUpdateContractModel; 1.

SSH in uw apparaat en werk de Device Update-agent bij.

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

Controleer of de DU-agent correct wordt uitgevoerd. Zoek naar 'HealthCheck geslaagd'
```
sudo -u adu /usr/bin/AducIotAgent -h  
```
Bekijk het bijgewerkte apparaat in de Device Update-portal. In de apparaatkenmerken worden nu de bijgewerkte PnP-modeldetails weergegeven. De naam van het contractmodel toont apparaatupdate model V2 en contractmodel-id dtmi :azure:iot:deviceUpdateContractModel; 2.

Upgrade van OTA DU-agent via APT-manifest

Voordat u uw apparaten bijwerkt, bevatten de apparaatkenmerken de details van het PPR PnP-model. De naam van het contractmodel toont apparaatupdatemodel V1 en contractmodel-id toont dtmi:azure:iot:deviceUpdateContractModel; 1.

Voeg de upgrade van de agent voor apparaatupdates toe als laatste stap in uw update. De importmanifestversie moet '4.0' zijn om ervoor te zorgen dat deze is gericht op de juiste apparaten. Zie hieronder een voorbeeld van een importmanifest en APT-manifest:

Voorbeeld van 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"
 }

Voorbeeld van APT-manifest

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

Notitie

Het is vereist dat de agentupgrade de laatste stap is. Mogelijk hebt u andere stappen vóór de upgrade van de agent. Alle stappen die worden toegevoegd nadat de agentupgrade is uitgevoerd, worden niet correct uitgevoerd en gerapporteerd omdat het apparaat opnieuw verbinding maakt met de DU-service.

Implementeer de update.
Zodra de update is geïmplementeerd, worden de bijgewerkte PnP-modelgegevens weergegeven in de apparaatkenmerken. De naam van het contractmodel toont apparaatupdate model V2 en contractmodel-id dtmi :azure:iot:deviceUpdateContractModel; 2.

Gedrag van groepen en implementaties in verschillende releases

Het apparaat met de openbare preview-vernieuwings-DU-agent (0.8.x) en GA DU-agent (1.0.x) kunnen worden beheerd via de portal voor apparaatupdates.
Apparaten met oudere agents (0.7.0/0.6.0) kunnen niet worden toegevoegd aan deze groepen.

Volgende stappen

Informatie over het configuratiebestand van de Device Update-agent

U kunt de volgende zelfstudies gebruiken voor een eenvoudige demonstratie van Device Update voor IoT Hub:

Delen via