Minimalistisches CATALINA_BASE
ulrich@undisclosed
2020-04-18 3182cf7d4cbc6f2988cfdcad3e2efd73aed316bb
commit | author | age
3182cf 1 # Vorlage für Tomcat CATALINA_BASE
0ed8f6 2
U 3 Der Web- und Applikationsserver [Tomcat](https://tomcat.apache.org) 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.
4
5 Im Start-Skript von Tomcat können deshalb zwei verschiedene Verzeichnisse angegeben werden:
6
7 1. Das Verzeichnis mit der Tomcat-Software und
ea4c0c 8 2. das Verzeichnis für Konfigurationen und auszuführende Anwendungen.
U 9
10 ```
11 #!/bin/sh
12
13 export JRE_HOME=/home/fred/zulu11.33.15-ca-jdk11.0.4-linux_x64
14 export CATALINA_HOME=/home/fred/apache-tomcat-9.0.29
15 export CATALINA_BASE=/home/fred/tomcat-base
16
17 $CATALINA_HOME/bin/sh catalina.sh start
18 ```
19
20 In diesem Repository ist ein minimalistischer Inhalt von `CATALINA_BASE` mit Einstellungen hinterlegt, die nachfolgend näher beschrieben sind.
21
22 ## Benutzer
23
24 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](http://tomcat.apache.org/tomcat-9.0-doc/realm-howto.html) liefert mehr Informationen zur Konfiguration von Authentifizierung und Autorisierung.
25
26 ## Tomcat Manager
27
28 Die [Manager-App](http://tomcat.apache.org/tomcat-9.0-doc/manager-howto.html), die als Teil des Standard-Pakets von Tomcat ausgeliefert wird, ist über die Datei `$CATALINA_BASE/conf/Catalina/localhost/manager.xml` eingeschaltet.
29
3182cf 30 ## Single Sign On
U 31
32 In der Datei `CATALINA_BASE/conf/server.xml` wurde das Single Sign On eingeschaltet. Damit ist der gerade angemeldete Benutzer für alle Webanwendungen gültig.
33
ea4c0c 34 ## ROOT Context
U 35
36 Der Inhalt für `http://localhost:8080/` liegt in `CATALINA_BASE/webapps/ROOT`.
c81724 37
629a00 38 ### Fehlerseiten
c81724 39
U 40 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.
41
42 ```
43 <error-page>
44   <exception-type>java.lang.Throwable</exception-type>
e924a6 45   <location>/fehler.jsp</location>
c81724 46 </error-page>
U 47 <error-page>
48   <error-code>403</error-code>
49   <location>/nicht-erlaubt.html</location>
50 </error-page>
51 <error-page>
52   <error-code>404</error-code>
e924a6 53   <location>/fehler.jsp</location>
c81724 54 </error-page>
U 55 <error-page>
56   <error-code>500</error-code>
e924a6 57   <location>/fehler.jsp</location>
c81724 58 </error-page>
U 59 ```