2.8.1 Where do I get the installer?
The software is distributed through the SourceForge.net Website at http://sourceforge.net/projects/geonetwork.
Use the platform independent installer (.jar) for all platforms except Windows. Windows has a .exe file installer.
2.8.2 System requirements
GeoNetwork can run either onMS Windows,LinuxorMac OS X.
Some general system requirements for the software to run without problems are listed below: Processor: 1 GHz or higher
Memory (RAM): 1 GB or higher
Disk Space: Minimum of 512MB of free disk space. Additional space is required depending on the amount of spatial data that you expect to upload.
Other Software requirements : A Java Runtime Environment (JRE 1.6.0). For server installations, Apache Tomcat and a dedicated JDBC compliant DBMS (MySQL, Postgresql, Oracle) can be used instead of Jetty and H2.
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)
2.8.3 How do I install GeoNetwork opensource?
Before running the GeoNetwork installer, make sure that all system requirements are satisfied, and in particular that the Java Runtime Environment version 1.6.0 is set up on your machine.
On Windows
If you use Windows, the following steps will guide you to complete the installation (other FOSS will follow):
Warning: Avoid installing in a directory containing spaces. Best is to install inc:\programs and not inc:\program files
1. Double click on geonetwork-install-2.10.x.exeto start the GeoNetwork opensource desktop in- staller
2. Follow the instructions on screen. You can choose to install the embedded map server (based onGeoServerand 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 athttp://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 tohttp://localhost:8080/geonetwork/
Figure 2.50:Installer The installer allows to install these additional packages:
GeoNetwork User Manual, Release 2.10.4-0
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 GeoNet-
work.
• INSPIRE validation rules.
• Thesaurus files (GEMET, Inspire themes). • INSPIRE search panel.
• INSPIRE metadata view.
4. GAST: Installs GeoNetwork’s Administrator Survival Tool. Seegast.
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.
Figure 2.52:Save the installation script for commandline installations
GeoNetwork User Manual, Release 2.10.4-0
Commandline installation
If you downloaded the platform independent installer (a .jar file), you can perform commandline in- stallations 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.10.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.10.0.jar
2.8.4 User interface configuration
As mentioned above, GeoNetwork now provides two user interfaces: • Defaultuser interface is the old user interface from 2.6.x and earlier
• Javascript Widgets user interface is the new user interface for searching, editing and viewing metadata records in 2.8.x
The catalog administrator can configure which interface to use inWEB-INF/config-gui.xmlas follows.
Configuring the Default user interface
WEB-INF/config-gui.xmlis used to define which home page to use. To configure the Default user inter- face use:
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:
• parameteris used to define custom application properties like default map extent for example or change the default language to be loaded
• createParameteris appended to URL when the application is called from the administration > New metadata menu (usually “#create”).
• stateIdis 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 (SeeConfiguration 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>
2.8.5 XSLT processor configuration
The fileINSTALL_DIR/web/geonetwork/WEB-INF/classes/META-INF/javax.xml.transform.TransformerFactory defines the XSLT processor to use in GeoNetwork. The allowed values are:
1. de.fzi.dbs.xml.transform.CachingTransformerFactory: This is the Saxon XSLT processor with caching (recommended value for production use). However, when caching is on, any updates you make to stylesheets may be ignored in favour of the cached stylesheets. 2. net.sf.saxon.TransformerFactoryImpl: This is the Saxon XSLT processorwithout
caching. If you plan to make changes to any XSLT stylesheets you should use this setting until you are ready to move to production.
GeoNetwork sets the XSLT processor configuration using Java system properties for an instant in order to obtain its TransformerFactory implementation, then resets it to the original value, to minimize affect the XSL processor configuration for other applications that may be running in the same container.
GeoNetwork User Manual, Release 2.10.4-0
2.8.6 Database configuration
Geonetwork uses theH2 database engineas default. The following additional database backends are supported (listed in alphabetical order):
• DB2 • H2 • Mckoi • MS SqlServer 2008 • MySQL • Oracle
• PostgreSQL (or PostGIS)
To configure one of these databases for use by GeoNetwork, three steps are required.
Choose a Database Connection Pool
To manage connections with the database efficiently, a database connection pool is used. GeoNetwork uses theApache 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 con- figuration section of this manual (SeeDatabase configuration).
Download and install JDBC Drivers
For the Apache DBCP pool, JDBC database driver jar files should be inINSTALL_DIR/WEB-INF/lib. For Open Source databases, like MySQL and PostgreSQL, the jar files are already installed. For com- mercial 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:gast.
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 willnotstart.
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>
2.8.7 Starting up GeoNetwork with a new database
At startup, GeoNetwork checks if the database tables it needs are present in the currently configured database. If not, the tables are created and filled with initial data.
If the database tables are present but were created with an earlier version of GeoNetwork, then a migra- tion script is run.
An alternative to running these scripts automatically is to execute them manually. This is preferable for those that would like to examine and monitor the changes being made to their database tables.
• The scripts for initial setup are located inINSTALL_DIR/WEB-INF/classes/setup/sql/create/ • The scripts for inserting initial data are located in INSTALL_DIR/WEB-
INF/classes/setup/sql/data/
• The scripts for migrating are located inINSTALL_DIR/WEB-INF/classes/setup/sql/migrate/
GeoNetwork User Manual, Release 2.10.4-0
2.8.8 Issues or exceptions with databases
If you run into problems when you start GeoNetwork with a particular database, you may find a solution in theSpecific Database Issuessection of this manual.