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

  • Articolo

Questo documento elenca alcune domande comuni e i problemi segnalati dagli utenti di Aggiornamento dispositivi. Man mano che l'aggiornamento dei dispositivi passa 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 Contatto supporto tecnico Microsoft per documentare la situazione.

Importazione degli aggiornamenti

D: Si verificano problemi durante la connessione dell'istanza di Aggiornamento dispositivi 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 le autorizzazioni di accesso non siano configurate correttamente. Assicurarsi di aver configurato correttamente le autorizzazioni di accesso in base alla documentazione relativa al controllo di accesso di Aggiornamento dispositivi .

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 supporto tecnico Microsoft per inviare una richiesta di supporto con Microsoft.

D: Voglio 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. Ma viene visualizzato un errore "Failed: error importing update due to exceeded limit" when I do so.

Lo stesso set esatto di proprietà di compatibilità non può essere usato con più combinazioni 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 del proxy offre tale funzionalità.

D: Viene visualizzato un messaggio di errore durante l'importazione del contenuto e si vuole saperne di più.

Per informazioni più dettagliate sui messaggi di errore relativi 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 a Aggiornamento dispositivi per 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à di portale di Azure.

D: Uno o più dispositivi non riescono ad eseguire l'aggiornamento.

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 dispositivi e 3) il servizio Ottimizzazione recapito (DO) sia in esecuzione. Se tutte e tre sono vere per il dispositivo, seguire le istruzioni nella sezione Contattare supporto tecnico Microsoft per inviare una richiesta di supporto con Microsoft.

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?

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

D: Lo stato della distribuzione del dispositivo indica che cosa devo fare?

È possibile che le proprietà del produttore e del modello di un dispositivo di destinazione siano state modificate dopo la connessione del dispositivo a hub IoT, causando l'incompatibilità del dispositivo con il contenuto di aggiornamento della distribuzione corrente.

Controllare l'interfaccia di base ADU per verificare il produttore e il modello che il dispositivo sta segnalando al servizio Aggiornamento dispositivi e verificare 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 di Aggiornamento dispositivi.

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, per impostazione predefinita la data di inizio della distribuzione viene impostata 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 nel hub IoT in base alla documentazione relativa alle risorse di Aggiornamento dispositivi. Sarà necessario contrassegnare di nuovo il dispositivo dopo aver configurato la route.

Un'altra causa radice potrebbe essere che è stato applicato il tag prima di connettere il dispositivo a Aggiornamento dispositivi per hub IoT. Assicurarsi che il dispositivo sia già connesso a Aggiornamento dispositivi. È possibile verificare che il dispositivo sia connesso a Aggiornamento dispositivi per hub IoT controllando se viene visualizzato in dispositivi "Non raggruppati" nella visualizzazione conformità. Aggiungere temporaneamente un tag di un valore diverso e quindi aggiungere di nuovo il tag desiderato 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 desiderato.

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

Ciò potrebbe essere stato causato da un errore lato client nei dispositivi non riusciti. Vedere la sezione Errori dei dispositivi 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 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. Ripetere la distribuzione dopo 10 minuti. Se si verifica lo stesso problema, eseguire il pull dei log del dispositivo e fare riferimento alla sezione Errori dei dispositivi di questa guida alla risoluzione dei problemi. Se lo stesso problema persiste, seguire le istruzioni nella sezione Contattare supporto tecnico Microsoft per inviare una richiesta di supporto con Microsoft.

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

_This potrebbe essere stato causato se non è stato rimosso l'agente precedente che comunicava tramite il dispositivo gemello. Quando si effettua il provisioning dell'agente di Aggiornamento dispositivi come modulo (vedere come) tutte le comunicazioni tra il dispositivo e il servizio Aggiornamento dispositivi avviene tramite il modulo gemello, ricordarsi di contrassegnare il modulo gemello del dispositivo quando si creano gruppi e tutte le comunicazioni devono essere eseguite sul modulo gemello.

Download degli aggiornamenti nei dispositivi

D: Ricerca per categorie riprendere un download quando un dispositivo si riconnette 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.

Fare riferimento alla documentazione IoT Edge per la distribuzione di moduli Edge in 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 l'errore di connessione di un dispositivo IoT a MCC. Per diagnosticare il problema, raccogliere i log del client DO e Nginx dal dispositivo che ha esito negativo (vedere la sezione Contacting 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 in tal caso, è necessario controllare le variabili di ambiente IoT Edge in 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 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 getDevices per verificare la presenza di informazioni aggiuntive nella risposta al 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 (Azure Percept, 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.

Passaggio successivo: Altre informazioni sui codici di errore di Aggiornamento dispositivi