Migrer des données entre des instances de GeoNode

Cet atelier montre comment migrer des couches GeoNode (en incluant les données et styles associées à GeoServer) d’une instance à l’autre.

Le tutoriel est divisé en différentes parties, chacune montrant une méthodologie différente pour effectuer la migration des données:

  1. Migration manuelle des données entre deux instances de GeoNode avec la même version

  2. Migration semi-automatique de données entre les instances de GeoNode avec la même version

  3. Migration automatique de données entre instances de GeoNode avec la même version

  4. Migration automatique des données entre instances de GeoNode avec des version différente

Avertissement

Actuellement, les méthodologies 2, 3, 4 ne sont pas encore faisable avec la version actuelle de GeoNode. Ces méthodologies seront disponibles dès que la branche de développement “GeoNode Backup & RestoreGNIP sera prête et fusionnée à la branche master.

Migration manuelle de données entre instances de GeoNode avec la même version

Cette section montre comment exporter une couche d’une instance GeoNode et l’importer vers une autre instance avec la même version.

Avant de passer aux commandes et aux opérations pour effectuer les tâches d’import / export, le tutoriel vous expliquera en détail la structure d’une couche de GeoNode.

Comme vous le savez déjà, les données physiques géospatiales, ainsi que ses feuilles de style graphiques (également connu sous le nom SLD), sont gérées par GeoServer. Chaque version de GeoNode est livrée avec une version correspondante de GeoServer et un répertoire de données GeoServer (nous verrons en détail plus tard qu’est-ce que cela signifie). Pour le moment, la chose importante à retenir est que GeoNode ne peut pas vivre sans une instance fonctionnelle de GeoServer. En conséquence, la migration des données entre deux instances de GeoNode implique aussi la migration des données géospatiales et des feuilles de style entre les instances de GeoServer connexes.

La structure d’une couche GeoNode

Nous allons analyser en profondeur la structure d’une couche GeoNode.

Préparation de l’atelier

Ce tutoriel est générique et peut être exécuté en utilisant une quelconque couche existante de GeoNode, cependant, afin de suivre exactement les mêmes instructions, veuillez s’il vous plaît exécuter ce simple exercice em premier.

Avertissement

Comme condition préalable, vous devez avoir accès à une instance GeoNode avec des droits d’administrateur.

Exercise

Ajouter une couche d’exemple à GeoNode

  1. Connectez-vous à GeoNode comme Administrator

  2. Cliquez sur le bouton Ajouter Layers de la page d’accueil, afin de passer à la page de téléchargement

    ../../_images/layer_add_layers_button.jpg

    Bouton qui permet d’ajouter des couches à GeoNode

  3. Cliquez sur le button Browse sur la page de téléchargement

    ../../_images/layer_upload_browse_button.jpg

    Button de GeoNode qui permet d’importer un fichier

  4. Sélectionnez dans le dossier gisdata/data/good/vector les 4 fichiers

    • san_andres_y_providencia_coastline.dbf
    • san_andres_y_providencia_coastline.prj
    • san_andres_y_providencia_coastline.shp
    • san_andres_y_providencia_coastline.shx
    ../../_images/layer_upload_coastline.jpg

    Button de GeoNode qui permet d’importer un fichier

  5. Cliquez sur le bouton Upload files et assurez-vous que l’opération se termine avec succès

    ../../_images/layer_upload_upload_files.jpg

    Button de GeoNode qui permet de télécharger des fichiers

Metadonnées d’une couche

Chaque ressource de GeoNode possède des métadonnées. Les métadonnées sont trés importantes dans GeoNode, elles sont utilisées par l’application pour décrire, rechercher et identifier une ressource. En tant que partie de l’instance le titre, le résumé, les régions ou les mots-clés d’une ressource font partie des métadonnées.

Dans GeoNode les métadonnées sont stockées sur la base de données d’arrière-plan comme un ensemble de champs associés à la ressource. Puis le service de catalogue utilise ces informations pour générer dynamiquement des enregistrements XML ISO conforme. Ces enregistrements peuvent être utilisés par des applications de catalogue externes, conformes aux normes soutenues par GeoNode, afin de reconnaître automatiquement et indexer les ressources disponibles sur le serveur.

La page d’information d’une couche de GeoNode utilise certains champs des métadonnées pour fournir une description immédiate de la couche.

Comme le montre la figure ci-dessous, l’onglet de GeoNode Info contient un tableau contenant des informations basiques sur la couche, comme le Titre, le Résumé, le Catégorie et d’autres.

../../_images/layer_metadata_001.jpg

Informations d’une couche GeoNode

Avertissement

Le Titre figurant sur les métadonnées de la couche n’est pas le nom de la couche réelle. Nous allons approfondir le sujet dans les sections suivantes de ce tutoriel.

Afin d’obtenir l’ensemble des métadonnées de la couche dans un format standard (généralement pas tout à fait lisible, un XML énorme et long), il est possible de cliquer sur le bouton Download Metadada sur le panneau droit. GeoNode présentera à l’utilisateur une fenêtre modale avec une liste de liens permanents aux formats XML dynamiques pris en charge.

../../_images/layer_metadata_002.jpg

Téléchargement des métadonnées d’une couche GeoNode

À titre d’exemple, si vous cliquez sur ISO, vous obtiendrez un fichier XML contenant tous les champs des métadonnées de la couche au format ISOTC211 / 19115.

../../_images/layer_metadata_003.jpg

Téléchargement des métadonnées d’une couche GeoNode au format ISOTC211 / 19115

Excercise

Modifier les métadonnées d’une couche

  1. Allez à la liste de couches de GeoNode GeoNode Layer List

    ../../_images/layer_metadata_004.jpg

    Liste des couches de GeoNode

  2. Cliquez sur une Couche afin d’aller à la page d’information de cette ressource

    ../../_images/layer_metadata_005.jpg

    Modification d’une couche GeoNode

  3. Cliquez sur le bouton Edit Layer

    ../../_images/layer_metadata_006.jpg

    Button de téléchargement des métadonnées GeoNode

  4. Cliquez sur le bouton Edit sous l’icône Metadada de la fenêtre modale

    ../../_images/layer_styles_002.jpg

    Modifications des métadonnées de GeoNode

  5. Mettre à jour au moins le Titre, le Résumé et la Catégorie et enfin cliquer sur le bouton Update

    ../../_images/layer_edit_metadata_001.jpg

    Modifications des métadonnées de GeoNode

L’exportation des métadonnées est une tâche fondamental à atteindre lors du déplacement d’une ressource d’une instance GeoNode à l’autre.

Excercise

Exporter les métadonnées de la couche au format ISOTC211 / 19115 et les enregistrer dans un fichier XML dans le système de fichiers local

  1. Allez à la liste de couches de GeoNode GeoNode Layer List

    ../../_images/layer_metadata_004.jpg

    Liste des couches de GeoNode

  2. Cliquez sur une Couche afin d’aller à la page d’information de cette ressource

    ../../_images/layer_metadata_005.jpg

    Modification d’une couche GeoNode

  3. Cliquez sur le bouton Download Metadada

    ../../_images/layer_metadata_006.jpg

    Button de téléchargement des métadonnées GeoNode

  4. Dans la fenêtre modale, cliquez avec le bouton droit de la souris sur le lien de ISO

    ../../_images/layer_metadata_007.jpg

    Téléchargement des métadonnées d’une couche GeoNode au format ISOTC211 / 19115

  5. Dans le menu contextuel, sélectionnez l’option Enregistrer le lien sous

    ../../_images/layer_metadata_008.jpg

    Lien enregistrer sous pour télécharger les métadonnées GeoNode au format XML ISOTC211 / 19115

  6. Stocker le XML dans le disque dur et notez l’emplacement pour une utilisation ultérieure

    ../../_images/layer_metadata_009.jpg

    Téléchargement des métadonnées GeoNode au format XML ISOTC211 / 19115

Feuilles de styles de couche

Chaque couche de GeoNode est associée a un style graphique ou Legend si vous voulez.

Un style est essentiellement un ensemble de règles instruisant le serveur géospatial sur la façon de créer une représentation graphique des données d’origine. L’image montrée dans la carte n’est qu’un exemple parmi l’infinité de façons possibles de représenter graphiquement les donnés stockées dans le serveur.

Il est intéressant de souligner que la visualisation des données est sensiblement différent de l’obtention des données. Une représentation de données fournit aux utilisateurs une compréhension immédiate du sens des données (ou du moins d’un sens possible), mais cela ne convient pas pour l’analyse des données ou des tâches de calcul plus sophistiquées.

La légende (ou le style), dépend exclusivement de la géométrie de la couche et, éventuellement, d’un sous-ensemble de ses attributs.

Sur GeoNode, si vous vous déplacez vers la page d’information d’une couche, vous pouvez remarquer un petit panneau Legend sur la droite représentant le style actuellement en cours d’utilisation.

../../_images/layer_styles_001.jpg

Téléchargement des métadonnées GeoNode au format XML ISOTC211 / 19115

Une couche peut avoir beaucoup de différents styles associés. Normalement, il existe un style par défaut Default Style qui montré aux utilisateurs si aucun autre style est spécifié.

Il est possible de gérer les styles associées a une couche et aussi de changer le style par défaut Default Style à partir de l’interface GeoNode.

Note

Seuls les propriétaires où les utilisateurs avec des permissions d’écriture sur la couche peuvent mettre à jour les styles.

Excercise

Panneau de gestion des styles de la couche

  1. Allez à la liste de couches de GeoNode GeoNode Layer List

    ../../_images/layer_metadata_004.jpg

    Liste des couches de GeoNode

  2. Cliquez sur une Couche afin d’aller à la page d’information de cette ressource

    ../../_images/layer_metadata_005.jpg

    Modification d’une couche GeoNode

  3. Cliquez sur le bouton Edit Layer sur le panneau droit

    ../../_images/layer_edit_button.jpg

    Button de GeoNode qui permet d’éditer une couche

  4. Cliquez sur le bouton Manage sous l’icône Styles de la fenêtre modale

    ../../_images/layer_styles_002.jpg

    Gestion des styles d’une couche GeoNode

  5. Jouer avec les styles combo boxes afin de changer le Default Style ou ajouter / supprimer plusieurs d’entre eux sans mise à jour de la couche

    ../../_images/layer_styles_003.jpg

    Paneau de gestion des styles d’une couche GeoNode

Avertissement

Ne cliquez pas sur le button Update Available Styles, sinon vous allez changer les styles de la couche actuelle.

GeoNode fournit aussi un outil simple pour l’édition du style de la couche directement à partir de l’interface web.

Note

Il est important de noter que l’éditeur de style GeoNode est très simple et ne permet pas d’éditions avancées du style. En conséquence cet outil peut ne pas fonctionner parfaitement avec des couches complexes. Plus loin dans le tutoriel, nous allons voir comment il est possible d’éditer directement le style en utilisant le format SLD natif.

Excercise

Mettre à jour le style par défaut à travers l’outil d’édition de style de GeoNode

  1. Allez à la liste de couches de GeoNode GeoNode Layer List

    ../../_images/layer_metadata_004.jpg

    Liste des couches de GeoNode

  2. Cliquez sur une Couche afin d’aller à la page d’information de cette ressource

    ../../_images/layer_metadata_005.jpg

    Modification d’une couche GeoNode

  3. Cliquez sur le bouton Edit Layer sur le panneau droit

    ../../_images/layer_edit_button.jpg

    Button de GeoNode qui permet d’éditer une couche

  4. Cliquez sur le bouton Edit sous l’icône Styles de la fenêtre modale

    ../../_images/layer_styles_002.jpg

    Édition des styles d’une couche GeoNode

  5. Vous devriez voir une petite fenêtre similaire à celle décrite ci-dessous

    ../../_images/layer_styles_004.jpg

    Éditeur des styles d’une couche GeoNode

  6. Sélectionnez la première Rule et cliquez sur le petit bouton Edit en-dessous

    ../../_images/layer_styles_006.jpg
    ../../_images/layer_styles_005.jpg

    Édition des règles des styles d’une couche GeoNode

  7. Modifiez le Nom, la Couleur et la Largeur du trait et cliquez sur enregistrer

    ../../_images/layer_styles_007.jpg

    Édition du trait des styles d’une couche GeoNode

L’outil d’édition de styles GeoNode permet de simplifier l’édition du style d’une couche en fournissant à l’utilisateur une interface graphique réduite des capacités de GeoServer.

Le style d’une couche n’est rien d’autre qu’un format XML spécial défini par l’Open Geospatial Consortium (OGC) comme Style Layer Descriptor ou SLD.

Les utilisateurs avancés peuvent modifier directement le SLD ou utiliser des outils plus avancés pour créer des styles de couche très complexes et très beaux

Pour faire ce-là, vous aurez besoin de mettre à jour la source de l’SLD directement via l’interface de GeoServer.

Excercise

Mettre à jour le style par défaut via l’interface de GeoServer

  1. Connectez-vous à GeoNode comme Administrator. Ensuite, cliquez sur le bouton d’utilisateur en haut à droite.

    ../../_images/layer_styles_008.jpg

    Administrateur GeoNode

  2. Dans le menu, cliquez sur le option GeoServer.

    ../../_images/layer_styles_009.jpg

    GeoNode Administrateur GeoServer

  3. Vous serez redirigé vers l’interface d’administration de GeoServer.

    ../../_images/layer_styles_010.jpg

    Interface d’aministration de GeoServer

  4. Sélectionnez l’option Styles dans le menu de gauche.

    ../../_images/layer_styles_011.jpg

    Administration de styles dans GeoServer

  5. Sélectionnez le nom du style dans la liste et cliquez dessus. Vous serez redirigé vers la page de l’éditeur SLD.

    ../../_images/layer_styles_012.jpg

    Editeur de styles de GeoServer

  6. Modifiez la Couleur et la Largeur de la règle XML External Border. Cliquez sur Preview Legend pour voir les changements, et quand vous êtes heureux Submit le SLD.

    ../../_images/layer_styles_013.jpg

    Editeur de styles de GeoServer

  7. Retour à GeoNode. Rechargez la couche afin de voir les changements.

    ../../_images/layer_styles_014.jpg

    Le style de la couche GeoNode a été mis à jour

Les bases de l’interface web de GeoServer

Cette section présente les concepts de base de l’interface d’administration Web (généralement abrégé “admin web”) de GeoServer.

Welcome Page

Pour la plupart des installations, GeoServer va démarrer un serveur web sous localhost associé au port 8080, accessible à l’adresse suivante

http://localhost:8080/geoserver/web

Note

Cette URL dépend de votre installation de GeoServer. Lors de l’utilisation d’une installation basée sur l’WAR, par exemple, l’URL dépendra de la configuration de votre conteneur. Dans un environnement de production GeoNode / GeoServer, GeoServer va être associé au port 80:

http://<geonode_host>/geoserver/web

Si correctement configuré, une page d’accueil s’ouvrira dans votre navigateur.

../../_images/web-admin.png

Welcome Page

La page d’accueil contient des liens vers les différents domaines de la configuration de GeoServer. Le section About GeoServer dans le menu Server fournit des liens externes vers la documentation, page principal, et bug tracker de GeoServer. La page fournit également un accès sécurisé à la console de GeoServer. Cette mesure de sécurité empêche les utilisateurs non autorisés de modifier la configuration de votre GeoServer. Le nom d’utilisateur et mot de passe par défaut sont admin et geoserver. Ceux-ci ne peuvent être modifiés que par la modification du fichier security/users.properties dans le répertoire data_directory.

../../_images/8080login.png

Connexion

Indépendamment du degré d’autorisation, le liens disponibles dans le menu d’administration donnent accès aux sections Demo et Layer Preview de la console. Le page webadmin_demos contient des liens vers différentes pages d’information, tandis que la page layerpreview fournit des données spatiales dans différents formats de sortie.

Avertissement

Dans un environnement GeoNode / GeoServer, vous devrez en premier vous identifier sur GeoNode. L’autorisation sera automatiquement utilisé par GeoServer à travers les cookies de votre navigateur.

Une fois connecté à GeoNode, allez sur la page http://<geonode_host>/geoserver/web et vous serez automatiquement connectez à GeoServer avec les mêmes droits.

Note

Dans un environnement GeoNode / GeoServer, GeoServer supporte aussi les mécanismes d’authentification FORM et BASIC (comme indiqué dans cette section). Mais cela est utile uniquement si vous avez besoin d’accéder à GeoServer depuis des applications externes ou avec un autre utilisateur / spécifique à GeoServer. Dans ce cas vous devez connaître le nom d’utilisateur et le mot de paase de l’utilisateur GeoServer.

Une fois connecté, des options supplémentaires seront présentées.

../../_images/welcome_logged_in.png

Autres options lorsque connecté

Les configurations spécifiques des services Web Coverage Service (WCS), Web Feature Service (WFS), et Web Map Service (WMS) sont aussi accessibles à partir de la page d’accueil.

Pages contenant des listes

Certaines pages de l’administration web montrent des vues contenant des liste avec des éléments qui permettent de configurer les données disponibles dans l’instance de GeoServer. La page affiche des liens vers ces éléments, et le cas échéant vers leurs éléments parents aussi. Pour faciliter le travail avec de grands ensembles d’éléments, les vues contenant des listes permettent le tri et la recherche dans tous les éléments disponibles sur la page.

Dans l’exemple ci-dessous, la page de couches de GeoServer affiche une liste des couches disponibles avec des liens vers leurs parents: la source de données GeoServer et l’espace de travail GeoServer.

../../_images/data_layers.jpg

Page qui contient la listes des couches disponibles

Triage

Pour trier une colonne par ordre alphabétique, cliquez sur l’en-tête de colonne.

../../_images/data_sort.png

Non triées (à gauche) et triées (à droite) colonnes

Recherche

La recherche peut être utilisée pour filtrer le nombre d’éléments affichés. Ceci est utile pour travailler avec des types de données qui contiennent un grand nombre d’éléments.

Pour rechercher des éléments de type de données, entrez le texte de recherche dans la zone de recherche et cliquez sur Enter. GeoServer va rechercher les type de données qui contiennent des éléments qui correspondent à votre requête, et afficher une vue contenant la liste des résultats de la recherche.

../../_images/data_search_results.jpg

Résultats de la recherche pour la requête «coast» sur la page des couches

Espaces de travail de GeoServer

Cette section décrit comment visualiser et configurer des espaces de travail. Analogue à un espace de noms, un espace de travail est un conteneur qui organise d’autres articles. Dans GeoServer, un espace de travail est souvent utilisé pour regrouper des couches similaires. Les couches peuvent être désignés par leur nom d’espace de travail, deux-points, le nom de la couche (par exemple geonode:san_andres_y_providencia_coastline). Deux couches différentes peuvent avoir le même nom tant qu’elles appartiennent à des espaces de travail différents (par exemple sf:states et topp:states).

Note

Dans un environnement GeoNode / GeoServer, par défaut il n’y a qu’un seul espace de travail défini appelé geonode. Vous pouvez toujours définir d’autres espaces de travail, mais GeoNode ne fonctionnera qu’avec les couches sous l’espace de travail geonode.

../../_images/data_workspaces.jpg

Page des espaces de travail

Modifier un espace de travail

Pour afficher ou modifier un espace de travail, cliquez sur le nom de l’espace de travail. Une page de configuration de l’espace de travail sera affichée.

../../_images/data_workspaces_URI.jpg

Espace de travail nommé “geonode”

Un espace de travail est défini par un nom et un espace de noms URI (Uniform Resource Identifier). Le nom de l’espace de travail est limité à dix caractères et ne peut pas contenir d’espace. Un URI est similaire à une URL, sauf que les URIs ne doivent pas pointer vers un emplacement réel sur le web, elles ont seulement besoin d’être un identifiant unique. Pour L’URI d’un espace de travail, nous vous recommandons d’utiliser une URL associée à votre projet, avec peut-être un identificateur en suffixe différent. Par exemple, http://www.geonode.org/ est l’URI pour l’espace de travail “geonode”, http://www.openplans.org/topp est l’URI pour l’espace de travail “topp”.

Ajouter un espace de travail

Les boutons pour ajouter et supprimer un espace de travail se trouvent en haut de la page des espaces de travail.

../../_images/data_workspaces_add_remove.png

Les boutons pour ajouter et supprimer

Pour ajouter un espace de travail, cliques sur le button Add new workspace. Vous serez invité à entrer le nom de l’espace de travail et l’URI.

../../_images/data_workspaces_medford.png

Page de création d’un nouveau espace de travail avec un exemple

Supprimer un espace de travail

Pour supprimer un espace de travail, sélectionnez-le en cliquant sur la case à côté de l’espace de travail. Plusieurs espaces de travail peuvent être sélectionnés, ou tous peuvent être sélectionnés en cliquant sur la case à cocher dans l’en-tête. Cliquez sur le button Remove selected workspaces(s). On vous demandera de confirmer ou d’annuler la suppression. En cliquant sur OK les espaces de travail sélectionnées seront éliminés.

../../_images/data_workspaces_rename_confirm.png

Confirmation de l’élimination d’un espace de travail

Avertissement

L’élimination d’un espace de travail va aussi supprimer toutes les couches qui lui sont associées.

Espaces de travail dans le répertoire de données de GeoServer

Tous les fichiers de configuration d’un espace de travail sont stockées dans le répertoire de données de GeoServer. Nous verrons plus loin, sur une autre section du tutoriel, comment accéder à ce dossier.

Il est à noter qu’il existe également une dépendance physique entre les espaces de travail, les sources de données et les couches.

Une couche de GeoServer est toujours définie par son espace de travail et sa source de données. Dans le répertoire de données de GeoServer la définition de la couche est stockée en tant que sous-répertoire de sa source de données, la définition de la source de données est stockée en tant que sous-répertoire de son espace de travail.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
 <data_directory>/

    ...

    workspaces/
      |
      +- workspace dirs...
         |
         +- datastore dirs...
            |
            +- layer dirs...

Entrepôts de données de GeoServer

Un entrepôt de données se connecte à une source de données qui contient des données matricielles ou vectorielles. Une source de données peut être un fichier ou un groupe de fichiers, une table dans une base de données, un fichier matricielle unique ou un répertoire (par exemple, une bibliothèque Vector Product Format). La construction de l’entrepôt permet de définir les paramètres de connexion une seule fois, plutôt que de les définir pour chaque ensemble de données présentes dans la source de données. En conséquence, il est nécessaire d’enregistrer un entrepôt avant de pouvoir configurer des ensembles de données avec cet entrepôt.

../../_images/data_stores.png

Visualization des entrepôts

Types d’entrepôts

Bien qu’il existe de nombreux formats possibles pour les sources de données, il n’y a seulement que quatre types d’entrepôts. Pour les données matricielles (un entrepôt peut être un fichier), pour les données vectorielles (un entrepôt peut être un fichier), une base de données ou un serveur.

Type d’icône

Description
../../_images/data_stores_type1.png

données matricielles dans un fichier

../../_images/data_stores_type3.png

données vectorielles dans un fichier

../../_images/data_stores_type2.png

données vectorielles dans une base de données

../../_images/data_stores_type5.png

serveur de données vectorielles (web feature server)

Modifier un entrepôt

Pour afficher ou modifier un entrepôt, cliquez sur le nom de l’entrepôt. Une page de configuration de l’entrepôt sera affichée. Le contenu exact de cette page dépendendra du format spécifique de l’entrepôt. Voir les sections Working with Vector Data, Working with Raster Data, et Working with Databases pour obtenir des informations sur les formats de données spécifiques. L’exemple montre la configuration pour l’entrepôt nurc:ArcGridSample.

../../_images/data_stores_edit.png

Modification d’un entrepôt de données matricielles

Information de base d’un entrepôt

L’information de base est commune à tous les formats.

  • Workspace - l’entrepôt est affecté à l’espace de travail sélectionné

  • Data Source Name - le nom de l’entrepôt comme indiqué sur la page de visualisation

  • Description - (optionel) une description qui sera affichée dans l’interface d’administration

  • Enabled - active ou désactive l’accès à l’entrepôt, ainsi que les sources de données associées a cet entrepôt

Paramètres de connexion

Les paramètres de connexion varient en fonction du format de données.

Ajouter un entrepôt

Les boutons pour ajouter et supprimer un entrepôt se trouvent en haut de la page des entrepôts.

../../_images/data_stores_add_remove.png

Les boutons pour ajouter et supprimer un entrepôt

Pour ajouter un entrepôt, cliquez sur Add new Store. Vous serez invité à choisir une source de données. GeoServer supporte nativement de nombreux formats (plus de formats sont disponibles via des extensions). Cliquez sur la source de données appropriée pour continuer.

../../_images/data_stores_chooser.png

Le choix de la source de données pour un nouveau entrepôt

La page suivante configure l’entrepôt. Puisque les paramètres de connexion varient selon les sources de données, le contenu exact de cette page dépendent du format spécifique de l’entrepôt. Voir les sections data_vector, data_raster et data_database pour obtenir des informations sur les formats de données spécifiques. L’exemple ci-dessous montre la page de configuration de données matricielles ArcGrid.

../../_images/data_stores_add.png

Page de configuration pour une source de données matricielles ArcGrid

Supprimer un entrepôt

Pour éliminer un entrepôt, cliquez sur la case à côté de l’entrepôt. Multiples entrepôts peuvent être sélectionnés, ou tous peuvent être sélectionnés en cliquant sur la case à cocher dans l’en-tête.

../../_images/data_stores_delete.png

Entrepôts sélectionnés pour elimination

Cliquez sur Remove selected Stores. Vous serez invité à confirmer l’élimination de la configuration de l’entrepôt(s) et toutes les ressources associées a cet entrepôt. Cliquer sur OK supprime l’entrepôt (s) sélectionné et retourne à la page des entrepôts.

../../_images/data_stores_delete_confirm.png

Confirmez la suppression des entrepôts

Comment GeoNode configure automatiquement les espaces de travail et les entrepôts

Actuellement GeoNode crée les entrepôts automatiquement lors du téléchargement d’une couche.

En resumé GeoServer:

  • GeoNode utilise toujours l’Espace de Travail geonode pour chaque Couche

  • GeoNode configure automatiquement les entrepôts associés couches

    • Pour des Couches Matricielles; GeoNode crée un entrepôt du type GeoTIFF avec le même nom de la Couche

    • Pour des Couches Vectorielles; GeoNode crée un entrepôt du type ESRI Shapefile avec le même nom de la Couche s’il n’est pas connecté à une base de données

    • Pour des Couches Vectorielles; GeoNode utilise toujours la même type d’Entrepôt c’est à dire Postgis et insère les données vectorielles dans des tables de la base de données

Excercise

Espaces de travail et entrepôts GeoNode

  1. Connectez-vous à GeoNode comme Administrator. Ensuite, cliquez sur le bouton d’utilisateur en haut à droite.

    ../../_images/layer_styles_008.jpg

    Administrateur GeoNode

  2. Dans le menu, cliquez sur le option GeoServer.

    ../../_images/layer_styles_009.jpg

    GeoNode Administrateur GeoServer

  3. Vous serez redirigé vers l’interface d’administration de GeoServer.

    ../../_images/layer_styles_010.jpg

    Interface d’aministration de GeoServer

  4. Sélectionnez le sujet Workspaces dans le menu de gauche.

    ../../_images/geonode_workspaces.jpg

    Menu GeoServer Workspace

  5. Sélectionnez l’espace de travail geonode dans la liste.

    ../../_images/geonode_workspace_geonode_list.jpg

    Listes des espaces de travail de GeoServer

  6. Modifiez l’espace de travail geonode.

    ../../_images/geonode_workspace_geonode_edit.jpg

    Espace de travail GeoServer geonode

  7. Sélectionnez le sujet Stores dans le menu de gauche.

    ../../_images/geonode_stores.jpg

    Menu d’entrepôts de GeoServer

  8. Si GeoNode et GeoServer ont été configurés pour utiliser une base de données en arrière plan, sélectionnez l’entrepôt datastore du type PostGIS.

    ../../_images/geonode_stores_datastore_list.jpg

    Liste des entrepôts de GeoServer

    ../../_images/geonode_stores_datastore.jpg

    Entrepôts GeoServer datastore

    Note

    La source de données est configurée en utilisant les mêmes paramètres de connexion spécifiés dans le fichier de GeoNode local_settings.py.

  9. Si GeoNode et GeoServer ont été configurés pour utiliser des Shapefiles, sélectionnez l’entrepôt san_andres_y_providencia_coastline du type Shapefile.

    ../../_images/geonode_stores_datastore_list2.jpg

    Liste des entrepôts de GeoServer

    ../../_images/geonode_stores_shapefile.jpg

    Entrepôt GeoServer san_andres_y_providencia_coastline

    Note

    L’entrepôt est configuré en pointant directement sur le chemin du fichier san_andres_y_providencia_coastline.shp.

Couches GeoServer

Dans GeoServer, le terme “couche” fait référence à un ensemble de données matricielles ou vectorielles qui représente un ensemble d’éléments géographiques. Les couches vectorielles sont analogues aux “featureTypes” et les couches matricielles sont analogues aux “coverages”. Toutes les couches ont une source de données, connue sous le nom d’entrepôt. La couche est associée à l’espace de travail dans lequel l’entrepôt est défini.

Dans la section de couches de l’interface Web, vous pouvez visualiser et modifier les couches existantes, ajouter une nouvelle couche, ou supprimer une couche. La page de visualisation des couches affiche la liste des couches, et l’entrepôt et l’espace de travail associées à chaque couche. Cette page affiche également l’état de la couche et sont SRS (système de coordonnées) natif.

../../_images/data_layers.png

Visualisation de Couches

Types de couches

Les couches peuvent être divisés en deux types de données: matricielles et vectorielles. Ces deux formats diffèrent dans leur façon de stocker l’information spatiale. Les types vectorielles stockent l’information des objets géographiques dans des entités mathématiques. Les points en une seule coordonnée x,y, les lignes comme une série de coordonnées x,y et les polygones comme une série de coordonnées x,y qui commencent et se terminent à la même place. Les données au format matriciel sont une représentation basée sur des cellules de caractéristiques positionées sur la surface de la terre. Chaque cellule a une valeur distincte, et toutes les cellules ayant la même valeur représentent une caractéristique spécifique.

champ

Description
../../_images/data_layers_type1.png raster (grid)
../../_images/data_layers_type2.png vector (feature)

Ajouter une nouvelle couche

Dans le coin supérieur gauche de la page de visualisation de couches il y a deux boutons pour l’ajout et la suppression des couches. Le bouton vert avec un plus vous permet d’ajouter une nouvelle couche (appelée ressources). Le bouton rouge avec un moins vous permet de supprimer les couches sélectionnées.

../../_images/data_layers_add_remove.png

Les boutons pour ajouter et supprimer une couche

En cliquant sur le bouton Add a new resource vous ouvrirez le panneau New Layer Chooser. Le menu affiche tous les entrepôts actuellement activées. Dans ce menu, sélectionnez l’entrepôt où la couche doit être ajouté.

../../_images/data_layers_add_chooser.png

Liste des magasins actuellement activés

Lors de la sélection d’un magasin, une liste affichera les ressources disponibles dans l’entrepôt. Les ressources qui ont déjà été publiées en tant que couches sont listés en premier, suivi par d’autres ressources qui sont disponibles pour être publiées. Dans cet exemple les couches giant_polygon, poi, poly_landmarks et tiger_roads sont toutes les couches existantes dans l’entrepôt de New York.

../../_images/data_layers_add_view.png

Liste des ressources publiées et disponibles dans un entrepôt

Pour ajouter une couche à partir d’une ressource disponible cliquez sur publish. Pour ajouter une nouvelle couche pour une ressource dejá publiée cliquez sur Publier Again. (Notez que lors d’une nouvelle publication le nom de la nouvelle couche doit être modifiée pour éviter tout conflit avec une couche existante.) Ces actions afficheront la page Edit Layer qui vous permettra d’entrer les définitions de la nouvelle couche.

Supprimer une couche

Pour supprimer une couche, sélectionnez-là en cliquant sur la case à côté de la couche. Comme on le voit ci-dessous, de multiples couches peuvent être choisies permettant l’élimination en lot. Notez que les sélections pour la suppression ne seront pas conservées entre deux pages de résultat.

../../_images/data_layers_delete.png

Certaines couches sélectionnées pour suppression

Toutes les couches peuvent être sélectionnées pour suppression en cliquant sur la case à cocher dans l’en-tête.

../../_images/data_layers_delete_all.png

Toutes les couches sélectionnées pour suppression

Une fois que les couches sont choisies, le lien Remove selected ressources est activé. Une fois que vous aurez cliqué sur le lien, il vous sera demandé de confirmer ou d’annuler la suppression. Si vous cliquez su OK les couches sélectionnées seront supprimées.

Modifier couche: données

Pour afficher ou modifier une couche, cliquez sur le nom de la couche. Une page de configuration de la couche sera affichée. L’onglet Data, activé par défaut, vous permet de définir et de modifier les paramètres des données de la couche.

../../_images/data_layers_edit_data.png

Modifier la couche: onglet Data

Information de base

Les sections de base comme: Basic Resource Info, Keywords et Metadata sont analogues à la section Service Metadata des services WCS, WFS et WMS. Ces sections fournissent “des données sur les données”, spécifiquement elles donnent des informations textuelles qui nous permettent de mieux comprendre et de mieux travailler avec les données de la couche. Ces métadonnées apparaîtront dans les documents de capacités (GetCapabilities) associés à la couche.

  • Name - Identificateur utilisé pour référencer la couche dans les requêtes WMS. (Notez que pour une nouvelle couche pour une ressource déjà publié, le nom doit être modifié pour éviter les conflits.)

  • Title - Description l’isible qui permettra brièvement d’identifier la couche aux clients (obligatoire)

  • Abstract - Décrit la couche en détail

  • Keywords - Liste des mots-clés associés à la couche qui assisteront les recherches dans le catalogue

  • Metadata Links - Permet de créer un lien vers des documents externes qui décrivent les données de la couche. Actuellement, seulement deux types de formats standard sont supportés: TC211 et FGDC. TC211 se réfère à la structure des métadonnées établie par le ISO Technical Committee for Geographic Information/Geomatics (ISO/TC 211), tandis que FGDC fait référence à ceux qui sont énoncés par le Federal Geographic Data Committee (FGDC) des États-Unis.

    ../../_images/data_layers_meta.png

    Ajout d’un lien de métadonnées au format FGDC

Système de coordonnées

Un système de coordonnées (CRS) définit comment situer les données spatiales géoréférencées sur la surface de la Terre. Les CRSs font partie d’un modèle plus général appelé Systèmes de Référence Spatiale (SRS), qui comprend le référencement par des coordonnées et des identificateurs géographiques. GeoServer a besoin de connaître le système de coordonnées de référence de vos données. Cette information est utilisée pour calculer le cadre de délimitation en longitude et latitude et reprojeter les données au cours de requêtes WMS et WFS.

../../_images/data_layers_CRS.png

Système de coordonnées d’une couche

  • Native SRS - Indique le système de coordonnées dans lequel la couche est stockée. En cliquant sur le lien de projection une description du SRS s’affiche.

  • Declared SRS - Indique le système de coordonnées que GeoServer va publier aux clients

  • SRS Handling - Détermine comment GeoServer doit gérer la projection lorsque les deux SRSs diffèrent

Bounding Boxes

Le cadre de délimitation détermine l’étendue des données à l’intérieur d’une couche.

  • Native Bounding Box - Les limites des données spécifiées dans le SRS natif. Ces limites peuvent être générés en cliquant sur le bouton Compute from data.

  • Lat/Lon Bounding Box - Les limites spécifiées dans des coordonnées géographiques. Ces limites peuvent être calculées en cliquant sur le bouton Compute from native bounds.

../../_images/data_layers_BB.png

Cadre de délimitation d’une couche

Details d’une entité geographique (Vecteur)

Les couches vectorielles ont une liste de Feature Type Details. Ceux-ci comprennent la Property et le Type d’une source de données. Par exemple, la couche sf: archsites ci-dessous contient une géométrie (`` the_geom``) de type “point”.

../../_images/data_layers_feature.png

Détails d’une entité géographique

Le option Nillable indique si la propriété requiert une valeur ou peut être marqué comme étant nul. L’option Min / Max Occurrences se réfère au nombre de valeurs qu’un champ est autorisé à avoir. Actuellement les propriétés Nillable et Min / Max Occurrences ont respectivement les valeurs true et 0 / 1 dans le futur les valeurs possibles peuvent être étendus afin de supporter les éléments géographiques complexes.

Modifier la couche: Publication

L’onglet Publishing configure HTTP et les paramètres des ervices WMS / WFS / WCS.

../../_images/data_layers_edit_publish.png

Modifier la couche: onglet :guilabel:`Publishing`

  • Enabled - Une couche non activé ne sera pas disponible pour aucune requête, elle n’apparaîtra que dans la configuration (et la ressource REST config)

  • Advertised - Une couche est annoncé par défaut. Une couche non annoncé sera disponible dans toutes les demandes d’accès aux données (par exemple, WMS GetMap, WMS GetFeature) mais n’apparaîtra pas dans un document de capacités ou dans l’aperçu de couches.

HTTP Settings

Paramètres de cache qui devront être appliqués à la réponse HTTP d’une requête d’un client.

  • Response Cache Headers - Si cette option est sélectionnée, GeoServer ne demandera pas la même tuile deux fois dans le délai indiqué dans Cache time. Une heure mesurée en secondes (3600), est la valeur par défaut pour Cache time.

Paramètres du service WMS

Définit les paramètres de publication spécifiques au service WMS.

../../_images/wms_settings.png

Paramètres du service WMS

  • Queryable - Contrôle si la couche est peut être interrogée via des requêtes WMS GetFeatureInfo.

  • Default style - Style qui sera utilisé lorsque le client ne spécifie pas un style nommé dans les demandes GetMap.

  • Additional styles - Autres styles qui peuvent être associés à cette couche. Certains clients (et la visualisation de couches de GeoServer) présenteront ces alternatives de style de la couche à l’utilisateur.

  • Default rendering buffer - Valeur par défaut du paramètre non standard (vendor paramater) buffer pour les opérations GetMap / GetFeatureInfo. Voir les Wms Vendor Parameters Pour plus de détails.

  • Default WMS path - Localisation de la couche dans l’arborescence des couches du document des capacités WMS. Utile pour la construction de groupes de couches non-opaques.

WMS Attribution

Définit les informations qui devront être publiées sur les fournisseurs de données.

../../_images/data_layers_WMS.png

WMS Attribution

  • Attribution Text - Texte lisible décrivant le fournisseur de données. Ceci peut être utilisé comme le texte d’un lien hypertexte vers le site web du fournisseur de données.

  • Attribution Link - URL vers le site Web du fournisseur de données.

  • Logo URL - URL de l’image qui sert de logo au fournisseur de données.

  • Logo Content Type, Width, and Height - Ces champs fournissent des informations sur l’image du logo que les clients peuvent utiliser pour aider à la mise en page. GeoServer détectera automatiquement ces valeurs si vous cliquez sur le lien Auto-detect image size and type au bas de la section. Le texte, lien, et l’URL seront annoncés dans le document de capacités WMS s’ils sont fournis. Certains clients WMS afficheront cette information pour conseiller les utilisateurs dont les fournisseurs fournissent un ensemble de données particulier. Si vous omettez certains des champs, ceux qui sont fournis seront publiés et ceux qui ne sont pas seront omis dans le document sur les capacités.

Paramètres du service WFS

  • Par-Request Feature Limit - Définit le nombre maximum d’éléments géographiques que devront être créés pour une couche lors d’une opération WFS GetFeature (indépendamment du nombre de requêtes)

  • Maximum number of decimals - Définit le nombre maximal de décimales en sortie GML.

    Note

    Il est également possible de remplacer la liste OtherSRS / OtherCRS configurée dans le service WFS, et si nécessaire la replacer avec une liste vide. La zone de saisie acceptera une liste de codes EPSG séparés par deux points:

    ../../_images/data_layers_WFS.png

    WFS otherSRS/otherCRS override

    La liste ne sera utilisée que pour la génération de documents de capacités, mais ne sera pas utilisé pour limiter les SRSs qui peuvent être utilisés dans les demandes GetFeature.

Comment GeoNode configure automatiquement les couches

GeoNode met à jour automatiquement les informations sur GeoServer chaque fois qu’une couche est créé ou que ses métadonnées sont mises à jour.

Excercise

Vérifier les informations dans GeoServer

  1. Connectez-vous à GeoNode comme Administrator. Ensuite, cliquez sur le bouton d’utilisateur en haut à droite.

    ../../_images/layer_styles_008.jpg

    Administrateur GeoNode

  2. Dans le menu, cliquez sur le option GeoServer.

    ../../_images/layer_styles_009.jpg

    GeoNode Administrateur GeoServer

  3. Vous serez redirigé vers l’interface d’administration de GeoServer.

    ../../_images/layer_styles_010.jpg

    Interface d’aministration de GeoServer

  4. Sélectionnez le sujet Layers dans le menu de gauche.

    ../../_images/geonode_layers_menu.jpg

    Menu des couches dans GeoServer

  5. Sélectionnez la couche san_andres_y_providencia_coastline dans la liste.

    ../../_images/geonode_layers_list.jpg

    List des couches dans GeoServer

  6. Remarquez comment le champs de Basic Resource Info ont été automatiquement configurés par GeoNode.

    • Le champ Name reflète le nom du fichier d’origine.

    • Le champ Title a été rempli avec la valeur de métadonnées

    • Le champ Abstract a été rempli avec la valeur des métadonnées

    • Les mot-clés Keywords ont été ajoutés avec les valeurs des métadonnées

    ../../_images/geonode_layers_basic_data.jpg

    Information de base d’une couche dans GeoServer

  7. Remarquez comment les liens des métadonnées Metadata Links reflètent les options de téléchargement de métadonnées disponibles dans GeoNode, ainsi que les URL.

    ../../_images/geonode_layers_metadata_links.jpg

    Liens pour les métadonnées d’une couche dans GeoServer

  8. Remarquez comment le système de coordonnées Coordinate Reference System et les limites geographiques Bounding Boxes ont été automatiquement remplis par GeoNode en conformément aux information de la source de données.

    ../../_images/geonode_layers_crs.jpg

    Système de cordonnées de la couche dans GeoServer

  9. Dans la section Publishing Section le style par défaut Default Style a été mis à jour et configuré par GeoNode.

    ../../_images/geonode_layers_styles.jpg

    Section de publication d’une couche GeoServer

Feuilles de style de GeoServer (SLD)

Les styles permettent de définir la visualisation de données géospatiales. Les styles de GeoServer sont écrits en dans le format Styled Layer Descriptor (SLD), qui est un sous-ensemble de XML. Veuillez vous rendre à la section Styling pour plus d’informations sur comment travailler avec les styles.

Sur la page des Styles, vous pouvez ajouter un nouveau style, afficher ou modifier un style existant ou supprimer un style.

../../_images/data_style.png

Page des Styles

Edition d’un Style

Pour afficher ou modifier un style, cliquez sur le nom du style. La page Style Editor sera affichée. La page présentera des options qui permettent de configurer le nom, le code et d’autres attributs du style. Le nom du style sont spécifiées en haut dans le champ de nom. L’espace de travail du style peut être choisi en utilisant le sélecteur d’espace de travail. Les styles sont modifiés à l’aide d’un éditeur de texte basique.

../../_images/data_style_editor.png

Éditeur de style

L’éditeur de style prend en charge la numérotation des lignes, l’indentation automatique et la coloration syntaxique en temps réel. Vous pouvez également augmenter ou diminuer la taille de la police de l’éditeur.

Bouton

Description
../../_images/data_style_editor_undo.png

annuler

../../_images/data_style_editor_redo.png

rétablir

../../_images/data_style_editor_goto.png

Aller à la ligne

../../_images/data_style_editor_reformat.png

auto-formater le contenu de l’éditeur

../../_images/data_style_editor_fontsize.png

changer la taille de la police de l’éditeur

Pour confirmer que le code SLD est entièrement compatible avec le schéma SLD, cliquez sur le bouton Validate. Une boîte de message vous confirmera si le style contient des erreurs de validation.

Note

Parfois GeoServer est capable d’utiliser des styles dont la validation échoue, mais ce n’est pas recommandé.

../../_images/data_style_editor_noerrors.png

Aucune erreur de validation

../../_images/data_style_editor_error.png

Message d’erreur de validation

Pour voir la légende crée generated legend entry pour le style, cliquez sur le bouton Preview Legend.

Ajouter un style

Les boutons pour ajouter et supprimer un style pervent être trouvés dans la partie supérieure de la page de Styles.

../../_images/data_style_add_delete.png

Ajout ou suppression d’un style

Pour ajouter un nouveau style, cliquez sur le bouton Add a new style. Vous allez être redirigé vers la page de l’éditeur. Entrez un nom pour le style. Vous pouvez également sélectionner le format du style. Dans une installation basique de GeoServer le format SLD est le seul pris en charge, mais il existe des extensions (comme css) qui ajoutent de nouveaux formats. La page de l’éditeur fournit plusieurs façons d’ajouter un nouveau style. Vous pouvez coller le style directement dans l’éditeur. Vous pouvez générer un nouveau style par défaut basé sur un modèle interne:

../../_images/data_style_editor_generate.png

Création d’un nouveau style par défaut.

Vous pouvez copier le contenu d’un style existant dans l’éditeur:

../../_images/data_style_editor_copy.png

Copie d’un style existant de GeoServer

Vous pouvez sélectionner et télécharger un fichier local qui contient le SLD:

../../_images/data_style_upload.png

Charger un fichier SLD à partir de votre ordinateur local

Une fois qu’un style est soumis avec succès, vous serez redirigé vers la page principale de Styles où le nouveau style sera présent.

Supprimer un style

Pour supprimer un style, sélectionnez-le en cliquant sur la case à côté du style. Plusieurs styles peuvent être sélectionnés ou tous peuvent être sélectionnés en cliquant sur la case à cocher dans l’en-tête. Cliquez sur le lien Remove selected style(s) en haut de la page. On vous demandera de confirmer ou d’annuler la suppression. En cliquant sur OK les style(s) sélectionnés seront supprimées.

../../_images/data_style_delete.png

Confirmation pour la suppression des styles

Comment GeoNode configure automatiquement un style

Quand ont charge une nouvelle couche dans GeoNode, il crée par défaut un SLD sur GeoServer avec le même nom natif de la couche et l’assigne à la nouvelle couche comme style par défaut Default Style.

Dans les sections précédentes vous avez déjà modifié le style par défaut de la couche san_andres_y_providencia_coastline généré automatiquement par GeoNode.

Structure du répertoire de données de GeoServer

Cette section donne un aperçu de la structure et le contenu du répertoire de données de GeoServer.

Le but de cette section n’est pas d’être une référence complète sur les informations de configuration de GeoServer, puisque normalment les fichiers de configuration du répertoire de données ne doivent pas être directement accessibles. Au lieu de cela, la Web Administration Interface peut être utilisé pour visualiser et modifier manuellement la configuration et pour accéder ou modifier la configuration programmatiquement L’API REST configuration doit être utilisé.

Les répertoires qui contiennent du contenu modifiable par l’utilisateur sont: logs, palettes, templates, user-projection, et www.

La figure suivante montre la structure du répertoire de données de GeoServer:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
 <data_directory>/

    global.xml
    logging.xml
    wms.xml
    wfs.xml
    wcs.xml

    data/
    demo/
    geosearch/
    gwc/
    layergroups/
    logs/
    palettes/
    plugIns/
    security/
    styles/
    templates/
    user_projections/
    workspaces/
      |
      +- workspace dirs...
         |
         +- datastore dirs...
            |
            +- layer dirs...
    www/

Les fichiers .xml

Le niveau supérieur de fichiers .xml contient des informations sur les services et sur les différentes options globales de l’instance du serveur.

Placez ce fichier dans <my_geonode>/static/css.

Description
global.xml

Contient des paramètres communs à tous les services, tels que les informations de contact, les paramètres de la< bibliothèque JAI, les jeux de caractères et la verbosité.

logging.xml

Indique les paramètres de journalisation, tels que le niveau de consignation, l’emplacement du fichier et s’il faut écrire dans la sortie standard.

wcs.xml

Contient les métadonnées du service et divers paramètres pour le service de WCS.

wfs.xml

Contient les métadonnées du service et divers paramètres pour le service WFS.

wms.xml

Contient les métadonnées du service et divers paramètres pour le service WMS.

espaces de travail

Le répertoire des espaces de travail contient des métadonnées sur les couches publiées par GeoServer. Il contient un répertoire pour chaque espace de travail défini. Chaque répertoire d’espace de travail contient des répertoires pour les entrepôts de données qui lui sont associés. Chaque répertoire d’entrepôt contient des répertoires pour les couches définies pour cet entrepôt. Chaque répertoire de couche contient soit un fichier layer.xml, un fichier coverage.xml ou un fichier featuretype.xml selon que le type de données soit respectivement matricielles ou vectorielles.

data

Le répertoire de données peut être utilisé pour stocker des ensembles de données géospatiales enregistrées dans des fichiers qui peuvent être servis sous forme de couches. (Ceci ne doit pas être confondu avec le “répertoire de données de GeoServer” principale.) Ce répertoire est couramment utilisé pour stocker des shapefiles et des fichiers de données matricielles, il peut être aussi utilisé pour toutes les données qui peuvent être représentées dans des fichiers.

Le principal avantage de stocker des fichiers de données dans le répertoire de données de GeoServer est la portabilité. Considérons une shapefile stockée dans un répertoire externe au répertoire de données de GeoServer à la location C:\gis_data\foo.shp. L’entrée correspondant à l’entrepôt associé a la shapefile dans le fichier catalog.xml rassemblera à ceci:

1
2
3
4
5
 <datastore id="foo_shapefile">
    <connectionParams>
      <parameter name="url" value="file://C:/gis_data/foo.shp" />
    </connectionParams>
  </datastore>

Maintenant, considérons que nous voulons porter ce répertoire de données dans un autre hôte exécutant GeoServer. L’emplacement C:\gis_data\foo.shp n’existera probablement pas sur cet hôte. Donc, soit le fichier doit être copié à cet emplacement sur le nouvel hôte ou le fichier catalog.xml devra être modifié pour tenir compte du nouvel emplacement.

Ce problème peut être évité en stockant foo.shp dans le répertoire de données de GeoServer. Dans ce cas, l’entrée correspondante à l’entrepôt dans le fichier catalog.xml devient:

1
2
3
4
5
  <datastore id="foo_shapefile">
    <connectionParams>
      <parameter name="url" value="file:data/foo.shp"/>
    </connectionParams>
  </datastore>

L’attribut de value est récrit de façon à être relatif au répertoire de données de GeoServer. Cette indépendance d’emplacement permet de copier le répertoire de données complètement vers un nouvel hôte et de l’utilisé directement sans aucune modification supplémentaire.

demo

Le répertoire demo contient des fichiers qui définissent les requêtes d’exemple disponible dans le Sample Request Tool (http://localhost/geoserver/demoRequest.do). Voir la page Demos pour plus d’informations.

geosearch

Le répertoire de geosearch contient des informations pour la régionalisation des fichiers KML.

gwc

Le répertoire gwc détient le cache créé par le service GeoWebCache intégré.

layergroups

Le répertoire layergroups contient des informations de configuration sur les groupes de couches définis.

logs

Le répertoire logs contient des informations de configuration des profils de journalisation, et le fichier de journalisation par défaut geoserver.log. Voir aussi Advanced log configuration.

palettes

Le répertoire de palettes est utilisé pour stocker des palettes d’images pré-calculées. Les palettes d’images sont utilisées par le service WMS de GeoServer pour réduire la taille des images produites sans sacrifié la qualité de l’image. Voir aussi Paletted Images.

security

Le répertoire security contient les fichiers utilisés pour configurer le sous-système de sécurité de GeoServer. Cela comprend un ensemble de fichiers de propriétés qui définissent les rôles d’accès, ainsi que les services et les données que chaque rôle est autorisé à accéder. Voir la section sécurité Security pour plus d’informations.

styles

Le répertoire de styles contient des styles (au format Styled Layer Descriptor (SLD)) qui contiennent des informations de style que seront utilisées par le service WMS de GeoServer. Pour chaque fichier dans ce répertoire il y a une entrée correspondante dans le fichier catalog.xml:

1
  <style id="point_style" file="default_point.sld"/>

Voir la section Styling pour plus d’informations sur la stylisation et le format SLD.

templates

Le répertoire de templates contient des fichiers utilisés par le sous-système templating de GeoServer. Les modèles sont utilisés pour personnaliser la sortie des différentes opérations de GeoServer. Voir aussi Freemarker Templates.

user_projections

Le répertoire de user_projections contient un fichier appelé epsg.properties qui est utilisé pour définir les systèmes de référence spatiale personnalisés qui ne font pas partie de la base de données officielle EPSG. Voir aussi Custom CRS Definitions.

www

Le répertoire www est utilisé pour permettre à GeoServer de servir des fichiers comme un quelconque serveur web. Le contenu de ce répertoire sera disponible à l’adresse http:/<host:port>/geoserver/www. Bien que ceci ne soit pas un remplacement pour un vrai server web, ceci peut être utile pour servir des applications de cartographie côté client. Voir aussi Serving Static Files.

Excercise

Naviguer dans le répertoire de données de GeoServer

  1. Connectez-vous à GeoNode comme Administrator. Ensuite, cliquez sur le bouton d’utilisateur en haut à droite.

    ../../_images/layer_styles_008.jpg

    Administrateur GeoNode

  2. Dans le menu, cliquez sur le option GeoServer.

    ../../_images/layer_styles_009.jpg

    GeoNode Administrateur GeoServer

  3. Vous serez redirigé vers l’interface d’administration de GeoServer.

    ../../_images/layer_styles_010.jpg

    Interface d’aministration de GeoServer

  4. Sélectionnez le sujet Serveur Status à partir du menu de gauche. Sur la page d’état noter l’option Data Directory.

    ../../_images/layer_gs_datadir_001.jpg

    GeoServer Admin Server Status Page

  5. Ouvrez une fenêtre Terminal et allez dans le dossier de données de GeoServer. Naviguez dans les dossiers et examinez les dossiers.

  6. Entrez dans le répertoire de styles et confirmez que le fichier san_andres_y_providencia_coastline.sld existe

    1
    $ cat san_andres_y_providencia_coastline.sld
    

Étapes à effectuer pour migrer manuellement une couche

Dans cette section, nous allons enregistrer sur le disque dur toutes les informations d’une couche de GeoNode nécessaires pour la restaurer plus tard sur une autre instance de GeoNode.

Voici ci-dessous un résumé rapide des actions à faire pour exporter manuellement une couche de GeoNode:

  • Tout d’abord il est nécessaire de stocker les données de la couche dans un format portable. Étant donné que nous ne pouvons assumer aucune configuration spécifique sur le GeoNode cible (nous ne savons pas si elle a été attachée à une base de données ou non, et nous ne connaissons pas les paramètres de connexion), nous avons besoin d’enregistrer les données de base de la couche dans un format qui soit passible d’être réimportés sur une instance de GeoNode quelconque. La solution consiste à exporter la couche comme une ESRI Shapefile.

  • Nous pouvons aussi avoir besoin d’exporter le SLD associé à la couche. Nous devons aussi enregistrer les styles de la couche sur le stockage.

  • Une fois que nous avons obtenu toutes les données de base, la dernière étape consiste à enregistrer les métadonnées de la couche. Toutes les informations définies pour cette couche doivent être répliquée sur l’instance cible.

L’exercice que nous allons exécuter en 4 étapes, consiste à:

  1. Télécharger un calque comme une ESRI Shapefile: Nous allons télécharger la couche san_andres_y_providencia_coastline, déjà configuré dans GeoNode, comme une ESRI ShapeFile. Cela nous permettra de stocker les données dans un format portable.

  2. Enregistrer et exporter l’SLD de la couche: Nous allons vérifier quels sont les styles associés à la couche san_andres_y_providencia_coastline, récupérer les fichiers SLD correspondants dans le dossier de données de GeoServer et les enregistrer pour une importation ultérieure.

  3. Enregistrer et exporter les métadonnées de la couche: Nous allons enregistrer les métadonnées de la couche san_andres_y_providencia_coastline dans un fichier au format ISOTC211 19115 / XML pour une importation ultérieure.

  4. Réimporter la couche: Nous allons nettoyer nôtre instance de GeoNode, en nous certifiant que GeoServer sera aussi nettoyé, puis nous allons restaurer la couche san_andres_y_providencia_coastline en utilisant les fichiers enregistrés lors des étapes précédentes.

1. Download a Layer as ESRI Shapefile

Note

Pour exécuter cet exercice, nous partons du principe que vous avez lu toutes les sections précédentes et que votre GeoNode a déjà une couche configuré comme indiqué sur les notes préliminaires.

Excercise

Exporter une couche comme une Shapefile

Avertissement

Vous devez être un administrateur de GeoNode pour pouvoir exécuter cet exercice.

  1. Identifier le nom réel de la couche.

    Connectez-vous à votre instance locale de GeoNode et explorez les couches disponibles.

    ../../_images/migrate_mode1_001.jpg

    Explorer les couches de GeoNode

    Sélectionnez la couche San Andreas Coastlines et cliquez sur Metadata Edit.

    ../../_images/migrate_mode1_002.jpg

    Modifier les métadonnées dans GeoNode

    Vous trouverez le nom réel de la couche comme sous-titre de la page Edit Metadada. Notez-le quelque part.

    ../../_images/migrate_mode1_003.jpg

    Nom réel de la couche GeoNode

  2. Identifier le lien pour accéder à GeoServer.

    Identifier le lien pour accéder à GeoServer. Cliquez sur admin et sur lien GeoServer dans le menu.

    ../../_images/migrate_mode1_004.jpg

    Lien qui permet d’accéder à GeoServer

    Dans notre cas, l’adresse de GeoServer est http://localhost/geoserver.

    ../../_images/migrate_mode1_005.jpg

    Page web de GeoServer

  3. Export de la couche dans un fichier au format ESRI ShapeFile.

    Ouvrez une invite de commandes et allez dans /home/geo/Desktop/.

    $> cd /home/geo/Desktop/
    
    ../../_images/migrate_mode1_006.jpg

    Terminal: Dossier Desktop

    Créer un nouveau dossier backup et entrez dedans.

    $> mkdir backup
    $> cd backup
    
    ../../_images/migrate_mode1_007.jpg

    Terminal: Dossier Backup

    Enfin exportez la couche geonode:san_andres_y_providencia_coastline comme une ShapeFile à partir de GeoServer en utilisant l’utilitaire WGET.

    $> wget --user=admin --password=admin -O san_andres_y_providencia_coastline.zip "http://localhost/geoserver/geonode/ows?service=WFS&version=1.0.0&request=GetFeature&typeName=geonode:san_andres_y_providencia_coastline&outputFormat=SHAPE-ZIP"
    
    ../../_images/migrate_mode1_008.jpg

    Terminal: Save san_andres_y_providencia_coastline.zip

    Note

    Examinons la commande que nous venons d’exécuter:

    # This is the executable
    wget
    
    # Those are the GeoNode credentials for the ``admin`` user. Yours maybe different.
    --user=admin --password=admin
    
    # This is the name of the output file we want to create. It's not important, you can choose anyone.
    -O san_andres_y_providencia_coastline.zip
    
    # This is the full URL to let GeoServer save the source data as ShapeFile ZIP.
    "http://localhost/geoserver/geonode/ows?service=WFS&version=1.0.0&request=GetFeature&typeName=geonode:san_andres_y_providencia_coastline&outputFormat=SHAPE-ZIP"
    
    # 1. It must be quoted ""
    # 2. The first part is the GeoServer Endpoint "http://localhost/geoserver"
    # 3. The "typename" is the real GeoNode Layer name "typeName=geonode:san_andres_y_providencia_coastline"
    # 4. With "outputFormat" we say to GeoServer how to download data "outputFormat=SHAPE-ZIP"
    

    Décompressez le fichier dans le dossier backup.

    $> unzip san_andres_y_providencia_coastline.zip
    
    ../../_images/migrate_mode1_009.jpg

    Terminal: Décompressez san_andres_y_providencia_coastline.zip

    Vérifiez que le ShapeFile a été correctement téléchargé. Vous devez voir les 4 fichiers .dbf, .prj, .shp, .shx dans le dossier backup.

    $> ls -la
    
    ../../_images/migrate_mode1_010.jpg

    Terminal: Vérifiez san_andres_y_providencia_coastline.zip

    Note

    Vous pouvez également supprimer le fichier san_andres_y_providencia_coastline.zip maintenant. Il ne sera plus utile à l’avenir.

2. Save and exrpot the Layer SLDs

Note

Pour exécuter cet exercice, nous partons du principe que vous avez lu toutes les sections précédentes et que votre GeoNode a déjà une couche configuré comme indiqué sur les notes préliminaires.

Excercise

Exportez l’SLD par défaut de la couche

Avertissement

Par défaut GeoNode crée un SLD dans GeoServer avec le même nom que la couche importée et l’utilise comme style par défaut. Dans cet exercice, nous allons supposer que la couche utilise uniquement l’SLD créé par défaut par GeoNode.

  1. Identifier le chemin complet du dossier de données de GeoServer

    Cliquez sur le lien GeoServer du menu àdmin de GeoNode.

    ../../_images/migrate_mode1_011.jpg

    GeoServer Admin Page

    Cliquez sur le lien Server Status de page admin de GeoServer.

    ../../_images/migrate_mode1_012.jpg

    GeoServer Page Admin Serveur Status

    Copiez le chemin complet du dossier de données de GeoServer à partir de la page``Serveur Status``.

    ../../_images/migrate_mode1_013.jpg

    GeoServer Page Admin Dossier de données de GeoServer

    En utilisant l’invite de commandes, copiez le style san_andres_y_providencia_coastline.sld dans le dossier backup.

    $> cd /home/geo/Desktop/backup/
    $> cp /var/lib/tomcat7/webapps/geoserver/data/styles/san_andres_y_providencia_coastline.sld .
    
    ../../_images/migrate_mode1_014.jpg

    Terminal: Copier san_andres_y_providencia_coastline.sld

    Note

    Examinons la commande que nous venons d’exécuter:

    # This is the executable
    cp
    
    # This is the full path of the ``san_andres_y_providencia_coastline.sld`` file
    /var/lib/tomcat7/webapps/geoserver/data/styles/san_andres_y_providencia_coastline.sld
    
    # 1. Notice that the first part ``/var/lib/tomcat7/webapps/geoserver/data`` is the path of the GeoServer Data Dir
    # 2. You must add the path ``/styles/`` to the path of the GeoServer Data Dir
    # 3. The SLD file has the same prefix of the original Layer ``san_andres_y_providencia_coastline.sld``
    

    Vérifiez que le SLD a été correctement téléchargé. Vous devez voir le fichier san_andres_y_providencia_coastline.sld dans le dossier backup.

    $> ls -la
    
    ../../_images/migrate_mode1_015.jpg

    Terminal: Vérifiez san_andres_y_providencia_coastline.sld

3. Save and exrpot the Layer Metadata

Note

Pour exécuter cet exercice, nous partons du principe que vous avez lu toutes les sections précédentes et que votre GeoNode a déjà une couche configuré comme indiqué sur les notes préliminaires.

Excercise

Exporter les métadonnées d’une couche en utilisant le format ISOTC211 / 19115 XML

Avertissement

Vous devez être un administrateur de GeoNode pour pouvoir exécuter cet exercice.

  1. Obtenez l’URL de ISOTC211/19115 XML.

    Connectez-vous à votre instance locale de GeoNode et explorez les couches disponibles.

    ../../_images/migrate_mode1_001.jpg

    Explorer les couches de GeoNode

    Sélectionnez la couche San Andreas Coastlines et cliquez sur Download Metadata.

    ../../_images/migrate_mode1_016.jpg

    GeoNode Télécharger Métadonnées

    Cliquez avec le bouton droit de la souris sur lien ISO puis sur Copy Link Location.

    ../../_images/migrate_mode1_017.jpg

    Copier le lien de ISOTC211/19115 XML

  2. Stocker le ISOTC211/19115 XML à travers la commande WGET.

    Dans l’invite de commandes, allez dans le dossier backup du fichier san_andres_y_providencia_coastline que nous avons créé précédemment.

    $> cd /home/geo/Desktop/backup/
    

    Pour terminer exportez le fichier san_andres_y_providencia_coastline.xml en tant que ISOTC211/19115 XML à partir de GeoNode en utilisant l’utilitaire WGET.

    $> wget --user=admin --password=admin -O san_andres_y_providencia_coastline.xml "http://localhost/catalogue/csw?outputschema=http%3A%2F%2Fwww.isotc211.org%2F2005%2Fgmd&service=CSW&request=GetRecordById&version=2.0.2&elementsetname=full&id=3236a2e0-f023-11e5-86e3-08002779b53d"
    
    ../../_images/migrate_mode1_018.jpg

    Terminal: Save san_andres_y_providencia_coastline.xml

    Note

    Examinons la commande que nous venons d’exécuter:

    # This is the executable
    wget
    
    # Those are the GeoNode credentials for the ``admin`` user. Yours maybe different.
    --user=admin --password=admin
    
    # This is the name of the output file we want to create. **It's important** that the file has the same prefix of the ``san_andres_y_providencia_coastline`` Layer name.
    -O san_andres_y_providencia_coastline.xml
    
    # This is the full URL of the ISOTC211/19115 XML.
    "http://localhost/catalogue/csw?outputschema=http%3A%2F%2Fwww.isotc211.org%2F2005%2Fgmd&service=CSW&request=GetRecordById&version=2.0.2&elementsetname=full&id=3236a2e0-f023-11e5-86e3-08002779b53d"
    
    # 1. It must be quoted ""
    # 2. The first part is the GeoNode Catalogue Endpoint "http://localhost/catalogue"
    # 3. With "outputschema" we say to GeoNode how to download metadata "outputschema=http%3A%2F%2Fwww.isotc211.org%2F2005%2Fgmd"
    # 4. Notice that any Layer in GeoNode is identified by a unique ID "id=3236a2e0-f023-11e5-86e3-08002779b53d", which can be retrieved from the Layer Metadata panel.
    

    Vérifiez que le XML a été correctement téléchargé. Vous devez voir le fichier san_andres_y_providencia_coastline.xml dans le dossier backup.

    $> ls -la
    
    ../../_images/migrate_mode1_019.jpg

    Terminal: Vérifiez san_andres_y_providencia_coastline.xml

4. Import back the Layer through the “importlayers” GeoNode Management Command

À ce stade, nous avons tout ce qu’il faut pour restaurer la couche enregistrée dans le dossier /home/geo/Desktop/backup/.

Voilà ce que nous allons faire maintenant:

  • Nettoyer GeoNode et GeoServer, en étant sûr que la couche san_andres_y_providencia_coastline a été complètement retirée de toutes les instances.

  • Restaurer la cocuhe san_andres_y_providencia_coastline et ses Métadonnées

  • Restaurer le style SLD san_andres_y_providencia_coastline

Exercise

Nettoyer la couche san_andres_y_providencia_coastline

  1. Supprimer la couche san_andres_y_providencia_coastline.

    Connectez-vous à votre instance locale de GeoNode et explorez les couches disponibles.

    ../../_images/migrate_mode1_001.jpg

    Explorer les couches de GeoNode

    Sélectionnez la couche San Andreas Coastlines et cliquez sur Layer Remove.

    ../../_images/migrate_mode1_002.jpg

    Supression d’une couche GeoNode

    Confirmez que vous souhaitez supprimer le couche san_andres_y_providencia_coastline.

    ../../_images/migrate_mode1_020.jpg

    Confirmation de la suppression de la couche de GeoNode

  2. Confirmez que la couche a été égualement retirée de GeoServer.

    Connectez-vous à l’interface d’administration de votre instance locale de GeoServer à travers le menu àdmin de GeoNode.

    ../../_images/migrate_mode1_021.jpg

    Interface d’administration de GeoServer

    Vérifiez bien que la couche san_andres_y_providencia_coastline n’est plus présente sur la liste des couches de GeoServer. Si elle est présente supprimez-là manuellement.

    ../../_images/migrate_mode1_022.jpg

    GeoServer GUI Admin: Couches

    Vérifiez bien que le style san_andres_y_providencia_coastline n’est plus présente dans la liste des styles de GeoServer. Si oui supprimez-là manuellement.

    ../../_images/migrate_mode1_023.jpg

    GeoServer GUI Admin: Styles

  3. Une fois que les instances de GeoNode et de GeoServer aie été nettoyées, réimporter le couche san_andres_y_providencia_coastline à travers la commande de management “importlayers” de GeoNode

    Dans l’invite de commandes, allez dans le dossier backup du fichier san_andres_y_providencia_coastline que nous avons créé précédemment.

    $> cd /home/geonode/geonode/
    

    Pour terminer, importez la couche san_andres_y_providencia_coastline en utilisant la commande de management “importlayers” de GeoNode.

    $> python manage.py importlayers /home/geo/Desktop/backup/
    
    ../../_images/migrate_mode1_024.jpg

    Terminal: Importer san_andres_y_providencia_coastline

    Note

    Remarquerez que

    • La commande de management “importlayers” de GeoNode importe automatiquement tous les fichiers ShapeFiles disponibles dans le dossier backup

    • La commande de management “importlayers” de GeoNode restaure automatiquement les métadonnées de la couche si le fichier ISOTC211/19115 XML est disponible dans le même dossier et a la même couche comme préfixe

    • La commande de management “importlayers” de GeoNode restaure automatiquement les styles de calque si le SLD est disponible sur le même dossier et a la même couche comme prefix

  4. Vérifier que le couche san_andres_y_providencia_coastline a été correctement restauré dans GeoNode.