Apache Tomcat

Layout

The Apache Tomcat (CATALINA) home directory is:

/home/tomcat/apache-tomcat-v/

Where apache-tomcat-v is the version installed.

The CATALINA_HOME variable is set both in the Tomcat init script as well as setenv.sh files.

Starting and Stopping

There are two ways to start/stop/restart Tomcat.

  1. Via Module, using the Stop/Start/Restart buttons as shown below:

../../_images/tomcat-functions.png
  1. Via SSH, using the following commands

systemctl { start | stop | restart | status } tomcat
  1. If Tomcat is not responding, you can also issue, as root

pkill -9 java

Service

Tomcat runs as a system service.

The service file is located at /etc/systemd/system/tomcat.service

The content of the tomcat.service file are below:

[Unit]
Description=Tomcat ${TOMCAT_VER}
After=multi-user.target

[Service]
User=tomcat
Group=tomcat

WorkingDirectory=${CATALINA_HOME}
Type=forking
Restart=always

EnvironmentFile=/etc/environment

ExecStart=$CATALINA_HOME/bin/startup.sh
ExecStop=$CATALINA_HOME/bin/shutdown.sh 60 -force

[Install]
WantedBy=multi-user.target

Any changes to the system file should be followed by

systemctl daemon-reload

Version

By default, Tomcat 9.x latest is used

Tomcat Users

On installation, random passwords are generated for both the admin and manager roles.

The passwords can be found at /home/tomcat/apache-tomcat-version/conf/tomcat-users.xml

<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
<role rolename="manager-gui" />
<user username="manager" password="aupiZ0GlzHAaC5-8GgL2gAi7XNuEiTE0" roles="manager-gui" />

<role rolename="admin-gui" />
<user username="admin" password="67Jyz1EdDXmmFfOL9DOBFzuwr17MUgLa" roles="manager-gui,admin-gui" />
</tomcat-users>

setenv.sh

The setenv.sh file is located at /home/tomcat/apache-tomcat-version/bin/setenv.sh

The default parameters set by GeoSuite are:

CATALINA_PID="/home/tomcat/apache-tomcat-9.0.76/temp/tomcat.pid"
JAVA_OPTS="${JAVA_OPTS} -server -Djava.awt.headless=true -Dorg.geotools.shapefile.datetime=false -XX:+UseParallelGC -XX:ParallelGCThreads=4 -Dfile.encoding=UTF8 -Duser.timezone=UTC -Djavax.servlet.request.encoding=UTF-8 -Djavax.servlet.response.encoding=UTF-8 -DGEOSERVER_CSRF_DISABLED=true -DPRINT_BASE_URL=http://localhost:8080/geoserver/pdf -Dgwc.context.suffix=gwc"
JAVA_OPTS="$JAVA_OPTS -Dgeostore-ovr=file:///home/tomcat/apache-tomcat-9.0.76/conf/geostore-datasource.properties"