https://github.com/simplicitesoftware/tomcat
Pre-configured Tomcat server for the Simplicité low code platform
https://github.com/simplicitesoftware/tomcat
java low-code tomcat
Last synced: 6 months ago
JSON representation
Pre-configured Tomcat server for the Simplicité low code platform
- Host: GitHub
- URL: https://github.com/simplicitesoftware/tomcat
- Owner: simplicitesoftware
- License: apache-2.0
- Created: 2021-02-24T14:35:00.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-02-17T14:09:05.000Z (over 1 year ago)
- Last Synced: 2025-02-17T15:23:52.813Z (over 1 year ago)
- Topics: java, low-code, tomcat
- Language: Shell
- Homepage:
- Size: 375 MB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
* * *
Tomcat for Simplicité®
=================================
This repository contains an optimized and customized version of Apache Tomcat® suitable for Simplicité® instances.
The default webapps have been removed, other changes are in the `conf` folder and 3 additional JARs have been included in the `lib` folder:
- `simplicite-valves-x.y.z.jar` contains the optional valves that you can use along with some Simplicité versions (<= 5.1)
- `mysql-connector-java-x.y.z-bin` the MySQL/MariaDB JDBC driver
- `postgresql-x.y.z` the PostgreSQL JDBC driver
Usage
-----
Before launching Tomcat:
* make sure to create the `temp`, `logs` and `webapps`folders (and deploy web applications, at least a `ROOT` web application, in this last folder)
NB: these 3 folders are excluded of Git repository by entries in the `.gitignore` file
* define the **JVM properties** the `conf/server.xml` file is expecting by setting the `JAVA_OPTS` environment variable:
export JAVA_OPTS="-Dtomcat.adminport=8005 -Dtomcat.httpport=8080 -Dtomcat.httpsport=8443 -Dtomcat.ajpport=8009 $JAVA_OPTS"
Upgrade
-------
To upgrade:
* Stop Tomcat
* Pull/checkout changes on the Git repository
* Restart Tomcat
Sample init script
------------------
To automate the Tomcat start/stop create a `/etc/init.d/tomcat` init script with:
```sh
#!/bin/sh
#
# Tomcat Control Script
#
# chkconfig: 2345 55 25
#
# description: Start up the tomcat engine.
# Source function library.
. /etc/init.d/functions
RETVAL=$?
JAVA_HOME=/usr/lib/jvm/java-11
export JAVA_HOME
PATH=$JAVA_HOME/bin:$PATH
export PATH
TOMCAT_USER="simplicite"
TOMCAT_HOME="/home/$TOMCAT_USER/tomcat"
# JVM options
JAVA_OPTS="-server -Dfile.encoding=UTF-8"
# Server
JAVA_OPTS="$JAVA_OPTS -Dserver.vendor=tomcat -Dserver.version=9"
# Small
#JAVA_OPTS="$JAVA_OPTS -Xms256m -Xmx512m"
# Medium
JAVA_OPTS="$JAVA_OPTS -Xms512m -Xmx1024m"
# Large
#JAVA_OPTS="$JAVA_OPTS -Xms1024m -Xmx2048m"
# Ports
JAVA_OPTS=""$JAVA_OPTS -Dtomcat.adminport=8005 -Dtomcat.httpport=8080 -Dtomcat.httpsport=8443" -Dtomcat.ajpport=8009"
# Git repository
JAVA_OPTS="$JAVA_OPTS -Dgit.basedir=/home/$TOMCAT_USER/git"
export JAVA_OPTS
CATALINA_PID=$TOMCAT_HOME/catalina.pid
export CATALINA_PID
case "$1" in
start)
echo "Starting tomcat engine"
cd $TOMCAT_HOME/bin
/bin/su $TOMCAT_USER -c "/bin/sh ./startup.sh"
;;
stop)
echo "Stopping tomcat engine"
cd $TOMCAT_HOME/bin
/bin/su $TOMCAT_USER -c "/bin/sh ./shutdown.sh"
cd ..
rm -fr conf/Catalina work/Catalina $CATALINA_PID
;;
*)
echo "Usage: $0 {start|stop}"
exit 1
;;
esac
exit $RETVAL
```
And enable this init script by:
chkconfig tomcat on