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:
- Java web server Apache Tomcat or Jetty: 8080
- Elasticsearch: 9200
- Kibana: 5601
- Database eg. 5432 for a default PostgreSQL installation
For Apache Tomcat we recommend the following versions: 8.5.x and 9.0.x. The latest Apache Tomcat 10.x cannot be used at this time.
For Jetty we the following versions: 9.4.x. Newer versions to Jetty cannot be used at this time.
-
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 -
Copy the WAR to the Java web server
After download, copy the WAR file in the webapp folder of Tomcat or Jetty.
-
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. -
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.
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.
-
Up and running?
Open or refresh http://localhost:8080/geonetwork in your web browser. You should see the GeoNetwork home page:
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.