Additional Software¶

The software listed here is not required to run GeoNetwork, but can be used for custom installations.

1. MySQL DBMS v5.5+ (All) [1]
2. Postgresql DBMS v7+ (All) [1]
3. Apache Tomcat v5.5+ (All) [1]

Supported browsers¶

GeoNetwork should work normally with the following browsers:

1. Firefox v1.5+ (All) [1]
2. Internet Explorer v8+ (Windows)
3. Safari v3+ (Mac OS X Leopard)

On Windows¶

If you use Windows, the following steps will guide you to complete the installation (other FOSS will follow):

1. Double click on geonetwork-install-2.8.0.exe to start the GeoNetwork opensource desktop installer
2. Follow the instructions on screen. You can choose to install the embedded map server (based on GeoServer, GAST and the European Union Inspire Directive configuration pack. Developers may be interested in installing the source code and installer building tools. Full source code can be found in the GeoNetwork github code repository at http://github.com/geonetwork.
3. After completion of the installation process, a ‘GeoNetwork desktop’ menu will be added to your Windows Start menu under ‘Programs’
4. Click Start>Programs>GeoNetwork desktop>Start server to start the Geonetwork opensource Web server. The first time you do this, the system will require about 1 minute to complete startup.
5. Click Start>Programs>Geonetwork desktop>Open GeoNetwork opensource to start using GeoNetwork opensource, or connect your Web browser to http://localhost:8080/geonetwork/

Installer

Packages to be installed

The installer allows to install these additional packages:

1. GeoNetwork User Interface: Experimental UI for GeoNetwork using javascript components based on ExtJs library.
2. GeoServer: Web Map Server that provides default base layers for the GeoNetwork map viewer.
3. European Union INSPIRE Directive configuration pack: Enables INSPIRE support in GeoNetwork.

• INSPIRE validation rules.
• Thesaurus files (GEMET, Inspire themes).
• INSPIRE search panel.
• INSPIRE metadata view.

4. GAST: Installs GeoNetwork’s Administrator Survival Tool. See GeoNetwork’s Administrator Survival Tool - GAST.

Installation using the platform independent installer¶

If you downloaded the platform independent installer (a .jar file), you can in most cases start the installer by simply double clicking on it.

Follow the instructions on screen (see also the section called On Windows).

At the end of the installation process you can choose to save the installation script.

Save the installation script for commandline installations

Commandline installation¶

If you downloaded the platform independent installer (a .jar file), you can perform commandline installations on computers without a graphical interface. You first need to generate an install script (see Figure Save the installation script for commandline installations). This install script can be edited in a text editor to change some installation parameters.

To run the installation from the commandline, issue the following command in a terminal window and hit enter to start:

java -jar geonetwork-install-2.8.0.jar install.xml
[ Starting automated installation ]
Read pack list from xml definition.
Try to add to selection [Name: Core and Index: 0]
Try to add to selection [Name: GeoServer and Index: 1]
Try to add to selection [Name: European Union INSPIRE Directive configuration pack and Index: 2]
Try to add to selection [Name: GAST and Index: 3]
Modify pack selection.
Pack [Name: European Union INSPIRE Directive configuration pack and Index: 2] added to selection.
Pack [Name: GAST and Index: 3] added to selection.
[ Starting to unpack ]
[ Processing package: Core (1/4) ]
[ Processing package: GeoServer (2/4) ]
[ Processing package: European Union INSPIRE Directive configuration pack (3/4) ]
[ Processing package: GAST (4/4) ]
[ Unpacking finished ]
[ Creating shortcuts ....... done. ]
[ Add shortcuts to uninstaller  done. ]
[ Writing the uninstaller data ... ]
[ Automated installation done ]

You can also run the installation with lots of debug output. To do so run the installer with the flag -DTRACE=true:

java -DTRACE=true -jar geonetwork-install-2.8.0.jar

Configuring the Default user interface¶

WEB-INF/config-gui.xml is used to define which home page to use. To configure the Default user interface use:

<client type="redirect"
  widget="false"
  url="main.home"
  parameters=""
  stateId=""
  createParameter=""/>

Configuring the Javascript Widgets user interface¶

Widgets can be used to build custom interfaces. GeoNetwork provides a Javascript Widgets interface for searching, viewing and editing metadata records.

This interface can be configured using the following attributes:

• parameter is used to define custom application properties like default map extent for example or change the default language to be loaded
• createParameter is appended to URL when the application is called from the administration > New metadata menu (usually “#create”).
• stateId is the identifier of the search form (usually “s”) in the application. It is used to build quick links section in the administration and permalinks.

Sample configuration:

<!-- Widget client application with a tab based layout -->
<client type="redirect"
  widget="true"
  url="../../apps/tabsearch/"
  createParameter="#create"
  stateId="s"/>

Configuring the user interface with configuration overrides¶

Instead of changing config-gui.xml file, the catalog administrator could use the configuration overrides mechanism to create a custom configuration (See Configuration override). By default, no overrides are set and the Default user interface is loaded.

To configure which user interface to load, add the following line in WEB-INF/config-overrides.xml in order to load the Widgets based user interface:

<override>/WEB-INF/config-overrides-widgettab.xml</override>

Choose a Database Connection Pool¶

To manage connections with the database efficiently, a database connection pool is used. GeoNetwork uses the Apache Database Connection Pool (DBCP). This connection pool can be configured directly in the config.xml file described below or in Jetty/tomcat through the Java Naming and Directory Interface (JNDI).

• ApacheDBCPool: This pool is recommended for smaller catalogs (less than 10,000 records).
• JNDIPool: This pool is configured in Jetty or Tomcat. It is recommended for larger catalogs (especially those with more than approx 30,000 records).

More details about the DBCP configuration parameters that can be used here are in the advanced configuration section of this manual (See Database configuration).

Download and install JDBC Drivers¶

For the Apache DBCP pool, JDBC database driver jar files should be in INSTALL_DIR/WEB-INF/lib. For Open Source databases, like MySQL and PostgreSQL, the jar files are already installed. For commercial databases like Oracle, the jar files must be downloaded and installed manually. This is due to licensing issues.

• DB2 JDBC driver download
• MS Sql Server JDBC driver download
• Oracle JDBC driver download

Specify configuration in GeoNetwork¶

GAST provides a graphical user interface to make database configuration easy. You can find out how to do this in the GAST section of the manual: GeoNetwork’s Administrator Survival Tool - GAST.

Alternatively you can manually configure the database by editing INSTALL_DIR/WEB-INF/config.xml. In the resources element of this file, you will find a resource element for each database that GeoNetwork supports. Only one of these resource elements can be enabled. The following is an example for the default H2 database used by GeoNetwork:

<resource enabled="true">
  <name>main-db</name>
  <provider>jeeves.resources.dbms.ApacheDBCPool</provider>
  <config>
    <user>admin</user>
    <password>gnos</password>
    <driver>org.h2.Driver</driver>
    <url>jdbc:h2:geonetwork;MVCC=TRUE</url>
    <poolSize>33</poolSize>
    <validationQuery>SELECT 1</validationQuery>
  </config>
</resource>

If you want to use a different database, then you need to set the enabled attribute on your choice to “true” and set the enabled attribute on the H2 database to “false”. NOTE: If two resources are enabled, GeoNetwork will not start.

As a minimum, the <user> , <password> and <url> for your database need to be changed. Here is an example for the DB2 database:

<resource enabled="true">
  <name>main-db</name>
  <provider>jeeves.resources.dbms.ApacheDBCPool</provider>
  <config>
    <user>db2inst1</user>
    <password>mypassword</password>
    <driver>com.ibm.db2.jcc.DB2Driver</driver>
    <url>jdbc:db2:geonet</url>
    <poolSize>10</poolSize>
    <validationQuery>SELECT 1 FROM SYSIBM.SYSDUMMY1</validationQuery>
  </config>
</resource>