Guida alla risoluzione dei problemi di Aggiornamento dei dispositivi per l'hub IoT

Questo documento elenca alcune domande comuni e problemi segnalati dagli utenti di Aggiornamento dispositivi. Con l'avanzamento dell'aggiornamento dei dispositivi attraverso l'anteprima pubblica, questa guida alla risoluzione dei problemi verrà aggiornata periodicamente con nuove domande e soluzioni. Se si verifica un problema che non viene visualizzato in questa guida alla risoluzione dei problemi, fare riferimento alla sezione Contattare il supporto tecnico Microsoft per documentare la situazione.

Importazione di aggiornamenti

Q: Sto avendo problemi a connettere la mia istanza di Aggiornamento dispositivi alla mia istanza dell'hub IoT.

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

È possibile che le autorizzazioni di accesso non siano configurate correttamente. Assicurati di aver configurato correttamente le autorizzazioni di accesso secondo la documentazione sul controllo di accesso di Aggiornamento 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 nella sezione Contattare il supporto tecnico Microsoft per inviare una richiesta di supporto con Microsoft.

D: Si desidera mantenere le stesse proprietà di compatibilità (specificare come destinazione l'aggiornamento allo stesso tipo di dispositivo), ma modificare il provider o il nome nel manifesto di importazione. Viene visualizzato un errore "Failed: error importing update due to exceeded limit" (Errore: errore durante l'importazione dell'aggiornamento a causa del limite superato) quando lo si esegue.

Non è possibile usare lo stesso set esatto di proprietà di compatibilità con più di una combinazione di provider di aggiornamento e 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à di aggiornamento proxy di offre questa capacità.

D: Viene visualizzato un messaggio di errore durante l'importazione del contenuto e si vuole ottenere altre informazioni su di esso.

Per informazioni più dettagliate sui messaggi di errore correlati all'importazione, fare riferimento alla documentazione codici di errore di aggiornamento del dispositivo.

Errori del dispositivo

D: Come è possibile verificare che il dispositivo sia connesso all'aggiornamento dei dispositivi per l'hub IoT?

È possibile verificare che il dispositivo sia connesso a Device Update controllando se viene visualizzato nella sezione "Ungrouped" devices (Dispositivi non raggruppati) nella visualizzazione conformità del portale di Azure.

D: Uno o più dispositivi non vengono aggiornati.

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

Distribuzione di un aggiornamento

Q: Ho distribuito un aggiornamento ai miei dispositivi, ma lo stato di conformità indica che non è all'ultimo aggiornamento. Cosa dovrei fare?

L'aggiornamento dello stato di conformità del dispositivo può richiedere fino a 5 minuti. Attendere, quindi controllare di nuovo.

D: Lo stato di distribuzione del mio dispositivo risulta incompatibile, cosa dovrei fare?

Le proprietà del produttore e del modello di un dispositivo di destinazione potrebbero essere state modificate dopo la connessione del dispositivo all'hub IoT, causando l'incompatibilità del dispositivo con il contenuto di aggiornamento della distribuzione corrente.

Controlla l'interfaccia principale di ADU Core per verificare quale produttore e modello il tuo dispositivo segnala al servizio Aggiornamento dispositivi, e assicurati che corrisponda al produttore e al modello specificato nel manifesto di importazione del contenuto di aggiornamento che viene distribuito. È possibile modificare queste proprietà per un determinato dispositivo usando il file di configurazione Aggiornamento dispositivi.

D: Vedo che la mia distribuzione è nella fase "Attiva", ma nessuno dei miei device è "In corso d'aggiornamento". Cosa dovrei fare?

Assicurarsi che la data di inizio della distribuzione non sia impostata per il futuro. Quando si crea una nuova distribuzione, la data di inizio della distribuzione viene impostata per impostazione predefinita sul 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 nell'hub IoT in base alle risorse Aggiornamento dispositivi documentazione. Sarà necessario contrassegnare nuovamente il dispositivo dopo aver configurato la route.

Un'altra causa principale potrebbe essere che avete applicato il tag prima di connettere il dispositivo a Device Update for IoT Hub. Assicurarsi che il dispositivo sia già connesso a Device Update. È possibile verificare che il dispositivo sia connesso all'aggiornamento del dispositivo per l'hub IoT controllando se viene visualizzato in dispositivi "Non raggruppati" nella visualizzazione conformità. Aggiungere temporaneamente un tag di un valore diverso e quindi aggiungere nuovamente il tag desiderato dopo la connessione del 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 hai già contrassegnato il dispositivo durante il passaggio di creazione del dispositivo, dovrai contrassegnare temporaneamente il dispositivo con un valore diverso dopo il provisioning e quindi aggiungere di nuovo il tag desiderato.

D: La distribuzione è stata completata correttamente, ma alcuni dispositivi non sono stati aggiornati.

Ciò potrebbe essere stato causato da un errore sul 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.

Ciò potrebbe essere stato causato da un bug di servizio/esperienza utente o da un problema di autorizzazioni API. Seguire le istruzioni nella sezione Contattare il supporto tecnico Microsoft per inviare una richiesta di supporto con Microsoft.

D: Ho avviato una distribuzione, ma non raggiunge uno stato finale.

Ciò potrebbe essere stato causato da un problema di prestazioni del servizio, da un bug del servizio o da un bug del client. Si prega di ripetere la distribuzione dopo 10 minuti. Se si verifica lo stesso problema, recuperare i log del dispositivo e fare riferimento alla sezione Guasti del dispositivo di questa guida alla risoluzione dei problemi. Se lo stesso problema persiste, seguire le istruzioni nella sezione Contattare il supporto tecnico Microsoft per inviare una richiesta di supporto con Microsoft.

Domanda: Ho effettuato la migrazione da un agente a livello di dispositivo per aggiungere l'agente come identità di modulo sul 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 tramite il Device Twin. Quando si esegue il provisioning dell'agente di Aggiornamento dispositivi come modulo (vedere come), tutte le comunicazioni tra il dispositivo e il servizio Aggiornamento dispositivi avvengono tramite il modulo gemello, quindi ricordarsi di contrassegnare il modulo gemello del dispositivo quando si creano gruppi , e tutte le comunicazioni devono avvenire tramite il modulo gemello.

Download degli aggiornamenti nei dispositivi

D: Come 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 IoT Edge per la distribuzione di moduli Edge nei dispositivi IoT Edge. È possibile verificare se il modulo MCC è in esecuzione correttamente nel dispositivo IoT Edge passando a http://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 di un dispositivo IoT a MCC. Per diagnosticare il problema, raccogliere i log del client DO e Nginx dal dispositivo non riuscito (vedere la sezione Contattare il 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 in uso non è consentito. Per determinare in tal caso, è necessario controllare le variabili di ambiente IoT Edge nel portale di Azure.

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 il supporto tecnico Microsoft tramite l'interfaccia del 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 consentire al supporto tecnico Microsoft di analizzare il problema.

Vedere di seguito per istruzioni su come raccogliere ogni tipo di dati. È possibile usare getDevices 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:

Quale tipo di dispositivo si sta tentando di aggiornare (Azure Percept, IoT Edge Gateway, altro)
Che tipo di client di aggiornamento del dispositivo stai utilizzando (basato su immagine, 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 qui:
```
/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

Potrebbe essere richiesto di fornire 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 l'autodiagnosi e la risoluzione dei problemi, consultare la documentazione sui codici di errore di aggiornamento del dispositivo .

ID di traccia

Potrebbe essere 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 nella risposta dell'API o nella sezione Cronologia importazione dell'interfaccia utente del portale di Azure.

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

ID distribuzione

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

L'ID 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 del portale di Azure vengono generati automaticamente e non vengono visualizzati all'utente.

Nome dell'istanza dell'hub IoT

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

Il nome dell'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, agli errori dei dispositivi o alla distribuzione di un aggiornamento.

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

Nome dell'istanza di aggiornamento del dispositivo

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 momento del primo provisioning. Altre informazioni sono disponibili nella documentazione delle risorse Aggiornamento dispositivi .

ID del dispositivo

Potrebbe essere richiesto di specificare un ID dispositivo quando si segnala un problema correlato agli errori del dispositivo o alla distribuzione di un aggiornamento.

L'ID dispositivo viene definito dal cliente alla prima configurazione del dispositivo. Può anche essere recuperato dal Device Twin del dispositivo.

ID di 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 di Nginx

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

ADU-conf.txt

Potrebbe essere richiesto di specificare il file di configurazione di Aggiornamento dispositivi ("adu-conf.txt") quando si segnala un problema correlato alla distribuzione di un aggiornamento.

Il file di configurazione è facoltativo ed è creato dall'utente seguendo le istruzioni riportate nella documentazione di configurazione di Aggiornamento Dispositivi.

Manifesto di importazione

Potrebbe essere 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 di aggiornamento nel servizio Aggiornamento dispositivi.

Passaggio successivo: Scopri di più sui codici di errore dell'Aggiornamento del dispositivo

Last updated on 2021-02-17

Condividi tramite