Avis de fin de support : le 7 octobre 2026, AWS le support de. AWS IoT Greengrass Version 1 Après le 7 octobre 2026, vous ne pourrez plus accéder aux AWS IoT Greengrass V1 ressources. Pour plus d'informations, rendez-vous sur [Migrer depuis AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# IDT pour AWS IoT Greengrass résolution des problèmes
IDT for AWS IoT Greengrass écrit ces erreurs à différents emplacements en fonction du type d'erreur. Les erreurs sont écrites dans la console, les fichiers journaux et les rapports de tests.
## Codes d’erreur
Le tableau suivant répertorie les codes d'erreur générés par IDT pour AWS IoT Greengrass.
| Code d’erreur | Nom du code d'erreur | Cause racine possible | Résolution des problèmes |
| --- | --- | --- | --- |
| 101 | InternalError | Une erreur interne s’est produite. | Vérifiez les journaux du répertoire `{{}}/results`. Si vous ne parvenez pas à résoudre le problème, contactez le [Support aux AWS développeurs](https://aws.amazon.com/premiumsupport/plans/developers/). |
| 102 | TimeoutError | Le test ne peut pas être réalisé dans une plage de temps limitée. Ceci peut se produire si :[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/greengrass/v1/developerguide/idt-troubleshooting.html) | [See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/greengrass/v1/developerguide/idt-troubleshooting.html) |
| 103 | PlatformNotSupportError | OS/architecture Combinaison incorrecte spécifiée dans`device.json`. | Remplacez votre configuration par l'une des combinaisons prises en charge :[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/greengrass/v1/developerguide/idt-troubleshooting.html)
Pour de plus amples informations, veuillez consulter [Configurer device.json](set-config.md#device-config). |
| 104 | VersionNotSupportError | La version du logiciel AWS IoT Greengrass Core n'est pas prise en charge par la version d'IDT que vous utilisez. | Utilisez la **device\_tester\_bin version** commande pour trouver la version prise en charge du logiciel AWS IoT Greengrass Core. Par exemple, si vous utilisez macOS, utilisez : **./devicetester\_mac\_x86\_64 version**.
Pour trouver la version du logiciel AWS IoT Greengrass Core que vous utilisez, procédez comme suit :[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/greengrass/v1/developerguide/idt-troubleshooting.html)
Vous pouvez tester une autre version du logiciel AWS IoT Greengrass Core. Pour de plus amples informations, veuillez consulter [Démarrage avec AWS IoT Greengrass](gg-gs.md). |
| 105 | LanguageNotSupportError | IDT prend en charge Python pour les AWS IoT Greengrass bibliothèques et les SDK uniquement. | Vérifiez les éléments suivants :[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/greengrass/v1/developerguide/idt-troubleshooting.html) |
| 106 | ValidationError | Certains champs de `device.json` ou de `config.json` sont non valides. | Vérifiez le message d'erreur situé à droite du code d'erreur dans le rapport. [See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/greengrass/v1/developerguide/idt-troubleshooting.html) |
| 107 | SSHConnectionFailed | La machine de test ne peut pas se connecter à l'appareil configuré. | Vérifiez que les champs suivants sont corrects dans votre fichier `device.json` :[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/greengrass/v1/developerguide/idt-troubleshooting.html)
Pour de plus amples informations, veuillez consulter [Configurer device.json](set-config.md#device-config). |
| 108 | RunCommandError | Un test n'a pas réussi à exécuter une commande sur l'appareil testé. | Vérifiez que l'accès racine est autorisé pour l'utilisateur configuré dans `device.json`.
Un mot de passe est requis par certains appareils lors de l'exécution de commandes avec accès racine. Assurez-vous que l'accès racine est autorisé sans mot de passe. Pour de plus amples informations, veuillez consulter la documentation relative à votre appareil.
Essayez d'exécuter manuellement la commande qui a échoué sur votre appareil pour vérifier si une erreur se produit. |
| 109 | PermissionDeniedError | Aucun accès racine. | Définissez l'accès racine pour l'utilisateur configuré sur votre appareil. |
| 110 | CreateFileError | Impossible de créer un fichier. | Vérifiez l'espace disque de votre appareil et les autorisations sur les répertoires. |
| 111 | CreateDirError | Impossible de créer un répertoire. | Vérifiez l'espace disque de votre appareil et les autorisations sur les répertoires. |
| 112 | InvalidPathError | Le chemin d'accès au logiciel AWS IoT Greengrass Core est incorrect. | Vérifiez que le chemin indiqué dans le message d'erreur est valide. Ne modifiez aucun fichier sous le répertoire `devicetester_greengrass_{{}}`. |
| 113 | InvalidFileError | Un fichier n'est pas valide. | Vérifiez que le fichier indiqué dans le message d'erreur est valide. |
| 114 | ReadFileError | Le fichier spécifié ne peut pas être lu. | Vérifiez les paramètres suivants :[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/greengrass/v1/developerguide/idt-troubleshooting.html)
Si vous procédez aux tests sur Mac OS, augmentez le nombre limite de fichiers ouverts. La limite par défaut est 256, ce qui est suffisant pour les tests. |
| 115 | FileNotFoundError | Un fichier requis est introuvable. | Vérifiez les paramètres suivants :[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/greengrass/v1/developerguide/idt-troubleshooting.html) |
| 116 | OpenFileFailed | Impossible d'ouvrir le fichier spécifié. | Vérifiez les paramètres suivants :[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/greengrass/v1/developerguide/idt-troubleshooting.html)
Si vous procédez aux tests sur Mac OS, augmentez le nombre limite de fichiers ouverts. La limite par défaut est 256, ce qui est suffisant pour les tests. |
| 117 | WriteFileFailed | Échec de l'écriture du fichier (peut être l'appareil testé ou la machine de test). | Vérifiez que le répertoire indiqué dans le message d'erreur existe et que vous disposez d'une autorisation d'écriture. |
| 118 | FileCleanUpError | Pendant le test, le fichier ou le répertoire spécifié n'a pas pu être supprimé, ou le fichier spécifié n'a pas pu être démonté de l'appareil distant. | Si le fichier binaire est toujours en cours d'exécution, il est possible que le fichier soit verrouillé. Terminez le processus et supprimez le fichier spécifié. |
| 119 | InvalidInputError | Configuration non valide. | Vérifiez que votre fichier `suite.json` est valide. |
| 120 | InvalidCredentialError | AWS Informations d'identification non valides. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/greengrass/v1/developerguide/idt-troubleshooting.html) |
| 121 | AWSSessionError | Impossible de créer une AWS session. | Cette erreur peut se produire si les AWS informations d'identification ne sont pas valides ou si la connexion Internet est instable. Essayez d'utiliser le AWS CLI pour appeler une opération d' AWS API. |
| 122 | AWSApiCallError | Une erreur d' AWS API s'est produite. | Cette erreur peut être due à un problème de réseau. Vérifiez votre réseau avant de relancer le groupe de tests. |
| 123 | IpNotExistError | L'adresse IP ne figure pas dans les informations de connectivité. | Vérifiez votre connexion Internet. Vous pouvez utiliser la AWS IoT Greengrass console pour vérifier les informations de connectivité relatives à l'élément AWS IoT Greengrass principal utilisé par le test. Si 10 points de terminaison figurent dans les informations de connectivité, vous pouvez en supprimer certains ou tous les supprimer, puis relancer le test. Pour de plus amples informations, veuillez consulter [Informations de connectivité](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-connectivity-info.html). |
| 124 | OTAJobNotCompleteError | Une tâche OTA ne s'est pas terminée. | Vérifiez votre connexion réseau et réexécutez le groupe de tests OTA. |
| 125 | CreateGreengrassServiceRoleError | L'une des erreurs suivantes s'est produite :[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/greengrass/v1/developerguide/idt-troubleshooting.html) | Configurez le rôle AWS IoT Greengrass de service. Pour de plus amples informations, veuillez consulter [Rôle de service Greengrass](service-role.md). |
| 126 | DependenciesNotPresentError | Une ou plusieurs dépendances requises pour le test spécifique ne sont pas présentes sur l'appareil. | Consultez le journal de test pour voir quelles dépendances manquent sur votre appareil : `{{}}/results/{{}}/logs/{{}}`. |
| 127 | InvalidHSMConfiguration | La HSM/PKCS configuration fournie est incorrecte. | Dans votre fichier `device.json`, fournissez la configuration requise pour interagir avec HSM en utilisant PKCS\#11. |
| 128 | OTAJobNotSuccededError | La tâche OTA n'a pas abouti. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/greengrass/v1/developerguide/idt-troubleshooting.html) |
| 129 | NoConnectivityError | L'agent hôte ne parvient pas à se connecter à Internet. | Vérifiez vos paramètres de connexion réseau et de pare-feu. Réessayez le groupe de test une fois le problème de connectivité résolu. |
| 130 | NoPermissionError | L'utilisateur IAM pour lequel vous exécutez IDT n'est AWS IoT Greengrass pas autorisé à créer les AWS ressources requises pour exécuter IDT. | Veuillez consulter [Modèle de stratégie d'autorisations](https://docs.aws.amazon.com/greengrass/latest/developerguide/policy-template.html) pour connaître le modèle de stratégie qui accorde les autorisations requises pour exécuter IDT pour AWS IoT Greengrass. |
| 131 | LeftoverAgentExistError | Votre appareil exécute AWS IoT Greengrass des processus lorsque vous essayez de démarrer IDT pour AWS IoT Greengrass. | Assurez-vous qu'aucun démon Greengrass n'est en cours d'exécution sur votre appareil.[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/greengrass/v1/developerguide/idt-troubleshooting.html) Si vous utilisez une installation existante AWS IoT Greengrass configurée pour démarrer automatiquement après le redémarrage, vous devez arrêter le démon après le redémarrage et avant d'exécuter la suite de tests. |
| 132 | DeviceTimeOffsetError | L'heure de l'appareil est incorrecte. | Réglez votre appareil sur l'heure correcte. |
| 133 | InvalidMLConfiguration | La configuration ML fournie est incorrecte. | Dans votre fichier `device.json`, indiquez la configuration requise pour exécuter les tests d'inférence ML. Pour de plus amples informations, veuillez consulter [Facultatif : Configuration de votre appareil pour la qualification ML](idt-ml-qualification.md). |
## Résolution de l'IDT pour AWS IoT Greengrass errors
Lorsque vous utilisez IDT, vous devez mettre en place les fichiers de configuration appropriés avant d'exécuter IDT pour. AWS IoT Greengrass Si vous obtenez des erreurs d'analyse et de configuration, la première étape consiste à localiser et à utiliser un modèle de configuration approprié pour votre environnement.
Si le problème persiste, consultez les processus de débogage suivants.
**Topics**
+ [Où puis-je rechercher les erreurs ?](#where-to-look)
+ [Erreurs d'analyse](#parse-error)
+ [Erreur liée à un paramètre obligatoire manquant](#param-missing)
+ [Erreur indiquant l'impossibilité de démarrer le test](#could-not-start-test)
+ [Erreur d'absence d'autorisation d’accès à la ressource](#not-authorized-to-access-resource)
+ [Erreurs de type « Autorisation refusée »](#pwd-sudo)
+ [Erreurs de connexion SSH](#ssh-connect-errors)
+ [Erreurs de délai d'attente](#test-timeout)
+ [Erreurs liées à des commandes introuvables lors des tests](#cmd-not-found)
+ [Exception de sécurité sur macOS](#macos-notarization-exception)
### Où puis-je rechercher les erreurs ?
High-level les erreurs sont affichées sur la console pendant l'exécution, et un résumé des tests ayant échoué avec l'erreur s'affiche lorsque tous les tests sont terminés. `awsiotdevicetester_report.xml`contient un résumé de toutes les erreurs à l'origine de l'échec d'un test. Les fichiers journaux pour chaque série de tests sont stockés dans un répertoire dont le nom comporte un UUID relatif à l'exécution du test, affiché sur la console pendant la série de tests.
Le répertoire des journaux de test est situé dans `{{}}/results/{{}}/logs/`. Ce répertoire contient les fichiers suivants, qui sont utiles pour le débogage.
| Fichier | Description |
| --- | --- |
| test\_manager.log | Contient tous les journaux qui ont été écrits dans la console lors de l'exécution du test. Un récapitulatif des résultats est situé à la fin de ce fichier, et comprend une liste des tests qui ont échoué.
Les journaux des erreurs et des avertissements de ce fichier peuvent vous donner des informations sur les défaillances. |
| {{}}\_\_{{}}.log | Journaux détaillés pour le test spécifique. |
| {{}}\_ggc\_logs.tar.gz | Une collection compressée de tous les journaux générés par le démon AWS IoT Greengrass principal pendant le test. Pour plus d'informations, consultez [Dépannage AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-troubleshooting.html). |
| {{}}\_ota\_logs.tar.gz | Collection compressée de journaux générés par l'agent AWS IoT Greengrass OTA pendant le test. Pour les tests OTA uniquement. |
| {{}}\_basic\_assertion\_publisher\_ggad\_logs.tar.gz | Collection compressée de journaux générés par l'appareil de l'éditeur AWS IoT pendant le test. |
| {{}}\_basic\_assertion\_subscriber\_ggad\_logs.tar.gz | Ensemble compressé de journaux générés par l'appareil de l'abonné AWS IoT pendant le test. |
### Erreurs d'analyse
Parfois, une faute de frappe dans une configuration JSON peut entraîner des erreurs d'analyse. La plupart du temps, le problème est lié à l'absence d'une virgule, d'une apostrophe ou d'un crochet dans le fichier JSON. IDT effectue la validation JSON et imprime les informations de débogage. Il imprime la ligne dans laquelle l'erreur s'est produite, le numéro de ligne et le numéro de colonne de l'erreur de syntaxe. Ces informations devraient suffire pour vous aider à résoudre l'erreur, mais si vous ne parvenez toujours pas à localiser cette dernière, vous pouvez effectuer la validation manuellement dans un environnement de développement intégré, un éditeur de texte tel qu'Atom ou Sublime, ou via un outil en ligne comme JSONLint.
### Erreur liée à un paramètre obligatoire manquant
Les fichiers de configuration peuvent être modifiés pour refléter les nouvelles fonctions ajoutées régulièrement à IDT. L'utilisation d'un ancien fichier de configuration peut corrompre votre configuration. Si tel est le cas, le fichier `{{}}.log` sous `/results/{{}}/logs` répertorie explicitement tous les paramètres manquants. IDT vérifie également les schémas de votre fichier de configuration JSON pour s'assurer que la dernière version prise en charge a bien été utilisée.
### Erreur indiquant l'impossibilité de démarrer le test
Vous pouvez rencontrer des erreurs qui renvoient à une défaillance lors du démarrage du test. Il y a plusieurs causes possibles. Par conséquent, procédez de la façon suivante :
+ Assurez-vous que le nom du groupe que vous avez inclus dans votre commande d'exécution existe réellement. Le nom du groupe est référencé directement à partir du fichier `device.json`.
+ Assurez-vous que les appareils du groupe ont des paramètres de configuration corrects.
### Erreur d'absence d'autorisation d’accès à la ressource
Vous pouvez voir le message d’erreur ` is not authorized to access this resource` dans la sortie du terminal ou dans le fichier `test_manager.log` sous `/results/{{}}/logs`. Pour résoudre ce problème, attachez la stratégie gérée `AWSIoTDeviceTesterForGreengrassFullAccess` à votre utilisateur de test. Pour de plus amples informations, veuillez consulter [Créez et configurez un Compte AWS](dev-tst-prereqs.md#config-aws-account-for-idt).
### Erreurs de type « Autorisation refusée »
IDT effectue des opérations sur différents répertoires et fichiers d'un appareil testé. Certaines de ces opérations nécessitent un accès racine. Pour automatiser ces opérations, IDT doit être en mesure d'exécuter des commandes avec la commande sudo sans avoir à saisir un mot de passe.
Suivez les étapes ci-après pour autoriser l'accès sudo sans saisie de mot de passe.
**Note**
`user` et `username` font référence à l'utilisateur SSH utilisé par IDT pour accéder à l'appareil testé.
1. Utilisez **sudo usermod -aG sudo {{}}** pour ajouter l'utilisateur SSH au groupe sudo.
1. Déconnectez-vous, puis reconnectez-vous pour que les modifications entrent en vigueur.
1. Ouvrez le fichier `/etc/sudoers`, puis ajoutez la ligne suivante à la fin du fichier : `{{}} ALL=(ALL) NOPASSWD: ALL`
**Note**
En tant que bonne pratique, nous vous recommandons d'utiliser **sudo visudo** lorsque vous modifiez `/etc/sudoers`.
### Erreurs de connexion SSH
Lorsqu'IDT ne parvient pas à se connecter à un appareil testé, les échecs de connexion sont consignés dans `/results/{{}}/logs/{{}}.log`. Les messages d'échec SSH apparaissent en haut de ce fichier journal, car la connexion à un appareil testé est l'une des premières opérations effectuées par IDT.
La plupart des configurations Windows utilisent l'application de terminal PuTTY pour se connecter aux hôtes Linux. Cette application nécessite que les fichiers de clé privée PEM standard soient convertis dans un format propriétaire Windows appelé PPK. Lorsqu'IDT est configuré dans votre fichier `device.json`, utilisez les fichiers PEM uniquement. Si vous utilisez un fichier PPK, IDT ne peut pas créer de connexion SSH avec le AWS IoT Greengrass périphérique et ne peut pas exécuter de tests.
### Erreurs de délai d'attente
Vous pouvez augmenter le délai d'attente pour chaque test en spécifiant un multiplicateur de délai d'attente, qui sera appliqué à la valeur par défaut du délai d'attente de chaque test. Toute valeur configurée pour cet indicateur doit être supérieure ou égale à 1.0.
Pour utiliser le multiplicateur de délai d'attente, utilisez l'indicateur `--timeout-multiplier` lors de l'exécution de tests. Par exemple :
```
./devicetester_linux run-suite --suite-id GGQ_1.0.0 --pool-id DevicePool1 --timeout-multiplier 2.5
```
Pour de plus amples informations, exécutez `run-suite --help`.
### Erreurs liées à des commandes introuvables lors des tests
Vous avez besoin d'une ancienne version de la bibliothèque OpenSSL (libssl1.0.0) pour exécuter des tests sur des appareils. AWS IoT Greengrass La plupart des distributions Linux récentes utilisent libssl 1.0.2 ou version ultérieure (v1.1.0).
Par exemple, sur un Raspberry Pi, exécutez les commandes suivantes pour installer la version requise de 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
```
### Exception de sécurité sur macOS
Lorsque vous exécutez IDT sur une machine hôte qui utilise macOS 10.15, le ticket de notarisation pour IDT n'est pas correctement détecté et son exécution est bloquée. Pour exécuter IDT, vous devez accorder une exception de sécurité à l'`devicetester_mac_x86-64`exécutable.
**Pour accorder une exception de sécurité à l'exécutable IDT**
1. Lancez **les préférences système** depuis le menu Apple.
1. Choisissez **Sécurité et confidentialité**, puis dans l'onglet **Général**, cliquez sur l'icône représentant un cadenas pour modifier les paramètres de sécurité.
1. Recherchez le message `"devicetester_mac_x86-64" was blocked from use because it is not from an identified developer.` et choisissez **Autoriser quand même**.
1. Acceptez l'avertissement de sécurité.
Si vous avez des questions concernant la politique d'assistance d'IDT, contactez [AWS le support client](https://aws.amazon.com/contact-us/).