Comment Installer Mapfish

>> Document officiel “HowTo Install” non traduit disponible ici

Note : Je viens de m’apercevoir que la page vient de changer et qu’une nouvelle version (v0.2) est maintenant disponible en yeah le seul hic c’est que je dois retraduire cette page. Pas Grave mais du coup cette traduction est à revoir.

Instructions d’installation

MapFish est un framework qui permet d’interagir avec des cartes. La première question que vous devez vous poser est de déterminer quelle partie du framework vous intéresse, et de quelle technologie vous voulez ou avez l’intention d’utiliser dans votre application.

Uniquement le côté Client

Si vous n’avez pas besoin de déployer des services côté serveur, il vous suffit d’utiliser la partie client du framework. C’est la façon la plus simple d’installer MapFish, car il vous suffit d’extraire l’archive dans un répertoire accessible à partir de votre serveur Web, et de modifier certaines balises HTML et/ou Javascript.

Télécharger l’archive MapFish-xy.tar.gz à partir de la page de téléchargement. Puis extraire son contenu, et rendre le répertoire client/mfbase disponible pour votre serveur Web.

Les composants côté serveur

Le framework MapFish prévoit des bibliothèques qui peuvent être utilisés coté serveur à partir de plusieurs langages. Dans les premières versions, seuls les modules Python sont disponibles. En utilisant ou en étendant ces services, vous pouvez faire face aux deux scénarios suivants :

1. Vous voulez intégrer ces services dans votre projet. Dans ce cas, vous devez appliquer la colle entre votre application Web et la bibliothèque du serveur MapFish.
2. Vous voulez utiliser ces services dans un standalone. Dans ce cas, MapFish fournit un module tiers qui s’appuie sur Pylons, un framework Python pour le Web, afin d’offrir un cadre existant où l’on peut déployer et étendre les services d’un serveur existant.

Les instructions ci-dessous indiquent comment mettre en place ce module tiers.

Mise en place du module MapFishSample

Parce que ce module utilise le framework Pylons, vous pouvez vous référer aux instructions fournies sur la page d’accueil de Pylons (en Anglais). Toutefois, les instructions ci-dessous devraient être suffisantes pour installer le framework et les modules nécessaires.

Les instructions pour Unix (Linux, OS X, …)

Installation d’un environnement virtuel Python

Installer les paquets gcc, libc6-dev, libpq-dev, python, python-dev et libgeos-dev.

Pour Debian tapez dans un terminal :

apt-get install gcc libc6-dev libpq-dev python python-dev libgeos-dev

Installez les outils d’installation s’ils ne sont pas déjà installés :

cd /tmp
wget http://peak.telecommunity.com/dist/ez_setup.py
python ez_setup.py

Installer virtualenv :

easy_install virtualenv

Maintenant vous pouvez créer votre environnement virtuel python (avec votre identifiant) :

cd /chemin/vers/le/lieu/souhaité/
virtualenv vpython

Il est maintenant temps d’installer l’archive egg de MapFish et ses dépendances. Deux choix sont possibles :

• soit installer le fichier egg précompilé de MapFish situé sur http://dev.camptocamp.com/packages/eggs/,
• soit installer un fichier egg MapFish construit à partir des sources.

Installation du fichier egg précompilé de MapFish

cd vpython
bin/easy_install Pylons
bin/easy_install psycopg2
bin/easy_install -f http://dev.camptocamp.com/packages/eggs/ MapFish

Vous pouvez aller directement au démarrage du serveur Pylons.

Construction et installation de MapFish à partir des sources

cd /chemin/vers/le/lieu/souhaité/
svn co http://www.mapfish.org/svn/mapfish/trunk/MapFish
cd server/python
/chemin/vers/vpython/bin/python setup.py install

Démarrage du serveur

Vous pouvez obtenir le module MapFishSample sur la page de téléchargement.

Ensuite, vous devez extraire cette archive quelque part. Dans l’instruction suivante, ce chemin est appelé /chemin/vers/mapfishsample/MapFishSample.

Vous aurez aussi besoin de télécharger et extraire l’archive MapFish à un autre endroit.

Editer le fichier de configuration Pylons (qui se trouve dans /chemin/vers/mapfishsample/MapFishSample/development.ini), vous devez modifier la variable document_root de votre chemin d’installation MapFish/client/mfbase/.

En supposant que vous avez installé le fichier dans /chemin/vers/mapfish/, development.ini doit contenir :

...
[app:mfbase]
use = egg:Paste#static
# paramétrez ici le chemin vers le répertoire MapFish :
document_root = /chemin/vers/mapfish/MapFish/client/mfbase/
...
[app:examples]
use = egg:Paste#static
# Paramétrez ici le chmein vers les exemples de MapFish contenu dans le répertoire "client/examples" :
document_root = /chemin/vers/mapfish/MapFish/client/examples/
...

cd /chemin/vers/mapfishsample/MapFishSample/
/chemin/vers/vpython/bin/paster serve development.ini

Après cela, l’application Web sera disponible à l’URL http://localhost:5000/ .

Les instructions pour Windows

Les principales étapes d’installation pour Windows sont :

Télécharger easy_install.py et à partir de l’interpréteur de commande DOS tapez :

1. Python easy_install.py Pylons
2. Python easy_install.py sqlalchemy
3. Téléchargez et installez à partir d’ici http://www.stickpeople.com/projects/python/win-psycopg/ psycopg2 (choisir le fichier en fonction de votre version de Python)
4. Téléchargement à partir du tronc : svn co http://www.mapfish.org/svn/mapfish/trunk/MapFish
5. construire le fichier egg
6. Copier le fichier egg dans votre dossier site-packages situé dans le répertoire Python (Pour Python version 2.5 le répertoire par défaut est C:\Python25)
7. Téléchargez et installez Shapely en utilisant l’installateur Windows téléchargeable sur http://pypi.python.org/pypi/Shapely

.. Maintenant, vous pouvez suivre les mêmes instructions que pour Linux afin de faire fonctionner des exemples ou créer de nouveaux projets.