Provisioning dell'agente di aggiornamento del dispositivo

L'agente del modulo di aggiornamento del dispositivo può essere eseguito insieme ad altri processi di sistema e IoT Edge moduli che si connettono al hub IoT come parte dello stesso dispositivo logico. In questa sezione viene descritto come effettuare il provisioning dell'agente di aggiornamento del dispositivo come identità del modulo.

Modifiche apportate all'agente di aggiornamento del dispositivo in Aggiornamento anteprima pubblica

Sono state aggiunte molte nuove funzionalità all'agente Aggiornamento dispositivi nell'agente di aggiornamento pubblico più recente (versione 0.8.0). Per informazioni dettagliate, vedere l'elenco delle nuove funzionalità .

Se si usa l'agente di aggiornamento dispositivi versione 0.6.0 o 0.7.0, eseguire la migrazione alla versione più recente dell'agente 0.8.0. Vedere Agente di aggiornamento anteprima pubblica per le modifiche e come aggiornare

È possibile controllare la versione installata dell'agente di aggiornamento del dispositivo e l'agente di ottimizzazione recapito nella sezione Proprietà dispositivo del dispositivo gemello IoT. Altre informazioni sulle proprietà del dispositivo in ADU Core Interface.

Identità del modulo e identità del dispositivo

In hub IoT, in ogni identità del dispositivo, è possibile creare fino a 50 identità del modulo. Ogni identità del modulo genera implicitamente un modulo gemello. Sul lato del dispositivo, gli SDK per dispositivi dell'hub IoT consentono di creare moduli ognuno dei quali apre una connessione indipendente all'hub IoT. L'identità del modulo e il modulo gemello offrono funzionalità simili come identità del dispositivo e dispositivo gemello, ma in una granularità più fine. Altre informazioni sulle identità dei moduli in hub IoT

Se si esegue la migrazione da un agente a livello di dispositivo per aggiungere l'agente come identità del modulo nel dispositivo, rimuovere l'agente precedente che comunicava tramite Device Twin. Quando si esegue il provisioning dell'agente di aggiornamento del dispositivo come identità modulo, tutte le comunicazioni tra il dispositivo e il servizio Aggiornamento dispositivi si verificano nel modulo gemello, quindi ricordarsi di contrassegnare il modulo gemello del dispositivo quando si creano gruppi e tutte le comunicazioni devono verificarsi sul modulo gemello.

Supporto per l'aggiornamento del dispositivo

Il dispositivo IoT seguente sui tipi di aggiornamento aria è attualmente supportato con l'aggiornamento del dispositivo:

• Dispositivi Linux (IoT Edge e dispositivi non IoT Edge):

  • Aggiornamento di Immagine A/B
  • Aggiornamento del pacchetto
  • Aggiornamento proxy per i dispositivi downstream

• Dispositivi vincolati:

  • Esempi dell'agente di aggiornamento del dispositivo AzureRTOS: Aggiornamento del dispositivo per hub IoT di Azure esercitazione per Azure-Real-Time-Operating-System

• Dispositivi disconnessi:

  • Informazioni sul supporto per l'aggiornamento del dispositivo disconnesso

Prerequisiti

Se si configura il dispositivo IoT/IoT Edge dispositivo per gli aggiornamenti basati sul pacchetto, aggiungere packages.microsoft.com ai repository del computer seguendo questa procedura:

1. Accedere al computer o al dispositivo IoT in cui si intende installare l'agente di aggiornamento del dispositivo.

2. Aprire una finestra Terminale.

3. Installare la configurazione del repository corrispondente al sistema operativo del dispositivo.

   curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list
   

4. Copiare l'elenco generato nella directory sources.list.d.

   sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/
   

5. Installare la chiave pubblica GPG Microsoft.

   curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
   

   sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/
   

Come effettuare il provisioning dell'agente di aggiornamento del dispositivo come identità del modulo

Questa sezione descrive come effettuare il provisioning dell'agente di aggiornamento del dispositivo come identità del modulo in

• IoT Edge dispositivi abilitati o
• Dispositivi IoT non Perimetrali o
• Altri dispositivi IoT.

Per verificare se IoT Edge abilitato nel dispositivo, vedere le istruzioni di installazione IoT Edge.

Seguire tutte o tutte le sezioni seguenti per aggiungere l'agente di aggiornamento del dispositivo in base al tipo di dispositivo IoT gestito.

Nei dispositivi abilitati IoT Edge

Seguire queste istruzioni per effettuare il provisioning dell'agente di aggiornamento del dispositivo nei dispositivi abilitati IoT Edge.

1. Seguire le istruzioni per effettuare manualmente il provisioning di un singolo dispositivo Linux IoT Edge.

2. Installare l'agente di aggiornamento dell'immagine dell'aggiornamento del dispositivo.

   Vengono fornite immagini di esempio nel repository Asset . Il file swUpdate è l'immagine di base che è possibile flashare su una scheda Raspberry Pi B3+ . Il file con estensione gz è l'aggiornamento che si importa tramite Aggiornamento dispositivo per hub IoT. Per un esempio, vedere Come flashare l'immagine nel dispositivo hub IoT.

3. Installare l'agente di aggiornamento del pacchetto di aggiornamento del dispositivo.

   • Per le versioni più recenti dell'agente da packages.miscrosoft.com: aggiornare gli elenchi di pacchetti nel dispositivo e installare il pacchetto dell'agente di aggiornamento del dispositivo e le relative dipendenze usando:

     sudo apt-get update
     

     sudo apt-get install deviceupdate-agent deliveryoptimization-plugin-apt
     

   • Per qualsiasi versione dell'agente candidato di rilascio da Artifacts : scaricare il file con estensione deb nel computer in cui si vuole installare l'agente di aggiornamento del dispositivo in, quindi:

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

4. È ora possibile avviare l'agente di aggiornamento del dispositivo nel dispositivo IoT Edge.

Nei dispositivi Iot Linux senza IoT Edge installato

Seguire queste istruzioni per effettuare il provisioning dell'agente di aggiornamento del dispositivo nei dispositivi IoT Linux.

1. Installare il servizio identità IoT e aggiungere la versione più recente al dispositivo IoT seguendo le istruzioni seguenti in Installazione del servizio Identità IoT di Azure.

2. Configurare il servizio identità IoT seguendo le istruzioni riportate in Configurazione del servizio identità IoT di Azure.

3. Installare infine l'agente Di aggiornamento dispositivi. Vengono fornite immagini di esempio in Asset, il file swUpdate è l'immagine di base che è possibile eseguire il flash su una scheda Raspberry Pi B3+ e il file con estensione gz è l'aggiornamento che si importa tramite Aggiornamento dispositivo per hub IoT. Vedere l'esempio di come eseguire il flash dell'immagine nel dispositivo hub IoT.

4. Dopo aver installato l'agente di aggiornamento del dispositivo, sarà necessario modificare il file di configurazione per l'aggiornamento del dispositivo eseguendo il comando seguente.

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

   Modificare il connectionType in "AIS" per gli agenti che usano il servizio identità IoT per il provisioning. Il campo ConnectionData deve essere una stringa vuota

5. È ora possibile avviare l'agente di aggiornamento del dispositivo nel dispositivo IoT.

Altri dispositivi IoT

L'agente di aggiornamento dispositivi può essere configurato anche senza il servizio Identità IoT per il test o nei dispositivi vincolati. Seguire la procedura seguente per effettuare il provisioning dell'agente di aggiornamento del dispositivo usando una stringa di connessione (dal modulo o dal dispositivo).

1. Vengono fornite immagini di esempio nel repository Asset . Il file swUpdate è l'immagine di base che è possibile flashare su una scheda Raspberry Pi B3+ . Il file con estensione gz è l'aggiornamento che si importa tramite Aggiornamento dispositivo per hub IoT. Per un esempio, vedere Come flashare l'immagine nel dispositivo hub IoT.

2. Accedere al computer o IoT Edge dispositivo/IoT.

3. Aprire una finestra del terminale.

4. Aggiungere la stringa di connessione al file di configurazione dell'aggiornamento del dispositivo:

   1. Immettere quanto segue nella finestra del terminale:

      • Per l'uso dell'agente Ubuntu : sudo nano /etc/adu/du-config.json
      • Per l'immagine di riferimento yocto usare: sudo nano /adu/du-config.json

   2. Copiare la stringa di connessione primaria

      • Se l'agente di aggiornamento del dispositivo è configurato come modulo copia la stringa di connessione primaria del modulo.
      • In caso contrario, copiare la stringa di connessione primaria del dispositivo.

   3. Immettere la stringa di connessione primaria copiata al valore del campo 'connectionData' nel file du-config.json. Salvare quindi il file e chiuderlo.

5. A questo punto si è pronti per avviare l'agente di aggiornamento dei dispositivi nel dispositivo IoT.

Come avviare l'agente di aggiornamento del dispositivo

Questa sezione descrive come avviare e verificare l'agente di aggiornamento del dispositivo come identità del modulo in esecuzione correttamente nel dispositivo IoT.

1. Accedere al computer o al dispositivo con l'agente di aggiornamento del dispositivo installato.

2. Aprire una finestra Terminale e immettere il comando seguente.

   sudo systemctl restart adu-agent
   

3. È possibile controllare lo stato dell'agente usando il comando seguente. Se vengono visualizzati problemi, vedere questa guida alla risoluzione dei problemi.

   sudo systemctl status adu-agent
   

   Verrà visualizzato lo stato OK.

4. Nel portale di hub IoT passare al dispositivo IoT o IoT Edge dispositivi per trovare il dispositivo configurato con l'agente di aggiornamento del dispositivo. Verrà visualizzato l'agente di aggiornamento del dispositivo in esecuzione come modulo. Ad esempio:

   

Come creare ed eseguire l'agente di Aggiornamento dispositivi

È anche possibile compilare e modificare l'agente di aggiornamento dei dispositivi del cliente.

Seguire le istruzioni per compilare l'agente di aggiornamento del dispositivo dall'origine.

Dopo aver compilato correttamente l'agente, è possibile eseguire l'agente.

Apportare ora le modifiche necessarie per incorporare l'agente nell'immagine. Per indicazioni, vedere come modificare l'agente di aggiornamento dispositivi.

Guida per la risoluzione dei problemi

Se si verificano problemi, consultare la Guida alla risoluzione dei problemi di Aggiornamento del dispositivo per hub IoT per sbloccare eventuali problemi e raccogliere le informazioni necessarie da fornire a Microsoft.

Passaggi successivi

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

• Aggiornamento delle immagini: Introduzione con Raspberry Pi 3 B+ Reference Yocto Image estendibile tramite open source per creare immagini personalizzate per altre architetture in base alle esigenze.

• Aggiornamento pacchetto: Introduzione con l'agente del pacchetto Ubuntu Server 18.04 x64

• Aggiornamento proxy: Introduzione usando l'agente binario aggiornamento dispositivi per i dispositivi downstream

• Agente di riferimento del simulatore Introduzione using Ubuntu (18.04 x64)

• Esercitazione su Aggiornamento dei dispositivi per hub IoT di Azure per Azure-Real-Time-Operating-System