Eseguire la migrazione di dispositivi e gruppi alla versione più recente di Aggiornamento dispositivi per hub IoT

Articolo
11/08/2023

Poiché Aggiornamento del dispositivo per hub IoT servizio rilascia nuove versioni, è consigliabile aggiornare i dispositivi per le funzionalità e i miglioramenti della sicurezza più recenti. Questo articolo fornisce informazioni su come eseguire la migrazione dalla versione [Aggiornamento anteprima pubblica (PPR) alla versione corrente disponibile a livello generale. Questo articolo illustra anche il comportamento del gruppo e dell'esperienza utente in queste versioni. Se non si dispone di dispositivi, gruppi e distribuzioni che usano la versione aggiornamento anteprima pubblica, è possibile ignorare questa pagina.

Per eseguire correttamente la migrazione, è necessario aggiornare l'agente DU in esecuzione nei dispositivi. Si noti che, poiché sono state apportate modifiche importanti alla versione ga, è consigliabile seguire attentamente le istruzioni per evitare errori.

Nota

Tutti i gruppi di dispositivi PPR creati verranno modificati automaticamente in gruppi ga. I gruppi e i dispositivi saranno disponibili dopo la migrazione. La cronologia della distribuzione non verrà conserci ai gruppi di disponibilità generale aggiornati.

Aggiornare l'agente di Aggiornamento dispositivi

Per la versione ga, l'agente di Aggiornamento dispositivi può essere aggiornato manualmente o usando il servizio Aggiornamento dispositivi usando aggiornamenti del manifesto o delle immagini apt. Se si usano gli aggiornamenti delle immagini, è possibile includere l'agente di aggiornamento dei dispositivi ga nell'aggiornamento.

Aggiornamento manuale dell'agente DU

Prima di aggiornare il dispositivo, gli attributi del dispositivo includeranno i dettagli del modello PPR PnP. Il nome del modello di contratto mostrerà il modello di aggiornamento del dispositivo V1 e l'ID del modello di contratto mostrerà dtmi:azure:iot:deviceUpdateContractModel; 1.

Connettersi tramite SSH al dispositivo e aggiornare l'agente di Aggiornamento dispositivi.

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

Verificare che l'agente DU sia in esecuzione correttamente. Cercare "HealthCheck superato"
```
sudo -u adu /usr/bin/AducIotAgent -h  
```
Vedere il dispositivo aggiornato nel portale di aggiornamento dispositivi. Gli attributi del dispositivo visualizzeranno ora i dettagli del modello PnP aggiornati. Il nome del modello di contratto mostrerà il modello di aggiornamento del dispositivo V2 e l'ID del modello di contratto mostrerà dtmi:azure:iot:deviceUpdateContractModel; 2.

Aggiornamento dell'agente OTA DU tramite manifesto APT

Prima di aggiornare i dispositivi, gli attributi del dispositivo includeranno i dettagli del modello PPR PnP. Il nome del modello di contratto mostrerà il modello di aggiornamento del dispositivo V1 e l'ID del modello di contratto mostrerà dtmi:azure:iot:deviceUpdateContractModel; 1.

Aggiungere l'aggiornamento dell'agente di aggiornamento del dispositivo come ultimo passaggio dell'aggiornamento. La versione del manifesto di importazione deve essere "4.0" per assicurarsi che sia destinata ai dispositivi corretti. Vedere di seguito un manifesto di importazione di esempio e un manifesto APT:

Esempio di importazione manifesto

{
   "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"
 }

Manifesto APT di esempio

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

Nota

È necessario che l'aggiornamento dell'agente sia l'ultimo passaggio. Prima dell'aggiornamento dell'agente potrebbero essere necessari altri passaggi. Tutti i passaggi aggiunti dopo l'aggiornamento dell'agente non verranno eseguiti e segnalati correttamente quando il dispositivo si riconnette al servizio DU.

Distribuire l'aggiornamento.
Dopo la distribuzione dell'aggiornamento, gli attributi del dispositivo visualizzeranno ora i dettagli del modello PnP aggiornati. Il nome del modello di contratto mostrerà il modello di aggiornamento del dispositivo V2 e l'ID del modello di contratto mostrerà dtmi:azure:iot:deviceUpdateContractModel; 2.

Comportamento di raggruppamento e distribuzione tra le versioni

Il dispositivo con l'agente du aggiornamento anteprima pubblica (0.8.x) e l'agente DU ga (1.0.x) possono essere gestiti tramite il portale di aggiornamento dispositivi.
I dispositivi con agenti meno recenti (0.7.0/0.6.0) non possono essere aggiunti a questi gruppi.

Passaggi successivi

Informazioni sul file di configurazione dell'agente di Aggiornamento dispositivi

È possibile usare le esercitazioni seguenti per una semplice dimostrazione di Aggiornamento dei dispositivi per hub IoT:

Condividi tramite