Building from Source Code

System Requirements

Java 8

GeoNetwork is a Java 8 application that runs as a servlet, which means that a Java Development Kit (JDK) must be installed in order to build and run it. You can get a Java 8 JDK from your Linux distribution, Oracle OpenJDK or AdoptOpenJDK. Please note that the Java 8 Oracle JDK is currently only being distributed for testing purposes.

Because GeoNetwork is developed with Java 8 (LTS), this has the following implications:

  • GeoNetwork should not be developed with newer versions of Java.

  • Java 11 (LTS) is not supported at this time.

  • GeoNetwork won’t run at all with Java 7 (1.6) or earlier releases.

Application Server

Next, you need a servlet container. GeoNetwork ships with an embedded container, Eclipse Jetty, which is fast and well-suited for most applications.

If you need a more powerful container, we recommend Apache Tomcat. Tomcat provides load balancing, fault tolerance and other production features. Apache Tomcat is widely used with many organizations standardizing on Tomcat for all their Java Web Applications.

We recommend the following stable releases of Tomcat:

  • Apache Tomcat 8.5

  • Apache Tomcat 9.0

Database

Regarding storage, you need a Database Management System (DBMS) like Oracle, MySQL, Postgresql etc. GeoNetwork 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.

Environment

Being written in Java, GeoNetwork can run on any platform that supports Java: primarily Linux, Windows and macOS.

GeoNetwork is not resource intensive and will not require a powerful machine. Good performance can be obtained with 1GB of RAM. However, the suggested amount is 2GB of RAM.

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 could grow up to 50 GB or more. A simple (SSD) disk of 250 GB should be sufficient in most cases. You also need some disk 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 runs 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 startup.* and shutdown.* and you must be inside the bin directory to run them. You can use these scripts just after installation.

Tools

The following tools are required to be installed to setup a development environment for GeoNetwork:

  • Java 8 - Developing with GeoNetwork requires Java Development Kit (JDK) 1.8.

  • Maven 3.1.0+ - 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 available. Please check the Git website for some alternatives and good documentation. More documentation can be found on the Github website.

  • 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 build the GeoNetwork documentation in a nice format, Sphinx is used. Please note that if you don’t have a Python interpreter on your system, Sphinx will not work, so you need to install Python.

Building & Running

If you only wish to quickly build and run GeoNetwork, execute the following:

git clone --depth 3 --recursive https://github.com/geonetwork/core-geonetwork.git
cd core-geonetwork
mvn clean install -DskipTests
cd web
mvn jetty:run

Now open your browser and navigate to http://localhost:8080/geonetwork.

For a more detailed explanation, please read on.

Check out the source code

Clone the repository and build:

git clone --recursive https://github.com/geonetwork/core-geonetwork.git
cd core-geonetwork
mvn clean install -DskipTests

Submodules

GeoNetwork use submodules, these were initialized by the --recursive option when cloning the repository.

If you missed using --recursive run the following:

cd core-geonetwork
git submodule init
git submodule update

Submodules are used to keep track of externals dependencies. It is necessary to init and update them after a branch change:

git submodule update --init

Remember to rebuild the application after updating external dependencies.

Build GeoNetwork

Once you checked out the code from Github repository, go inside the GeoNetwork’s root folder and execute the Maven build command:

mvn clean install

If the build is successful you’ll get an output like:

[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO] ------------------------------------------------------------------------
[INFO] GeoNetwork opensource ................................. SUCCESS [1.345s]
[INFO] Caching xslt module ................................... SUCCESS [1.126s]
[INFO] Jeeves modules ........................................ SUCCESS [3.970s]
[INFO] ArcSDE module (dummy-api) ............................. SUCCESS [0.566s]
[INFO] GeoNetwork web client module .......................... SUCCESS [23.084s]
[INFO] GeoNetwork user interface module ...................... SUCCESS [15.940s]
[INFO] Oaipmh modules ........................................ SUCCESS [1.029s]
[INFO] GeoNetwork domain ..................................... SUCCESS [0.808s]
[INFO] GeoNetwork core ....................................... SUCCESS [6.426s]
[INFO] GeoNetwork CSW server ................................. SUCCESS [2.050s]
[INFO] GeoNetwork health monitor ............................. SUCCESS [1.014s]
[INFO] GeoNetwork harvesters ................................. SUCCESS [2.583s]
[INFO] GeoNetwork services ................................... SUCCESS [3.178s]
[INFO] GeoNetwork Web module ................................. SUCCESS [2:31.387s]
[INFO] ------------------------------------------------------------------------
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 3 minutes 35 seconds
[INFO] Finished at: Sun Oct 27 16:21:46 CET 2013

Your local Maven repository now contain the GeoNetwork artifacts created ($HOME/.m2/repository/org/geonetwork-opensource).

Compilation options

Many Maven build options are available, for instance, you might like to use following options :

-- Skip test
$ mvn install -DskipTests

-- Offline use
$ mvn install -o

-- Build really fast with 2 threads per cpu core
$ mvn install -o -DskipTests -T 2C

Please refer to the Maven documentation for any other options.

Maven Profiles

Maven profiles are used to enable additional build configuration.

Some components (eg. WFS feature indexing) of the application rely on an Elasticsearch instance. To enable those options, build the application with the `es` profile.

mvn clean install -Pes

Run embedded Jetty server

Maven comes with built-in support for Jetty via a plug-in.

To run GeoNetwork with the embedded Jetty server you have to change directory to the root of the web module, and then execute the following Maven command:

mvn jetty:run -Penv-dev

After a while, GeoNetwork should be accessible at: http://localhost:8080/geonetwork

For changes related to the user interface in the web-ui module or the metadata schemas in the schemas module, these can be deployed in Jetty executing the following Maven command in the web module:

mvn process-resources