¶ Première installation
¶ Installation sous Windows
Le plugin express'eau s’ajoute à une installation existante de QGIS et s’appuie sur une base de données relationnelle (hébergée sous PostgreSQL). La procédure complète se déroule ainsi :
- Installer QGIS3 (minimum version 3.22) : https://qgis.org/downloads/ ou utilisez une version déjà installée si elle est postérieure à la version 3.22.
- Faire une demande de licence sur https://licence.hydra-software.net/expresseau/, le téléchargement du set-up se déclenche automatiquement.
- Lancer le set-up téléchargé lors de la demande de licence.
- Ouvrir QGIS puis ouvrir le gestionnaire d'extensions :
Extensions → Installer et gérer les extensions. - Dans l'item
paramètres, voletdépôts d'extensionscliquer surajouteret paramétrer le dépôt comme suit avec l'URL suivante : https://hydra-software.net/telechargement/expresseau.xml
- Charger express'eau (dans “Non installées” ou “Toutes”, rechercher expresseau et cliquer sur
Installer) - Ouvrir avec un éditeur de texte le fichier .pg_service.conf qui se trouve dans C:/Users/votrenom. Assurer-vous que le fichier dispose d'un bloc
[expresseau]. Si ce n'est pas le cas, copier-coller le bloc hydra et remplacer[hydra]par[expresseau].
L'installation d'express'eau est terminée !
A noter que pour les installations standard de QGIS, le plugin est installé dans le répertoire suivant :
C:\Users\{user}\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins\expresseau
Une fois l'installation d'express'eau finalisée, il vous faudra activer votre clé de licence : cette procédure est décrite au chapitre Licence.
Warnings
- L'installation ne peut se faire que sur un poste 64 bits.
- Afin que le setup fonctionne correctement, QGIS doit être installé dans son répertoire par défaut. Si ce n'est pas le cas, vous devrez réaliser une installation manuelle.
- Si vous installez express'eau en tant qu'administrateur de la machine, pour un autre utilisateur, il vous faudra récupérer le fichier .pgservice.conf qui s'est installé dans C:/Users/admin (ou le télécharger ici) et le copier dans le répertoire C:/Users/nom_utilisateur
¶ Installation sous Linux
L'ensemble des composants interface est compatible Linux. Le moteur est également compilé pour Linux mais le setup n'est disponible que pour Windows. Pour une installation sous Linux, n'hésitez pas à nous contacter, nous pourrons vous fournir le moteur pour Linux.
¶ Cas particulier : Installation Windows 11 d'une ancienne version d'express'eau
Windows 11 et Express'eau version inférieure à 0.13.2 : problème avec WMIC
Le passage de Windows 10 à Windows 11 peut engendrer des erreurs d'activation de licence. En effet, expresseau utilise le module Windows wmic pour lire l'adresse MAC de la machine courante mais ce module est devenu optionnel sur certaines installations de Windows 11 et peut ne pas être disponible du tout.
Les installations récentes d'Expresseau (à partir de la version 0.13.2) ont remplacé la recherche de l'adresse MAC via wmic par Powershell. En revanche, une utilisation d'une version plus ancienne d'Expresseau sous Windows 11 peut demeurer problématique. La solution de contournement suivante permet de rétablir la fonctionnalité :
- Ouvrir un invite de commande (cmd) et exécuter la commande suivante powershell -Command "Get-CimInstance Win32_BIOS | Select-Object SerialNumber" qui vous donne un numéro de série à copier.
- Dans votre répertoire utilisateur express'eau (C:/users/<vous>/.expresseau), créer un fichier nommé wmic.bat contenant les lignes suivantes :
@echo off echo SerialNumber echo < le numéro de série que vous avez copié> exit /B 0 call (exit 0)
- Dans le répertoire C:/users/prenom.nom/AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins\expresseau, ouvrez avec un éditeur de texte (NotePad++ par exemple) le fichier plugin.py, et modifiez à partir de la ligne 124 en ajoutant les lignes suivantes :
if os.name == 'nt': os.environ["PATH"] = "C:\\Users\\<vous>\\.hydra;"+os.environ["PATH"]
- Veillez à bien mettre une tabulation (ou 2 à 4 espaces) d'écart entre la ligne if os.name<...>, et la ligne os.environ<...>
- Au final, votre numéro de série sera lu avant l'exécution éventuelle de wmic. Réouvrez QGIS et Expresseau, et le problème précédent ne devrait plus apparaître
¶ Mise à jour du plugin
Menu Extensions → Installer/Gérer les extensions
Ensuite dans “Installées”, chercher express'eau puis cliquer sur Mettre à jour l'extension.
¶ Optimisation de l'installation
¶ Paramétrage de QGIS
¶ Rendu
Afin d’accélérer le rafraîchissement des couches graphiques après déplacement ou zoom de la fenêtre d’affichage, cocher l’option ci-dessous dans le menu Préférences → Options → Onglet Rendu de QGIS :
¶ Nom par défaut des nouveaux éléments
Afin que le nom par défaut des éléments proposé lors de la création soit pertinent, décocher “Réutiliser la dernière valeur attributaire saisie” dans le menu Préférences → Options → Numérisation
Cela permet à express'eau d'incrémenter le n° de l'élément.
¶ Installation d'un serveur linux ubuntu/debian (modèles partagés)
Configuration matérielle minimale:
- CPU 2.90GHz
- RAM 4Go
- HDD 20Go
Package à installer:
- postgresql-13
- postgresql-13-pgrouting
- postgresql-13-pgrouting-scripts
- postgresql-13-postgis-3
- postgresql-13-postgis-3-scripts
sudo apt install \
postgresql-13 \
postgresql-13-pgrouting \
postgresql-13-pgrouting-scripts \
postgresql-13-postgis-3 \
postgresql-13-postgis-3-scripts
Les utilisateurs doivent être superuser postgresql pour pouvoir créer/mettre à jour des projet expresseau depuis QGIS (création de bases de données).
sudo su - postgres
psql -c "create user utilisateur_postgres superuser password 'mot_de_passe_postgres';"
Une gestion des droit plus fine est possible en donnant aux utilisateurs des droits sur le schéma api d'une base de donnée expresseau.
Les utilisateurs souhaitant accéder au nouveau serveur doivent ajouter une section au fichier .pg_service.conf qui se trouve dans leur répertoire personnel.
[expresseau]
host=127.0.0.1
port=5454
user=hydra
password=hydra
[nouveau_serveur]
host=adresse_ip_ou_nom_du_serveur
port=5432
user=utilisateur_postgres
password=mot_de_passe_postgresLe choix du serveur se fait ensuite dans QGIS, dans le gestionnaire de projets.