vMap dispose d’un installateur spécifique VAI qui permet d’assurer l’installation et la mise à jour du produit sans perte de configuration ni de données.

1. Préconisations techniques

Poste Configuration minimale
Mémoire vive4 Go
Espace disque disponible2 Go
Base de donnéesPostGresql 9.3 ou plus
avec Postgis 2.1 ou plus
Serveur httpApache 2.4.x (mod_ssl)

 2. Prérequis

Installation du serveur https Apache 2.4

vMap utilise le protocole sécurisé https qui assure le cryptage des échanges entre le serveur d’application Vitis et le poste client. Il est donc nécessaire d’installer une version spécifique du serveur http Apache compilé avec le module SSL.

Procédure d’installation Apache 2.4 pour Windows
Procédure d’installation Apache 2.4 pour Linux

Installation de PostgreSQL

vMap utilise une base PostgreSQL pour stocker les informations sur les couches et cartes à publier ainsi que sur les utilisateurs et leurs droits. Si PostgreSQL est déjà installé sur votre poste, cette étape est facultative.

Procédure d’installation PostgreSQL pour Windows
Procédure d’installation PostgreSQL pour Linux

3. Installation de vMap

Téléchargez puis décompressez l’installateur de vMap pour votre système d’exploitation à partir du vStore de Veremes (magasin vMap) : Site de téléchargement de vMap

vStore : Magasin vMap

Pour installer vMap, éditez le fichier install.cmd (Windows) ou install.sh (Linux) afin de définir les paramètres de votre installation.

Les variables à modifier pour l’installation sont :

VariableDescription
dirRépertoire d'installation (/var/www/vmap préférable pour Linux C:/server/vmap conseillé pour Windows)
serveurServeur de la base de données
port Port d'accès à la base de données
bdd Nom de la base de données (La base de données peut être existante)
dblogin Compte d'un superutilisateur de la base
dbpswd Mot de passe du compte superutilisateur
apacheService Nom du service Apache exploité par l'application
apachePort Port du service https du serveur Apache
appAdmin Compte PostgreSql de l'administrateur de l'application. Ce compte sera créé s'il n'existe pas.
appPswd Mot de passe du compte précédent s'il doit être créé. Si le compte existe déjà cette valeur n'est pas exploitée. Il faut néammoins saisir une valeur car ce paramètre est obligatoire.
SRIDCode EPSG des données cadastrales sous forme d'entier

L’installateur de vMap assure les opérations suivantes :

  • Copie du code du serveur d’application Vitis
  • Installation du PHP
  • Configuration du serveur HTTPS Apache
  • Création de la base de données dans PostgreSQL
  • Création d’un compte administrateur dans PostgreSQL

Exécutez le script install.cmd ou install.sh pour lancer l’installation.
Sur Windows, il faut attendre une minute environ pour avoir un retour dans la console.

Un rapport d’installation install_report_dd-mm-yyyy.txt est généré, il permet de savoir si l’installation s’est déroulée correctement.

Pour Ubuntu 14

Il faudra exécuter avec un compte administrateur le fichier Ubuntu14/before-install_ubuntu14.sh avant ou après installation.

4. Configuration de PostgreSQL

Il est nécessaire de configurer le serveur PostgreSQL pour permettre à l’application d’accéder à la base de données.
La procédure ci-dessous s’applique si le serveur PostgreSQL est sur la même machine que vMap. Si ce n’est pas le cas, il faut prévoir une configuration spécifique.

  1.     Editez le fichier pg_hba.conf de PostgreSQL
    Immédiatement après « # IPv4 local connections » insérez la ligne :
    host vmapdatabase u_vitis 127.0.0.1/32 trust
    Immédiatement après « # IPv6 local connections » insérez la ligne :
    host vmapdatabase u_vitis ::1/128 trust
    Où vmapdatabase est la base de données que vous venez de créer (vmap par defaut).
  2.     Redémarrez le service PostgreSQL

5. Premiers pas

Votre instance de vMap doit être disponible à l’adresse :
https://<serveur>/vmap

Où <serveur> est l’adresse de la machine où vous avez installé l’application.
Attention ! La connexion à vMap par l’adresse localhost est impossible
Note : si vous vous connectez avec le protocole http, la connexion sera automatiquement redirigée vers https.

Si vous avez créé vous-même votre propre certificat, votre serveur n’est pas sécurisé et votre navigateur va sans doute afficher un message d’alerte.

Erreur HTTPS

Vous devrez créer une exception de sécurité dans votre navigateur avant de pouvoir accéder à votre site.

Si vous utilisez un certificat valide ou si vous avez créé une exception de sécurité, vous devez arriver à la page de connexion :
Login vMap

Vous pouvez vous connecter en utilisant le compte et le mot de passe définis pendant l’installation.

La première chose à faire après la connexion est de vous attribuer des privilèges pour vous permettre d’exploiter toutes les fonctions d’administration et d’utilisation de vMap.

Cliquez sur l’icône
vmap_utilisateurspour passer en mode « Gestion des utilisateurs », choisissez l’onglet « Utilisateurs » (activé par défaut) et éditez votre compte.

  • Attribuez les privilèges : vmap_admin, vm4ms_admin et vmap_user à l’utilisateur
  • Attribuez le groupe demo à l’utilisateur

Privilèges utilisateurs

Vous disposez maintenant de tous les droits pour administrer et utiliser vMap. Reconnectez-vous pour accéder aux nouvelles fonctionnalités.

Si vous avez créé vous-même votre propre certificat, cliquez sur l’icône
mode_configpour passer en mode « Configuration », puis désactivez l’option « Vérifier la validité du certificat SSL »

Enfin, cliquez sur l’icône
mode_mapserverpour passer en mode « Maperver », choisissez l’onglet « Flux WMS publics », éditez le flux « FluxPublic » puis cliquez sur « Mettre à jour ». Cela va publier votre flux WMS.

Reconnectez-vous pour accéder à la carte de démonstration.
Tous les modes sont désormais accessibles : vMap, Cartes, Développement, Modules, Impressions..

A vous de jouer maintenant !