GUIDE D INSTALLATION DE L APPLICATION GECOL SUR SERVEUR WINDOWS INTRODUCTION Le guide d installation qui va suivre va tenter d amener de la simplicité et de centraliser toutes les informations nécessaires à l installation de l application GeCol. En effet, une documentation importante existe déjà sur internet, néanmoins, celle- ci reste éparse et imprécise. Ainsi, des directives précises pour l installation sur système Windows seront énoncés successivement afin d amener l application à être fonctionnelle le plus rapidement possible. Dans un premier temps, nous allons installer la suite MS4W (MapServer For Windows) qui permet de mettre en place avec simplicité MapServer avec toutes les librairies nécessaires ainsi que l environnement permettant à MapServer de fonctionner dont notamment un serveur Apache et PHP. Il faut comprendre que MapServer permettra d implémenter notre serveur de carte géographique qui aura pour but de fournir des cartes qu importe si notre serveur Windows a un accès internet ou pas. Par la suite, nous installerons le serveur de base de données PostgreSQL nécessaire à l application GeCol. Nous verrons ensuite l installation de l application GeCol proprement dite avec la configuration de tous les composants de la pile APP (Apache PHP PostgreSQL). Notes Importantes: Toute ligne débutant avec le symbole # dans ce guide d installation vous indique qu il faut entrer la commande qui suit dans une invite de commande. En effet, n entrez surtout pas le symbole #. 1) PREREQUIS A L APPLICATION GECOL : MS4W ET POSTGRESQL 1.1 INSTALLATION DE MS4W La pile APP est essentielle à l application GeCol. Nous utiliserons MS4W qui, en plus d installer MapServer, va installer un serveur http Apache ainsi que l environnement PHP nécessaire à l exécution de l application GeCol. Nous allons guider l installation de MS4W étape par étape. Avant tout, rendons nous sur le site MapTools.org : Via votre navigateur internet préféré, téléchargez MS4W en entrant l adresse suivante dans votre barre d adresse : http://www.maptools.org/dl/ms4w/ms4w-3.0.6-setup.exe Notes : La version release de MS4W proposé en téléchargement peut évoluer. N hésitez pas à vous rendre sur maptools.org et dans la section Downloads pour télécharger la dernière version de MS4W. A l ouverture du fichier, un assistant d installation se lance. Cliquez sur I Agree :
Sélectionner Without Add- on Packages et cliquez ensuite sur Next : Gardez le dossier d installation à son chemin par défaut, c est- à- dire C:/. La suite de ce guide tiendra compte uniquement de ce chemin par défaut. Cliquez alors sur Next :
Gardez le port Apache à 80 et cliquez ensuite sur Install : Laissez l assistant télécharger et installer tous les composants nécessaires. 1.2 INSTALLATION DU SERVEUR POSTGRESQL Donc pour télécharger le package de la version 9.1 : http://www.enterprisedb.com/products-services-training/pgdownload#windows Choisissez la dernière version de PostgreSQL et la plateforme Windows utilisé (32 Bits ou 64 Bits). Dans le doute, cliquez sur : Installez le serveur de base de données en suivant l assistant d installation.
DEFINITION DU MOT DE PASSE POUR L UTILISATEUR POSTGRES: Nous allons ici modifier uniquement le mot de passe de l utilisateur postgres sur le serveur PostgreSQL car il est indispensable lorsque l application demandera à se connecter au serveur de données PostgreSQL. Les mécanismes de sécurité de PostgreSQL font que l absence de mot de passe mène systématiquement à une erreur lorsque l application souhaite se connecter au serveur de données même si, répété également, l utilisateur est créé par défaut sans mot de passe. Ceci reste inutile si, lors de l installation du serveur PostgreSQL, un mot de passe a été précisé. Pour ouvrir l invite de commande SQL du serveur PostgreSQL qui va permettre le changement de mot de passe : [DossierCourant]# psql postgres postgres Puis, dans l invite : postgres:=#alter user postgres with password postgres ; On prend postgres pour éviter les oublis. Si tout se passe correctement, on devrait avoir : ALTER ROLE Quittez la console d administration PostgreSQL en entrant : postgres:=# \q Configuration du fichier pg_hba.conf de PostgreSQL : Se mettre sur le répertoire via l explorateur Windows et Ouvrez le fichier avec votre éditeur de texte préféré :
Changer toutes les valeurs de la colonne méthode à md5 comme ceci : # TYPE DATABASE USER ADDRESS METHOD # "local" is for Unix domain socket connections only local all all md5 # IPv4 local connections: host all all 127.0.0.1/32 md5 # IPv6 local connections: host all all ::1/128 md5 Pour que ces modifications prennent effet : [DossierCourant]#pg_ctl D "C:\Program Files\ PostgreSQL\9.1\data" restart CONFIGURATION D UN ACCES A DISTANCE DU SERVEUR DE DONNEES POSTGRESQL (OPTIONNELLE) Les futurs besoins peuvent vous amener à vouloir héberger le serveur de données sur un autre serveur physique que celui de l application GeCol. Dans ce cas, le fichier postgresql.conf dans le répertoire C:\Program Files\PostgreSQL\9.2\data doit être modifié: Ouvrez le fichier avec votre éditeur préféré, décommenter la ligne listen_addresses si elle ne l est pas déjà et Remplacez localhost par * :
#- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - # CONNECTIONS AND AUTHENTICATION #- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - # - Connection Settings - listen_addresses = '*' # what IP address(es) to listen on; # comma- separated list of addresses; # defaults to 'localhost', '*' = all # (change requires restart) #port = 5432 # (change requires restart) Vous pouvez également restreindre l'accès à certaines adresses IP, à vous de les entrer en les séparant par une simple virgule. Pour une meilleure sécurité, vous pouvez également changer le port par défaut à 5432. Décommenter la ligne concernant le port et faire les changements souhaités. Redémarrer le serveur pour tenir compte des changements : [DossierCourant]#pg_ctl D "C:\Program Files\ PostgreSQL\9.1\data" restart 2) INSTALLATION DE GECOL Nous allons enfin pouvoir installer l application GeCol proprement dite. 2.1 CREATION D UN NOUVEL UTILISATEUR SUR LE SERVEUR POSTGRESQL (OPTIONNELLE) L utilisateur postgres est l utilisateur par défaut du serveur. Il est de ce fait l administrateur et le super utilisateur du serveur PostgreSQL. Vous pouvez néanmoins créer un nouvel utilisateur et l associer (le rendre propriétaire) à la base de données que nous créerons dans les lignes qui vont suivre. Néanmoins, l utilisateur postgres peut être propriétaire de la future base de données et, ainsi, le choix d un nouvel utilisateur vous est laissé. Pour la création d un nouvel utilisateur, nous devons préalablement Ouvrez l invite de commande SQL en tant qu utilisateur postgres : [DossierCourant]#psql postgres ou tout simplement en une seule ligne :
#psql postgres postgres Créons notre utilisateur : postgres=# create user nomutilisateur with password motdepasse ; où nomutilisateur est le nom choisi pour le nouvel utilisateur et motdepasse le mot de passe choisie. Si tout se passe bien : CREATE ROLE 2.2 CREATION DE LA BASE DE DONNEES Et pour créer une nouvelle base de données : postgres=# create database nombd owner=nomutilisateur; où nombd est le nom choisi pour votre nouvelle base de données (par ex : arim) et nomutilisateur est le nom d utilisateur propriétaire de la base de données à créer. Ce nom peut être postgres, l utilisateur par défaut, ou vous pouvez associer la base de données à un autre utilisateur. Pour cela, revenez à la section précédente 2.1. 2.3 CHARGEMENT DE LA BASE DE DONNEES Sortez de l invite de commande SQL avec : postgres=# \q récupérer le dossier databases sur le svn. Ne pas oubier de rajouter dans la variable d environnement ( outil système) PATH le chemin vers l éxécutable psql.exe (c:/programm Files/postgresql/9.1/bin) Pour installer la base de données souhaitée, entrez la commande dans l invite de commande : [DossierCourant]#psql -d nombd -U nomutilisateurayantpermission -f <chemin complet vers le dump.sql> où nombd désigne la base de données à alimenter (la base de données doit être au préalable créé comme précédemment - section 2.2), nomutilisateurayantpermission désigne le nom d utilisateur qui fait l opération (Bien évidemment, l utilisateur doit être autorisé à faire cette opération en étant soit propriétaire de la base de données soit super utilisateur postgres) et nomfichier.sql désigne donc le fichier contenant les instructions d installation de la base de données (instructions de création de la structure de la base de données et instructions d insertion des enregistrement). L opération est longue surtout si le fichier SQL est important. 2.4 CONFIGURATION DU SERVEUR APACHE ET DES FICHIERS RELATIFS AU LANGAGE PHP Les directives suivantes vont en majeur partie vous inviter à modifier des fichiers de configuration. Choisissez votre éditeur de texte préféré. 2.4.1 CONFIGURATION DU FICHIER PHP.INI
Ouvrez le fichier php.ini dans le répertoire C:\ms4w\Apache\cgi- bin: Vérifiez et Modifiez si besoin les valeurs suivantes : (Utiliser + pour la fonction recherche dans votre éditeur): file_uploads = On post_max_size = 50M upload_max_filesize = 50M max_input_time = -1 memory_limit = 256M 2.4.2 METTRE EN PLACE LE DOSSIER DE SOURCE Récupérer le dossier de source cake et app via SVN. Copier- coller app dans C:\ms4w\Apache\htdocs. Copier- coller cake dans C:\ms4w\Apache\htdocs. Nous désignerons le nom de ce dossier racine par <nomdossierracinesource> 2.4.3 CONFIGURATION DU FICHIER HTTPD.CONF D APACHE Décommenter l instruction suivante dans le fichier httpd.conf situé dans C:\ms4w\Apache\conf : LoadModule rewrite_module modules/mod_rewrite.so Toujours dans le fichier httpd.conf, créer un alias avec la forme suivante : Alias /arim-cirmf/ "C:/ms4w/Apache/htdocs/app/webroot/" <Directory "C:/ms4w/Apache/htdocs/app/webroot/"> Options Indexes FollowSymLinks MultiViews AllowOverride all Order allow,deny Allow from all </Directory> où <nomalias> est le nom qui sera utilisé dans l URL à entrer dans le navigateur pour accéder à GeCol. Ici c est pinssvn, le mot qui suit «alias». 2.4.4 MISE EN PLACE DU FICHIER.HTACCESS
Ce fichier, en plus de la configuration précédente, va permettre notamment au Framework Cake PHP, utilisé par l application, de fonctionner correctement et plus précisément de réécrire les URLs correctement. Copier Coller le fichier.htaccess.default en le renommant.htaccess dans le dossier C:\ms4w\Apache\htdocs\app\webroot. Y coller via votre éditeur de texte: <IfModule mod_rewrite.c> RewriteEngine On RewriteBase /<nomalias> RewriteCond %{REQUEST_FILENAME}!-d RewriteCond %{REQUEST_FILENAME}!-f RewriteRule ^(.*)$ index.php?url=$1 [QSA,L] </IfModule> où <nomalias> est le nom d alias créé dans la section 2.4.3 ( pinssvn ou gecol dans notre exemple) 2.4.5 CONFIGURATION DES FICHIERS DE CONFIGURATION DE CAKE PHP. Copiez le fichier C:\ms4w\Apache\htdocs\app/config/database.php.default et le coller dans le même répertoire en le renommant database.php (attention sous windows le suffixe.php peut etre caché une fois que vous l aurez renommer, il n apparait alors que «dabase» comme nom), verifier dans les propriétés du fichier qu il est bien un fichier php ( click droit pius «Propriétés») : Configurer la variable $default du fichier C:\ms4w\Apache\htdocs\app\config\database.php comme ce qui suit : var $default = array( 'driver' => 'postgres', 'persistent' => false, 'port' => 5432,
'host' => '<ip du serveur de BD ou localhost>', 'login' => '<user BD>', 'password' => '<password de l user de la BD>', database' => '<nom de la BD>s', 'prefix' => '', où le nom de la base de données à utiliser est <nom de la BD>, ou <ip du serveur de BD ou localhost> est soit l adresse IP du serveur PostgreSQL à distance ou soit localhost si le serveur est local, <user BD> le propriétaire ou le super utilisateur (postgres) de la base de données, <password de l user de la BD> est postgres si le propriétaire de la base est postgres sinon le mot de passe relatif à l utilisateur désigné dans le champ <user BD>. Copiez le fichier C:\ms4w\Apache\htdocs\app\config\bootstrap.php.default et le coller dans le même répertoire en le renommant bootstrap.php (attention sous windows le suffixe.php peut être caché une fois que vous l aurez renommer) Trois possibilités d affichage des menus sont possibles. Pour utiliser les menus : Spécimens Echantillons Prélèvements Collectes Conservations : Dans le fichier C:\ms4w\Apache\htdocs\app\config\bootstrap.php, décommenter configure::write('umr','cbgp') ainsi que configure::write('umr','defaut'); et commenter configure::write('umr','mivegec'); comme ce qui suit : configure::write('umr','cbgp'); //configure::write('umr','mivegec'); //configure::write('umr','defaut'); Pour utiliser les menus : Spécimens Catalogue Taxonomique, on configure de la manière suivante : //configure::write('umr','cbgp'); configure::write('umr','mivegec'); //configure::write('umr','defaut'); Pour utiliser TOUT les menus //configure::write('umr','cbgp'); //configure::write('umr','mivegec'); configure::write('umr','defaut'); Il est possible de personnaliser les menus qui s affichent ( ainsi que l aspect général du site), pour cela lire la documentation «doc_modifications_visuelles» présente dans le dossier «\docs» du svn.
Relancer le serveur apache avec le raccourci : C:\ms4w\apache- restart A ce stade, vous pouvez tester l application via un navigateur. Entrez dans la barre d adresse : http://localhost/<nomalias> où <nomalias> est le nom d alias choisi précédemment ( gecol). 3) INSTALLATION DES CARTES HORS- LIGNE Récupérer sur le svn le dossier data Copiez le contenu du répertoire data\win\ dans le répertoire C:\ms4w\. Copiez le contenu du répertoire data\map dans le répertoire C:\ms4w\. Pour n afficher que les cartes de notre serveur local de carte, Ouvrez le fichier C:\ms4w\Apache\htdocs\app\config\bootstrap.php et donnez à la variable de configuration internet la valeur non : configure::write('internet','non'); et vérifier que configure::write('mapserverlocal','oui'); 4) CORRECTIFS MESSAGES D ERREURS STRICT STANDARD Ce message est lié à une incompatibilité entre la dernière version de PHP et la version de CakePHP actuellement utilisé. Ce correctif ne sera plus valable dès lors que CakePHP aura été mis à jour. Il est à noter également que ce genre de message ne sera plus généré avec une version de CakePHP mis à jour. Voici la démarche pour ne plus avoir ces messages : Ouvrir le fichier bootstrap.php contenu dans le dossier C:\ms4w\Apache\htdocs\cake et le modifier la ligne : error_reporting(e_all & ~E_DEPRECATED); de façon à obtenir ceci : error_reporting(e_all & ~E_STRICT &~E_DEPRECATED);