Skip to content
Ethan Gruber edited this page Sep 18, 2025 · 1 revision

The first step in deploying Nomisma is to deploy Tomcat on the server.

sudo apt-get install tomcat10

This will install Tomcat and all dependencies, including the latest Java JDK. Tomcat's home in Ubuntu is /var/lib/tomcat10 by default.

Configuring the Virtual Machine

By default, the Tomcat startup script will allot less than 500 MB of heap space to Java. Any application running Orbeon will likely require at least 2GB for test and 4GB in production, especially considering the complexity of the harvesting and transformation process. Nomisma.org serves hundreds of thousands or even millions of API calls and SPARQL queries per day, and so it should run on a server with at least 32GB of memory. Of this, Tomcat should be assigned 24GB, with the remaining reserved for Solr, Apache, and other system services.

The Orbeon wiki has documentation for configuring the virtual machine. Edit /etc/default/tomcat10 to modify the Java defaults. The following should function well in production:

JAVA_OPTS="-server -Djava.awt.headless=true -Xms24G -Xmx24G"
Clone this wiki locally