From 633ceced4baf3e2a9155900fbc135973188f884e Mon Sep 17 00:00:00 2001
From: "Christian P. MOMON" <christian.momon@devinsy.fr>
Date: Tue, 13 Aug 2024 03:05:47 +0200
Subject: [PATCH] Improved README with Tomcat configuration.

---
 README.md | 85 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 82 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index d217e4c..b54ce5b 100644
--- a/README.md
+++ b/README.md
@@ -55,6 +55,7 @@ Read CONCEPT.md and ONTOLOGY.md files.
 
 ## INSTALL
 
+### Requirements
 Install Java :
 
 ```
@@ -63,9 +64,87 @@ apt-get install openjdk-17-jre-headless
 
 Download the last release: https://forge.devinsy.fr/statool/statoolinfosweb/releases
 
+### Apache Web Server
 
-TODO
+Add a JK section:
+```
+        # Configure du mod-jk.
+        JkUnMount /.well-known/statoolinfos/* ajp13_worker
+        JkUnMount /.well-known/acme-challenge/* ajp13_worker
+        JkMount /* ajp13_worker
+```
 
-## Usage
+Enable the JK module:
+```
+a2enmod jk
+```
+
+### Tomcat Server
+Create a dedicated directory:
+
+```
+mkdir /srv/infos.mydomain.eu/
+```
+
+Create a log configuration file:
+
+```
+cd /srv/infos.mydomain.eu/
+wget https://forge.devinsy.fr/statool/statoolinfosweb/src/branch/main/webapp/WEB-INF/log4j2.properties
+```
+
+Edit the `/srv/infos.mydomain.eu/log4j2.properties`:
+
+```
+appender.logfile.fileName = /var/log/tomcat10/statoolinfosweb.log
+appender.logfile.filePattern = /var/log/tomcat10/statoolinfosweb-%i.log.gz
+```
+
+Create a directory dedicated to webapps:
+
+```
+mkdir /var/log/tomcat10# cd /var/lib/tomcat10/webapps/statoolinfoweb
+cd /srv/infos.mydomain.eu/
+ln -s /var/log/tomcat10# cd /var/lib/tomcat10/webapps/statoolinfoweb webapps
+```
+
+Put the StatoolInfosWeb WAR file in `/srv/infos.mydomain.eu/` and create a link into the webapps directory:
+
+```
+cd /srv/infos.mydomain.eu/webapps/
+ln -s /srv/infos.mydomain.eu/SIW.ar ROOT.war
+```
+
+Create a context file:
+
+```
+cd /etc/tomcat10/Catalina
+mkdir infos.mydomain.eu
+cd infos.mydomain.eu
+wget https://forge.devinsy.fr/statool/statoolinfosweb/src/branch/main/webapp/META-INF/context.xml  -o ROOT.xml
+```
+
+Edit it:
+
+```
+<Environment name="kiss4web.environment.name" value="PROD" type="java.lang.String" override="true"/>
+<Environment name="kiss4web.website.url" value="https://infos.mydomain.eu/" type="java.lang.String" override="true"/>
+<Environment name="kiss4web.log4j2.path" value="/srv/infos.mydomain.eu/log4j2.properties" type="java.lang.String" override="true"/>
+<Environment name="statoosinfosweb.configuration.file" value="/srv/statoolinfos/conf/mydomain.eu.conf" type="java.lang.String" override="true"/>
+```
+
+Add a dedicated `host` section in `/etc/tomcat10/server.xml`:
+
+```
+<Host name="infos.libre-service.eu"  appBase="webapps/infoslibreserviceeu"
+            unpackWARs="true" autoDeploy="true">
+        <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
+               prefix="infos.libre-service.eu-access_log" suffix=".txt"
+               pattern="%h %l %u %t &quot;%r&quot; %s %b" />
+</Host>
+```
+
+### StatoolInfos
+
+The `cache` directory must be readable by Tomcat.
 
-TODO
\ No newline at end of file