Tomcat 10.1.x on Ubuntu 24.04

This article describes the procedure for installing and configuring Apache Tomcat 10 for the OvalEdge application on Ubuntu 24.04. It includes the required prerequisites, application configuration steps, Tomcat service configuration, and application startup process. Follow the steps in the order provided to complete the installation successfully.

Prerequisites

Ensure the following prerequisites are available before starting the installation:

• Ubuntu 24.04 server

• User account with sudo privileges

• Stable internet connection

• Apache Tomcat 10 package

• OvalEdge application WAR file

• Required OvalEdge configuration files, including oasis.properties and log4j.properties

• Encryption key for the OVALEDGE_ENCRYPT_DECRYPT_KEY parame

Steps Involved

1. Create Required Directories

   • Log in to the application virtual machine.

   • Create the required folders to store OvalEdge application configuration files.

2. Download Apache Tomcat

   • Download the Apache Tomcat package using the following command:

     Copy

     wget https://ovaledge.s3.us-west-1.amazonaws.com/scripts/hardened_tomcat/apache-tomcat-10.1.40.tar.gz

     Sample Reference Screenshot:

     
3. Extract the Apache Tomcat Package

   • Extract the downloaded Tomcat package using the following command:

     Copy

     tar -xvf apache-tomcat-10.1.40.tar.gz

     Sample Reference Screenshots:

     

     
4. Configure the setenv.sh File

   • Navigate to the Tomcat bin directory.

   • Create the setenv.sh file using the following command:

     Copy

     vi apache-tomcat-10.1.40/bin/setenv.sh

   • Add the following content to the setenv.sh file:

     Copy

     export CATALINA_OPTS="-Duse.http=true -DOVALEDGE_SECURITY_TYPE=db -Dlog4j.configuration=file:/home/ovaledge/extprop/log4j.properties -Dext.properties.dir=file:/home/ovaledge/extprop/ -Xms4g -Xmx7g -DOVALEDGE_ENCRYPT_DECRYPT_KEY=<client_input> --add-opens=jdk.zipfs/jdk.nio.zipfs=ALL-UNNAMED --add-opens=java.base/jdk.internal.loader=ALL-UNNAMED --add-opens=java.base/java.net=ALL-UNNAMED"

     Sample Reference Screenshot:

     
   • Save the file.

     Ensure that the paths for oasis.properties and log4j.properties are correct.

5. Deploy the OvalEdge WAR File

   • Navigate to the Tomcat webapps directory.

   • Copy the ovaledge.war file into the webapps directory.

     The OvalEdge team provides the ovaledge.war file.

     Sample Reference Screenshot:

     
6. Configure Tomcat as a Service

   • Navigate to the following directory:

     Copy

     cd /etc/systemd/system

   • Create the tomcat.service file:

     Copy

     sudo vi tomcat.service

   • Add the following content to the tomcat.service file:

     Copy

     [Unit]
     Description=Apache Tomcat Web Application Container for OvalEdge
     After=syslog.target network.target
     [Service]
     Type=forking
     WorkingDirectory=/home/ovaledge/apache-tomcat-10.1.40/bin
     ExecStart=/bin/bash /home/ovaledge/apache-tomcat-10.1.40/bin/startup.sh
     ExecStop=/bin/bash /home/ovaledge/apache-tomcat-10.1.40/bin/shutdown.sh
     User=ovaledge
     Group=ovaledge
     [Install]
     WantedBy=multi-user.target

     Sample Reference Screenshot:

     
   • Save the file.

7. Reload and Start the Tomcat Service

   • Reload the system daemon:

     Copy

     sudo systemctl daemon-reload

   • Enable the Tomcat service:

     Copy

     sudo systemctl enable tomcat

   • Start the Tomcat service:

     Copy

     sudo systemctl start tomcat

     Sample Reference Screenshot:

     
8. Verify the Application Deployment

   • Open a web browser.

   • Access the OvalEdge application using the following URL:

     Copy

     http://<IPADDRESS>:8080/ovaledge

   • Wait approximately two minutes for the application to load.

   • Verify that the OvalEdge login page displays successfully. Sample Reference Screenshot

     

Copyright © 2026, OvalEdge LLC, Peachtree Corners, GA, USA.