Guida alla risoluzione dei problemi di aggiornamento dei dispositivi per hub IoT

Articolo
05/24/2023

Questo documento elenca alcune domande comuni e problemi relativi agli utenti dell'aggiornamento dei dispositivi. Se si verifica un problema che non viene visualizzato in questa guida alla risoluzione dei problemi, vedere la sezione Contatto supporto tecnico Microsoft per documentare la situazione.

Importazione di aggiornamenti

D: Si verificano problemi durante la connessione dell'istanza di Aggiornamento dispositivo all'istanza di hub IoT

Assicurarsi che le route dei messaggi hub IoT siano configurate correttamente, in base alla documentazione relativa alle risorse di Aggiornamento dispositivi.

È possibile che non siano configurate correttamente le autorizzazioni di accesso. Assicurarsi di aver configurato correttamente le autorizzazioni di accesso in base alla documentazione del controllo di accesso degli aggiornamenti del dispositivo .

D: Si verifica un errore di tipo 500 durante l'importazione del contenuto nel servizio Aggiornamento dispositivi

Un codice di errore nell'intervallo 500 può indicare un problema con il servizio Aggiornamento dispositivi. Attendere 5 minuti, quindi riprovare. Se lo stesso errore persiste, seguire le istruzioni riportate nella sezione Contatto supporto tecnico Microsoft per inviare una richiesta di supporto con Microsoft.

D: Si desidera mantenere le stesse proprietà di compatibilità (destinazione dell'aggiornamento allo stesso tipo di dispositivo), ma modificare il provider o il nome nel manifesto di importazione. Ma viene visualizzato un errore "Errore: errore di importazione dell'aggiornamento a causa del superamento del limite" quando lo si esegue

Impossibile usare lo stesso set esatto di proprietà di compatibilità con più provider di aggiornamenti e combinazione nome. Ciò consente al servizio Aggiornamento dispositivi di determinare con certezza quali aggiornamenti devono essere disponibili per la distribuzione in un determinato dispositivo. Se è necessario aggiornare più componenti o partizioni in un singolo dispositivo, la funzionalità aggiornamenti proxy offre tale funzionalità.

D: Viene visualizzato un messaggio di errore durante l'importazione del contenuto e si vuole comprendere di più su di esso

Per informazioni più dettagliate sui messaggi di errore correlati all'importazione, vedere la documentazione relativa ai codici di errore di aggiornamento del dispositivo .

Errori del dispositivo

D: Come è possibile assicurarsi che il dispositivo sia connesso all'aggiornamento del dispositivo per hub IoT?

È possibile verificare che il dispositivo sia connesso all'aggiornamento del dispositivo controllando se viene visualizzato nella sezione dispositivi "Ungrouped" nella visualizzazione conformità di portale di Azure.

D: uno o più dispositivi non riesce ad aggiornare

Esistono molte possibili cause radice per un errore di aggiornamento del dispositivo. Verificare che il dispositivo sia: 1) connesso all'istanza di hub IoT, 2) connesso all'istanza di Aggiornamento dispositivo e 3) il servizio Ottimizzazione recapito (DO) è in esecuzione. Se tutte e tre sono vere per il dispositivo, seguire le istruzioni riportate nella sezione Contatto supporto tecnico Microsoft per inviare una richiesta di supporto con Microsoft.

D: L'agente di aggiornamento del dispositivo non riesce ad avviare

Uno dei motivi più comuni per un errore nell'avvio dell'agente di aggiornamento del dispositivo è un file di configurazione non valido (du-config.json). Fare riferimento alla documentazione del file di configurazione e verificare che l'agente sia configurato correttamente. Si noti che tutti i valori nel file di configurazione devono usare virgolette doppie.

Distribuzione di un aggiornamento

D: È stato distribuito un aggiornamento ai dispositivi, ma lo stato di conformità indica che non è nell'aggiornamento più recente. Cosa devo fare?

Lo stato di conformità del dispositivo può richiedere fino a 5 minuti per aggiornare. Attendere, quindi controllare di nuovo.

D: Lo stato della distribuzione del dispositivo mostra elementi incompatibili, cosa devo fare?

Le proprietà del produttore e del modello di un dispositivo di destinazione potrebbero essere state modificate dopo la connessione del dispositivo a hub IoT, causando che il dispositivo sia ora considerato incompatibile con il contenuto di aggiornamento della distribuzione corrente.

Controllare l'interfaccia ADU Core per visualizzare il produttore e il modello che il dispositivo segnala al servizio Aggiornamento dispositivi e assicurarsi che corrisponda al produttore e al modello specificato nel manifesto di importazione del contenuto di aggiornamento distribuito. È possibile modificare queste proprietà per un determinato dispositivo usando il file di configurazione dell'aggiornamento del dispositivo.

D: La distribuzione è in fase "Attiva", ma nessuno dei dispositivi è in corso con l'aggiornamento. Cosa devo fare?

Assicurarsi che la data di inizio della distribuzione non sia impostata in futuro. Quando si crea una nuova distribuzione, la data di inizio della distribuzione viene impostata per impostazione predefinita al giorno successivo come protezione a meno che non venga modificata in modo esplicito. È possibile attendere l'arrivo della data di inizio della distribuzione o annullare la distribuzione in corso e crearne una nuova con la data di inizio desiderata.

D: Si sta tentando di raggruppare i dispositivi, ma non viene visualizzato il tag nell'elenco a discesa durante la creazione di un gruppo

Assicurarsi di aver configurato correttamente le route dei messaggi nel hub IoT in base alla documentazione relativa alle risorse di Aggiornamento dispositivi. Dopo aver configurato la route, sarà necessario contrassegnare di nuovo il dispositivo.

Un'altra causa radice potrebbe essere che è stato applicato il tag prima di connettere il dispositivo ad Aggiornamento dispositivo per hub IoT. Assicurarsi che il dispositivo sia già connesso all'aggiornamento del dispositivo. È possibile verificare che il dispositivo sia connesso all'aggiornamento del dispositivo per hub IoT controllando se viene visualizzato in dispositivi "Ungrouped" nella visualizzazione conformità. Aggiungere temporaneamente un tag di un valore diverso e quindi aggiungere di nuovo il tag previsto una volta connesso il dispositivo.

Se si usa il servizio Device Provisioning (DPS), assicurarsi di contrassegnare i dispositivi dopo il provisioning e non durante il processo di creazione del dispositivo. Se il dispositivo è già stato contrassegnato durante il passaggio di creazione del dispositivo, sarà necessario contrassegnare temporaneamente il dispositivo con un valore diverso dopo il provisioning e quindi aggiungere di nuovo il tag previsto.

D: La distribuzione è stata completata correttamente, ma alcuni dispositivi non sono riusciti ad aggiornare

Questo potrebbe essere stato causato da un errore lato client nei dispositivi non riusciti. Vedere la sezione Errori del dispositivo di questa guida alla risoluzione dei problemi.

D: Si è verificato un errore nell'esperienza utente durante il tentativo di avviare una distribuzione

Questo potrebbe essere stato causato da un bug di servizio/esperienza utente o da un problema di autorizzazioni api. Seguire le istruzioni riportate nella sezione Contatto supporto tecnico Microsoft per inviare una richiesta di supporto con Microsoft.

D: È stata avviata una distribuzione, ma non raggiunge uno stato finale

Questo potrebbe essere stato causato da un problema di prestazioni del servizio, un bug del servizio o un bug client. Riprovare la distribuzione dopo 10 minuti. Se si verifica lo stesso problema, eseguire il pull dei log del dispositivo e fare riferimento alla sezione Errori del dispositivo di questa guida alla risoluzione dei problemi. Se lo stesso problema persiste, seguire le istruzioni riportate nella sezione Contatto supporto tecnico Microsoft per inviare una richiesta di supporto con Microsoft.

D: È stata eseguita la migrazione da un agente a livello di dispositivo per aggiungere l'agente come identità del modulo nel dispositivo e l'aggiornamento viene visualizzato come "in corso" anche se è stato applicato al dispositivo

Questo potrebbe essere stato causato se non è stato rimosso l'agente precedente che comunicava su Device Twin. Quando si esegue il provisioning dell'agente di aggiornamento del dispositivo come modulo (vedere come) tutte le comunicazioni tra il dispositivo e il servizio Aggiornamento dispositivi si verificano sul modulo gemello, quindi ricordarsi di contrassegnare il modulo gemello del dispositivo quando si creano gruppi e tutte le comunicazioni devono verificarsi sul modulo gemello.

Download di aggiornamenti nei dispositivi

D: Ricerca per categorie riprendere un download quando un dispositivo si è riconnesso dopo un periodo di disconnessione?

Il download riprenderà automaticamente quando la connettività viene ripristinata entro un periodo di 24 ore. Dopo 24 ore, il download dovrà essere reiniziato dall'utente.

Uso di Microsoft Connected Cache (MCC)

D: Si verifica un problema durante il tentativo di distribuire il modulo MCC nel dispositivo IoT Edge

Vedere la documentazione di IoT Edge per la distribuzione dei moduli Edge nei dispositivi IoT Edge. È possibile verificare se il modulo MCC è in esecuzione correttamente nel dispositivo IoT Edge passando ahttp://localhost:5100/Summary.

D: Uno dei dispositivi IoT sta tentando di scaricare un aggiornamento tramite MCC, ma ha esito negativo

Esistono diversi problemi che potrebbero causare un errore di connessione a MCC di un dispositivo IoT. Per diagnosticare il problema, raccogliere i log do client e Nginx dal dispositivo non riuscito (vedere la sezione Contatto supporto tecnico Microsoft per istruzioni sulla raccolta dei log client).

Il dispositivo potrebbe non riuscire a eseguire il pull del contenuto da Internet per passare al modulo MCC perché l'URL usato non è consentito. Per determinare se è così, è necessario controllare le variabili di ambiente IoT Edge in portale di Azure.

Risoluzione dei problemi relativi a un'istanza mancante nel portale di Azure

D: Non viene visualizzata un'istanza di Aggiornamento del dispositivo per hub IoT quando si seleziona l'icona "ingranaggio"

Esistono alcune possibili cause per questo problema. Per la procedura di risoluzione dei problemi, vedere di seguito.

Un'istanza di Aggiornamento dispositivi deve essere associata a un hub IoT di Azure nello stesso gruppo di risorse e nella stessa sottoscrizione. Se è stata spostata l'istanza di Aggiornamento dispositivi o l'hub in un gruppo di risorse o una sottoscrizione diversa, potrebbe non essere visualizzata l'istanza nell'portale di Azure. Per continuare a usare l'aggiornamento del dispositivo per hub IoT, è necessario eseguire una delle operazioni seguenti:

Restituire gli elementi spostati alla configurazione originale.
Se l'hub IoT è stato spostato solo da un gruppo di risorse a un altro, modificare l'istanza di Aggiornamento del dispositivo con il nuovo resourceId dell'hub IoT.
Se si spostano elementi da una sottoscrizione a un'altra, assicurarsi che l'account Di aggiornamento del dispositivo e l'hub IoT si trovino nella stessa sottoscrizione e quindi modificare l'istanza di Aggiornamento dispositivo con il nuovo resourceId dell'hub IoT.

Sono necessarie almeno autorizzazioni a livello di lettura per l'hub IoT e per l'account Di aggiornamento del dispositivo per hub IoT per accedere alla funzionalità Aggiornamento dispositivi tramite l'esperienza dell'hub IoT nell'portale di Azure.

Per gestire le autorizzazioni per il hub IoT:
- Selezionare l'hub dall'portale di Azure
- Selezionare "Controllo di accesso (IAM) dalla barra di spostamento a sinistra.
- Selezionare "Aggiungi assegnazione ruolo".
- Selezionare un ruolo con almeno accesso in lettura e selezionare Avanti.
- Accanto a "Membri", selezionare "+Seleziona membri".
- Aggiungere l'account nel riquadro a comparsa a destra e selezionare il pulsante "Seleziona".
- Selezionare "Rivedi e assegna".
Per gestire le autorizzazioni per l'aggiornamento del dispositivo per hub IoT account, chiedere al proprietario dell'account di eseguire questi passaggi:
- Selezionare l'account di Aggiornamento dispositivi dal portale di Azure.
- Selezionare "Controllo di accesso (IAM) dalla barra di spostamento a sinistra.
- Selezionare "Aggiungi assegnazione di ruolo".
- Selezionare il ruolo Lettore (o uno con autorizzazioni equivalenti).
- Accanto a "Membri", selezionare "+Seleziona membri".
- Aggiungere l'account nel riquadro a comparsa a destra e selezionare il pulsante "Seleziona".
- Selezionare "Rivedi e assegna".

Altre informazioni sul controllo degli accessi in base al ruolo per il servizio Aggiornamento dispositivi.

Contattare il supporto tecnico Microsoft

Se si verificano problemi che non possono essere risolti usando le domande frequenti precedenti, è possibile inviare una richiesta di supporto con supporto tecnico Microsoft tramite l'interfaccia portale di Azure. A seconda della categoria a cui si indica che appartiene il problema, potrebbe essere richiesto di raccogliere e condividere dati aggiuntivi per aiutare supporto tecnico Microsoft analizzare il problema.

Per istruzioni su come raccogliere ogni tipo di dati, vedere di seguito.

È possibile usare getDevice per verificare la presenza di informazioni aggiuntive nella risposta del payload dell'API.

Inoltre, le informazioni seguenti possono essere utili per restringere la causa radice del problema:

Tipo di dispositivo che si sta tentando di aggiornare (IoT Edge Gateway, altro)
Tipo di client di Aggiornamento dispositivi in uso (basato su immagini, basato su pacchetto, simulatore)
Quale sistema operativo è in esecuzione nel dispositivo
Dettagli relativi all'architettura del dispositivo
Indica se l'aggiornamento del dispositivo è stato usato correttamente per aggiornare un dispositivo prima

Se si dispone di una delle informazioni precedenti disponibili, includerla nella descrizione del problema.

Raccolta dei log client

Nel dispositivo Raspberry Pi sono disponibili due set di log:
```
/adu/logs
```
```
/var/cache/do-client-lite/log
```
Per il client in pacchetto, i log sono disponibili qui:
```
/var/log/adu
```
```
/var/cache/do-client-lite/log
```
Per il simulatore, i log sono disponibili qui:
```
/tmp/aduc-logs
```

Codici di errore

È possibile che venga richiesto di specificare i codici di errore quando si segnala un problema correlato all'importazione di un aggiornamento, a un errore del dispositivo o alla distribuzione di un aggiornamento.

I codici di errore possono essere ottenuti esaminando l'interfaccia ADUCoreInterface . Per informazioni su come analizzare i codici di errore per la diagnosi automatica e la risoluzione dei problemi, vedere la documentazione relativa ai codici di errore di Aggiornamento dispositivi.

ID traccia

È possibile che venga richiesto di specificare un ID di traccia quando si segnala un problema correlato all'importazione o alla distribuzione di un aggiornamento.

L'ID di traccia per una determinata azione utente è disponibile all'interno della risposta dell'API o nella sezione Cronologia importazione dell'interfaccia utente di portale di Azure.

Attualmente, gli ID di traccia per le azioni di distribuzione sono accessibili solo tramite la risposta dell'API.

ID distribuzione

È possibile che venga richiesto di specificare un ID di distribuzione quando si segnala un problema correlato alla distribuzione di un aggiornamento.

L'ID di distribuzione viene creato dall'utente quando chiama l'API per avviare una distribuzione.

Attualmente, gli ID di distribuzione per le distribuzioni avviate dall'interfaccia utente di portale di Azure vengono generati automaticamente e non vengono visualizzati all'utente.

hub IoT nome dell'istanza

Potrebbe essere richiesto di specificare il nome dell'istanza di hub IoT quando si segnala un problema correlato agli errori del dispositivo o si distribuisce un aggiornamento.

Il nome hub IoT viene scelto dall'utente al primo provisioning.

Nome dell'account di Aggiornamento dispositivi

Potrebbe essere richiesto di specificare il nome dell'account di Aggiornamento dispositivi quando si segnala un problema correlato all'importazione di un aggiornamento, a errori del dispositivo o alla distribuzione di un aggiornamento.

Il nome dell'account di Aggiornamento dispositivi viene scelto dall'utente al momento della prima iscrizione al servizio. Altre informazioni sono disponibili nella documentazione relativa alle risorse di Aggiornamento dispositivi .

Nome dell'istanza di Aggiornamento dispositivi

Potrebbe essere richiesto di specificare il nome dell'istanza di Aggiornamento dispositivi quando si segnala un problema correlato all'importazione di un aggiornamento, agli errori del dispositivo o alla distribuzione di un aggiornamento.

Il nome dell'istanza di Aggiornamento dispositivi viene scelto dall'utente al primo provisioning. Altre informazioni sono disponibili nella documentazione relativa alle risorse di Aggiornamento dispositivi .

ID dispositivo

Potrebbe essere richiesto di specificare un ID dispositivo quando si segnala un problema relativo agli errori del dispositivo o si distribuisce un aggiornamento.

L'ID dispositivo viene definito dal cliente al primo provisioning del dispositivo. Può anche essere recuperato dal dispositivo gemello del dispositivo.

ID aggiornamento

Potrebbe essere richiesto di specificare un ID aggiornamento quando si segnala un problema correlato alla distribuzione di un aggiornamento.

L'ID aggiornamento viene definito dal cliente all'avvio di una distribuzione.

Log Nginx

È possibile che venga chiesto di specificare i log Nginx quando si segnala un problema correlato a Microsoft Connected Cache.

ADU-conf.txt

È possibile che venga richiesto di specificare il file di configurazione di Aggiornamento dispositivi ("adu-conf.txt") durante la segnalazione di un problema correlato alla distribuzione di un aggiornamento.

Il file di configurazione è facoltativo e creato dall'utente seguendo le istruzioni nella documentazione sulla configurazione di Aggiornamento dispositivi.

Importa manifesto

È possibile che venga richiesto di specificare il file manifesto di importazione quando si segnala un problema correlato all'importazione o alla distribuzione di un aggiornamento.

Il manifesto di importazione è un file creato dal cliente durante l'importazione del contenuto dell'aggiornamento nel servizio Aggiornamento dispositivi.

Passaggi successivi

Altre informazioni sui codici di errore di Aggiornamento dispositivi

Condividi tramite