Changes between Version 7 and Version 8 of HowToRunUnderTomcat

Timestamp:

06/11/08 19:30:20 (17 years ago)

Author:

rjwalker

Comment:

--

HowToRunUnderTomcat

@@ -3 +3 @@
 GeoNetwork can be run under Tomcat.
 
+There are three web applications (webapps) in GeoNetwork; you will find
+them in the `web` directory of the installation: `geonetwork`, `intermap`, and `geoserver`.
+For GeoNetwork to function correctly in Tomcat (or in any servlet
+container, for that matter), you must publish at least `geonetwork` and `intermap`;
+the following instructions publish all three webapps.
+
  1. Install Tomcat.
- 2. Get a copy of GeoNetwork from [wiki:HowToWorkWithSubversion SVN] (or use an installed version)
- 3. Build GeoNetwork.  (See HowToCompile for instructions.  If you will be using !McKoi, use GAST to initialize the database.)
- 4. Configure Tomcat:
- * option 1: From your GeoNetwork build, copy the subdirectories of the `web` directory to the `webapps` directory of Tomcat. (So you will have `webapps/geonetwork`, etc., in your Tomcat installation.)
- * option 2: Put a file called geonetwork.xml in {$CATALINA_HOME}/conf/Catalina/localhost with the following contents (adjust the path as necessary):
-{{{
-<Context docBase="C:\Path To\devtree\sourceforge\geonetwork\trunk\web\geonetwork"
-         privileged="true" antiResourceLocking="false" antiJARLocking="false">
-</Context>
-}}}
- 5. Edit Tomcat's `server.xml` to set parameters as you wish.
- 6. Start Tomcat.
+ 1. Prepare GeoNetwork.  You can either:
+   a. Use the installer.
+   a. Download and build from source.  See HowToWorkWithSubversion
+      for help with downloading, and HowToCompile for help with
+      building.  If you will be using !McKoi, follow the instructions
+      to use GAST to initialize the database.
+ 1. Copy or link to the webapps.  Either:
+   a. From your GeoNetwork build (or installation), copy all of the
+      subdirectories of the `web` directory to the `webapps` directory
+      of Tomcat. (So you will have `webapps/geonetwork`, etc.,
+      in your Tomcat installation.)
+   a. In the directory `$CATALINA_HOME/conf/Catalina/localhost`
+      of your Tomcat installation, create a configuration file for
+      each webapp.  You will have files `geonetwork.xml`,
+      `intermap.xml`, and `geoserver.xml`. In the file `geonetwork.xml`
+      put the following, adjusting the `docBase` path as necessary:
+      {{{
+      <Context docBase="/...path_to_GeoNetwork_installation_goes_here.../web/geonetwork"
+               privileged="true" antiResourceLocking="false" antiJARLocking="false">
+      </Context>
+      }}}
+      In the file `intermap.xml`
+      put the following, adjusting the `docBase` path as necessary:
+      {{{
+      <Context docBase="/...path_to_GeoNetwork_installation_goes_here.../web/intermap"
+               privileged="true" antiResourceLocking="false" antiJARLocking="false">
+      </Context>
+      }}}
+      Same story with `geoserver.xml`.
+ 1. Edit Tomcat's `server.xml` to set parameters as you wish.
+ 1. Start Tomcat.
 
 '''''Unfortunately''''' . . . at present stopping Tomcat does not shut down GeoNetwork cleanly.  This is