Wir beginnen mit der Aktualisierung des Servers selbst.

sudo -s

apt update && apt upgrade

Im Anschluss daran werden die Softwareanforderungen an die Volltextsuche sichergestellt und erfüllt.

apt install apt-transport-https ca-certificates
apt install openjdk-8-jre

Jetzt laden wir den elasticsearch-Key des Software-Repositories herunter und publizieren diesen im System

wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -

um das hinzuzufügende Repository nutzen zu können:

echo "deb https://artifacts.elastic.co/packages/7.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elasticsearch7.list

Elasticsearch kann nun bereits installiert werden:

apt update && apt install elasticsearch -y

Die Installation ist abgeschlossen – konfigurieren wir Elasticsearch noch für den automatischen Start:

systemctl daemon-reload
systemctl enable elasticsearch
systemctl start elasticsearch

Um auch PDF Dokumente inhaltlich durchsuchen zu können installieren wir noch ein Plugin für Elasticsearch:

/usr/share/elasticsearch/bin/elasticsearch-plugin install ingest-attachment

Abschließend editieren wir noch die Konfiguration hinsichtlich des network.host:

nano /etc/elasticsearch/elasticsearch.yml

Tragen Sie Folgendes ein:

network.host: 127.0.0.1

Nach einem Neustart von Elasticsearch ist die Volltextsuche für Nextcloud bereits vorbereitet und einsatzfähig.

service elasticsearch restart

Um Text aus Bildern lesbar und somit auch durchsuchbar zu machen benötigen wir noch Tessaract (OCR).

apt-get install tesseract-ocr tesseract-ocr-deu tesseract-ocr-eng

Nach einem Neustart des elasticsearch-Services

service elasticsearch restart

können wir mit der Einrichtung, also der Aktivierung und Konfiguration der Apps in Nextcloud fortfahren.

Aktivieren Sie mindestens diese Apps:

• Full text search – Diese App bietet die Grundfunktionen zur Volltextsuche
• Full text search – Elasticsearch Platform: Dies stellt die Verbindung zur Suchmaschine her.
• Full text search – Files: Erweitert die Dateien-App um die Volltextsuche.
• Full text search – Files – Tesseract OCR: Verbindung zu Tesseract.

Bevor die Volltextsuche in Nextcloud genutzt werden kann muss diese noch konfiguriert werden. Dies geschieht in den Nextcloud-Administratoreinstellungen unter Volltextsuche:

Die Werte werden automatisch gespeichert! Nun erzeugen wir noch initial den Volltextindex über das Nextcloud Kommandozeilentool occ:

sudo -u www-data php /var/www/nextcloud/occ fulltextsearch:index

Achtung:
Je nach Größe des Datenbestands kann dieser Befehl Minuten bis Stunden dauern.

Nach dem initialen Anlegen des Volltextindexes muss der zuvor ausgeführte Befehl nicht mehr regelmäßig ausgeführt werden. Die Aktualisierung des Indexes erfolgt dann im Rahmen des Nextcloud-Cronjobs.

Nach der Indizierung finden Sie über die Suche Dokumente sowohl über die Dateienamen, als auch über Inhalte.

Sofern Updates eingespielt werden muss das Plugin aktualisiert werden. Ein Blick in das Logfile lohnt sich und gibt entsprechende Auskunft:

nano /var/log/elasticsearch/elasticsearch.log

„… org.elasticsearch.bootstrap.StartupException: java.lang.IllegalArgumentException: Plugin [ingest-attachment] was built for Elasticsearch version…“

Wir entfernen zuerst das bestehende Plugin,

/usr/share/elasticsearch/bin/elasticsearch-plugin remove ingest-attachment

um es anschließend in der neuen Version zu installieren:

/usr/share/elasticsearch/bin/elasticsearch-plugin install ingest-attachment

Nach einem Neustart des Dienstes wird die Volltextsuche wieder funktionieren.