Eseguire la migrazione di dispositivi e gruppi da Anteprima pubblica all'aggiornamento di anteprima pubblica

  • Articolo

Poiché l'aggiornamento del dispositivo per hub IoT servizio rilascia nuove versioni, si vuole 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, Aggiornamento 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 le istruzioni per evitare errori.

Aggiornare l'agente di aggiornamento del dispositivo

Per la versione Di aggiornamento anteprima pubblica, l'agente di aggiornamento del dispositivo deve essere aggiornato manualmente come descritto di seguito. L'aggiornamento dell'agente tramite una distribuzione di Aggiornamento dispositivi non è supportato a causa di modifiche importanti nella versione di anteprima pubblica e PPR.

  1. Per visualizzare i dispositivi che usano agenti meno recenti (versioni 0.7.0/0.6.0) e gruppi creati prima del 02/03/2022, passare al portale di anteprima pubblica, a cui è possibile accedere 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 dispositivo per un secondo momento. Per altre informazioni, vedere la sezione Aggiungi dispositivo a hub IoT.

  3. Quindi, SSH nel dispositivo e rimuovere qualsiasi agente di aggiornamento del 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 con estensione deb da GitHub e installare l'agente

    sudo apt install <file>.deb

    Il tentativo di aggiornare l'agente di aggiornamento del dispositivo senza rimuovere l'agente precedente e i file di configurazione generano l'errore riportato di seguito.

    Screenshot dell'errore di aggiornamento.

  6. Immettere il dispositivo del dispositivo IoT (o il modulo, a seconda della modalità di provisioning del dispositivo con Aggiornamento dispositivo) della stringa di connessione primaria 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.

Nota

Il tentativo di aggiornare l'agente tramite una distribuzione DU consentirà al dispositivo di non essere più gestibile dall'aggiornamento del dispositivo. Il dispositivo dovrà essere nuovamente sottoposto a provisioning per essere gestito dall'aggiornamento del dispositivo.

Eseguire la migrazione dei gruppi all'aggiornamento di anteprima pubblica

  1. Se i dispositivi usano l'agente di aggiornamento dispositivi versione 0.6.0 o 0.7.0, eseguire l'aggiornamento alla versione più recente dell'agente 0.8.0 seguendo i passaggi precedenti.

  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 altre informazioni, fare riferimento alla sezione Aggiungi un tag al dispositivo .

  4. Ricreare i gruppi nel portale PPR passando a "Aggiungi gruppi" e selezionando il tag dei gruppi corrispondenti nell'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.

Gruppo e comportamento di distribuzione tra versioni

  • I gruppi creati nel portale di versione di aggiornamento anteprima pubblica consentono solo l'aggiunta di dispositivi con l'agente di aggiornamento del dispositivo 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 viene aggiunto un tag di gruppo 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

Informazioni sul file di configurazione dell'agente di aggiornamento del dispositivo

È possibile usare le esercitazioni seguenti per una semplice dimostrazione dell'aggiornamento dei dispositivi per hub IoT: