<commit_before># Hotfolder einrichten

Der Hotfolder der easydb ist ein Verzeichnis, in dem abgelegte Dateien automatisch vereinnahmt werden. Basis bilden die [Arbeitsmappen](/webfrontend/datamanagement/search/quickaccess/collection/collection.html), die entsprechend konfiguriert werden können. Auf der administrativen Seite sind folgende Einstellungen vorzunehmen:

## Freigabe des Arbeitsverzeichnisses

Das Arbeitsverzeichnis, in dem für jede freigegebene Mappe ein Unterverzeichnis angelegt wird, muss mit Betriebssystemmiteln freigegeben werden. Im Normalfall erfolgt das über WebDAV, andere Optionen wie FTP oder SMB sind prinzipiell möglich, werden hier aber nicht beschrieben.

### Konfiguration von WebDAV

Für WebDAV ist ein vor die Docker-Container geschalteter Apache-Webserver notwendig, wie er auch schon bei der [Einrichtung von HTTPS](/sysadmin/konfiguration/https/https.html) beschrieben ist.

Zuerst sollte das passende Apache-Modul aktiviert werden:
~~~~
# a2enmod dav_fs
~~~~

Das Hotfolder-Verzeichnis muss existieren und für den Webserver schreibbar sein, das kann z.B. sichergestellt werden, wenn das Verzeichnis dem `www-data`-Nutzer gehört:
~~~~
# mkdir -p /media/hotfolder
# chown www-data. /media/hotfolder
~~~~

Folgende Einstellungen sind zusätzlich notwendig, das Arbeitsverzeichnis (`/media/hotfolder` im Beispiel) ist an die lokalen Gegebenheiten anzupassen. Einige Einstellungen im `VirtualHost`-Eintrag wurden aus Gründen der Übersichtlichkeit weggelassen.

~~~~
<VirtualHost *:443>
	AliasMatch ^/upload(.*)$ /media/upload$1
	<Location /upload>
		ProxyPass "!"
		Require all granted
		DAV on
		Options -MultiViews
		ErrorDocument 404 "Not Found"
		ErrorDocument 500 "Internal Server Error"
		ErrorDocument 502 "Bad Gateway"
	</Location>

	ProxyPass / http://127.0.0.1:80/
	ProxyPassReverse / http://127.0.0.1:80/
	…
</VirtualHost>
~~~~

## Konfiguration des easydb-Servers

Der easydb-Server legt für alle freigegebenen Mappen im o.g. Arbeitsverzeichnis entsprechende Unterverzeichnisse an. Außerdem ist die WebDAV-URL (bzw. andere URLs für andere, hier nicht dokumentierte Zugriffswege) im Frontend zugänglich, deren Basis muss konfiguriert werden (`easydb5-master.yml`). Da der Hotfolder als Plugin ausgeführt wird, muss dieses Plugin noch aktiviert werden.

~~~~
easydb-server:
  hotfolder:
    enabled: true
    urls:
      - type: windows_http
        url: \\easydb.example.com@SSL\upload\collection
        separator: \
      - type: webdav_http
        urls: https://easydb.example.com/upload/collection
        separator: /
  plugins:<commit_msg>fix l10n key in webdav docs<commit_after># Hotfolder einrichten

Der Hotfolder der easydb ist ein Verzeichnis, in dem abgelegte Dateien automatisch vereinnahmt werden. Basis bilden die [Arbeitsmappen](/webfrontend/datamanagement/search/quickaccess/collection/collection.html), die entsprechend konfiguriert werden können. Auf der administrativen Seite sind folgende Einstellungen vorzunehmen:

## Freigabe des Arbeitsverzeichnisses

Das Arbeitsverzeichnis, in dem für jede freigegebene Mappe ein Unterverzeichnis angelegt wird, muss mit Betriebssystemmiteln freigegeben werden. Im Normalfall erfolgt das über WebDAV, andere Optionen wie FTP oder SMB sind prinzipiell möglich, werden hier aber nicht beschrieben.

### Konfiguration von WebDAV

Für WebDAV ist ein vor die Docker-Container geschalteter Apache-Webserver notwendig, wie er auch schon bei der [Einrichtung von HTTPS](/sysadmin/konfiguration/https/https.html) beschrieben ist.

Zuerst sollte das passende Apache-Modul aktiviert werden:
~~~~
# a2enmod dav_fs
~~~~

Das Hotfolder-Verzeichnis muss existieren und für den Webserver schreibbar sein, das kann z.B. sichergestellt werden, wenn das Verzeichnis dem `www-data`-Nutzer gehört:
~~~~
# mkdir -p /media/hotfolder
# chown www-data. /media/hotfolder
~~~~

Folgende Einstellungen sind zusätzlich notwendig, das Arbeitsverzeichnis (`/media/hotfolder` im Beispiel) ist an die lokalen Gegebenheiten anzupassen. Einige Einstellungen im `VirtualHost`-Eintrag wurden aus Gründen der Übersichtlichkeit weggelassen.

~~~~
<VirtualHost *:443>
	AliasMatch ^/upload(.*)$ /media/upload$1
	<Location /upload>
		ProxyPass "!"
		Require all granted
		DAV on
		Options -MultiViews
		ErrorDocument 404 "Not Found"
		ErrorDocument 500 "Internal Server Error"
		ErrorDocument 502 "Bad Gateway"
	</Location>

	ProxyPass / http://127.0.0.1:80/
	ProxyPassReverse / http://127.0.0.1:80/
	…
</VirtualHost>
~~~~

## Konfiguration des easydb-Servers

Der easydb-Server legt für alle freigegebenen Mappen im o.g. Arbeitsverzeichnis entsprechende Unterverzeichnisse an. Außerdem ist die WebDAV-URL (bzw. andere URLs für andere, hier nicht dokumentierte Zugriffswege) im Frontend zugänglich, deren Basis muss konfiguriert werden (`easydb5-master.yml`). Da der Hotfolder als Plugin ausgeführt wird, muss dieses Plugin noch aktiviert werden.

~~~~
easydb-server:
  hotfolder:
    enabled: true
    urls:
      - type: windows_webdav
        url: \\easydb.example.com@SSL\upload\collection
        separator: \
      - type: webdav_http
        urls: https://easydb.example.com/upload/collection
        separator: /
  plugins:
{'fraction_non_alphanumeric': 0.08086253369272237, 'fraction_numerical': 0.012321909896033885, 'mean_word_length': 4.646739130434782, 'pattern_counts': {'":': 0, '<': 11, '<?xml version=': 0, '>': 11, 'https://': 2, 'lorem ipsum': 0, 'www.': 4, 'xml': 0}, 'pii_count': 4, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6639592', 'n_tokens_mistral': 1750, 'n_tokens_neox': 1727, 'n_words': 528}