Skip to content

Install Apache Tomcat

Overview

In addition to a Java runtime environment, Fusion Metadata Registry requires a Java web application server, also known as a web container.

Note

FMR 12 requires a Java web application server that implements the Servlet 6.0, Jakarta EE 10, and JSP 3.1 specifications.

In practice this means Apache Tomcat 10.1 or equivalent.

FMR is tested with the following servers:

The rest of this guide assumes Apache Tomcat.

Set the Java runtime options

Configure Tomcat to set the Java runtime options used when it starts. The most important setting is the Java heap size available to FMR.

A minimum of 16 GB is recommended. Set this using the Java runtime -Xmx option:

  1. Go to the tomcat\bin folder.
  2. Create a file called setenv.bat with the following content:
set "JAVA_OPTS=-Xmx16G"
  1. Go to the tomcat/bin folder.
  2. Create a file called setenv.sh with the following content:
export JAVA_OPTS="-Xmx16G"

The file does not need executable permissions, but it must be readable.

Additional Java configuration

You can set other Java runtime options using the JAVA_OPTS and CLASSPATH environment variables. Refer to the Java environment variables guidance.

Change the Tomcat port number

By default, Apache Tomcat serves the FMR web application on port 8080.

To choose a different port:

  1. Go to the tomcat/conf folder.
  2. Edit server.xml.
  3. Search for Connector port.
  4. Replace 8080 with the port number you want to use, for example 8081.
  5. Restart the Tomcat server.