Condividi tramite

Eseguire la migrazione di dispositivi e gruppi dall'anteprima pubblica all'aggiornamento dell'anteprima pubblica

Quando il servizio Aggiornamento dispositivi per l'hub IoT 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 di anteprima pubblica alla versione corrente dell'aggiornamento dell'anteprima pubblica (PPR). 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 di anteprima pubblica, è possibile ignorare questa pagina.

Per eseguire correttamente la migrazione, è necessario aggiornare l'agente DU in esecuzione nei dispositivi. Sarà anche necessario creare nuovi gruppi di dispositivi per distribuire e gestire gli aggiornamenti. Si noti che, poiché sono state apportate modifiche importanti alla versione PPR, è consigliabile seguire attentamente le istruzioni per evitare errori.

Aggiornare l'agente di aggiornamento del dispositivo

Per la versione di aggiornamento refresh dell'anteprima pubblica, l'agente di aggiornamento dispositivi deve essere aggiornato manualmente come descritto di seguito. L'aggiornamento dell'agente tramite una distribuzione dell'aggiornamento dei dispositivi non è supportato a causa delle significative modifiche introdotte tra l'anteprima pubblica e la versione PPR.

  1. Per visualizzare i dispositivi che usano agenti meno recenti (versioni 0.7.0/0.6.0) e gruppi creati prima del 03/02/2022, passare al portale di anteprima pubblica, accessibile tramite il banner.

    Screenshot del banner.

  2. Creare un nuovo dispositivo IoT/IoT Edge nel portale di Azure. Copiare la stringa di connessione primaria per il dispositivo dalla visualizzazione del dispositivo per un secondo momento. Per altri dettagli, vedere la sezione Aggiungere un dispositivo all'hub IoT .

  3. Accedi tramite SSH al tuo dispositivo e rimuovi qualsiasi agente di aggiornamento dispositivo precedente.

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

  4. Rimuovere il file di configurazione precedente

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

  5. Installare il nuovo agente

    sudo apt-get install deviceupdate-agent

    In alternativa, è possibile ottenere l'asset .deb da GitHub e installare l'agente

    sudo apt install <file>.deb

    Il tentativo di aggiornare l'agente di Aggiornamento dispositivi senza rimuovere l'agente precedente e i file di configurazione genererà l'errore riportato di seguito.

    Screenshot dell'errore di aggiornamento.

  6. Immettere la stringa di connessione primaria del proprio dispositivo IoT (o del modulo, a seconda di come è stato effettuato il provisioning del dispositivo con Aggiornamento dispositivi) nel file di configurazione eseguendo il comando seguente.

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

  7. Aggiungere il modello, il produttore, il nome dell'agente, il tipo di connessione e altri dettagli nel file di configurazione

  8. Eliminare il dispositivo IoT/IoT Edge precedente dal portale di anteprima pubblica.

Annotazioni

Tentando di aggiornare l'agente tramite una distribuzione DU, il dispositivo non sarà più gestibile da Device Update. Il dispositivo dovrà essere riprovisionato per essere gestito tramite Aggiornamento dispositivi.

Migrare i gruppi all'anteprima pubblica aggiornata

  1. Se i dispositivi usano le versioni dell'agente di Aggiornamento dispositivi 0.6.0 o 0.7.0, eseguire l'aggiornamento alla versione più recente dell'agente 0.8.0 seguendo la procedura precedente.

  2. Eliminare i gruppi esistenti nel portale di anteprima pubblica passando attraverso il banner.

  3. Aggiungere un tag di gruppo al dispositivo gemello per i dispositivi aggiornati. Per altri dettagli, vedere la sezione Aggiungere un tag al dispositivo .

  4. Ricreare i gruppi nel portale PPR passando a "Aggiungi gruppi" e selezionando il tag gruppi corrispondente dall'elenco a discesa.

  5. Si noti che non è possibile creare un gruppo con lo stesso nome nel portale PPR se il gruppo nel portale di anteprima pubblica non viene eliminato.

Comportamento di raggruppamento e distribuzione tra le versioni

  • I gruppi creati nel portale per la versione di aggiornamento dell'anteprima pubblica consentiranno solo l'aggiunta di dispositivi con l'agente di aggiornamento dispositivi più recente (0.8.0). I dispositivi con agenti meno recenti (0.7.0/0.6.0) non possono essere aggiunti a questi gruppi.

  • Tutti i nuovi dispositivi che usano l'agente più recente verranno aggiunti automaticamente a un gruppo DeviceClass predefinito nella scheda "Gruppi e distribuzioni". Se un tag di gruppo viene aggiunto alle proprietà del dispositivo, il dispositivo verrà aggiunto a tale gruppo se esiste un gruppo per tale tag.

  • Per il dispositivo che usa l'agente più recente, se viene aggiunto un tag di gruppo alle proprietà del dispositivo, ma il gruppo corrispondente non è ancora stato creato, il dispositivo non sarà visibile nella scheda "Gruppi e distribuzioni".

  • I dispositivi che usano gli agenti meno recenti verranno visualizzati come non raggruppati nel portale precedente se il tag di gruppo non viene aggiunto.

Passaggi successivi

Comprendere il file di configurazione dell'agente di Aggiornamento dispositivi

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

  • Last updated on