tomcat root war

Java Web Application example

ROOT.war replaces Tomcat's default ROOT application - $TOMCAT_HOME/webapps/ROOT

Pre-requisites

• sdkman

  Install and use JDK 18

  sdk install java 18.0.2-tem
  sdk use java 18.0.2-tem

• Apache Maven

  Install Apache Maven 3.9.9

  sdk install maven 3.9.9
  sdk use maven 3.9.9

• git

Test with Jetty web server

git clone [email protected]:AndriyKalashnykov/tomcat-root-war.git
cd tomcat-root-war
mvn clean package jetty:run

xdg-open http://localhost:8080/index.html

Access http://localhost:8080/index.html or see Tomcat ROOT WAR Web Application UI

Create WAR file

git clone [email protected]:AndriyKalashnykov/tomcat-root-war.git
cd tomcat-root-war
mvn clean install

Building WAR in a Secure environmets that enforce SSL

mvn clean install -Daether.connector.https.securityMode=insecure -Dmaven.wagon.http.ssl.insecure=true -Dmaven.wagon.http.ssl.allowall=true -Dmaven.wagon.http.ssl.ignore.validity.dates=true

List content of generated WAR file

jar tf ./target/ROOT.war

Replace TOMCAT ROOT application

Edit $TOMCAT_HOME/conf/server.xml: autoDeploy and deployOnStartUp needs to be set to false

<Host name="localhost"  appBase="webapps" unpackWARs="true" autoDeploy="false" deployOnStartUp="false">

Remove default ROOT folder and copy ROOT.war

rm -rf $TOMCAT_HOME/webapps/ROOT/
rm -f $TOMCAT_HOME/webapps/ROOT.war
cp ./target/ROOT.war $TOMCAT_HOME/webapps/ROOT.war

Tomcat ROOT WAR Web Application UI

Default welcome page - http://localhost:8080/

JSP - http://localhost:8080/index.jsp

Servlet - http://localhost:8080/infoservlet

HTML - http://localhost:8080/index.html

This project used in

• Java Web Application (WAR) deployed as root "/" context onto Customized Bitnami Tomcat 9
• Docker image of this application deployed onto Customized Bitnami Tomcat 9