Installation

Les systèmes d’exploitation suivants ont été testés fonctionnels :
  • Windows 7, 10
  • Ubuntu 16.04, 18.04

Prérequis

Python 3.x
Windows
  • Télécharger la dernière version (3.x) de Python.
  • Lancer l’exécutable
  • Cocher la case : Add Python 3.x to PATH
  • Lancer l’installation par défaut : Install Now
Linux
  • Installer la dernière version de Python 3.x avec le gestionnaire de paquets de votre distribution

  • Vérifier que la bonne version est installée:

    $ python3 --version
    
GDAL - Librairie géographique
Windows
  • Il existe de nombreuses manières d’installer GDAL. La plus simple est d’utiliser une distribution géospatiale comme OSGEO4W
Linux
  • Téléchargez et installez les binaries GDAL pour votre distribution (Exemple Ubuntu)
PostgreSQL 9.4 ou supérieure
Windows
  • Télécharger PostgreSQL (v9.4+).
  • Lancer l’exécutable et suivre l’installation avec les valeurs par défaut jusque …
  • Sélectionner un mot de passe (à retenir, important!)
  • Continuer l’installation avec les valeurs par défaut
  • Lancer « StackBuilder » à la fin de l’installation lorsqu’il le propose
  • Sélectionner la version PostgreSQL que vous avez choisie
  • Cocher Categories>Spatial Extensions>PostGIS 2.x (sélectionner la dernière version adaptée à votre installation PostgreSQL 32/64bits)
  • Terminer l’installation avec les valeurs par défaut
Linux
  • PostgreSQL est installé par défaut
PostGIS
  • La méthode d’installation peut varier selon la version de PostgreSQL et le système d’exploitation. Si StackBuilder n’a pas été exécuté, visitez _PostGIS
Environnement de développement python
  • Installer virtual environment via l’outil pip installé par défaut avec Python 3.x

    $ pip install virtualenv
    

Créer la base de données

  • Vous avez besoin de créer un superutilisateur avec mot de passe. Référez-vous à des tutoriels pour savoir comment faire précisément sur votre système d’exploitation.

  • Déclarez cette nouvelle base de données en tant que base de données géographique PostGIS

    $ psql -U <nom_superutilisateur_choisi>
    $ CREATE DATABASE haitiwater;
    $ \connect haitiwater
    $ CREATE EXTENSION postgis;
    

Installer le projet

Cloner le repository GitHub
  • Ouvrir un terminal (Windows : cmd.exe) à l’emplacement désiré pour le projet

  • Cloner le repository

    $ git clone https://github.com/AdrienHalletUCL/HaitiWater
    
  • Naviguer dans l’arborescense jusque

    ../HaitiWater/code
    
  • Créer un environnement virtuel Python (il permettra d’isoler l’installation, empêchant des conflits avec d’éventuels autres projets)

    ../HaitiWater/code $ virtualenv env
    

Configurer le projet

Configurez l’accès à la base de données dans le fichier HaitiWater/code/haitiwater/haitiwater/settings.py

DATABASES = {
  'default': {
      'ENGINE': 'django.contrib.gis.db.backends.postgis',
      'NAME': 'haitiwater',
      'HOST': 'localhost',
      'PORT': '<PORT>',
      'USER': '<SUPERUSER>',
      'PASSWORD': '<PASSWORD>',
  }
}
  • <PORT> est le numéro de port utilisé par votre serveur PostgreSQL (5432 par défaut)
  • <SUPERUSER> est le nom de superutilisateur choisi
  • <PASSWORD> est le mot de passe choisi pour le superutilisateur

Lancer le projet

En vous positionnant au chemin (dernier laissé précédemment) ../HaitiWater/code:
  • Activer l’environnement virtuel Python

    Windows

    env\Scripts\activate
    

    Linux

    $ source env/bin/activate
    
  • Naviguer jusqu’au projet

    $ cd haitiwater
    
  • Installer les dépendances

    $ pip install -r requirements.txt
    

    Note: sous Windows, il est possible que la dépendance GDAL ne puisse s’installer. Il suffit de la supprimer de la liste et de l’installer manuellement (voir ci-dessus).

  • Exporter le schéma de la base de données

    $ python3 manage.py makemigrations
    $ python3 manage.py migrate
    
  • Importer des données d’exemple (optionnel)

    $ python3 manage.py loaddata initial_data.json
    
  • Créer les tables virtuelles dans la base de données. Uutiliser l’accès à la base de données décrit dans le fichier settings.py et rentrer le mot de passe <PASSWORD> si/quand il vous est demandé.

    $ psql -p <PORT> -U <SUPERUSER> -d haitiwater -f views.sql
    
  • Lancer le serveur

    $ python3 manage.py runserver
    

    Note: sous Windows, supprimez les “/” (slash) après “static-common/images”, “static” et “static-common” aux lignes 140, 186 et 191 du fichier settings.py.