Installation

publicité
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
Téléchargement