Installer ScribeUI sous Windows (fr) - smercier/scribeui GitHub Wiki

Installation Scribe Windows

ScribeUI n'est pas encore fonctionnel dans l'environnement Windows. Il sera par contre possible de l'installer à l'aide de VirtualBox et Vagrant. Cette combinaison d'outils offre ce qu'il faut pour monter un environnement jetable Virtual Machine (VM), à l'aide de quelques lignes de commandes. Vagrant est un outil qui exploite un moteur de d'ordinateur virtuel comme VirtualBox ou VMware Fusion qui simplifie concidérablement l'installation et la configuration d'un serveur virtuel sur votre ordinateur hôte.

1 Installation

La première étape sera d'installer VirtualBox, Vagrant et le client ssh MobaXtrem portable edition (fortement proposé):

NOTE: le client ssh MobaXtrem, sera utilisé pour communiquer avec le serveur virtuel via les paramètres mises en place par Vagrant. L'utilitaire Putty peut aussi être utilisé.

2 Initialisé un serveur virtuel (VM)

Par la suite, on va passer au mode terminal pour créer une instance serveur dans un répertoire spécifique de votre ordinateur:

$ ... cd\
$ mkdir vagrant
$ cd vagrant
$ mkdir data
$ vagrant box add precise32 http://files.vagrantup.com/precise32.box
$ vagrant init precise32
$ notepad Vagrantfile

L'initiation de la VM avec Vagrant, vient de créer un fichier Vagrantfile. Il me permettra de se configurer adéquatement la communication entre votre serveur virtuel et votre poste de travail hôte. Dans l'exemple suivant, le port 5555 permettra d'accéder à votre serveur Postgresql/PostGIS et serveur Web sera sur localhost au port 8080 ( http://localhost:8080). À l'aide du répertoire "data" créé dans votre répertoire "vagrant" sera un répertoire d'échange. Il sera possible de transférer des fichiers entre votre serveur virtuel(/vagrant_data/data) et votre poste de travail hôte(C:\vagrant\data):

# -*- mode: ruby -*-
# vi: set ft=ruby :
 
Vagrant.configure("2") do |config|
 
# Every Vagrant virtual environment requires a box to build off of.
config.vm.box = "precise32"
 
# Create a forwarded port mapping which allows access to a specific port
# within the machine from a port on the host machine. In the example below,
# accessing "localhost:8080" will access port 80 on the guest machine.
config.vm.network :forwarded_port, guest: 5432, host: 5555
config.vm.network :forwarded_port, guest: 80, host: 8080

3 Ouvrir du serveur virtuel

Vous êtes maintenant en mesure de démarrer le serveur virtuel avec la commande vagrant up. Une fois le serveur en marche, on pourra ouvrir MobaXtrem pour se connecter sur le serveur. Il faudra configurer une connexion locale avec ces paramètres: 

Host: 127.0.0.1
Port: 2222
Username: vagrant
Private key: C:/Documents and Settings/mapgears/.vagrant.d/insecure_private_key

4 Configuration du serveur virtuel

Première chose à faire pour lors de l'installation d'un nouveau serveur est de configurer la langue en français UTF-8

export LANGUAGE=en_CA.UTF-8
export LANG=en_CA.UTF-8
export LC_ALL=en_CA.UTF-8
sudo localedef -i en_CA -f UTF-8 en_CA
sudo locale-gen en_CA.UTF-8
sudo update-locale
sudo sudo dpkg-reconfigure locales

Ensuite, faire la mise à jour du serveur avec un script VirtualBox et brancher le dépot logiciels géomatique UbuntuGIS:

sudo sh postinstall.sh
sudo apt-get update
sudo apt-get install -y binutils git vim screen make

5 Installer ScribeUI

Ne reste plus qu'à installer ScribeUI. L'installation proposée ici va installer Mapserver et les composantes requises pour ScribeUI. Les données spatiales format shapefiles Natural Earth(644Mb) seront aussi installées.

cd /opt/
sudo git clone https://github.com/mapgears/scribeui
cd scribeui
sudo make download_deps
sudo make
sudo make install
sudo make load-demo-data

Modifier le fichier de configuration d'adresse de domaine de votre installation sudo vim config.py. Dans l'éditeur faire ESC suivi de la touche i. Modifier pour ip = “127.0.0.1:8080” puis sauvegarder avec la suite de touches ESC :wq Enter. Il faudra ensuite redémarrer le serveur Apache avec sudo /etc/init.d/apache2 restart. Enfin, naviguer à l'adresse suivante sur votre ordinateur hôte pour accéder à l'utilitaire de cartographie Web : http://localhost:8080/ScribeUI/.

6 Fermeture du serveur virtuel

Dans la fenêtre terminale MobaXtrem, simplement faire la commande exit. Ceci fermera votre connexion ssh entre votre serveur virtuel et votre hôte. Par la suite, dans la fenêtre terminale de votre ordinateur hôte, faire vagrant halt.

7 Installations complémentaires

Pour aller plus loin dans l'installation de composantes logiciels utilent pour votre instance serveur, considérer utiliser ce script init.sh qui automatise le processus. Vous pouvez faire cette étape avant ou après l'installation de ScribeUI. Ce script installera entre autres:

  • Postgresl 9.1 /PostGIS 2
  • Mapcache et TinyOWS
  • imposm 2
  • osm2pgsql
  • osmconvert
  • osmosis