= Running GeoNetwork under Tomcat =

GeoNetwork can be run under Tomcat.

 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.)
 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.

'''''Unfortunately''''' . . . at present stopping Tomcat does not shut down GeoNetwork cleanly.  This is
documented at [http://www.nabble.com/Tomcat-5.5-hangs-when-hosting-GN-2.2.0--SEC%3DUNCLASSIFIED--td17660763.html].
You need to make either of the modifications suggested there before you build.