Appendix A. Frequently Asked Questions

A.1. Users FAQ

A.1.1.

Where do I learn more about the use and functionality of the GeoNetwork opensource catalog?

The Quick Start Guide will provide you with an excellent first introduction. The Guide can be downloaded from the GeoNetwork Community website

A.2. Administrators FAQ

A.2.1.

I want to run GeoNetwork on another port than port 8080. What should I do?

To change the default port 8080, take the following steps:

  1. Change the servlet engine configuration. When running on the embedded Jetty, the configuration file to change is bin/jetty.xml

  2. Search intermap/WEB-INF/config.xml for 8080 and change it to the new port number

  3. Change the map service URLs for the local GeoServer layers that GeoNetwork connects to by default. The file to change is web/intermap/WEB-INF/mapServers.xml

  4. On Windows systems, change the startup script bin/win/start-stdln.html

  5. Start the GeoNetwork application and login as Administrator. In the System configuration panel you will need to change the Server port number

  6. If you changed the port number after uploading data in the system while using another port, you may need to start GAST and run the Metadata Sync in order to update the download links in the metadata.

Other affected, but non-critical files:

  • geonetwork/xml/csw/test/csw-Harvest.xml

  • geonetwork/xml/schemas/iso19139/process/thumbnails-host-url-relocator.xsl

  • geonetwork/xml/validation/csw202_apiso100/csw/2.0.2/examples/wsdl/2.0.2/service.wsdl

  • intermap/static/iframepoc.html

A.2.2.

I am having difficulty installing multiple instances of GeoNetwork on the same server

To run multiple installation you have to change the ports that GeoNetwork uses in order to avoid conflicts. The ports are:

  • Z39.50 listening port. This is the most probable source of conflicts. You can change the port in the System preferences panel under Administrative tools. Use for example 2101 but keep in mind that remote nodes usually use 2100 so your second node will not be reachable. You cannot use the system configuration web form the first time because if the port conflicts, the server won't start.

  • If you are using Jetty. 

    • Jetty's listening port. This can be modified in the bin/jetty.xml configuration file. The default value is 8080. To run a second installation use a different value, like 8081.

    • Jetty's stop port. This is defined into the scripts bin/start-geonetwork.* and bin/stop-geonetwork.* (for both Windows and Linux). The provided value is 8079 as the value of the STOP.PORT parameter. Use another value for the second installation, like 8078. If you don't change this value, the stop script will stop all instances.

  • If you are using the embedded McKoi DBMS. 

    • McKoi listening port. This can be easily modified using GAST. The default value is 9157. For other installations you can use 9158, 9159 and so on. The affected files are web/WEB-INF/config.xml and web/WEB-INF/db/db.conf.

A.2.3.

What is normally logged when running GeoNetwork opensource?

GeoNetwork has its own internal logging based on log4j Logging services (written by default to the file jetty/logs/geonetwork.log and jetty/logs/intermap.log for Intermap application). Additionaly there are log files generated by the web server (Jetty , Apache Tomcat etc..) and by the DBMS used (for example by the internal McKoi SQL ).

A.2.4.

How do I control what is written to the GeoNetwork internal log file?

The logging is configured in the files web/geonetwork/WEB-INF/log4j.cfg and web/intermap/WEB-INF/log4j.cfg. You can change the settings by editing the file in a text editor.

The default configuration uses a DailyRollingFileAppender that writes the daily log to the file logs/geonetwork.log and at midnight is copied to the file logs/geonetwork.log.yyyy-MM-dd starting in the file logs/geonetwork.log the logging for the new day.

log4j.appender.jeeves =org.apache.log4j.DailyRollingFileAppender log4j.appender.jeeves.DatePattern='.'yyyy-MM-dd log4j.appender.jeeves.file = logs/geonetwork.log

The console logging is also configured to show the datetime, the log intensity of the message (see below), the category and the logging message.

log4j.appender.console = org.apache.log4j.ConsoleAppender log4j.appender.console.layout = org.apache.log4j.PatternLayout log4j.appender.console.layout.ConversionPattern=%d{ISO8601} %-5p [%c] - %m%n

For operational systems it is suggested to put all log options to OFF or FATAL. The log options are, with increasing log intensity:

  • OFF - The OFF Level has the highest possible rank and is intended to turn off logging.

  • FATAL - The FATAL level designates very severe error events that will presumably lead the application to abort.

  • ERROR - The ERROR level designates error events that might still allow the application to continue running.

  • WARN - The WARN level designates potentially harmful situations.

  • INFO - The INFO level designates informational messages that highlight the progress of the application at coarse-grained level.

  • DEBUG - The DEBUG Level designates fine-grained informational events that are most useful to debug an application.

  • ALL - The ALL Level has the lowest possible rank and is intended to turn on all logging.

A.3. Developers FAQ

A.3.1.

What is Free and Open Source Software (FOSS) and how can I use, participate and contribute to the GeoNetwork opensource project?

The book "Producing Open Source Software" (shown in Figure A.1, “Producing Open Source Software”) is a highly recommended book for anyone working on open source software projects. It provides insight in all aspects of FOSS development and on how to make a project successful. If you are interested in participating in the GeoNetwork opensource project, please spend some time reading through this book. It's definitely worth the time and money (so buy the hardcopy if you can afford it!).

Producing Open Source Software is a book about the human side of open source development. It describes how successful projects operate, the expectations of users and developers, and the culture of free software.

The book is available in bookstores and from the publisher (O'Reilly Media), or you can browse or download it from http://producingoss.com/. Producing Open Source Software is released under an open copyright that allows everyone to share and modify the book freely. The latest version is always available on the website. The online version is the same as the commercially available print version ? in other words, you can buy a printed copy and know that it's up-to-date.

Figure A.1. Producing Open Source Software

Producing Open Source Software


Other documents: The complete manual in pdf format | License | Readme | Changes