Les 3 premières étapes peuvent être faite sur un poste accessible à différents utilisateurs pour centraliser les bases de données.

cf. https://www.postgresql.org/download/

Installer une version de postgresql (version au moins 9.3) qui correspond à votre système d'exploitation .

(Touche Windows + Pause puis lire la ligne "Type du système" pour connaître le nombre de bit)

L'installation demande de choisir :

• un nom d' utilisateur ("user") : par exemple "mascaret" (ou sinon "postgres")
• un hôte ("host") : "localhost" pour une installation en local sur son propre PC, sinon IP de la machine distante qui héberge la base
• un mot de passe
• un port : en général "5432"

Bien retenir ces paramètres, il faudra les renseigner par la suite.

Deux possibilités :

• Installation à l'aide de l'application Stack Builder qui s'installe en même temps que Postgres.

Le plugin se trouve dans « Spatial Extensions ».

• Téléchargement depuis le lien http://download.osgeo.org/postgis/ la bonne version : la même que celle de postgresql.

Après installation, il faut à présent créer une base de données, nécessaire à l'utilisation du plugin Mascaret.

Se rendre dans postgreSQL via pgAdmin (Logiciel de gestion de la base PostgreSQL, à installer également).

• Cliquer doit sur Database -> New database. La nommer « nomdelabasededonnee »

Maintenant que la base de données est créée, le plugin peut être installé.

Cette installation et paramétrage doit être fait sur tous les postes utilisateurs qui doivent accéder serveur postgres soit installé localement soit accessible à distance et commun à différents utilisateurs.

⚠️ Attention :

Dans ce cas, attention à ne pas travailler sur le même modèle Mascaret en même temps.

Dans le cas où QGIS n'est pas déjà installé, installer QGIS version 3 de préférence.

Dans QGIS, rajouter une couche postgis : Couches > Ajouter une couche > Ajouter une couche postGIS -> bouton ‘Nouveau'.

• Rentrer les paramètres de la base de données :

  - Nom = « nomdelacouche »

  - hôte = celui qui a été choisi pour l'installation de postgres <> pour une installation sur son propre PC, sinon IP de la machine distante qui héberge la base)

  - port = 5432 par défaut

  - base de données : nom de la base de donnee

• Renseigner ensuite le nom d'utilisateur (normalement "mascaret" ou à défaut "postgres") et le mot de passe défini à l'installation dans la fenêtre « Authentification »

• Mémoriser le mot de passe et tester la connexion. Si pas de message d'erreur faire ok.

• Se connecter ensuite à la base de donnée en cliquant sur le bouton 'Connecter'. Le schéma « public » doit apparaître dans la fenêtre .

⚠️ Attention :

Dans le cas où l'hote est une IP d'une machine distance, la fonction d'export de base du plugin ne fonctionne pas. Il faut alors le faire via pgAdmin Databases>...>Schemas clic droit ‘Backup...' § 3.5.

Pour configurer le proxy sous QGis, aller dans Préférences > Options > Réseau

Depuis QGIS, installer le plugin grâce au menu Extension > Installer/Gérer les extensions

Chercher l'extension « Mascaret » dans l'onglet « Non installés » puis installer l'extension. Pour voir les versions expérimentales (et tester de nouvelles fonctionnalités) du plugin Mascaret, cocher « Afficher les extensions expérimentales » depuis le menu Paramètres.

Une icône doit apparaître dans la barre d'outils.

Si ce n'est pas possible ou pour tester une version béta,

• Télécharger le plugin sur : http://plugins.qgis.org/plugins/Mascaret/
• Dézipper et le copier dans répertoire des plugins

%APPDATA%\QGIS\profil\python\plugins\mascaret

• Lancer QGIS et rajouter l'extension dans le gestionnaire d'extension. Un bouton M en jaune dans un disque bleu apparaît.

Lorsque Postgres est installé en local, définir le chemin de l'exécutable de Postgres :

• Cliquer sur l'icône , aller au menu Help > Settings. Exemple :

 C:\Program Files\PostgreSQL\{numero de version}\bin 

⚠️ Attention :

Dans le cas contraire, la fonctionnalité d'export ne sera pas disponible depuis le plugin. Il faudra passer par pgAdmin pour l'exportation

L'exécutable Mascaret contenu dans le plugin est compilé pour un PC windows 64 bits. Pour les PC en 32 bits, il est possible de remplacer l'exécutable Mascaret ( §5) par un exécutable compilé pour 32 bits.

⚠️ Attention :

Après l'installation du plugin, il faut créer un premier modèle même vide pour que toutes les fonctions soit bien initialisé. Surtout si vous prévoyez importer un modèle.

Le plugin est alors prêt pour utilisation.

La mise à jour du plugin s'effectue de la même façon que l'installation. Chercher l'extension « Mascaret » dans l'onglet « Installées » puis mettre à jour l'extension. Ensuite, pensez à mettre à jour les bases de données de modèles fabriqués avec une autre version du plugin : § 3.7.