Installing an application server

Tomcat is one of the most popular Applications Servers. We recommend using Tomcat 8.5 to run GeoNetwork Enterprise.

If you are running Windows, follow these step to install Tomcat:

  1. Visit the Apache Tomcat Download page:

  2. Under Binary Distributions download 32-bit/64-bit Windows Service Installer (pgp, sha512).

    ../../_images/tomcat_download.png

    Download 32-bit/64-bit Windows Service Installer

  3. Run the installer file. When prompted for the elements to install, check the Native and Service Startup options.

    ../../_images/tomcatinstalloptions.png

    Installation options

To manually install Apache Tomcat on Linux, follow these steps to install Tomcat:

  1. Download a Tomcat package (.tar.gz file in /bin folder)

  2. Extract the package:

    $ tar xvzf apache-tomcat-$TOMCAT_VERSION.tar.gz

  3. Move the extracted folder into a dedicated directory:

    $ sudo mv apache-tomcat-$TOMCAT_VERSION /usr/local/example/path/to/tomcat

  4. Edit your ~/.bashrc file to define the JAVA_HOME and CATALINA_HOME variables, needed for Tomcat to run. These should point to the paths where you have installed Java and Tomcat respectively. Add the following lines to the file, adapting the paths accordingly:

    export JAVA_HOME=/usr/lib/path/to/java
export CATALINA_HOME=/path/to/tomcat

Starting/stopping Tomcat

To start the Tomcat server, follow these steps:

  1. Navigate to the Tomcat bin folder (CATALINA_HOME/bin)

  2. Run startup (or ./startup.sh if you are running Linux)

To stop the server, do:

  1. Navigate to the Tomcat bin folder (CATALINA_HOME/bin)

  2. Run shutdown (or ./shutdown.sh if you are running Linux)