From 3182cf7d4cbc6f2988cfdcad3e2efd73aed316bb Mon Sep 17 00:00:00 2001
From: ulrich@undisclosed
Date: Sat, 18 Apr 2020 08:11:44 +0000
Subject: [PATCH] Doku angepasst

---
 readme.md |   55 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 files changed, 53 insertions(+), 2 deletions(-)

diff --git a/readme.md b/readme.md
index 26d73b6..9fb103a 100644
--- a/readme.md
+++ b/readme.md
@@ -1,8 +1,59 @@
-# Vorlage für Tomcat `CATALINA_BASE`  
+# Vorlage für Tomcat CATALINA_BASE
 
 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.
 
 Im Start-Skript von Tomcat können deshalb zwei verschiedene Verzeichnisse angegeben werden:
 
 1. Das Verzeichnis mit der Tomcat-Software und
-2. Das Verzeichnis für Konfigurationen und auszuführende Anwendungen.
+2. das Verzeichnis für Konfigurationen und auszuführende Anwendungen.
+
+```
+#!/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.
+
+## Benutzer
+
+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.
+
+## Tomcat Manager
+
+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.
+
+## Single Sign On
+
+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.
+
+## ROOT Context
+
+Der Inhalt für `http://localhost:8080/` liegt in `CATALINA_BASE/webapps/ROOT`.
+
+### Fehlerseiten
+
+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>
+```

--
Gitblit v1.9.3