Tomcat installation per tarball (Ubuntu 18.04)

Noch in Bearbeitung

Voraussetzungen

Java siehe Java (Ubuntu)

Benutzer anlegen

sudo addgroup --system --no-create-home --disabled-login --group tomcat
sudo adduser --system --no-create-home --disabled-login --ingroup tomcat tomcat

Alternativ mit fixer UID:

sudo addgroup --system --no-create-home --disabled-login --uid 128 --group tomcat
sudo adduser --system --no-create-home --disabled-login --uid 128 --ingroup tomcat tomcat 

Download

Verfügbare Versionen siehe http://www.eu.apache.org/dist/tomcat/

wget https://downloads.apache.org/tomcat/tomcat-10/v10.0.0/bin/apache-tomcat-10.0.0.tar.gz
tar -xzf apache-tomcat-10.0.0.tar.gz

Installationsverzeichnis anlegen:

sudo mkdir -p /opt/tomcat/tomcat10_0_0/

Entpacktes Tomcat-Verzeichnis verschieben und Besitzer setzen:

sudo mv apache-tomcat-10.0.0 /opt/tomcat/tomcat10_0_0/tomcat10
sudo chown -R tomcat:tomcat /opt/tomcat/tomcat10_0_0/

Installation

Einen symbolischen Link auf das Verzeichnis mit der Version für Tomcat 10 anlegen (falls mehrere Versionen installiert sind):

cd /opt/tomcat/
sudo ln -s /opt/tomcat/tomcat10_0_0 tomcat10

Umgebungsvariablen setzen

• CATALINA_HOME = Verzeichnis, wo die Binärdateien liegen
• CATALINA_BASE = Verzeichnis, wo die Instanz-spezifischen Dateien (z.B. Konfigurationsdateien) liegen (bei einer Instanz können beide Variablen gleich sein)

Dazu eine Datei /etc/tomcat10.conf erstellen:

sudo vi /etc/tomcat10.conf

Diese Datei mit folgenden Inhalt befüllen:

# Where your java installation lives
JAVA_HOME="/usr/lib/jvm/java-1.8.0-openjdk-armhf"

# Where your tomcat installation lives
CATALINA_BASE="/opt/tomcat/tomcat10_0_0/tomcat10"
CATALINA_HOME="/opt/tomcat/tomcat10_0_0/tomcat10"
JASPER_HOME="/opt/tomcat/tomcat10_0_0/tomcat10"
CATALINA_TMPDIR="/opt/tomcat/tomcat10_0_10/tomcat10/temp"

# Set the TOMCAT_PID location
CATALINA_PID="/tmp/tomcat10.pid"

# What user should run tomcat
TOMCAT_USER="tomcat"

In der Datei /opt/tomcat/tomcat10_0_0/tomcat10/bin/catalina.sh die Variablenkonfiguration einfügen:

sudo vi /opt/tomcat/tomcat10_0_0/tomcat10/bin/catalina.sh

...
# Ensure that any user defined CLASSPATH variables are not used on startup,
# but allow them to be specified in setenv.sh, in rare case when it is needed.
CLASSPATH=

# Get the tomcat config (use this for environment specific settings)
if [ -z "${TOMCAT_CFG}" ]; then
        TOMCAT_CFG="/etc/tomcat10.conf"
fi

if [ -r "$TOMCAT_CFG" ]; then
        . $TOMCAT_CFG
fi

if [ -r "$CATALINA_BASE/bin/setenv.sh" ]; then
  . "$CATALINA_BASE/bin/setenv.sh"
...

Konfiguration

Tomcat Benutzer anlegen

Dazu in der Datei $CATALINA_HOME/conf/tomcat-users.xml folgende Zeilen zwischen <tomcat-users> und </tomcat-users> einfügen:

sudo vi /opt/tomcat/tomcat10_0_0/tomcat10/conf/tomcat-users.xml

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

Admin-GUI's für alle Addressen erlauben

Hinweis: Bei mehreren Tomcat-Instanzen kann man den Remote-Zugriff zentral in CATALINA_BASE erlauben (siehe 2. Absatz).

In ${CATALINA_HOME} bei einzelner Tomcat-Instanz

${CATALINA_HOME}/webapps/manager/META-INF/context.xml:

Dazu die Datei

sudo vi /opt/tomcat/tomcat10_0_0/tomcat10/webapps/manager/META-INF/context.xml

bearbeiten und folgende Zeile auskommentieren:

<?xml version="1.0" encoding="UTF-8"?>

...

<Context antiResourceLocking="false" privileged="true" >

...

<!--
  <Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" />
-->      

...

</Context>

${CATALINA_HOME}/webapps/host-manager/META-INF/context.xml:

Weiters in der Datei

sudo vi /opt/tomcat/tomcat10_0_0/tomcat10/webapps/host-manager/META-INF/context.xml

wie vorher ebenfalls Valve auskommentieren.

In ${CATALINA_HOME} bei mehreren Tomcat-Instanzen

${CATALINA_BASE}/conf/Catalina/localhost/manager.xml:

Die Datei

sudo vi /opt/tomcat/tomcat10_0_0/tomcat10/conf/Catalina/localhost/manager.xml

erstellen und mit folgendem Inhalt befüllen:

<Context privileged="true" antiResourceLocking="false" docBase="${catalina.home}/webapps/manager">
  <Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="^.*$" />
</Context>

${CATALINA_BASE}/conf/Catalina/localhost/host-manager.xml:

Die Datei

sudo vi /opt/tomcat/tomcat10_0_0/tomcat10/conf/Catalina/localhost/host-manager.xml

erstellen und mit folgendem Inhalt befüllen:

<Context privileged="true" antiResourceLocking="false" docBase="${catalina.home}/webapps/host-manager">
  <Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="^.*$" />
</Context>

Als Service mit systemctl

sudo vi /etc/systemd/system/tomcat10.service

[Unit]
Description=Tomcat10
After=network.target

[Service]
Type=forking
User=tomcat
Group=tomcat

Environment=CATALINA_PID=/tmp/tomcat10.pid
Environment=TOMCAT_JAVA_HOME=/usr/bin/java
Environment=CATALINA_HOME=/opt/tomcat/tomcat10_0_0/tomcat10
Environment=CATALINA_BASE=/opt/tomcat/tomcat10_0_0/tomcat10
Environment=CATALINA_OPTS=
Environment="JAVA_OPTS=-Dfile.encoding=UTF-8 -Dnet.sf.ehcache.skipUpdateCheck=true -XX:+CMSClassUnloadingEnabled -XX:+UseG1GC -XX:MaxPermSize=128m -Xms512m -Xmx512m"

ExecStart=/opt/tomcat/tomcat10_0_0/tomcat10/bin/startup.sh
ExecStop=/opt/tomcat/tomcat10_0_0/tomcat10/bin/shutdown.sh

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl start tomcat10.service
sudo systemctl enable tomcat10.service

Mehrere Tomcat-Instanzen parallel

Noch in Bearbeitung

Für jede weitere Instanz ein weiteres Verzeichnis (CATALINA_BASE) anlegen. Die Unterverzeichnise conf und webapps werden kopiert. Anstelle des Unterverzeichnisses bin wird ein symbolischer Link zu CATALINA_HOME/bin gesetzt.

cd /opt/tomcat/tomcat10_0_0/
sudo mkdir tomcat10_1
sudo cp -r tomcat10/conf/ tomcat10_1/conf/
sudo cp -r tomcat10/webapps/ tomcat10_1/webapps/
sudo mkdir tomcat10_1/logs/
sudo mkdir tomcat10_1/temp/
sudo mkdir tomcat10_1/work/
cd tomcat10_1
sudo ln -s ../tomcat10/bin bin
sudo ln -s ../tomcat10/lib lib
sudo chown -R tomcat:tomcat /opt/tomcat/tomcat10_0_0/tomcat10_1/
sudo chmod -R 755 /opt/tomcat/tomcat10_0_0/tomcat10_1/
sudo -u tomcat cp /opt/tomcat/tomcat10_0_0/tomcat10/bin/catalina.sh /opt/tomcat/tomcat10_0_0/tomcat10/bin/catalina10_1.sh
sudo cp /etc/tomcat10.conf /etc/tomcat10_1.conf

Dieser Vorgang wird für jede weitere Instanz wiederholt:

cd /opt/tomcat/tomcat7_0_69/
sudo mkdir tomcat7_<instance>
sudo cp -r tomcat7/conf/ tomcat7_<instance>/conf/
sudo cp -r tomcat7/webapps/ tomcat7_<instance>/webapps/
sudo mkdir tomcat7_<instance>/logs/
sudo mkdir tomcat7_<instance>/temp/
sudo mkdir tomcat7_<instance>/work/
cd tomcat7_<instance>
sudo ln -s ../tomcat7/bin bin
sudo ln -s ../tomcat7/lib lib
sudo chown -R tomcat:tomcat /opt/tomcat/tomcat7_0_69/tomcat7_<instance>/
sudo chmod -R 755 /opt/tomcat/tomcat7_0_69/tomcat7_<instance>/
sudo -u tomcat cp /opt/tomcat/tomcat7_0_69/tomcat7/bin/catalina.sh /opt/tomcat/tomcat7_0_69/tomcat7/bin/catalina7_<instance>.sh
sudo cp /etc/tomcat7.conf /etc/tomcat7_<instance>.conf

$CATALINA_BASE/bin/catalina7_X.sh

Danach in /opt/tomcat/tomcat7_0_69/tomcat7/bin/catalina7_<instance>.sh den Namen der Tomcat-Konfigurationsdatei anpassen:

...
# Get the tomcat config (use this for environment specific settings)
if [ -z "${TOMCAT_CFG}" ]; then
        TOMCAT_CFG="/etc/tomcat7_<instance>.conf"
fi
...

$CATALINA_BASE/conf/server.xml

Alle Instanzen müssen unterschiedliche Ports verwenden. Die verwendeten Ports werden in der Datei $CATALINA_BASE/conf/server.xml geändert:

cd /opt/tomcat/tomcat7_0_69/tomcat7_1/conf/
sudo nano server.xml

Die Standard-Ports sind in der folgenden Tabelle aufgelistet:

Port	Beschreibung
8005	Shutdown Port
8080	Connector Port
8443	Redirect Port
8009	AJP Connector Port

Ein Möglichkeit ist, die führende 8 bei allen Ports jeweils erhöhen oder erniedrigen. Aus 8005 wird dann z.B. 9005.

/etc/tomcat7_<instance>

In den Konfigurations-Dateien tomcat7 durch tomcat7_<instance> (ausgenommen CATALINA_HOME) ersetzen

# Where your java installation lives
JAVA_HOME="/opt/Oracle_Java/jdk1.8.0_92"

# Where your tomcat installation lives
CATALINA_BASE="/opt/tomcat/tomcat7_0_69/tomcat7_<instance>"
CATALINA_HOME="/opt/tomcat/tomcat7_0_69/tomcat7"
JASPER_HOME="/opt/tomcat/tomcat7_0_69/tomcat7_<instance>"
CATALINA_TMPDIR="/opt/tomcat/tomcat7_0_69/tomcat7_<instance>/temp"

# Set the TOMCAT_PID location
CATALINA_PID="$CATALINA_HOME/bin/catalina7_<instance>.pid"

# What user should run tomcat
TOMCAT_USER="tomcat"

Load Balancer

Load Balancer mit mod_jk (Linux)

Eclipse

Tomcat und Eclipse

Zurück zu Tomcat (tarball)