In this document you’ll only find specific information for installing GeoNetwork.
It is expected that the base system has already been properly installed and configured as described in Installing the Operating System.
In such document there are information about how to install some required base components, such as PostgreSQL (Installing PostgreSQL and PostGIS), Apache HTTPD (Apache HTTP Server Installation), Java (Installing Java), Apache Tomcat (Tomcat Installation).
Hint
The GeoNetwork project page is at http://geonetwork-opensource.org/
Download the .war files needed for a full GeoNetwork installation, for instance:
cd /root/download
wget https://kent.dl.sourceforge.net/project/geonetwork/GeoNetwork_opensource/v3.2.1/geonetwork.war
Hint
You may find other userful custom builds at http://demo.geo-solutions.it/share/geonetwork
Create catalina base directory for GeoNetwork:
cp -a /var/lib/tomcat/base/ /var/lib/tomcat/geonetwork
cp /root/download/geonetwork.war /var/lib/tomcat/geonetwork/webapps/
GeoNetwork data dirs can be externalized. This means that GeoNetwork can be instructed to create such directories outside the webapp directory, so they will be maintained through the application upgrades.
We’ll put the data in /var/lib/tomcat/geonetwork/gn/data. Create the directory hierarchy:
cd /var/lib/tomcat/geonetwork/
mkdir -p gn/data
By setting the sytem property geonetwork.dir we’ll tell GeoNetwork to use such directory to store its data.
Some GeoNetwork internal configuration can be overridden by external definitions.
By setting the system property geonetwork.jeeves.configuration.overrides.file you can define an override file which will replace some default configuration with local ones. We’ll set this property in the setenv.sh file (see next subsection).
In the override file you can:
Here a recap of the configuration flow:
We have to set some system vars used by tomcat, by the JVM, and by the webapp itself.
Create the file
vim /var/lib/tomcat/geonetwork/bin/setenv.sh
and insert this content.
Then make it executable:
chmod +x /var/lib/tomcat/geonetwork/bin/setenv.sh
Create the override file:
vim /var/lib/tomcat/geonetwork/gn/config-overrides.xml
You need different content in the override file for the different DBMS.
This is the content of the override file to setup the H2 db.
Note that using H2 you can configure the path where H2 will store the files containing the DB data. By default the DB files will be create in the current directory at the time of the startup of GeoNetwork. You can define the path in the JDBC URL.
<overrides>
<spring>
<set bean="jdbcDataSource" property="Url" value="jdbc:h2:/PATH/TO/THE/DB/FILE"/>
<set bean="jdbcDataSource" property="username" value="admin"/>
<set bean="jdbcDataSource" property="password" value="gnos"/>
</spring>
</overrides>
This is the content of the override file to setup a PG db:
<overrides>
<spring>
<set bean="jpaVendorAdapter" property="database" value="POSTGRESQL"/>
<set bean="jdbcDataSource" property="driverClassName" value="org.postgresql.Driver"/>
<set bean="jdbcDataSource" property="Url" value="jdbc:postgresql://localhost:5432/gn3"/>
<set bean="jdbcDataSource" property="username" value="gn3"/>
<set bean="jdbcDataSource" property="password" value="gn3"/>
</spring>
</overrides>
This is the content of the override file to setup an Oracle db.
Please note that when GeoNetwork is installed the first time, it will insert some initial data in the DB. This procedure will use lots of resources, so you’ll need to set the properties poolPreparedStatements and maxOpenPreparedStatements as indicated below, or you’ll get a “Too many cursor” error. Once the installation has completed, you can safely remove those settings.
Also remember to install the Oracle JDBC .jar file in the tomcat lib/ directory. Since this file is not redistributable according to Oracle policies, you’ll have to download it on your own, accepting Oracle’s license.
<overrides>
<spring>
<set bean="jpaVendorAdapter" property="database" value="ORACLE"/>
<set bean="jdbcDataSource" property="driverClassName" value="oracle.jdbc.driver.OracleDriver"/>
<set bean="jdbcDataSource" property="Url" value="jdbc:oracle:thin:@//10.10.100.77:1521/ORCL"/>
<set bean="jdbcDataSource" property="username" value="gnora"/>
<set bean="jdbcDataSource" property="password" value="gnora"/>
<set bean="jdbcDataSource" property="validationQuery" value="SELECT 1 FROM DUAL"/>
<!-- only when installing the first time -->
<set bean="jdbcDataSource" property="poolPreparedStatements" value="false"/>
<set bean="jdbcDataSource" property="maxOpenPreparedStatements" value="-1"/>
</spring>
</overrides>
Copy the content of this file into /var/lib/tomcat/geonetwork/gn/config-datastore.xml.
This file will configure the database for the spatial index. By default it will use the same information and credentials used for the default PostgreSQL database, (which means it should be spatially enabled).
If you need to use another database (maybe on Oracle), you need to edit this file.
JNDI should allow you to configure the databases at the container level, so that you won’t need to set any credentials in GeoNetwork configuration files. It should work both for the internal database and the db for the spatial index.
(More will be added here once we test the JNDI configuration and prepare the sample files.)
Set the ownership of the geonetwork/ related directories to user tomcat
chown tomcat: -R /var/lib/tomcat/geonetwork