# 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:

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

     \
     **Sample Reference Screenshot:**<br>

     <figure><img src="/files/WAHaGEjIwWcJykQ8zW8g" alt=""><figcaption></figcaption></figure>
3. #### Extract the Apache Tomcat Package
   * Extract the downloaded Tomcat package using the following command:

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

     **Sample Reference Screenshots:**<br>

     <figure><img src="/files/CTLUWfSlI8yQUUNHAp9j" alt=""><figcaption></figcaption></figure>

     <br>

     <figure><img src="/files/JtUeUXnUspgG3fNDuDJK" alt=""><figcaption></figcaption></figure>
4. #### Configure the setenv.sh File
   * Navigate to the Tomcat bin directory.
   * Create the setenv.sh file using the following command:

     ```bash
     vi apache-tomcat-10.1.40/bin/setenv.sh
     ```
   * Add the following content to the setenv.sh file:

     ```bash
     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:**<br>

     <figure><img src="/files/ySC5lxjPvckfTyHJv8Vh" alt=""><figcaption></figcaption></figure>
   * Save the file.

     <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Ensure that the paths for oasis.properties and log4j.properties are correct.</p></div>
5. #### Deploy the OvalEdge WAR File
   * Navigate to the Tomcat webapps directory.
   * Copy the ovaledge.war file into the webapps directory.

     <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The OvalEdge team provides the ovaledge.war file.</p></div>

     **Sample Reference Screenshot:**<br>

     <figure><img src="/files/Ni0wjx4HICpGT5lOu2P8" alt=""><figcaption></figcaption></figure>
6. #### Configure Tomcat as a Service
   * Navigate to the following directory:

     ```bash
     cd /etc/systemd/system
     ```
   * Create the tomcat.service file:

     ```bash
     sudo vi tomcat.service
     ```
   * Add the following content to the tomcat.service file:

     ```bash
     [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:**<br>

     <figure><img src="/files/UwhQAyhjdWYpD8g59oWB" alt=""><figcaption></figcaption></figure>
   * Save the file.
7. #### Reload and Start the Tomcat Service
   * Reload the system daemon:

     ```bash
     sudo systemctl daemon-reload
     ```
   * Enable the Tomcat service:

     ```bash
     sudo systemctl enable tomcat
     ```
   * Start the Tomcat service:

     ```bash
     sudo systemctl start tomcat
     ```

     **Sample Reference Screenshot:**<br>

     <figure><img src="/files/x1zq6HkTyTCIMdjSn2is" alt=""><figcaption></figcaption></figure>
8. Verify the Application Deployment
   * Open a web browser.
   * Access the OvalEdge application using the following URL:&#x20;

     ```bash
     http://<IPADDRESS>:8080/ovaledge
     ```
   * Wait approximately two minutes for the application to load.
   * Verify that the OvalEdge login page displays successfully.\
     **Sample Reference Screenshot**\ <br>

     <figure><img src="/files/uxgyJScNh6haKkHfTv9D" alt=""><figcaption></figcaption></figure>

***

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ovaledge.com/release8.1/deployment-and-maintenance/installation/tomcat-10.1.x-on-ubuntu-24.04.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.