Installation and Configuration Examples

Example 1

* from Tom Kralidis

Environment

• os: fc10
• db: MySQL 5.0.67
• java: 1.5.0_06
• apache: 2.2.10
• tomcat: 6.0.18
• Other notes:
  • required to run on port 80 (tomcat is tied to apache via proxy_ajp)
  • no X11 capability (restricted to command line only)

Steps

1. create a MySQL geonetwork db instance

$ mysqladmin create geonetwork

2. Create a u/p for the database

> grant select, insert, update, delete, drop, alter, create on table geonetwork.* to geonetwork@’localhost’ identified by ‘password’;

3. download and build GeoNetwork source (either latest stable or svn trunk [I'm using SVN trunk])

       $ svn co http://geonetwork.svn.sourceforge.net/svnroot/geonetwork/trunk ./geonetwork
       $ cd geonetwork && ant

4. update web/geonetwork/WEB-INF/config.xml

• in geonet/resources, set the McKoi resource to resource/@enabled="false"
• in geonet/resources, set the MySQL resource to resource/@enabled="true"
• In the MySQL XML definition:
  • set resource/config/user to the username you set in MySQL
  • set resource/config/password to the password you set in MySQL
  • set resource/config/url to jdbc:mysql://HOSTNAME:PORT/DATABASE_NAME

5. run GAST

$ cd geonetwork/gast && java -jar ./gast.jar -setupdb

6. Update tomcat configuration (in $CATALINA_HOME/conf/server.xml, inServer/Service/Engine/Host)

        <!-- geonetwork -->
        <Context path="/geonetwork" docBase="/path/to/geonetwork/web/geonetwork" reloadable="true"/>
        <Context path="/intermap" docBase="/path/to/geonetwork/web/intermap"/>
        <Context path="/geoserver" docBase="/path/to/geonetwork/web/geoserver"/>
        <Context path="/geonetwork/docs" docBase="/path/to/geonetwork/docs"/>

7. Update the Apache proxy_ajp configuration (mine was in /etc/httpd/conf.d/proxy_ajp.conf)

     ProxyPass /geonetwork ajp://localhost:8009/geonetwork/
     ProxyPass /geoserver ajp://localhost:8009/geoserver/
     ProxyPass /intermap ajp://localhost:8009/intermap/
     ProxyPass /geonetwork/docs ajp://localhost:8009/geonetwork/docs/

8. Restart tomcat (service tomcat6 restart OR $CATALINA_HOME/bin/shutdown.sh && $CATALINA_HOME/bin/startup.sh)

9. Restart Apache (service httpd restart OR /path/to/apachectl restart)

10. Go to http://HOSTNAME/geonetwork

Other info

• you have to set $SERVLET manually in gast/data/index.html. gast.jar usually sets this up through X11.
• if you make changes to the source code, running ant at the root of the dist builds the code again with the changes. You shouldn't have to reboot tomcat or apache