From 4e8bf303df852bd3ad1b557644c28ddcf5f957c3 Mon Sep 17 00:00:00 2001
From: ulrich <undisclosed>
Date: Fri, 29 Nov 2019 14:27:35 +0000
Subject: [PATCH] Doku ergaenzt

---
 README.md |   20 +++++++++++++++++++-
 1 files changed, 19 insertions(+), 1 deletions(-)

diff --git a/README.md b/README.md
index 1b99dce..143a191 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # Dateiverwaltung
 
-Eine Bedienoberfläche zur Bearbeitung und Verwaltung von Dateien für die [WebBox](/data/ulrich/prg/webbox).  
+Eine Webanwendung zur Bearbeitung und Verwaltung von Dateien für die [WebBox](/data/ulrich/prg/webbox).  
 
 ## Funktionen
 
@@ -121,6 +121,24 @@
 - [Moment](http://momentjs.com/)
 - [Numeral](http://numeraljs.com/)
 
+## Ausfuehren
+
+Zum Ausfuehren wird die Datei `file-cms.war` in den Ordner `$CATALINA_BASE/webapps` von Tomcat gelegt. Der Aufruf erfolgt anschliessend mit dem URL `https://example.com/file-cms/ui`. Nutzer muessen die Rolle `ownFileAdmin` besitzen um die Webanwendung verwenden zu koennen. 
+
+Die Ausfuehrung gelingt in der hier beschriebenen Konfiguration auch ohne die WebBox auf einem Tomcat, wie er ab Werk ausgestattet ist. Die folgenden Einstellungen muessen in diesem Fall von Hand an Tomcat vorgenommen werden:
+
+- SingleSignOn Valve in `$CATALINA_BASE/conf/server.xml` einschalten
+- Environment-Variable fuer den Ablageort in `$CATALINA_BASE/conf/context.xml` anlegen (Angabe fuer `wbxFileBase` wie weiter oben erwaehnt)
+- `data.xml` und `home.xml` in `$CATALINA_BASE/conf/Catalina/localhost` anlegen wie in folgendem Beispiel
+
+```
+<?xml version="1.0" encoding="UTF-8"?>
+<Context path="/data" docBase="/pfad/zum/ablageort">
+</Context>
+```
+
+Das `file-cms` legt beim ersten Start die Verzeichnisse www und home in dem Verzeichnis an, das mit `wbxFileBase` angegeben wurde (siehe weiter oben). Wenn beispielsweise der Ablageort `/media/rdata/cms` als `wbxFileBase` angegeben wurde ist der Eintrag fuer `docBase` in `data.xml` `/media/rdata/cms/www` und in `home.xml` `/media/rdata/cms/home`.
+
 ## Lizenz
 
 Die Dateiverwaltung wird zu den Bedingungen der [GNU Affero General Public License](/gitblit/doc/file-cms.git/master/web!agpl.txt) bereitgestellt. Die von der Dateiverwaltung verwendeten Komponenten unterliegen zum Teil anderen Lizenzen. Deren Nutzungsbedingungen sind an den Quellen der Komponenten angegeben.

--
Gitblit v1.9.3