Dépannage

Le traitement refuse de démarrer

Commencez par lire le premier diagnostic du journal. Les causes courantes sont :

• entrée obligatoire non raccordée ;
• paramètre invalide ou manquant ;
• fichier source déplacé ;
• schéma source devenu incompatible ;
• connexion de base absente ou modifiée ;
• cache requis manquant pour une exécution partielle.

Corrigez la cause indiquée plutôt que de contourner la validation.

Un cache est obsolète

Une modification fonctionnelle en amont invalide le cache. Relancez la partie concernée ou une exécution complète.

Si le moteur ou son contrat de cache a changé après une mise à jour, régénérez les caches. Le projet .etl peut rester compatible même si ses caches ne le sont plus.

Un format spatial ne fonctionne pas

La distribution officielle fournit son propre runtime spatial. N’ajoutez pas de DLL QGIS ou GDAL système dans le dossier de Catenivo.

Vérifiez le format, les fichiers compagnons et le SCR attendu. Une géométrie Z/M ou un type non pris en charge doit produire un diagnostic plutôt qu’une conversion silencieuse.

Le mot de passe n’est pas conservé sous Linux

Le stockage « sur cet appareil » nécessite un service freedesktop Secret Service disponible dans la session de bureau, par exemple GNOME Keyring ou un KWallet compatible.

Si le service est absent, utilisez le stockage de session. Catenivo n’écrit pas le secret en clair comme solution de repli.

L’AppImage ne démarre pas

Vérifiez qu’elle est exécutable :

chmod +x Catenivo_<version>_amd64.AppImage

Ubuntu Desktop 24.04 LTS x64 est la référence Linux testée. Sur une autre distribution, une incompatibilité des bibliothèques de base reste possible.

Windows affiche un avertissement

Les binaires Catenivo ne sont actuellement pas signés avec un certificat Authenticode payant. Vérifiez qu’ils proviennent de la release attendue et contrôlez leur SHA-256.

Signaler une anomalie

Conservez :

• la version Catenivo ;
• le système et sa version ;
• le message d’erreur exact ;
• le type de source/destination ;
• les étapes minimales permettant de reproduire le problème.

Ne joignez pas de mots de passe, jetons ou données sensibles.