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

Create Required Directories
- Log in to the application virtual machine.
- Create the required folders to store OvalEdge application configuration files.
Download Apache Tomcat
- Download the Apache Tomcat package using the following command:
  wget https://ovaledge.s3.us-west-1.amazonaws.com/scripts/hardened_tomcat/apache-tomcat-10.1.40.tar.gz
  Sample Reference Screenshot:
Extract the Apache Tomcat Package
- Extract the downloaded Tomcat package using the following command:
  tar -xvf apache-tomcat-10.1.40.tar.gz
  Sample Reference Screenshots:

Configure the setenv.sh File

Navigate to the Tomcat bin directory.
Create the setenv.sh file using the following command:
```
vi apache-tomcat-10.1.40/bin/setenv.sh
```

Add the following content to the setenv.sh file:

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.

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:

Configure Tomcat as a Service

Navigate to the following directory:
```
cd /etc/systemd/system
```
Create the tomcat.service file:
```
sudo vi tomcat.service
```

Add the following content to the tomcat.service file:

[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.

Reload and Start the Tomcat Service
- Reload the system daemon:
  sudo systemctl daemon-reload
- Enable the Tomcat service:
  sudo systemctl enable tomcat
- Start the Tomcat service:
  sudo systemctl start tomcat
  Sample Reference Screenshot:
Verify the Application Deployment
- Open a web browser.
- Access the OvalEdge application using the following URL:
  http://<IPADDRESS>:8080/ovaledge
- Wait approximately two minutes for the application to load.
- Verify that the OvalEdge login page displays successfully. Sample Reference Screenshot