zumult-org / zumultapi

1 stars 0 forks source link

Server specification #152

Open berndmoos opened 1 year ago

berndmoos commented 1 year ago

To enable other sites to setup a ZuMult instance, we would need a detailed specification of the server. What I found is:

Die ZuMult-Anwendung ist derzeit auf einer VM mit CentOS installiert. Sie läuft als Java-Webanwendung in einem Tomcat-Container (Tomcat 9 mit Java 11). Notwendig für die Anwendung sind ausserdem:

  • Ein Apache-Webserver
  • Eine Nutzerdatenbank, die für die Zugangsbeschränkung vom Tomcat angefragt wird. Wir verwenden dafür die Oracle-DB der DGD auf einem separaten Server. Eine eigenständige Installation würde wohl am besten mit einer MariaDB auf dem betreffenden Server arbeiten. Die DB ist nur für die Nutzerverwaltung notwendig, nicht zu anderweitiger Datenhaltung.
  • Eine ausführbare Instanz von FFMPEG (zum Schneiden von Videos)
  • Speicherplatz für Transkripte und Metadaten (XML). Wir holen diese Daten aus einem Subversion-Repository ab, das ist aber nicht zwingend notwendig. Der Platzbedarf ist abhängig vom Umfang der Korpora.
  • Speicherplatz für Lucene-Indizes. Auch hier ist der Platzbedarf abhängig vom Umfang der Korpora.
  • Eine Verbindung zu einem Netzlaufwerk mit den Audio- und Videodaten. Der Apache ist so eingerichtet, dass die Daten über http gestreamt werden, es aber nicht möglich ist, sie vollständig herunterzuladen.

We would need this in English, with a little (or a lot?) more detail. I will look at it and make a README inside the code.

berndmoos commented 1 year ago

Started here: https://github.com/zumult-org/zumultapi/blob/THOMAS_TGDP_AUG_2023/src/main/java/org/zumult/README_SERVER.md

berndmoos commented 11 months ago

Need to add: we have relaxed query chars in server.xml (i.e. Tomcat server config):

    <Connector ...
               relaxedQueryChars="&#x5B;&#x5D;&#x7C;&#x7B;&#x7D;&#x5E;&#x5C;&#x60;&#x22;&#x3C;&#x3E;"

This is more than the default and important, because these chars are in CQP queries