DOCSLIB.ORG

Geonetwork Developer Manual Release 2.10.4-0

Total Page：16

File Type：pdf, Size：1020Kb

Download full-text PDF Read full-text
Geonetwork Developer Manual Release 2.10.4-0 GeoNetwork Developer Manual Release 2.10.4-0 GeoNetwork September 23, 2021 CONTENTS 1 Software development 3 1.1 System Requirements..........................................3 1.2 Tools...................................................4 1.3 Check out source code..........................................4 1.4 Build GeoNetwork............................................5 1.5 Creating the installer...........................................7 1.6 Running tests...............................................7 1.7 Eclipse setup...............................................7 2 Create a release 13 2.1 Call for vote............................................... 13 2.2 Release committee............................................ 13 2.3 Notify developer lists........................................... 13 2.4 Prerequisites............................................... 14 2.5 Add release to trac............................................ 14 2.6 Making the release............................................ 14 2.7 Updating the master branch version number............................... 16 2.8 Upload and release on SourceForge................................... 17 2.9 Update geonetwork-opensource website................................. 18 2.10 Announce the release........................................... 18 3 Harvesting 21 3.1 Structure................................................. 21 3.2 Data storage............................................... 22 3.3 Guidelines................................................ 23 4 Schema Plugins 25 5 Metadata schemas and profiles 27 6 Implementing a metadata schema or profile 29 7 Schema Plugins 31 7.1 Contents of a GeoNetwork schema................................... 31 7.2 Preparation................................................ 33 7.3 Example - ISO19115/19139 Marine Community Profile (MCP).................... 33 8 Metadata Exchange Format 61 8.1 Introduction............................................... 61 8.2 MEF v1 file format............................................ 61 8.3 MEF v2 file format............................................ 62 i 8.4 The info.xml file............................................. 63 9 XML Services 67 9.1 Calling specifications........................................... 67 9.2 Login and Logout services........................................ 70 9.3 Group services.............................................. 72 9.4 User services............................................... 77 9.5 Category services............................................. 89 9.6 Search and Retrieve Metadata services................................. 94 9.7 Metadata insert, update and delete services............................... 105 9.8 Metadata Select services......................................... 112 9.9 Metadata Privilege services....................................... 114 9.10 Metadata Ownership services...................................... 118 9.11 Metadata Status services......................................... 125 9.12 Metadata Category services....................................... 130 9.13 Metadata Versioning services...................................... 133 9.14 Metadata Processing services...................................... 136 9.15 Metadata Relation services........................................ 142 9.16 Metadata Validation services....................................... 147 9.17 System configuration........................................... 152 9.18 Site Information and Request Forwarding Services........................... 158 9.19 File download services.......................................... 167 9.20 Harvesting services............................................ 170 9.21 Schema Services............................................. 183 9.22 MEF services............................................... 189 9.23 CSW service............................................... 191 9.24 Java development with XML services.................................. 201 10 Settings hierarchy 209 10.1 Introduction............................................... 209 10.2 System node............................................... 209 10.3 Harvesting nodes............................................. 211 11 User Interface 233 11.1 Classic.................................................. 233 11.2 Search.................................................. 234 11.3 TabSearch................................................ 236 11.4 HTML5UI................................................ 236 Index 243 ii GeoNetwork Developer Manual, Release 2.10.4-0 Welcome to the GeoNetwork Developer Manual v2.10.4-0. The manual is for those who want to help with the devel- opment process, including source code, software releasing, and other administrative work. Other documents: GeoNetwork User Manual GeoNetwork Developer Manual (PDF) CONTENTS 1 GeoNetwork Developer Manual, Release 2.10.4-0 2 CONTENTS CHAPTER ONE SOFTWARE DEVELOPMENT 1.1 System Requirements GeoNetwork is a Java application that runs as a servlet so the Java Runtime Environment (JRE) must be installed in order to run it. You can get the JRE from http://www.oracle.com/technetwork/java/javase/downloads and you have to download the Java 6 Standard Edition (SE). GeoNetwork won’t run with Java 1.4. It will run with: • Java 5 - but few people should be using that now as it is unsupported. • Java 6 - most testing has taken place under Java 6, so we recommend Java 6. • OpenJDK 7 - note: problems have been reported with OpenJDK 6. Being written in Java, GeoNetwork can run on any platform that supports Java, so it can run on Windows, Linux and Mac OSX. For MacOSX, make sure you use version 10.4 (Tiger) or newer. Version 10.3 (Panther) has only Java 1.4 so it cannot run GeoNetwork. Next, you need a servlet container. GeoNetwork comes with an embedded container (Jetty) which is fast and well suited for most applications. If you need a stronger one, you can install Tomcat from the Apache Software Foundation (http://tomcat.apache.org). It provides load balancing, fault tolerance and other production features. If you work for an organisation, it is probable that you already use Tomcat. The tested version is 6.0.x but GeoNetwork should work with all other versions (>= 5.5). Regarding storage, you need a Database Management System (DBMS) like Oracle, MySQL, Postgresql etc. GeoNet- work comes with an embedded DBMS (H2) which is used by default during installation. This DBMS can be used for small or desktop installations of no more than a few thousand metadata records with one or two users. If you have heavier demands then you should use a professional, stand alone DBMS. GeoNetwork does not require a powerful machine. Good performance can be obtained even with 1GB of RAM. The suggested amount is 2GB. For hard disk space, you have to consider the space required for the application itself (about 350 MB) and the space required for data, which can require 50 GB or more. A simple disk of 250 GB should be OK. You also need some space for the search index which is located in GEONETWORK_DATA_DIR/index (by default GEONETWORK_DATA_DIR is INSTALL_DIR/web/geonetwork/WEB_INF/data. However, even with a few thousand metadata records, the index is small so usually 500 MB of space is more than enough. The software is run in different ways depending on the servlet container you are using: • Tomcat - GeoNetwork is available as a WAR file which you can put into the Tomcat webapps directory. Tomcat will deploy the WAR file when it is started. You can then use the Tomcat manager web application to stop/start GeoNetwork. You can also use the startup.* and shutdown.* scripts located in the Tomcat bin directory (.* means .sh or .bat depending on your OS) but if you have other web applications in the tomcat container, then they will also be affected. • Jetty - If you use the provided container you can use the scripts in GeoNetwork’s bin directory. The scripts are start-geonetwork.* and stop-geonetwork.* and you must be inside the bin directory to run them. You can use these scripts just after installation. 3 GeoNetwork Developer Manual, Release 2.10.4-0 1.2 Tools The following tools are required to be installed to setup a development environment for GeoNetwork: • Java - Developing with GeoNetwork requires Java Development Kit (JDK) 1.6 or greater (scroll down to find 1.6) OR the OpenJDK (version 7 or higher only) for Linux users. • Maven - GeoNetwork uses Maven to manage the build process and the dependencies. Once is installed, you should have the mvn command in your path (on Windows systems, you have to open a shell to check). • Git - GeoNetwork source code is stored and versioned in a Git repository on Github. Depending on your operating system a variety of git clients are avalaible. Check in http://git-scm.com/downloads/guis for some alternatives. Good documentation can be found on the git website: http://git-scm.com/documentation and on the Github website https://help.github.com/. • Ant - GeoNetwork uses Ant to build the installer. Version 1.6.5 works but any other recent version should be OK. Once installed, you should have the ant command in your path (on Windows systems, you have to open a shell to check). • Sphinx - To create the GeoNetwork documentation in a nice format Sphinx is used. 1.3 Check out source code If you just want to quickly get the code the fastest way is to download the zip bundle: https://github.com/geonetwork/ core-geonetwork/zipball/master However, it is recommended that if you want to contribute back to Geonetwork you create a Github account, fork the Geonetwork
Load more

Recommended publications
  • An Open-Source Web Platform to Share Multisource, Multisensor Geospatial Data and Measurements of Ground Deformation in Mountain Areas
    International Journal of Geo-Information Article An Open-Source Web Platform to Share Multisource, Multisensor Geospatial Data and Measurements of Ground Deformation in Mountain Areas Martina Cignetti 1,2, Diego Guenzi 1,* , Francesca Ardizzone 3 , Paolo Allasia 1 and Daniele Giordan 1 1 National Research Council of Italy, Research Institute of Geo-Hydrological Protection (CNR IRPI), Strada delle Cacce 73, 10135 Turin, Italy; [email protected] (M.C.); [email protected] (P.A.); [email protected] (D.G.) 2 Department of Earth Sciences, University of Pavia, 27100 Pavia, Italy 3 National Research Council of Italy, Research Institute of Geo-Hydrological Protection (CNR IRPI), Via della Madonna Alta 126, 06128 Perugia, Italy; [email protected] * Correspondence: [email protected] Received: 20 November 2019; Accepted: 16 December 2019; Published: 18 December 2019 Abstract: Nowadays, the increasing demand to collect, manage and share archives of data supporting geo-hydrological processes investigations requires the development of spatial data infrastructure able to store geospatial data and ground deformation measurements, also considering multisource and heterogeneous data. We exploited the GeoNetwork open-source software to simultaneously organize in-situ measurements and radar sensor observations, collected in the framework of the HAMMER project study areas, all located in high mountain regions distributed in the Alpines, Apennines, Pyrenees and Andes mountain chains, mainly focusing on active landslides. Taking advantage of this free and internationally recognized platform based on standard protocols, we present a valuable instrument to manage data and metadata, both in-situ surface measurements, typically acquired at local scale for short periods (e.g., during emergency), and satellite observations, usually exploited for regional scale analysis of surface displacement.
    [Show full text]
  • Implementing Data Share Policy Final
    Implementing Data Share Through Open Source Portal Platforms presented by Bo Guo, PE, PhD and Kathy O’Donnell of Gistic Research, Inc and Scott Andreasen of Parsons Brinckerhoff Spatial Data Infrastructure (SDI) An SDI is to acquire, process, distribute, use, maintain, and preserve spatial data through Technology Policies Standards Human Resources, and related activities necessary A geospatial data portal is an important part of an SDI Tale of Two Portals Geoportal Discussion of GOS 2 Esri Opensource GOS Initiative performance & Geoportal scalability GOS implementation GOS retires with Geoportal Toolkit Merged with data.gov as geo.data.gov Version 2 GeoNetwork FAO + UNEP Multiple metadata standards started Harvesting development Initial release as FOSS 2001 2003 2006 2009 2012 Outline AGIC Data Sharing Guidelines Data Sharing Models and Web Portals Esri’s Geoportal Server OpenSource GeoNetwork Opensource Conclusion Arizona Data Sharing Guidelines “A Blueprint for Geospatial Data Sharing Policy in Arizona” Developed by AGIC Administration & Legal Committee Currently under review – discussed fully in next session! Provides guide to data sharing best practices Conforms to ARS provisions for data sharing No written agreement necessary between agencies – okay to share if you’re custodian Sharing agency retains custodial ownership of data Okay to prohibit redistribution of data, if desired Okay to exempt from commercial fees Sharing agency not liable for data errors Arizona Data Sharing Guidelines Arizona portal should
    [Show full text]
  • Developing a Free and Open Source Software Based Spatial Data Infrastructure
    Developing a Free and Open Source Software based Spatial Data Infrastructure Jeroen Ticheler 1 License This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 2.5 License. To view a copy of this license, visit http:// creativecommons.org/licenses/by-nc-sa/2.5/ or send a letter to Creative Commons, 543 Howard Street, 5th Floor, San Francisco, California, 94105, USA. 2 The acronyms ☺ OGC - Open Geospatial Consortium ISO - International Standards Organization SDI - Spatial Data Infrastructure FOSS - Free and Open Source Software GEOFOSS - GeoSpatial FOSS ;-) 3 I’ll only use five acronyms in the presentation, so we’ll say them out loud together starting really easy! Overview What is Free and Open Source Software? Complexity of a Spatial Data Infrastructure Some examples Expert communities The future 4 What is Free and Open Source Software? 5 What is Software? Instructions that make hardware work Programmers write scripts that can be understood by people and by compilers: the source code Compiled software can not be fixed or adapted to user needs 6 What is Software? A key property is that it can be infinitely copied without any loss 7 What is FOSS? FOSS provides access to the source code of an application You are Free to use software and modify the source code to suit your needs 8 Source code is often the most secret property of a company What is FOSS? FOSS Closed Source The most prominent examples 9 Some of the most prominent examples of Open Source versus Commercial software: Linux vs Windows Mozilla Firefox vs
    [Show full text]
  • Establishing a CSW Metadata Catalogue with Geonetwork Opensource
    NETMAR Deliverable D7.9.2: ICAN semantic interoperability cookbooks – Part 3 International Coastal Atlas Network Cookbook: Establishing a CSW metadata catalogue with GeoNetwork opensource © 2012 NETMAR Consortium 1 EC FP7 Project No. 249024 NETMAR Deliverable D7.9.2: ICAN semantic interoperability cookbooks – Part 3 Table of Contents Introduction............................................................................................................................................3 What is a metadata catalogue? ...........................................................................................................3 What is CSW?.......................................................................................................................................3 CSW Application Profiles .....................................................................................................................3 CSW Servers.........................................................................................................................................4 Installing and configuring GeoNetwork 2.6.4......................................................................................5 Installing GeoNetwork 2.6.4.............................................................................................................5 Configuring the database for GeoNetwork 2.6.4............................................................................6 Configure GeoNetwork for Tomcat (optional).................................................................................8
    [Show full text]
  • Descargar Manual De Instalación De Geonetwork Para Windows
    MANUAL DE INSTALACIÓN Y CONFIGURACIÓN DE GEONETWORK 3.2 EN WINDOWS Versión: 1.0 Autor: Darwin Denis Quispe Llancacuro Contacto: [email protected] Resumen: En este documento se detallan los pasos para la instalación y configuración de Geonetwork 3.2.x. Palabras claves: metadatos, IDEP, geonetwork Fecha: 19/07/2017 Manual De Instalación Y Configuración De Geonetwork 3.2 1 CONTENIDO INTRODUCCIÓN ............................................................................................................................. 3 PROPÓSITO ................................................................................................................................ 3 DEFINICIONES ............................................................................................................................ 3 TÉRMINOS Y ABREVIACIONES ................................................................................................... 4 REQUERIMIENTOS PREVIOS A LA INSTALACIÓN ........................................................................... 6 Software Requerido .................................................................................................................. 6 Hardware Requerido ................................................................................................................. 6 PROCESO DE INSTALACIÓN EN WINDOWS ................................................................................... 7 1. Instalación y Configuración de Java Runtime Environment (JRE) ..................................... 7 1.1. Instalación
    [Show full text]
  • Newsletter Ecdl-Gis@Lartu Ecdl-Gis
    NEWSLETTER ECDL-GIS@LARTU ECDL-GIS NEWSLETTER Anno I - Numero 2 – Novembre 2011 - Politecnico e Università di Torino - Dipartimento Interateneo Territorio [ DITER ] - Laboratorio di Analisi e Rappresentazioni Territoriali ed Urbane [ LARTU ] - Castello del Valentino Manica Chevalley - Primo e secondo piano interrato - Viale Mattioli, 39 - 10125 Torino - Tel. +390115647478 - Fax. +390115647451 – www.ecdlgis.polito.it - www.lartu.polito.it – [email protected] – Test Center ECDL-GIS NEWSLETTER ECDL-GIS@LARTU Useful resources [!Update Your Bookmarks!] - Unsorted, unclassified GIS tools, blogs and other resources… ..................................................................................................................................5 GeoNetwork .............................................................................................................................................5 Nasa World Wind ....................................................................................................................................5 NatureServe Vista: Decision Support for Better Planning ................................................................5 Digital Media Center ...............................................................................................................................6 Biodiversity Informatics ..........................................................................................................................7 Open Topography ...................................................................................................................................7
    [Show full text]
  • Osgeo Journal the Journal of the Open Source Geospatial Foundation Volume 2 / September 2007
    OSGeo Journal The Journal of the Open Source Geospatial Foundation Volume 2 / September 2007 In This Volume Topology Basics 1Spatial: Data Quality Concepts Introducing MapWindow & GeoNetwork LizardTech: Why we use Open Source software Local Chapter Reports: Taiwan, U.K., Francophone, Spanish... Case studies: UN FAO, Fishing Vessel Tracking... Community Event Reports: India, France GRASS & distributed computing News & Software Updates... OSGeo Journal GeoNetwork opensource Vol. 2, September 2007 Project Spotlights GeoNetwork opensource Internationally Standardized Distributed Spatial within the UN system, forming a central and basic Information Management element in the development of a United Nations Spa- tial Data Infrastructure (UNSDI). In other national by Jeroen Ticheler and Jelle U. Hielkema and international organizations and initiatives such as the Consultative Group on International Agricul- GeoNetwork "opensource" is a standardized and tural Research (CGIAR), the European Space Agency decentralized Geospatial Information Management (ESA), the US Federal Geographic Data Committee System, based on the concept of distributed data (FGDC), in countries implementing National Spatial and information ownership and is designed to en- Data Infrastructures (NSDI), in Europe in the con- able access to geo-referenced data and cartographic text of The INfrastructure for SPatial InfoRmation products through descriptive metadata. Collections in Europe (INSPIRE), as contribution to the Group maintained at different organizations are accessible on Earth Observations (GEO) and others, GeoNetwork through a single entry point. This approach of ge- opensource has also seen a remarkable uptake. ographic information management enhances easy and timely access to existing spatial data for a wide community of users, supporting informed decision- The GeoNetwork opensource making in a variety of application fields.
    [Show full text]
  • Open Source Software
    Open Source Software Desktop GIS GRASS GIS -- Geographic Resources Analysis Support System, originally developed by the U.S. Army Corps of Engineers:, is a free, open source geographical information system (GIS) capable of handling raster, topological vector, image processing, and graphic data. http://grass.osgeo.org/ gvSIG -- is a geographic information system (GIS), that is, a desktop application designed for capturing, storing, handling, analyzing and deploying any kind of referenced geographic information in order to solve complex management and planning problems. http://www.gvsig.com/en ILWIS -- Integrated Land and Water Information System is a GIS / Remote sensing software for both vector and raster processing. http://52north.org/downloads/category/10-ilwis JUMP GIS / OpenJUMP -- is a Java based vector GIS and programming formwork. http://jump-pilot.sourceforge.net/ MapWindow GIS -- is an open source GIS (mapping) application and set of programmable mapping components. http://www.mapwindow.org/ QGIS -- is a cross-platform free and open-source desktop geographic information system (GIS) application that provides data viewing, editing, and analysis capabilities http://qgis.org/en/site/ SAGA GIS -- System for Automated Geoscientific Analysis (SAGA GIS) is a free and open source geographic information system used for editing spatial data. http://www.saga-gis.org/en/index.html uDig -- is a GIS software program produced by a community led by Canadian-based consulting company Refractions Research. http://udig.refractions.net/ Capaware -- is a 3D general purpose virtual world viewer. http://www.capaware.org/ FalconView -- is a mapping system created by the Georgia Tech Research Institute. https://www.falconview.org/trac/FalconView Web map servers GeoServer -- an open-source server written in Java - allows users to share process and edit geospatial data.
    [Show full text]
  • The Complete Manual in Pdf Format
    The complete manual By the developers V 2.4 Copyright © 2007-2009 The Open Source Geospatial Foundation Table of Contents Preface ..................................................................................................................................... vi I. User Guide ............................................................................................................................. 1 1. A Geographic Information Management System for all ..................................................... 2 1.1. Introduction ......................................................................................................... 2 What is GeoNetwork opensource ........................................................................ 2 Background and evolution .................................................................................. 2 The use of International Standards ..................................................................... 3 Harvesting geospatial data in a shared environment ............................................. 3 1.2. GeoNetwork and the Open Source Community Development ................................. 3 2. Getting Started ............................................................................................................... 5 2.1. Default Search .................................................................................................... 5 2.2. Searching by Categories ...................................................................................... 6 2.3. Advanced Search ...............................................................................................
    [Show full text]
  • Geonetwork User Manual (PDF)
    GeoNetwork User Manual Release 2.10.4-0 GeoNetwork September 23, 2021 CONTENTS 1 Preface 3 1.1 About this Project............................................3 1.2 License Information...........................................3 1.3 Author Information............................................4 2 Quick Start Guide 5 2.1 Geographic Information Management for all..............................5 2.2 Getting Started..............................................8 2.3 Viewing and Analysing the Data..................................... 21 2.4 Adding a metadata record........................................ 28 2.5 Uploading a New Record using the XML Metadata Insert Tool..................... 46 2.6 Metadata in Spatial Data Management.................................. 50 2.7 New Features............................................... 51 2.8 Installing the software.......................................... 55 2.9 Upgrading to a new Version....................................... 64 3 Administration 65 3.1 System configuration........................................... 65 3.2 Authentication.............................................. 75 3.3 OGC CSW server configuration..................................... 81 3.4 Advanced configuration......................................... 86 3.5 User and Group Administration..................................... 101 3.6 Localization............................................... 107 3.7 System Monitoring............................................ 108 4 Managing Metadata 111 4.1 Templates................................................
    [Show full text]
  • Geonetwork User Manual Release 2.6.4
    GeoNetwork User Manual Release 2.6.4 GeoNetwork May 24, 2011 Contents 1 Preface 3 1.1 About this Project.....................................3 1.2 License Information....................................3 1.3 Author Information.....................................4 2 Quick Start Guide5 2.1 Geographic Information Management for all.......................5 2.2 Getting Started.......................................8 2.3 Viewing and Analysing the Data.............................. 20 2.4 Adding new Data and Information............................. 27 2.5 Entering Metadata for your Map.............................. 34 2.6 Uploading a New Record using the XML Metadata Insert Tool.............. 49 2.7 Metadata in Spatial Data Management........................... 50 2.8 Installing the software................................... 54 3 Administration 61 3.1 Basic configuration..................................... 61 3.2 User and Group Administration.............................. 67 3.3 OGC CSW Server configuration.............................. 72 3.4 Import facilities...................................... 74 3.5 Harvesting......................................... 79 3.6 Metadata ownership.................................... 96 3.7 Templates.......................................... 98 3.8 Thesaurus.......................................... 100 3.9 GeoNetwork’s Administrator Survival Tool - GAST................... 105 3.10 Localization........................................ 108 3.11 Import / export tools.................................... 109 4 Glossary
    [Show full text]
  • Title: Report of the Metadata Catalog Implementation Creator: Matteo
    DOCUMENT INFORMATION Title: Report of the Metadata catalog implementation Creator: Matteo Mazzucato, Qiu Songyin Subject: Installation, setup and tests on metadata catalogue Description: This document describes how to install and setting the CAIQ metadata catalog Publisher: Istituto Zooprofilattico Sperimentale delle Venezie (Italy) Chinese Academy of Inspection and Quarantine (China) Date: 10/07/2016 Identifier: Metadata catalog Language: En Introduction In the previous meeting a scouting session was done in order to define which metadata catalog software would have been to be used for the project. The software named GeoNetwork (https://geonetwork- opensource.org/) was identified as the final solution. GeoNetwork GeoNetwork is a catalog application used to manage spatially referenced resources. It provides powerful metadata editing and search functions as well as an interactive web map viewer. It is currently used in numerous Spatial Data Infrastructure initiatives across the world. The software was selected for several reasons: an open-source solution named GeoNetwork opensource is available; it is constantly supported and maintained by the community; it is an OSGeo Project; it has a dedicated User Interface (UI) for metadata setting and publishing; it may work combined with Geoserver (software that we use in this project to publish spatial data). Installation During the training, under the supervision of Prof. Massimo Rumor, a dedicated Virtual Machine (VM) was activated in order to prepare a safe environment for installing and testing different software. The same was built locally in order to test configuration in different computers (not server) to test and verify the SO compatibility. To install GeoNetwork the WAR file method was applied.
    [Show full text]