Der Web- und Applikationsserver Tomcat besitzt eine sehr große Zahl an Konfigurationsmöglichkeiten. Von Einstellungen für den Server selbst bis hin zu den vom Server ausgeführten Anwendungen und ihren Wechselwirkungen sind denkbare Kombinationen sich ergebender Ausführungsvarianten nahezu unendlich.
Im Start-Skript von Tomcat können deshalb zwei verschiedene Verzeichnisse angegeben werden:
#!/bin/sh
export JRE_HOME=/home/fred/zulu11.33.15-ca-jdk11.0.4-linux_x64
export CATALINA_HOME=/home/fred/apache-tomcat-9.0.29
export CATALINA_BASE=/home/fred/tomcat-base
$CATALINA_HOME/bin/sh catalina.sh start
In diesem Repository ist ein minimalistischer Inhalt von CATALINA_BASE mit Einstellungen hinterlegt, die nachfolgend näher beschrieben sind.
Es sind keine Benutzer konfiguriert. Benutzer können z.B. in der Datei CATALINA_BASE/conf/tomcat-users.xml angelegt werden. Die Dokumentation von Tomcat liefert mehr Informationen zur Konfiguration von Authentifizierung und Autorisierung.
Die Manager-App, die als Teil des Standard-Pakets von Tomcat ausgeliefert wird, ist über die Datei $CATALINA_BASE/conf/Catalina/localhost/manager.xml eingeschaltet.
Der Inhalt für http://localhost:8080/ liegt in CATALINA_BASE/webapps/ROOT.
Der Deployment Descriptor des ROOT Context, die Datei CATALINA_BASE/webapps/ROOT/WEB-INF/web.xml, enthält u.a. eine Deklaration von Standardfehlerseiten. Das sorgt im Fall eines Fehlers für die Anzeige einer neutralen Seite.
<error-page>
<exception-type>java.lang.Throwable</exception-type>
<location>/fehler.jsp</location>
</error-page>
<error-page>
<error-code>403</error-code>
<location>/nicht-erlaubt.html</location>
</error-page>
<error-page>
<error-code>404</error-code>
<location>/fehler.jsp</location>
</error-page>
<error-page>
<error-code>500</error-code>
<location>/fehler.jsp</location>
</error-page>