Problèmes et actions correctives¶
Cette page vous indique les causes des problèmes fréquents dans LUC Analytics (LUCA) et les actions qui les corrigent.
Chaque tableau a trois colonnes. "Problème" donne le message que l'application ou Docker affiche, ou ce que vous voyez. Le texte entre "guillemets droits" est le message exact. Une commande ou une étiquette de l'application est en gras. Une partie comme {{code}} est une valeur que l'application écrit dans le message.
Docker et le conteneur¶
Pour les procédures complètes, consultez 01-install-and-start.md.
| Problème | Cause | Action |
|---|---|---|
docker run échoue avec un message qui indique qu'il n'a pas pu lier le port hôte 127.0.0.1:8000. Sous Linux, le message est address already in use. |
Un autre programme utilise le port 8000 de votre ordinateur portable. Docker a créé le conteneur, mais ne l'a pas démarré. | 1. Saisissez docker rm luc-analytics. 2. Saisissez à nouveau la commande docker run avec un autre port hôte, par exemple -p 127.0.0.1:8080:8000. 3. Dans le lien du journal, remplacez 8000 par 8080. |
| "The container name "/luc-analytics" is already in use" (le nom de conteneur "/luc-analytics" est déjà utilisé) | Un conteneur d'une commande docker run précédente existe. |
Démarrez ce conteneur avec docker start luc-analytics. Ou supprimez-le avec docker rm -f luc-analytics et saisissez à nouveau la commande docker run. Le volume et vos données restent. |
| Docker Desktop reste sur "Engine starting" (le moteur démarre), ou il affiche un délai expiré de WSL. | Le moteur Docker ou sa machine virtuelle WSL 2 ne démarre pas correctement. | 1. Faites un clic droit sur l'icône Docker dans la zone de notification de la barre des tâches. 2. Sélectionnez Quit Docker Desktop (quitter Docker Desktop). 3. Démarrez à nouveau Docker Desktop. 4. Si le problème continue, quittez à nouveau Docker Desktop. 5. Saisissez wsl --shutdown dans PowerShell. 6. Démarrez à nouveau Docker Desktop. |
docker version n'affiche pas de partie Server (serveur). |
Le moteur Docker n'est pas démarré. | Démarrez Docker Desktop. Attendez qu'il affiche Engine running (le moteur fonctionne). |
Le conteneur s'arrête immédiatement. Le journal, ou la sortie de docker run, contient exec format error. |
La version de l'image (amd64 ou arm64) ne correspond pas au processeur de votre ordinateur portable. | 1. Saisissez $env:PROCESSOR_ARCHITECTURE dans PowerShell. Sur un Mac, saisissez uname -m dans Terminal. 2. Saisissez docker image inspect luc-analytics --format "{{.Architecture}}". 3. Comparez les deux valeurs. AMD64 correspond à amd64. ARM64 correspond à arm64. Sur un Mac, x86_64 correspond à amd64 et arm64 correspond à arm64. 4. Si les valeurs ne correspondent pas, obtenez le fichier image pour la version correcte (luc-analytics-beta-...-amd64.tar.gz ou luc-analytics-beta-...-arm64.tar.gz). 5. Saisissez docker rm luc-analytics. 6. Faites les étapes de "Charger l'image" dans 01-install-and-start.md avec le fichier correct. 7. Démarrez à nouveau le conteneur avec la commande docker run. |
| Paramètres > Mémoire affiche "Non détecté sur cet hôte — saisissez la limite de mémoire de cette machine ou VM." | L'application ne trouve pas la limite de mémoire dans Docker Desktop. Aussi, Docker a peut-être trop peu de mémoire : par défaut, il peut utiliser environ la moitié de la mémoire de l'ordinateur portable. | 1. Donnez à Docker 5 GB de mémoire ou plus dans le fichier .wslconfig. 2. Saisissez wsl --shutdown et démarrez à nouveau Docker Desktop. 3. Dans Paramètres > Mémoire, saisissez la mémoire de Docker dans Limite de mémoire de l'hôte / VM (Go). 4. Fermez les autres grands programmes. |
| L'application ne répond pas dans le navigateur. | Le conteneur est arrêté, ou l'application a un problème. | 1. Saisissez docker ps -a pour voir si le conteneur fonctionne. 2. Saisissez docker logs luc-analytics pour lire les messages de l'application. 3. Si le conteneur est arrêté, saisissez docker start luc-analytics. |
| L'application ne répond pas après un nouveau démarrage de Windows. | Le conteneur ne démarre pas automatiquement. | Démarrez Docker Desktop. Ensuite, saisissez docker start luc-analytics. |
Clé d'accès¶
AVERTISSEMENT : Ne donnez pas le lien avec la clé d'accès à d'autres personnes. Une personne qui a le lien peut utiliser l'application et votre identifiant AWS.
Les pages "Clé d'accès requise" et "Clé d'accès indisponible" viennent du serveur.
| Problème | Cause | Action |
|---|---|---|
| Le navigateur affiche "Clé d'accès requise". | Le navigateur n'a pas la clé d'accès. | 1. Saisissez docker exec luc-analytics cat /data/state/access-key. 2. Ouvrez http://localhost:8000/?access_key=<key>. Utilisez la clé de l'étape 1. |
| Le navigateur affiche "Clé d'accès indisponible". La page indique que le serveur "ne peut plus la lire (son fichier de clé a peut-être été supprimé)". | Le fichier de la clé n'est pas dans le volume, ou le serveur ne peut pas le lire. | Redémarrez le conteneur avec docker restart luc-analytics. L'application crée une nouvelle clé et écrit un nouveau lien dans le journal. Ouvrez le nouveau lien. |
Identifiant AWS (Vérifier les identifiants)¶
Vous trouvez ces messages dans Paramètres > Identifiants, après un appui sur Vérifier les identifiants. Cette vérification est gratuite. Pour les paramètres, consultez 06-settings.md.
| Problème | Cause | Action |
|---|---|---|
| "AWS a rejeté cet identifiant ({{code}}) : l'ID de clé d'accès ou le secret est incorrect, ou la clé n'est pas active. Ensuite : ressaisissez les deux, puis vérifiez à nouveau les identifiants." | L'ID de clé d'accès AWS ou la clé d'accès secrète AWS est incorrect, ou la clé AWS n'est pas active. | Saisissez à nouveau les deux valeurs. Appuyez sur Vérifier les identifiants. |
| "Aucun identifiant AWS n'est saisi ni enregistré. Ensuite : saisissez l'ID de clé d'accès et le secret, puis vérifiez les identifiants." | Il n'y a pas d'identifiant AWS. | Saisissez l'ID de clé d'accès AWS et la clé d'accès secrète AWS. Appuyez sur Vérifier les identifiants. |
| "Un identifiant enregistré existe mais n'a pas pu être lu avec la clé active du coffre de secrets. Ensuite : ressaisissez l'ID de clé d'accès et le secret et enregistrez." | La clé du coffre chiffré a changé, ou le coffre est endommagé. | Saisissez à nouveau l'ID de clé d'accès AWS et la clé d'accès secrète AWS. Appuyez sur Enregistrer. |
| "AWS STS est injoignable (réseau ou point de terminaison). Cela ne dit rien de l'identifiant. Ensuite : réessayez." | Il n'y a pas de connexion réseau, ou AWS ne répond pas. | Assurez-vous que l'ordinateur portable a une connexion Internet. Appuyez à nouveau sur Vérifier les identifiants. |
| "AWS STS n'a pas répondu à temps. Cela ne dit rien de l'identifiant. Ensuite : réessayez." | AWS n'a pas répondu dans le délai autorisé. | Appuyez à nouveau sur Vérifier les identifiants. |
| "Saisissez à la fois l'ID de clé d'accès et la clé d'accès secrète, ou aucun des deux." | Vous avez saisi une seule des deux valeurs. | Saisissez les deux valeurs, ou effacez les deux champs. |
| "Vérifiez d'abord les identifiants. Une paire de clés qui a échoué à la vérification n'est jamais enregistrée." | Vous avez appuyé sur Enregistrer avant une vérification réussie. | Appuyez sur Vérifier les identifiants. Quand la vérification réussit, appuyez sur Enregistrer. |
Connexion à un jeu de données (Tester la connexion)¶
Vous trouvez ces messages pour une source de données après un appui sur Tester la connexion.
AVERTISSEMENT : Tester la connexion fait une requête au bucket du WRI. AWS facture cette requête à votre compte AWS.
| Problème | Cause | Action |
|---|---|---|
| "Votre identifiant est correct. Le réglage « Paiement par le demandeur » de ce jeu de données est désactivé, donc l'application refuse d'effectuer une requête facturée. Activez « Paiement par le demandeur » ci-dessus." | Paiement par le demandeur est désactivé. Sans ce réglage, l'application ne fait pas de requête qui coûte de l'argent. | Activez Paiement par le demandeur. Appuyez à nouveau sur Tester la connexion. |
| "AWS a rejeté cet identifiant pour ce jeu de données. La clé a peut-être été révoquée, est peut-être erronée ou n'a peut-être pas la permission. « Paiement par le demandeur » est déjà activé, donc le problème vient de l'identifiant." | L'identifiant AWS n'est pas correct, ou il n'a pas la permission. | Appuyez sur Vérifier les identifiants. Si la vérification échoue, corrigez l'identifiant AWS. |
| "AWS a rejeté cet identifiant ({{code}}) — c'est l'identifiant, pas l'emplacement. Ensuite : appuyez sur Vérifier les identifiants." | AWS a refusé l'identifiant. | Appuyez sur Vérifier les identifiants. |
| "Aucun identifiant AWS n'est résolu pour ce jeu de données. Ajoutez un ID de clé d'accès et une clé secrète ci-dessus, puis enregistrez et testez à nouveau." | Il n'y a pas d'identifiant AWS. | Saisissez et enregistrez l'identifiant AWS. Appuyez à nouveau sur Tester la connexion. |
| "Un identifiant stocké existe mais n'a pas pu être lu avec la clé active du coffre de secrets. Saisissez à nouveau l'ID de clé d'accès et la clé secrète ci-dessus et enregistrez." | L'application ne peut pas déchiffrer l'identifiant enregistré. | Saisissez à nouveau l'identifiant AWS et enregistrez-le. |
| "AccessDenied ({{code}}) : la clé est valide mais n'est pas autorisée à lire ce bucket, ou le bucket a refusé la requête à paiement par le demandeur. Ensuite : vérifiez les identifiants, puis la vérification CLI ci-dessous." | La clé AWS est correcte, mais elle n'a pas la permission de lire le bucket. | 1. Appuyez sur Vérifier les identifiants. 2. Faites la vérification de Vérifiez-le vous-même depuis votre propre terminal. 3. Donnez à la clé AWS la permission de lire le bucket. |
| "Le jeu de données n'a pas pu être atteint (panne réseau ou de point de terminaison). Cela n'est pas lié à votre identifiant ni au réglage « Paiement par le demandeur »." | Il n'y a pas de connexion réseau, ou le point de terminaison ne répond pas. | Assurez-vous que l'ordinateur portable a une connexion Internet. Appuyez à nouveau sur Tester la connexion. |
| "Le test de connexion a expiré. Le jeu de données n'a pas répondu dans le délai imparti — il s'agit probablement d'un point de terminaison lent ou injoignable, et non de votre identifiant ou du réglage « Paiement par le demandeur »." | Le point de terminaison n'a pas répondu dans le délai autorisé. | Appuyez à nouveau sur Tester la connexion plus tard. |
| "AWS a répondu {{code}} pour {{uri}} : rien ne se trouve à cet emplacement. Ensuite : appuyez sur Utiliser le chemin du manifeste ($, une requête facturée)." | Le chemin S3 du jeu de données est incorrect ou ancien. | Appuyez sur Utiliser le chemin du manifeste. Cette action fait une requête qui coûte de l'argent. |
| "Aucun objet n'existe sous {{uri}} : le bucket a répondu, mais rien n'est stocké à ce préfixe. Ensuite : appuyez sur Utiliser le chemin du manifeste ($, une requête facturée)." | Il n'y a pas de fichiers à ce chemin S3. | Appuyez sur Utiliser le chemin du manifeste. Cette action fait une requête qui coûte de l'argent. |
| "L'emplacement est accessible et autorisé, mais il ne contient pas de magasin Zarr lisible." | Le chemin S3 ne contient pas le jeu de données. | Corrigez le chemin S3 du jeu de données. |
| "Le bucket répond depuis {{bucketRegion}}, pas depuis {{region}} — le bucket de WRI est en us-east-1. Ensuite : corrigez datasets.upstream.region (ou regions) dans config.yaml." | La région AWS de la configuration est incorrecte. | 1. Dans /data/config.yaml, remplacez la valeur de datasets.upstream.region par us-east-1. 2. Redémarrez le conteneur. |
Identifiants des fournisseurs de fonds de carte¶
Vous trouvez ces messages sur les cartes Planet, Google Maps et Copernicus (CDSE) dans Paramètres > Identifiants, après un appui sur Tester la connexion. Le message commence par "Échec de la connexion :".
| Problème | Cause | Action |
|---|---|---|
| "Le fournisseur a refusé cet identifiant. Vérifiez la valeur ou qu'il dispose encore des autorisations nécessaires." | L'identifiant est incorrect, ou il n'a pas la permission. | Saisissez la valeur correcte. Appuyez à nouveau sur Tester la connexion. |
| "Le fournisseur n'a pas pu être joint (échec réseau ou du point de terminaison). Cela ne concerne pas votre identifiant." | Il n'y a pas de connexion réseau, ou le fournisseur ne répond pas. | Assurez-vous que l'ordinateur portable a une connexion Internet. Appuyez à nouveau sur Tester la connexion. |
| "Le fournisseur n'a pas répondu dans le délai autorisé. Il s'agit probablement d'un point de terminaison lent ou injoignable, et non de votre identifiant." | Le fournisseur n'a pas répondu dans le délai autorisé. | Appuyez à nouveau sur Tester la connexion plus tard. |
| "Le fournisseur est mal configuré sur le serveur ; l'identifiant n'a donc pas pu être testé." | La configuration du serveur pour ce fournisseur n'est pas correcte. | Parlez à la personne qui a installé l'application. |
| "Testez d'abord la connexion. Une connexion en échec n'est jamais enregistrée." | Vous avez appuyé sur Enregistrer avant un test réussi. | Appuyez sur Tester la connexion. Quand le test réussit, appuyez sur Enregistrer. |
Téléverser une liste¶
Pour plus d'informations sur les listes, consultez 02-lists.md.
| Problème | Cause | Action |
|---|---|---|
| "Les téléversements sont désactivés" | ingest.upload_enabled n'est pas true dans la configuration. Une installation que vous avez mise à niveau garde son ancien fichier de configuration. |
1. Assurez-vous que la clé d'accès protège l'application. 2. Réglez ingest.upload_enabled: true dans /data/config.yaml. 3. Redémarrez le conteneur. |
| "Type de fichier non pris en charge" | L'application ne peut pas lire ce type de fichier. L'application n'accepte pas les fichiers KMZ (.kmz). |
Utilisez un fichier CSV, Excel (.xlsx), GeoJSON, KML (.kml) ou un shapefile compressé (.zip). Pour utiliser un fichier KMZ, extrayez le fichier KML qu'il contient. |
| "Fichier trop volumineux" ou "Trop d'emplacements" | Le fichier dépasse la limite. | Divisez le fichier en fichiers plus petits. Téléversez chaque fichier comme une liste. |
| "Feuille de calcul trop large" | Une ligne de la feuille de calcul a trop de colonnes. | Supprimez les colonnes dont vous n'avez pas besoin. Téléversez à nouveau. |
| "Aucun emplacement trouvé" | Le fichier n'a pas de lignes. | Assurez-vous que le fichier a des lignes. |
| "Nous n’avons pas trouvé les colonnes des emplacements" | L'application ne trouve pas les colonnes avec les coordonnées. | Utilisez Modifier la correspondance des champs pour sélectionner les colonnes. |
| "Cette colonne ne figure pas dans votre fichier" | Les associations de colonnes utilisent une colonne qui n'est pas dans le fichier. | Corrigez les associations de colonnes. |
| "Aucun emplacement valide" | Les coordonnées ne sont pas correctes. | Corrigez les coordonnées. |
| "Impossible d’ouvrir l’archive" ou "Impossible de lire le KML/KMZ" | Le fichier est endommagé. | Exportez à nouveau le fichier depuis son programme. Téléversez-le à nouveau. |
| "Les emplacements ont besoin d’une taille" | Le fichier a des points sans taille. | Donnez une taille (une superficie ou un rayon) pour les points. |
| "Choisissez une unité" | La taille n'a pas d'unité. | Sélectionnez Superficie ou Rayon. |
| "Quelle projection cartographique ?" ou "Projection non reconnue" | Les coordonnées ne sont pas une latitude et une longitude WGS 84. | Sélectionnez la projection du fichier. |
| "Jeux de données indisponibles" | Les jeux de données ne sont pas disponibles maintenant. | Essayez à nouveau plus tard. |
| "Téléversement interrompu", "Téléversement expiré" ou "Échec de validation" | Le téléversement ne s'est pas terminé. | Téléversez à nouveau le fichier. |
| "Impossible de joindre le serveur" | Le navigateur ne peut pas se connecter à l'application. | Assurez-vous que le conteneur fonctionne (docker ps -a). |
Exports¶
Pour plus d'informations sur les exports, consultez 05-exports.md.
| Problème | Cause | Action |
|---|---|---|
| Vous ne pouvez pas appuyer sur Exporter ou sur ⬇ Télécharger le CSV. L'info-bulle affiche "L'export CSV sera disponible une fois l'analyse de cette liste terminée." | L'analyse de la liste n'est pas complète. | Attendez que l'analyse de la liste soit complète. Une liste avec l'étiquette Incomplète après Arrêter et valider ne devient pas complète. Pour une telle liste, exportez chaque emplacement terminé. |
| "L'export CSV sera disponible une fois l'analyse de cette liste terminée." | Le serveur a refusé un export de liste, car l'analyse de la liste n'est pas complète. | Attendez que l'analyse de la liste soit complète. Pour une liste avec l'étiquette Incomplète, exportez chaque emplacement terminé. |
| "Export indisponible — aucun emplacement de cette liste n'a encore été analysé, il n'y a donc rien à exporter." | Aucun emplacement de la liste n'est terminé. | Attendez que l'analyse soit terminée. |
| "Export indisponible — l’analyse de cet emplacement n’est pas terminée. L’export sera disponible une fois que toutes ses analyses seront terminées." | Une analyse de cet emplacement n'est pas terminée. | Attendez que chaque analyse de l'emplacement soit terminée. |
| "Le CSV a été téléchargé, mais son fichier annexe « Données utilisées » (les dates des jeux de données sources) n’a pas pu être téléchargé." | Le deuxième fichier ne s'est pas téléchargé. | Appuyez à nouveau sur le bouton. |
| "Export PDF indisponible — aucun emplacement n'a encore été analysé pour cette liste." | Aucun emplacement de la liste n'est terminé. | Attendez que l'analyse soit terminée. |
| "Export PDF indisponible — la carte et les couches d'analyse ne sont pas encore prêtes à être capturées. Veuillez patienter et réessayer." | La carte n'est pas entièrement dessinée. | Attendez que la carte soit entièrement dessinée. Appuyez à nouveau sur Télécharger le PDF. |
| "Export PDF indisponible — en attente de : {{items}}. Veuillez patienter et réessayer." | La carte attend les éléments du message, par exemple les tuiles du fond de carte. | Attendez. Appuyez à nouveau sur Télécharger le PDF. Si des tuiles ne se sont pas chargées, consultez "Cartes" plus bas. |
| "Échec de l'export PDF — la vue de la carte n'a pas pu être capturée. Réessayez une fois que la carte a fini de s'afficher." | L'application n'a pas fait d'image de la carte. | Attendez que la carte soit entièrement dessinée. Appuyez à nouveau sur Télécharger le PDF. |
| "Échec de l'export PDF — le rapport n'a pas pu être assemblé." ou "Échec de l'export PDF — la requête d'export n'a pas abouti. Veuillez réessayer." | L'application n'a pas fait le fichier PDF. | Appuyez à nouveau sur Télécharger le PDF. Si le problème continue, lisez la ligne qui commence par "Cause :". |
| "Impossible de charger les sources de données. Voir DATA-ATTRIBUTION.md dans le dépôt du projet." | L'application n'a pas obtenu le texte d'attribution. | Lisez le fichier DATA-ATTRIBUTION.md. Ouvrez à nouveau Sources de données et licences plus tard. |
Cartes¶
Pour plus d'informations sur les cartes, consultez 04-maps.md.
| Problème | Cause | Action |
|---|---|---|
| "La carte n'a pas pu être affichée" | Une erreur s'est produite dans la carte. Les autres parties de la page continuent à fonctionner. | Essayez à nouveau, ou chargez à nouveau la page. |
| "Échec du chargement des données de la grille cartographique." | L'application n'a pas obtenu les couches d'analyse pour la carte. | Chargez à nouveau la page. |
| "Des emplacements ont été trouvés, mais les limites de la carte sont invalides et ne peuvent pas être affichées." | Les limites des emplacements ne sont pas correctes. | Examinez les coordonnées des emplacements. |
| "La comparaison n'est pas disponible : ce fond de carte n'a pas de dates à choisir." | Le fond de carte n'a pas de dates. | Sélectionnez un autre fond de carte. |
| "Les cellules natives sont plus petites qu'un pixel d'écran à ce zoom. Zoomez pour la résolution maximale." | Vous avez fait un zoom arrière trop important pour la résolution maximale. | Faites un zoom avant. |
| "Ce fichier n'est pas un JSON valide." ou "Ce n'est pas un fichier de modèle de légende." | Vous avez sélectionné un fichier qui n'est pas un modèle de légende de carte. | Sélectionnez un fichier .mpky que vous avez enregistré depuis la légende de la carte. |
Listes et résultats¶
| Problème | Cause | Action |
|---|---|---|
| "Impossible de charger les listes" ou "Impossible de charger les résultats" | L'application ne peut pas lire la base de données des résultats. | Chargez à nouveau la page. Si le problème continue, lisez la sortie de docker logs luc-analytics. |
| "Liste introuvable" | La liste n'existe pas. Quelqu'un l'a peut-être supprimée. | Allez sur la page des listes et sélectionnez une liste qui existe. |
| "Cette exécution ne s'est pas terminée : {{message}}" | Une nouvelle exécution de la liste s'est arrêtée. | Lisez le message. Corrigez la cause. Ensuite, appuyez sur Relancer avec les données actuelles. |
| "Cette mise à jour ne s'est pas terminée : {{message}}. Les résultats précédents sont conservés." | Une mise à jour de la liste s'est arrêtée. L'application garde les résultats précédents. | Lisez le message. Démarrez à nouveau la mise à jour. |
| "Un problème est survenu" | La page a eu une erreur. | Essayez à nouveau, ou chargez à nouveau la page. |