Avviso di fine del supporto: il 7 ottobre 2026, AWS il supporto per. AWS IoT Greengrass Version 1 Dopo il 7 ottobre 2026, non potrai più accedere alle risorse. AWS IoT Greengrass V1 Per ulteriori informazioni, visita [Migrate](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html) from. AWS IoT Greengrass Version 1
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# IDT per la risoluzione dei problemi AWS IoT Greengrass
IDT for AWS IoT Greengrass scrive questi errori in varie posizioni in base al tipo di errore. Gli errori vengono scritti nella console, nei file di log e nei report di test.
## Codici di errore
Nella tabella seguente vengono elencati i codici di errore generati da IDT per AWS IoT Greengrass.
| Codice di errore | Nome del codice di errore | Possibile causa principale | Risoluzione dei problemi |
| --- | --- | --- | --- |
| 101 | InternalError | Si è verificato un errore interno. | Controlla i log nella directory `/results`. Se non riesci a eseguire il debug del problema, contatta [AWS Developer Support](https://aws.amazon.com/premiumsupport/plans/developers/). |
| 102 | TimeoutError | Il test non può essere completato in un intervallo di tempo limitato. Questo può accadere se: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v1/developerguide/idt-troubleshooting.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v1/developerguide/idt-troubleshooting.html) |
| 103 | PlatformNotSupportError | OS/architecture Combinazione errata specificata in`device.json`. | Modificare la configurazione in una delle combinazioni supportate: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v1/developerguide/idt-troubleshooting.html) Per ulteriori informazioni, consulta [Configura dispositivo.json](set-config.md#device-config). |
| 104 | VersionNotSupportError | La versione del software AWS IoT Greengrass Core non è supportata dalla versione di IDT in uso. | Usa il **device\$1tester\$1bin version** comando per trovare la versione supportata del software AWS IoT Greengrass Core. Ad esempio, se si sta utilizzando macOS, usa **./devicetester\$1mac\$1x86\$164 version**. Per trovare la versione del software AWS IoT Greengrass Core che stai utilizzando: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v1/developerguide/idt-troubleshooting.html) È possibile testare una versione diversa del software AWS IoT Greengrass Core. Per ulteriori informazioni, consulta [Guida introduttiva con AWS IoT Greengrass](gg-gs.md). |
| 105 | LanguageNotSupportError | IDT supporta Python solo AWS IoT Greengrass per le librerie SDKs . | Assicurarsi che: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v1/developerguide/idt-troubleshooting.html) |
| 106 | ValidationError | Alcuni campi in `device.json` o `config.json` non sono validi. | Controllare il messaggio di errore a destra del codice di errore nel report. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v1/developerguide/idt-troubleshooting.html) |
| 107 | SSHConnectionFallito | Il computer di test non si connette al dispositivo configurato. | Verificare che i seguenti campi nel file `device.json` siano corretti: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v1/developerguide/idt-troubleshooting.html) Per ulteriori informazioni, consulta [Configura dispositivo.json](set-config.md#device-config). |
| 108 | RunCommandError | Un test non è riuscito a eseguire un comando sul dispositivo sottoposto a test. | Verificare che l'accesso root sia consentito per l'utente configurato in `device.json`. Alcuni dispositivi richiedono una password durante l'esecuzione di comandi con accesso alla radice. Assicurarsi che l'accesso root sia consentito senza una password. Per ulteriori informazioni, consultare la documentazione relativa al dispositivo. Provare a eseguire manualmente sul dispositivo il comando che non viene eseguito per controllare se si verifica un errore. |
| 109 | PermissionDeniedError | Nessun accesso root. | Impostare l'accesso root per l'utente configurato sul dispositivo. |
| 110 | CreateFileError | Impossibile creare un file. | Controllare lo spazio su disco del dispositivo e le autorizzazioni di directory. |
| 111 | CreateDirError | Impossibile creare una directory. | Controllare lo spazio su disco del dispositivo e le autorizzazioni di directory. |
| 112 | InvalidPathError | Il percorso verso il software AWS IoT Greengrass Core non è corretto. | Verificare che il percorso nel messaggio di errore sia valido. Non modificare i file nella directory `devicetester_greengrass_`. |
| 113 | InvalidFileError | Un file non è valido. | Verificare che il file nel messaggio di errore sia valido. |
| 114 | ReadFileError | Impossibile leggere il file specificato. | Verificare quanto segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v1/developerguide/idt-troubleshooting.html) Se il test viene eseguito su un macOS, aumentare il limite di file aperti. Il limite predefinito è di 256, sufficiente per eseguire il test. |
| 115 | FileNotFoundError | Un file obbligatorio non è stato trovato. | Verificare quanto segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v1/developerguide/idt-troubleshooting.html) |
| 116 | OpenFileFailed | Impossibile aprire il file specificato. | Verificare quanto segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v1/developerguide/idt-troubleshooting.html) Se il test viene eseguito su un macOS, aumentare il limite di file aperti. Il limite predefinito è di 256, sufficiente per eseguire il test. |
| 117 | WriteFileFailed | Impossibile scrivere nel file (può essere il computer in fase di test o il computer di test). | Verificate che la directory specificata nel messaggio di errore esista e che disponiate del permesso di scrittura. |
| 118 | FileCleanUpError | Un test non è stato in grado di rimuovere la directory o il file specificato oppure di eseguire l'umount del file specificato sul dispositivo remoto. | Se il file binario è ancora in esecuzione, potrebbe essere bloccato. Terminare il processo ed eliminare il file specificato. |
| 119 | InvalidInputError | Configurazione non valida. | Verificare che il file `suite.json` sia valido. |
| 120 | InvalidCredentialError | AWS Credenziali non valide. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v1/developerguide/idt-troubleshooting.html) |
| 121 | AWSSessionErrore | Impossibile creare una AWS sessione. | Questo errore può verificarsi se AWS le credenziali non sono valide o la connessione Internet è instabile. Prova a utilizzare AWS CLI per chiamare un' AWS operazione API. |
| 122 | AWSApiCallError | Si è verificato un errore AWS API. | Questo errore potrebbe essere causato da un problema di rete. Verificare la rete prima di riprovare il gruppo di test. |
| 123 | IpNotExistError | L'indirizzo IP non è incluso nelle informazioni di connettività. | Verificare la connessione Internet. È possibile utilizzare la AWS IoT Greengrass console per verificare le informazioni di connettività relative all'elemento AWS IoT Greengrass principale utilizzato dal test. Se le informazioni di connettività includono 10 endpoint è possibile rimuoverne alcuni o tutti e rieseguire il test. Per ulteriori informazioni, consulta [Informazioni di connettività](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-connectivity-info.html). |
| 124 | OTAJobNotCompleteError | Un processo OTA non è terminato. | Verificare la connessione Internet e riprovare a eseguire il gruppo di test OTA. |
| 125 | CreateGreengrassServiceRoleError | Si è verificato uno degli eventi seguenti: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v1/developerguide/idt-troubleshooting.html) | Configurare il ruolo AWS IoT Greengrass di servizio. Per ulteriori informazioni, consulta [Ruolo del servizio Greengrass](service-role.md). |
| 126 | DependenciesNotPresentError | Una o più dipendenze necessarie per i test specifici non sono presenti sul dispositivo. | Controllare il log di test per vedere quali sono le dipendenze mancanti nel dispositivo: `/results//logs/`. |
| 127 | Non valido HSMConfiguration | La HSM/PKCS configurazione fornita non è corretta. | Nel file `device.json`, fornire la configurazione necessaria per interagire con HSM utilizzando PKCS\$111. |
| 128 | OTAJobNotSuccededError | Il processo OTA non è andato a buon fine. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v1/developerguide/idt-troubleshooting.html) |
| 129 | NoConnectivityError | L'agente host non riesce a connettersi a Internet. | Controlla la connessione di rete e le impostazioni firewall. Riprovare il gruppo di test dopo che il problema di connettività è stato risolto. |
| 130 | NoPermissionError | L'utente IAM per cui stai utilizzando IDT AWS IoT Greengrass non è autorizzato a creare le AWS risorse necessarie per eseguire IDT. | Consulta l'argomento relativo al [modello della policy di autorizzazione](https://docs.aws.amazon.com/greengrass/latest/developerguide/policy-template.html) per il modello di policy che concede le autorizzazioni richieste per eseguire IDT per AWS IoT Greengrass. |
| 131 | LeftoverAgentExistError | Il tuo dispositivo sta eseguendo AWS IoT Greengrass dei processi quando tenti di avviare IDT for. AWS IoT Greengrass | Assicurati che non sia presente alcun daemon Greengrass esistente in esecuzione sul dispositivo. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v1/developerguide/idt-troubleshooting.html) Se si utilizza un'installazione esistente di AWS IoT Greengrass configurata per l'avvio automatico dopo il riavvio, è necessario arrestare il demone dopo il riavvio e prima di eseguire la suite di test. |
| 132 | DeviceTimeOffsetError | L’ora del dispositivo non è corretta. | Imposta il dispositivo sull'ora corretta. |
| 133 | Non valido MLConfiguration | La configurazione ML fornita non è corretta. | Nel file `device.json`, fornisci la configurazione corretta necessaria per eseguire i test di inferenza di ML. Per ulteriori informazioni, consulta [Facoltativo: configurazione del dispositivo per la qualificazione di ML](idt-ml-qualification.md). |
## Risoluzione di IDT per errori AWS IoT Greengrass
Quando si utilizza IDT, è necessario disporre dei file di configurazione corretti prima di eseguire IDT for. AWS IoT Greengrass Se ottieni errori di parsing e di configurazione, per prima cosa dovresti individuare e utilizzare un modello di configurazione appropriato per il tuo ambiente.
Se continui a riscontare problemi, consulta la seguente procedura di debug.
**Topics**
+ [Dove posso cercare gli errori?](#where-to-look)
+ [Errori di parsing](#parse-error)
+ [Errore di parametro richiesto mancante](#param-missing)
+ [Errore di avvio del test non riuscito](#could-not-start-test)
+ [Errore di accesso non autorizzato alla risorsa](#not-authorized-to-access-resource)
+ [Errori di autorizzazione negata](#pwd-sudo)
+ [Errori di connessione SSH](#ssh-connect-errors)
+ [Errori di timeout](#test-timeout)
+ [Errori di comando non trovato durante l'esecuzione del test](#cmd-not-found)
+ [Eccezione di sicurezza su macOS](#macos-notarization-exception)
### Dove posso cercare gli errori?
Gli errori di alto livello vengono visualizzati sulla console durante l'esecuzione e un riepilogo dei test non riusciti con l'errore viene visualizzato quando tutti i test sono stati completati. `awsiotdevicetester_report.xml` contiene un riepilogo di tutti gli errori che hanno causato un test non riuscito. I file di log per ogni sessione di test vengono archiviati in una directory denominata con un UUID per l'esecuzione del test che è stato visualizzato nella console durante la sessione di test.
La directory dei log di test si trova in `/results//logs/`. Questa directory contiene i file seguenti, che sono utili per il debug.
| File | Description |
| --- | --- |
| test\$1manager.log | Tutti i log che sono stati scritti nella console durante l'esecuzione del test. Un riepilogo dei risultati si trova al termine di questo file che include un elenco dei test non riusciti. I log di avviso e di errore in questo file possono fornire informazioni sull'errore. |
| \$1\$1.log | Log dettagliati per il test specifico. |
| \$1ggc\$1logs.tar.gz | Una raccolta compressa di tutti i log generati dal demone AWS IoT Greengrass principale durante il test. Per ulteriori informazioni, consulta [Risoluzione dei problemi AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-troubleshooting.html). |
| \$1ota\$1logs.tar.gz | Una raccolta compressa di log generati dall'agente OTA durante il AWS IoT Greengrass test. Solo per i test OTA. |
| \$1basic\$1assertion\$1publisher\$1ggad\$1logs.tar.gz | Una raccolta compressa di log generati dal dispositivo editore AWS IoT durante il test. |
| \$1basic\$1assertion\$1subscriber\$1ggad\$1logs.tar.gz | Una raccolta compressa di log generati dal dispositivo sottoscrittore AWS IoT durante il test. |
### Errori di parsing
Talvolta un refuso in una configurazione JSON può causare errori di parsing. Nella maggior parte dei casi, il problema è dovuto all'omissione di parentesi, virgole o virgolette nel file JSON. IDT esegue una convalida JSON e visualizza le informazioni di debug. Inoltre indica la riga in cui si è verificato l'errore, il numero di riga e il numero di colonna dell'errore di sintassi. Queste informazioni dovrebbero essere sufficienti per aiutarti a correggere l'errore, ma se ancora non riesci a individuare l'errore, puoi eseguire la convalida manualmente nel tuo IDE, in un editor di testo come Atom o Sublime o tramite uno strumento online come. JSONLint
### Errore di parametro richiesto mancante
Poiché si stanno aggiungendo nuove caratteristiche a IDT, potrebbero essere introdotte modifiche ai file di configurazione. L'utilizzo di un file di configurazione precedente potrebbe invalidare la tua configurazione. Se dovesse succedere, il file `.log` in `/results//logs` elenca in modo esplicito tutti i parametri mancanti. IDT convalida inoltre gli schemi dei tuoi file di configurazione JSON per assicurare che sia stata utilizzata la versione supportata più recente.
### Errore di avvio del test non riuscito
È possibile che si verifichino errori relativi a problemi in fase di avvio del test. Le cause sono diverse, quindi esegui le operazioni descritte di seguito:
+ Assicurati che il nome del pool incluso nel comando di esecuzione esista effettivamente. Al nome del pool si fa riferimento direttamente nel file `device.json`.
+ Verifica che i parametri di configurazione dei dispositivi nel pool siano corretti.
### Errore di accesso non autorizzato alla risorsa
È possibile che venga visualizzato il messaggio di errore ` is not authorized to access this resource` nell'output del terminale o nel file `test_manager.log` sotto `/results//logs`. Per risolvere questo problema, associare la policy `AWSIoTDeviceTesterForGreengrassFullAccess` gestita all'utente del test. Per ulteriori informazioni, consulta [Crea e configura un Account AWS](dev-tst-prereqs.md#config-aws-account-for-idt).
### Errori di autorizzazione negata
IDT esegue operazioni su varie directory e file in un dispositivo sottoposto a test. Alcune di queste operazioni richiedono l'accesso root. Per automatizzare queste operazioni, IDT deve essere in grado di eseguire comandi con il comando sudo senza la digitazione di una password.
Segui questi passaggi per consentire l'accesso al comando sudo senza la digitazione di una password.
**Nota**
`user` e `username` si riferiscono all'utente SSH utilizzato da IDT per accedere al dispositivo sottoposto a test.
1. Utilizza **sudo usermod -aG sudo **** per aggiungere l'utente SSH al gruppo sudo
1. Per rendere effettive le modifiche, esci ed esegui di nuovo l'accesso.
1. Apri il file `/etc/sudoers` e aggiungi la riga seguente alla fine del file: ` ALL=(ALL) NOPASSWD: ALL`
**Nota**
Come best practice, ti consigliamo di utilizzare **sudo visudo** quando modifichi `/etc/sudoers`.
### Errori di connessione SSH
Quando UDT non è in grado di connettersi a un dispositivo sottoposto a test, gli errori di connessione vengono registrati in `/results//logs/.log`. I messaggi di errore SSH vengono visualizzati all'inizio di questo file di log perché la connessione a un dispositivo sottoposto a test è una delle prime operazioni eseguite da IDT.
La maggior parte delle configurazioni di Windows utilizza l'applicazione TTy terminale Pu per connettersi agli host Linux. Questa applicazione richiede che i file della chiave privata PEM standard siano convertiti in un formato Windows proprietario denominato PPK. Quando IDT è configurato nel `device.json`, utilizza solo i file PEM. Se si utilizza un file PPK, IDT non può creare una connessione SSH con il AWS IoT Greengrass dispositivo e non può eseguire test.
### Errori di timeout
Puoi aumentare il timeout per ogni test specificando un moltiplicatore di timeout, che viene applicato al valore predefinito di ogni timeout del test. Qualsiasi valore configurato per questo flag deve essere maggiore o uguale a 1.0.
Per usare il moltiplicatore di timeout, utilizza il flag `--timeout-multiplier` durante l'esecuzione dei test. Esempio:
```
./devicetester_linux run-suite --suite-id GGQ_1.0.0 --pool-id DevicePool1 --timeout-multiplier 2.5
```
Per ulteriori informazioni, esegui `run-suite --help`.
### Errori di comando non trovato durante l'esecuzione del test
È necessaria una versione precedente della libreria OpenSSL (libssl1.0.0) per eseguire i test sui dispositivi. AWS IoT Greengrass La maggior parte delle distribuzioni Linux correnti utilizza libssl versione 1.0.2 o versioni successive (v1.1.0).
Ad esempio, su un Raspberry Pi, esegui i seguenti comandi per installare la versione richiesta di libssl:
1.
```
wget http://ftp.us.debian.org/debian/pool/main/o/openssl/libssl1.0.0_1.0.2l-1~bpo8+1_armhf.deb
```
1.
```
sudo dpkg -i libssl1.0.0_1.0.2l-1~bpo8+1_armhf.deb
```
### Eccezione di sicurezza su macOS
Quando si esegue IDT su un computer host che utilizza macOS 10.15, il ticket di autenticazione notarile per IDT non viene rilevato correttamente e l'esecuzione di IDT è bloccata. Per eseguire IDT, è necessario concedere un'eccezione di sicurezza all'eseguibile. `devicetester_mac_x86-64`
**Per concedere un'eccezione di sicurezza all'eseguibile IDT**
1. Avvia **Preferenze di Sistema** dal menu Apple.
1. Scegli **Sicurezza e privacy**, quindi nella scheda **Generale**, fai clic sull'icona del lucchetto per apportare modifiche alle impostazioni di sicurezza.
1. Cerca il messaggio `"devicetester_mac_x86-64" was blocked from use because it is not from an identified developer.` e scegli **Consenti comunque**.
1. Accetta l'avviso di sicurezza.
In caso di domande sulla politica di supporto IDT, contatta l'[AWS assistenza clienti](https://aws.amazon.com/contact-us/).