Installing from WAR fileΒΆ

This section describes how to install GeoNetwork with the WAR.

At the end of the installation process you will end up with the web applications running.

Host ports requirements:

  1. Download the WAR file

GeoNetwork releases are available in https://sourceforge.net/projects/geonetwork/files/GeoNetwork_opensource/

You can download the WAR file geonetwork.war from your browser or use command line like

wget https://downloads.sourceforge.net/project/geonetwork/GeoNetwork_opensource/v3.10.2/geonetwork.war
  1. Copy the WAR to the Java web server

After download, copy the WAR file in the webapp folder of Tomcat or Jetty.

cp geonetwork.war /usr/share/apache-tomcat{X}/webapps/.
  1. Start the Java web server

If started, Tomcat will automatically deploy the application. If not, start the Java web server to deploy.

Note

You need to ensure Tomcat is configured with enough memory for GeoNetwork to launch. This can be be configured via the setenv script in tomcat with the appropriate memory for the JAVA_OPTS property). -Xms2g -Xmx2g is usually fine.

  1. Configure the search platform

Open http://localhost:8080/geonetwork in your web browser. You should see the GeoNetwork home page indicating that the search is not yet available.

../../_images/es-down.png

You need to install Elasticsearch or to configure GeoNetwork to use an existing instance.

Download Elasticsearch for your platform https://www.elastic.co/downloads/elasticsearch

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.6.2-linux-x86_64.tar.gz
tar xvfz elasticsearch-7.6.2-linux-x86_64.tar.gz
cd elasticsearch-7.6.2-linux-x86_64/bin
./elasticsearch

Open http://localhost:9200 in your web browser to check that Elasticsearch is running.

To use an existing instance check Configure connection in Installing search platform.

  1. Up and running?

Open or refresh http://localhost:8080/geonetwork in your web browser. You should see the GeoNetwork home page:

../../_images/es-empty.png

You have now a default GeoNetwork up and running.

To customize your catalog, you may follow the next steps to configure the database (See Configuring the database) instead of using the default H2 database and the data directory (See Customizing the data directory) .

See Loading templates and sample data to start loading metadata records.