Institut Géographique National Laboratoire COGIT GeOxygene : installation pas à pas - sous environnement Windows version 1.0 Date de la dernière modification 21 novembre 2008 Rédacteur Eric Grosso – IGN / Laboratoire COGIT Diffusion Libre Contenu du document Ce document a pour objectif de guider un utilisateur dans l’installation de GeOxygene, y compris les composants logiciels nécessaires à son fonctionnement (Java, PostgreSQL, PostGIS , pgAdmin, Eclipse). Installation pas à pas de GeOxygene p.1/36 IGN / COGIT Table des matières 1. PREREQUIS................................................................................................................................... 3 2. INSTALLATION DE JAVA............................................................................................................. 3 3. INSTALLATION DE POSTGRESQL ET DE POSTGIS................................................................. 4 A. B. C. D. E. F. G. H. I. J. K. L. CHOIX DE LA LANGUE .................................................................................................................... 4 FERMETURE DES APPLICATIONS..................................................................................................... 4 NOTES D’INSTALLATION ................................................................................................................. 5 OPTIONS D’INSTALLATION .............................................................................................................. 6 CONFIGURATION DU SERVICE ........................................................................................................ 6 INITIALISATION DU GROUPE DE BASES DE DONNEES......................................................................... 8 ACTIVATION DES LANGAGES DE PROCEDURE .................................................................................. 9 ACTIVATION DES MODULES DE CONTRIBUTION .............................................................................. 10 FIN DE L’INSTALLATION ................................................................................................................ 11 INSTALLATION DE POSTGIS......................................................................................................... 11 CONFIGURATION DES VARIABLES D’ENVIRONNEMENT .................................................................... 18 CREATION D’UNE BASE DE DONNEES SPATIALES ........................................................................... 19 4. INSTALLATION D’ECLIPSE ....................................................................................................... 22 5. RECUPERATION DU CODE SOURCE DE GEOXYGENE......................................................... 22 6. CONFIGURATION DE GEOXYGENE SOUS ECLIPSE.............................................................. 22 A. B. C. D. 7. CREATION D’UN WORKSPACE POUR ECLIPSE ................................................................................ 22 CREATION D’UN PROJET JAVA ...................................................................................................... 23 INTEGRATION DE GEOXYGENE DANS LE PROJET JAVA CREE .......................................................... 24 CONFIGURATION DES FICHIERS DE MAPPING (RELATIFS A OJB) ..................................................... 29 CHARGEMENT DE DONNEES AU FORMAT SHAPEFILE SOUS POSTGRESQL-POSTGIS 33 A. B. C. RECUPERATION DES DONNEES GEOFLA® .................................................................................. 33 CHARGEMENT DES DONNEES DANS LA BASE ................................................................................. 34 VISUALISATION DES RESULTATS DU CHARGEMENT ........................................................................ 36 Installation pas à pas de GeOxygene p.2/36 IGN / COGIT 1. Prérequis Pour réaliser cette installation, vous devez disposer : - des droits d’administrateur de votre machine pour installer Java, PostgreSQL et PostGIS, - d’une connection Internet. Afin de mieux appréhender et utiliser les différents outils logiciels utiles au développement sous un environnement GeOxygene, il vous est possible de vous référer aux documentations de ces outils. Dans l’objectif de vous guider dans cette démarche, nous vous proposons quelques possibles liens de documentation : Java : - Documentation officielle : http://java.sun.com/reference/docs/ http://java.sun.com/javase/reference/index.jsp - Autre documentation : http://jmdoudoux.developpez.com/cours/developpons/java/ PostgreSQL / PostGIS : - Documentation officielle : http://www.postgresql.org/docs/ (anglais) http://docs.postgresqlfr.org/ (française) http://postgis.refractions.net/documentation/ - (anglais) Autre documentation : http://www.davidgis.fr/documentation/win32/html/index.html Eclipse : - Documentation officielle : http://www.eclipse.org/documentation/ http://help.eclipse.org/ganymede/index.jsp - Autre documentation : http://www.jmdoudoux.fr/java/dejae/indexavecframes.htm http://www.eclipsetotale.com/ 2. Installation de JAVA L’environnement JAVA utilisé ici est l’environnement standard Java SE Development Kit (JDK) 6 Update 10 (JDK 1.6.0_u10). Cette version est testée compatible avec GeOxygene R1.3. Il est possible de télécharger cet environnement sur le site de Sun à l’adresse : http://java.sun.com/javase/downloads/index.jsp L’utilisateur est toutefois libre de télécharger toute autre version du JDK (autre update). Une fois le fichier exécutable téléchargé (a priori il porte le nom « jdk-6u10-windowsi586-p.exe »), exécuter le fichier en double cliquant sur ce dernier et suivre les instructions (cliquer sur « Suivant »), en acceptant les paramétrages proposés par défaut. Installation pas à pas de GeOxygene p.3/36 IGN / COGIT 3. Installation de PostgreSQL et de PostGIS La version de PostgreSQL que nous utilisons ici est la version 8.3.5-1. Cette version est testée compatible avec la release 1.3 de GeOxygene. Il est possible de télécharger cet environnement sur le site de PostgreSQL à l’adresse : http://www.postgresql.org/download/windows dans la catégorie « pgInstaller » ou directement à l’adresse : http://www.postgresql.org/ftp/binary/v8.3.5/win32/ Une fois le fichier téléchargé (a priori il porte le nom « postgresql-8.3.5-1.zip »), décompresser le dans le répertoire de votre choix puis double cliquer sur le fichier d’installation « postgresql-8.3.msi » (vous devez avoir les droits d’administration). Suivre ensuite les instructions proposées pour chaque section proposée ci-dessous. a. Choix de la langue Choisir la langue française en cochant « French / Français ». Cocher la case « Write detailed installation log to postgresql-8.3.log in the current directory » tel qu’illustré sur la figure 1. Cliquer sur « Start > ». Figure 1. Choix de la langue b. Fermeture des applications Il est conseillé de fermer l’ensemble des applications avant d’installer PostgreSQL, comme proposé par l’interface (figure 2). Installation pas à pas de GeOxygene p.4/36 IGN / COGIT Cliquer sur « Suivant > ». Figure 2. Fermeture des applications c. Notes d’installation Il est conseillé de lire les notes d’installation proposées (figure 3). Cliquer sur « Suivant > ». Figure 3. Notes d’installation Installation pas à pas de GeOxygene p.5/36 IGN / COGIT d. Options d’installation Cliquer (clic gauche de la souris) sur le disque à gauche de PostgreSQL (figure 4) et sélectionner « La fonctionnalité complète sera installée sur le disque dur local ». Cliquer sur « Parcourir » et utiliser le répertoire « C:\PostgreSQL\8.3\ » comme répertoire d’installation. Par défaut le répertoire d’installation proposé est « C:\Program Files\PostgreSQL\8.3\ » (ce répertoire par défaut pose parfois problème en raison de l’espace entre Program et Files). Cliquer sur « Suivant > ». Figure 4. Options d’installation e. Configuration du service Remarques préalables : - L’installation de PostgreSQL en tant que Service lancera automatiquement PostgreSQL à chaque démarrage. Il est toutefois possible a posteriori de changer cette option. Pour ce faire, désactivez le service au démarrage dans l’interface « Panneau de configuration – Outils d'administration – Services ». - Depuis la version 8.x, il est impossible que le compte du service soit membre du groupe « Administrateurs » de l’ordinateur. Ainsi, l’interface d’installation propose par défaut que ce compte soit « postgres ». Conserver le nom de ce compte (figure 5). Installation pas à pas de GeOxygene p.6/36 IGN / COGIT Configurer PostgreSQL en tant que service. Entrer un mot de passe. Choisir le mot de passe « postgres » dans un premier temps, pour des raisons de commodité. Quand vous serez habitué à manipuler PostgreSQL, vous pourrez choisir un mot de passe plus complexe. Cliquer sur « Suivant > ». Figure 5. Configuration du service Accepter que le compte « postgres » soit créé sur votre machine. Cliquer sur « Oui ». Figure 6. Erreur de compte Refuser qu’un mot de passe plus complexe soit généré automatiquement. Cliquer sur « Non ». Figure 7. Mot de passe faible Installation pas à pas de GeOxygene p.7/36 IGN / COGIT f. Initialisation du groupe de bases de données L’initialisation du groupe de bases de données permet tout d’abord de configurer le numéro de port via lequel il sera possible d’accéder aux bases PostgreSQL. Le port généralement consacré à l’application PostgreSQL est le port 5432. Laisser ce port par défaut. Pour cette installation, laisser décochée l’option « Accepte les connexions sur toutes les adresses, pas seulement localhost » pour raison de sécurité. Ainsi votre serveur PostgreSQL ne sera configuré que pour fonctionner de manière locale sur votre machine. Configurer à présent les différents systèmes d’encodage. Choisir la locale « C », l’encodage côté serveur en « UTF8 » et l’encodage côté client en « LATIN9 » (figure 8). Le choix de « LATIN9 » est celui qui permet le mieux d’encoder les différents symboles présents dans la langue française. Cet encodage (correspondant à l’encodage ISO-8859-15) vient en effet compléter l’encodage LATIN1 (correspondant à l’encodage ISO-8859-1), encodage associé aux langues d’Europe de l’Ouest dont le français, en y ajoutant les caractères suivants : €, Š, š, Ž, ž, Œ, œ et Ÿ. Pour plus de détails, se reporter à la description fournie par Wikipédia (http://fr.wikipedia.org/wiki/ISO_8859-15). Spécifier le superutilisateur comme étant « postgres ». Utiliser le mot de passe défini précédemment, à savoir « postgres », malgré les recommandations de sécurité indiquant le contraire dans l’interface. Figure 8. Initialisation du groupe de base de données Installation pas à pas de GeOxygene p.8/36 IGN / COGIT Remarque sur la locale d’encodage : L’idéal, pour une configuration en langue française optimale, aurait été de choisir la locale « French, France » et les encodages, côté serveur et côté client, en « LATIN9 ». Or cette configuration n’est pas autorisée, malgré les spécifications de PostgreSQL qui normalement la tolère, comme indiqué à l’adresse : http://docs.postgresqlfr.org/8.3/multibyte.html. Figure 9. Initialisations du groupe de base de données incorrectes g. Activation des langages de procédure Cocher la case relative au langage PL/pgsql. Cliquer sur « Suivant > ». Figure 10. Activation des langages de procédures Installation pas à pas de GeOxygene p.9/36 IGN / COGIT h. Activation des modules de contribution Activer les modules souhaités. A priori, seul le module « Adminpack » suffit. Pour éviter toute possible manipulation en ligne de commande plus tard, en cas de besoin d’ajout de nouveau(x) module(s), choisir l’activation de tous les modules disponibles (figure 11). Cliquer sur « Suivant > ». Figure 11. Activation des modules de contribution PostgreSQL est maintenant prêt à être installé. Cliquer sur « Suivant > » pour installer. Figure 12. Prêt à installer Installation pas à pas de GeOxygene p.10/36 IGN / COGIT i. Fin de l’installation L’installation de PostgreSQL est maintenant terminée à l’exception de la configuration des variables d’environnement (voir la Configuration des variables d’environnement). L’installation de PostgreSQL a également installé pgAdmin III, interface de gestion des bases de données PostgreSQL. Cocher « Exécuter Stack Buider à la fin » puis cliquer sur « Terminer ». Figure 13. Installation de PostgreSQL terminée j. Installation de PostGIS Stack Builder, fourni avec l’installeur de PostgreSQL choisi, permet d’installer PostGIS à la suite de l’installation de PostgreSQL. Pour ce faire, sélectionner « PostgreSQL Database Server 8.3 sur le port 5432 » (figure 14). Installation pas à pas de GeOxygene p.11/36 IGN / COGIT Figure 14. Bienvenue dans Stack Builder A ne faire que si vous utilisez un serveur proxy : Cliquer sur « Serveurs proxy ». Configurer les serveurs proxy HTTP et FTP comme illustré à la figure 15, en changeant les valeurs du proxy telles qu’elles vous sont propres. Attention, renseigner de la forme « proxy.entreprise.fr » et non « http://proxy.entreprise.fr ». Cliquer sur « Accepter » puis sur « Suivant > ». Figure 15. Configuration des serveurs proxy Installation pas à pas de GeOxygene p.12/36 IGN / COGIT Sélectionner « PostGIS 1.3.3 for PostgreSQL 8.3 v1.3.3 » dans Catégories / Spatial Extensions. Cliquer sur « Suivant > ». Figure 16. Sélection d’applications Sélectionner un des miroirs de téléchargement qui vous est proposé, par exemple « ftp.fr.postgresql.org (FTP) ». Cliquer sur « Suivant > ». Figure 17. Sélection d’un miroir de téléchargement Installation pas à pas de GeOxygene p.13/36 IGN / COGIT Cliquer sur « Suivant > ». Figure 18. Vérification des sélections Cliquer sur « Suivant > ». Figure 19. Débuter les installations Installation pas à pas de GeOxygene p.14/36 IGN / COGIT Cliquer sur « I Agree » pour accepter la licence GNU-GPL de PostGIS. Figure 20. Acceptation de la licence GPL Cliquer sur « Next > ». Figure 21. Choix des composants Installation pas à pas de GeOxygene p.15/36 IGN / COGIT Cliquer sur « Next > ». Figure 22. Choix du répertoire d’installation Renseigner le mot de passe utilisé pour l’utilisateur postgres (a priori « postgres »). Cliquer sur « Next > ». Figure 23. Paramètres de connexion à la base de données Installation pas à pas de GeOxygene p.16/36 IGN / COGIT Renseigner le nom de la base de données PostGIS qui sera créée à titre d’exemple (e.g. postgis). Cliquer sur « Install ». Figure 24. Choix du nom de la base spatiale à créer L’installation de PostGIS est maintenant terminée. Cliquer sur « Close » pour terminer. Figure 25. Installation terminée Installation pas à pas de GeOxygene p.17/36 IGN / COGIT Cliquer sur « Finir » pour terminer l’ensemble des installations relatives à PostgreSQL/PostGIS. Figure 26. Installation de PostgreSQL/PostGIS terminée k. Configuration des variables d’environnement Afin de pouvoir utiliser les différentes fonctionnalités liées à PostgreSQL, dans l’invite de commandes par exemple, il est nécessaire de configurer les variables d’environnement. Pour ce faire, ouvrir l’interface liée aux variables d’environnement en cliquant (clic droit) sur le « Poste de travail » puis sélectionner « Propriétés » (vous pouvez également ouvrir cet environnement par le menu « démarrer – Panneau de configuration – Système »). Une fois l’interface ouverte (figure 27) sélectionner l’onglet « Avancé » puis « Variables d’environnement ». Ajouter les variables système suivantes (cliquer sur Nouveau dans les Variables système) : - PGHOME avec la valeur « C:\PostgreSQL\8.3 » - PGDATA avec la valeur « C:\PostgreSQL\8.3\data » - PGHOST avec la valeur « localhost » - PGPORT avec la valeur « 5432 » Modifier également la variable système « Path » en ajoutant les deux chemins d’accès suivants (cliquer sur la variable système « Path » puis sur « Modifier ») : - C:\PostgreSQL\8.3\bin; - C:\PostgreSQL\8.3\lib; Installation pas à pas de GeOxygene p.18/36 IGN / COGIT Figure 27. Configuration des variables d’environnement l. Création d’une base de données spatiales La base de données que nous utiliserons par la suite sera appelée « geoxygene ». Pour la créer, utiliser l’outil de gestion pgAdmin fourni avec PostgreSQL. Pour lancer cet outil, cliquer sur « démarrer » puis « Programmes » puis « PostgreSQL 8.3 » et enfin sur « pgAdmin III ». Double cliquer sur « PostgreSQL Database Server 8.3 (localhost:5432) » et renseigner le mot de passe pour se connecter au serveur. Ici, « postgres ». Figure 28. Connexion au serveur Installation pas à pas de GeOxygene p.19/36 IGN / COGIT Ajouter une nouvelle base de données comme illustré figure 29. Figure 29. Ajouter une base de données Configurer cette nouvelle base avec les paramètres décrits ci-dessous (figure 30). Utiliser le « Modèle » « template_postgis » permet à cette base de bénéficier des fonctionnalités spatiales relatives à PostGIS. Figure 30. Ajouter une base de données Installation pas à pas de GeOxygene p.20/36 IGN / COGIT Visualiser le résultat de cette création sous pgAdmin comme illustré figure 31. Figure 31. Visualiser la base créée Installation pas à pas de GeOxygene p.21/36 IGN / COGIT 4. Installation d’Eclipse Eclipse est l’environnement de développement intégré que nous utilisons pour travailler avec GeOxygene. La version d’Eclipse que nous utilisons ici est la version Ganymede (version 3.4). Cette version est testée compatible avec la release 1.3 de GeOxygene. Il est possible de télécharger cet environnement sur le site d’Eclipse à l’adresse http://www.eclipse.org/downloads/, en choisissant « Eclipse IDE for Java Developers ». Une fois le fichier téléchargé (a priori il porte le nom « eclipse-java-ganymede-SR1win32.zip »), décompresser le dans le répertoire « C:\Program Files\eclipse ». Créer au besoin un raccourci d’Eclipse sur votre bureau (raccourci pour le fichier « C:\Program Files\eclipse\eclipse.exe »). 5. Récupération du code source de GeOxygene Télécharger les sources du projet GeOxygene à l’adresse suivante : http://sourceforge.net/project/showfiles.php?group_id=128892 Télécharger le fichier « geoxygene-1.3-src.zip ». 6. Configuration de GeOxygene sous Eclipse a. Création d’un workspace pour Eclipse Créer un répertoire « workspace » dans votre répertoire utilisateur (e.g. « C:\user\ »). ATTENTION : Le chemin de ce répertoire ne doit pas comporter d’espace. Lancer Eclipse et choisir le répertoire créé précédemment pour définir votre workspace, à savoir « C:\user\workspace ». Cocher la case « Use this as the default and do not ask again ». Figure 32. Choix du répertoire de travail Installation pas à pas de GeOxygene p.22/36 IGN / COGIT b. Création d’un projet Java Créer un nouveau projet Java sous Eclipse. Pour ce faire, cliquer soit dans le menu « File » puis sur « New » et enfin sur « Java Project », soit (clic gauche) dans la partie de l’interface appelée « Package Explorer » puis sur « New » et enfin « sur Java Project » (figure 33). Figure 33. Création d’un nouveau projet Java Choisir un nom de projet, par exemple GeOxygene, cliquer sur « Next » puis sur « Finish » (si vous êtes un utilisateur novice, conserver de préférence le nom de projet GeOxygene, ce dernier étant utilisé dans la suite de cette documentation). Figure 34. Configuration du nouveau projet Java Installation pas à pas de GeOxygene p.23/36 IGN / COGIT c. Intégration de GeOxygene dans le projet Java créé Hors Eclipse, décompresser le fichier « geoxygene-1.3-src.zip » dans votre répertoire du projet GeOxygene. Conformément au choix réaliser précédemment, décompresser dans le répertoire « C:\user\ workspace\GeOxygene ». Le résultat de cette décompression correspond à l’arborescence présentée en figure 35. Figure 35. Désarchivage de « geoxygene-1.3-src.zip » Rafraîchir le projet sous Eclipse afin qu’il prenne en compte les nouveaux fichiers décompressés (clic droit sur le projet puis « Refresh »). Figure 36. Rafraîchir un projet sous Eclipse Installation pas à pas de GeOxygene p.24/36 IGN / COGIT Le projet est maintenant importé sous Eclipse. Il reste à le configurer. Pour ce faire, cliquer (clic droit) sur le projet « GeOxygene » et sélectionner « Properties » comme illustrer en figure 37. Figure 37. Accéder aux propriétés d’un projet Sélectionner « Java Build Path ». Dans l’onglet « Source », cliquer sur « Add Folder… ». Figure 38. Configurer les sources d’un projet Installation pas à pas de GeOxygene p.25/36 IGN / COGIT Choisir les dossiers suivants : « src » et « data » puis cliquer sur « OK ». Figure 39. Configurer les sources d’un projet Le résultat doit être tel que l’illustre la figure 40. Figure 40. Configurer les sources d’un projet Installation pas à pas de GeOxygene p.26/36 IGN / COGIT Dans l’onglet « Libraries », cliquer sur « Add JARs… », sélectionner toutes les librairies présentes dans « GeOxygene/lib » puis cliquer sur « OK ». Figure 41. Configurer les librairies d’un projet Cliquer sur « OK » pour revenir au projet. Choisir l’option de présentation des packages de manière hiérarchique « Hierarchical » comme illustré ci-dessous (accéder au menu en cliquant sur la flèche descendante entourée par le rectangle rouge). Figure 42. Configurer la présentation des sources d’un projet Installation pas à pas de GeOxygene p.27/36 IGN / COGIT Remarque : Une partie du projet ne compile pas, faute de ne pas trouver la bibliothèque relative à Oracle (sdoapi.zip), non distribuée car sous licence propriétaire. Ajouter cette bibliothèque si vous la possédez, sinon il vous est possible de supprimer cette partie du code comme indiqué ci-dessous. Figure 43. Optionnel : Supprimer le code relatif à Oracle Installation pas à pas de GeOxygene p.28/36 IGN / COGIT d. Configuration des fichiers de mapping (relatifs à OJB) Créer sous Eclipse un nouveau dossier (folder) « user » (ou nommer ce dossier avec votre prénom – sans accent ni espace –) dans le dossier « mapping/ojb1». Figure 44. Création d’un nouveau dossier pour les fichiers de mapping Copier les fichiers « repository.dtd », « repository.xml », « repository_internal.xml », « repository_database.xml », « repository_dataset.xml » et « repository_dico.xml » contenus dans le dossier « mapping/ojb1/common » dans le dossier «mapping/ojb1/user », comme illustré ci-dessous. Figure 45. Copie des fichiers de mapping dans le dossier « user » Installation pas à pas de GeOxygene p.29/36 IGN / COGIT A chaque lancement d’application propre à GeOxygene nécessitant une connexion à une base de données spatiales (PostGIS, Oracle Spatial), le fichier OJB.properties est chargé. Ce fichier se trouve à la racine des codes sources de GeOxygene, dans le répertoire « src » (cf.figure 46). Figure 46. Configuration du fichier OJB.properties Deux variables importantes sont à considérer dans ce fichier, « repositoryFile » et « ImplicitLocking ». La variable « repositoryFile », permet de définir le chemin du principal fichier de mapping, «repository.xml » (figures 45 et 46). et de charger ainsi les différents fichiers de mapping vers lequel il pointe, comme par exemple le fichier « repository_database.xml » qui permet de configurer la connexion à une base de données. Avec la configuration telle que définie dans cette documentation, le fichier de mapping « repository.xml » relatif à « user » est situé dans « C:\user\workspace\GeOxygene\mapping\ojb1\user\repository.xml ». Il faut donc définir la variable « repositoryFile » de la manière suivante (figure 46) : repositoryFile=C:/user/workspace/GeOxygene/mapping/ojb1/user/repository.xml Figure 47. Paramétrage de la variable ImplicitLocking du fichier OJB.properties Installation pas à pas de GeOxygene p.30/36 IGN / COGIT La variable « ImplicitLocking » définit la possibilité ou non d’activer le verrouillage du Système de Gestion de Base de Données utilisé. Sa valeur par défaut est « false ». Il faut lui affecter la valeur « true » si l’on souhaite écrire dans la base (figure 47) : ImplicitLocking = true Editer maintenant le fichier « repository_database.xml » du dossier « mapping\ojb1\user\ » pour que celui-ci corresponde à la base de données « geoxygene » créée précédemment (voir la Création d’une base de données spatiales). Pour ce faire, utiliser l’option « Text Editor » tel que présenté figure 48. Figure 48. Edition de fichier XML Configurer le en éditant son contenu de la manière suivante : <!-- DEFINIR ICI LES PARAMETRES DE CONNECTION AU SGBD --> <jdbc-connection-descriptor jcd-alias="postgis" default-connection="true" platform="PostgreSQL" jdbc-level="4.0" driver="org.postgresql.Driver" protocol="jdbc" subprotocol="postgresql" dbalias="//localhost:5432/geoxygene" username="postgres" password="postgres" eager-release="false" batch-mode="true" useAutoCommit="2" ignoreAutoCommitExceptions="false" > <connection-pool maxActive="21" validationQuery="" /> <sequence-manager className="org.apache.ojb.broker.util.sequence.SequenceManagerInMemoryImpl" /> </jdbc-connection-descriptor> Installation pas à pas de GeOxygene p.31/36 IGN / COGIT <jdbc-connection-descriptor jcd-alias="ORACLE_ALIAS" default-connection="false" platform="Oracle9i" jdbc-level="2.0" driver="oracle.jdbc.driver.OracleDriver" protocol="jdbc" subprotocol="oracle" dbalias="thin:@HOSTNAME:1521:SID" username="USERNAME" password="PASSWORD" eager-release="false" batch-mode="true" useAutoCommit="2" ignoreAutoCommitExceptions="false" > <connection-pool maxActive="21" validationQuery="" /> <sequence-manager className="org.apache.ojb.broker.util.sequence.SequenceManagerInMemoryImpl" /> </jdbc-connection-descriptor> GeOxygene est maintenant configuré. Installation pas à pas de GeOxygene p.32/36 IGN / COGIT 7. Chargement de données au format Shapefile sous PostgreSQL-PostGIS Pour cet exemple de chargement de données, nous utilisons les données GEOFLA® fournies par l’Institut Géographique National (http://www.ign.fr). a. Récupération des données GEOFLA® Pour récupérer ces données, aller à l’adresse suivante : http://professionnels.ign.fr/ Sélectionner le produit GEOFLA® (figure 49). Figure 49. Récupération des données GEOFLA® Télécharger le fichier GéoFLA® Départements au format Shapefile avec un système de projection des données Lambert 93 (zip de 490Ko). Lien pour télécharger directement le fichier (lien valide à la date du 20 novembre 2008) : http://professionnels.ign.fr/DISPLAY/000/526/742/5267422/GEOFLA-dep-L93-SF.ZIP Une fois le fichier téléchargé, décompresser son contenu dans le répertoire « C:\user\donnees\GEOFLA-dep-L93-SF\ ». Installation pas à pas de GeOxygene p.33/36 IGN / COGIT b. Chargement des données dans la base Les fonction permettant de charger des données au format ESRI Shapefile dans une base de données PostGIS sont les fonctions « shp2pgsql » et « psql » dont les options sont les suivantes (figures 50 et 51). Figure 50. Paramètres de la fonction psql Au regard des paramètres des fonctions shp2pgsql (figure 51) et psql (figure 50), la syntaxe de la commande permettant de charger un fichier shape dans une base de données PostGIS est la suivante : shp2pgsql -D -I shapefile nom_table | psql nom_base_donnees nom_utilisateur Installation pas à pas de GeOxygene p.34/36 IGN / COGIT Les données relatives aux départements correspondent au fichier « dep_france_dom.shp » du répertoire « C:\user\donnees\GEOFLA-dep-L93-SF\ ». Pour charger ces données, il faut donc utiliser la commande suivante dans un « Invite de commandes » : shp2pgsql -D -I C:\user\donnees\GEOFLA-dep-L93-SF\dep_france_dom.shp departements | psql geoxygene postgres Figure 51. Paramètres de la fonction shp2pgsql Une fois la commande exécutée, le rapport suivant apparaît : Figure 52. Rapport de chargement des données Remarque : En théorie, d’après les spécifications fournies de psql, un mot de passe devrait être demandé pour raison de sécurité (figure 51 : option « - W »). Ce n’est en pratique pas le cas. Installation pas à pas de GeOxygene p.35/36 IGN / COGIT c. Visualisation des résultats du chargement Il est possible de vérifier que la table « departements » correspondant au fichier « dep_france_dom.shp » a bien été créée. Pour ce faire, utiliser pgAdmin et visualiser les résultats comme illustré figure 53. Figure 53. Visualisation du résultat du chargement L’installation de tous les composants est maintenant terminée. Installation pas à pas de GeOxygene p.36/36 IGN / COGIT