La structuration d'Hydra est articulée autour de plusieurs éléments :
Pour le bon fonctionnement, il est nécessaire également :
Les tests sont réalisés sur des versions LTR et le bon fonctionnement d'Hydra n'est pas garanti sur des versions autres que celles-ci (non matures)
Il est important de pouvoir faire correspondre la version de QGIS et la version d'hydra, notamment lors de la recherche d'une ancienne configuration de fonctionnement
Pour ce faire consulter attentivement le tableau de compatibilité :
| Version Hydra | Version QGIS LTR |
|---|---|
| 1.21 à 1.71 | 2.16 |
| 1.71 à 2.6.0 | 2.18 |
| 3.0 - 3.6 | 3.10 |
| 3.6 | 3.16 |
| 3.6-3.10.10 | 3.22 - 3.28 |
| 3.10.10 - 3.10.13 | 3.34.13 |
Vous disposez du programme de setup setup_hydra.exe.
Vous devez disposer des droits d'administraterur complets pour exécuter ce programme car :
L'installation est visible dans le dossier C:\Programmes\Hydra :
A la fin de cette installation, deux vérifications peuvent être faites :
Ce point d'étape est important car il garantit que la communication avec la base de données est effective. Le plugin Hydra nécessite une connexion fonctionnelle pour pouvoir exécuter ses tâches.
C'est à partir de là que l'installation du plugin Hydra (avec une version appropriée) au sein de la version de QGIS soigneusement choisie prend sens.
L'installation du plugin comprend les étapes suivantes :
Lorsque l'installation a correctement abouti, le logo d'Hydra doit apparaître à droite de la barre de menu de l'espace de travail de QGIS.
Le bon fonctionnement va être confirmé par la création d'un modèle vide. Pour ce faire, depuis le gestionnaire de projets :
L'ensemble des couches d'Hydra va être créé pour ce modèle et sont visibles dans la colonne des couches disponibles du projet QGIs et disponibles en édition. Il est donc possible à présent de pouvoir éditer son projet, signe de bonne santé du fonctionnement d'hydra.
La présentation de la structure a montré des dépendances techniques et humaines, et parfois, rien ne se passe comme prévu !
Nous pouvons lister plusieurs facteurs déstabilisants :
Plusieurs erreurs-type sont listées ci-après avec une voie de résolution possible, pour permettre une résolution des problèmes en toute autonomie
Les messages apparaissent souvent sous la forme d'une fenêtre informative dédiée, avec un message déplaisant en rouge, ou dans le Journal des messages QGIS, onglet "Erreur Python", sans compter le bandeau rouge en haut du cadre de carte...
| Message / Symptôme | Voie de résolution |
|---|---|
| SSL Error / Erreur de certificat | Vérifier le pare-feu et les droits associés pour permettre la communication avec le domaine hydra-software.net |
| cannot find geos_c.dll | Problème de version de numpy et shapely, probablement lié au fait que la version d'Hydra est récente par rapport à la version de QGIS. Une version 3.34.13 de QGIS assure la présence d'un environnement Python 3.12 avec les dernières version de numpy et shapely |
| psycopg2.OperationnalError : connection to server at '127.0.0.1', port 5454 failed : Connection refused (XXX) Is the server running on that host and accepting TCP/IP connections ? | Ce message montre une connexion défaillante à la base de données Postgres/PostGIS. C'est le résultat d'une installation avec des droits d'administration qui n'étaient probablement pas complets, conduisant à une possible absence de fichier .pg_service.conf dans le répertoire utilisateur (C:\users<vous>) et/ou à unservice postgresql-x64-13-hydra non démarré automatiquement. Armé des droits administrateur, vérifier l'existence du fichier .pg_service.conf, et/ou rendez-vous dans le gestionnaire des tâches de Windows et rendre le service postgresql-x64-13-hydra démarré en permanence |
En dernier ressort, en cas de configuration particulière, vous pouvez contacter le support à l'adresse (mailto:support@hydra-software.net)