2022.06 2024.06

MyCoRe und Apache Solr

Die MyCoRe-Anwendungen benötigen eine leistungsstarke Suchmaschine für vielfältige Suchoperationen. Die Grundinstallation wird auf dieser Seite beschrieben. Zur Konfiguration einer konkreten MyCoRe-Anwendung gibt es weiterführenden Hinweise im Kapitel Suche.

Einrichtung eines Solr-Servers

Mit dem Release 2022.06 wurde in MyCoRe auf Solr 8.11.x umgestellt. Zur Installation folgt man der Anleitung "Installing Solr" von der Solr Homepage. Die jeweilige aktuelle Solr Version kann dort heruntergeladen werden.

Ab dem MyCoRe-Release 2024.06 sollte ein Solr 9.x verwendet werden. Zur Installation folgt man der Anleitung "Installing Solr" von der Solr Homepage. Die jeweilige aktuelle Solr Version kann dort heruntergeladen werden.

Es ist sinnvoll, wenn man das Datenverzeichnis nicht innerhalb der Solr-Distribution anlegt.
Gleiches gilt auch für die Log-Dateien.

Mit folgendem Kommando lässt sich der Solr-Server 'individualisiert' starten:

cd .../solr-8.11.x/bin ; solr start -s {my_data_dir} -p {my_port} -m {my_ram} -Dsolr.log.dir={my_log_dir}

Die Cores werden dadurch im Verzeichnis {my_data_dir} erstellt und die Log-Dateien in {my_log_dir}. Beide Verzeichnisse müssen vorher angelegt werden. Im Produktivbetrieb wird der Speicher (RAM) per Umgebungsvariable gesetzt: SOLR_HEAP="2g".

Eine detailierte Beschreibung der Startparameter und weitere Konfigurationsmöglichkeiten befindet sich auf der Seite "Solr Control Script Reference". Für den produktiven Einsatz von Solr (Verzeichnisstruktur, init.d-Skript für den automatischen Start, ...) liefert die Seite "Taking Solr to Production". die notwendigen Informationen.

Hinweise

Alto-Indexierung

Wenn innerhalb der MyCoRe-Anwendung Volltexte im Alto-Format indexiert werden, ist eine weitere Einstellung notwendig. Das ist notwendig, wenn das Property MCR.Solr.Indexer.File.AccumulatorList=org.mycore.mets.solr.MCRSolrAltoExtractor gesetzt wurde.
Dann sollte beim Solr-Start zusätzlich der Parameter -Dsolr.jetty.request.header.size=524288 verwendet werden. Dadurch steht bei der Indexierung ausreichend Platz für die Übertragung der Wort-Koordinaten zur Verfügung. Im Produktivbetrieb kann der Parameter über die Umgebungsvariable SOLR_OPTS gesetzt werden.

Solr Module

Mit Solr 9.10.1 wurde die von MyCoRe benötigte ICU-Bibliothek in das Modul analysis-extras verschoben. Wenn das Modul beim Start von Solr nicht geladen wurde, sieht man beispielsweise beim Initialisieren der Solr-Cores folgende Fehlermeldung:

SOLR config add-field-type: ... Error loading class 'solr.ICUNormalizer2FilterFactory'>

Ebenfalls mit Solr 9.10.1 wurde Code für das Verarbeiten von XML in das Modul extraction verschoben.

Beide Module müssen beim Solr-Start konfiguriert werden, z.B. durch

Setzen der Umgebungsvariable SOLR_MODULES=analysis-extras,extraction
in solr.in.sh (Linux) bzw. solr.in.cmd (Windows), oder
einen Parameter beim Start über die Kommandozeile:
bin/solr start -Dsolr.modules=analysis-extras,extraction

Die Module sind nicht in der Slim-Variante von Solr enthalten. Es muss die full-Variante von Solr installiert werden.

Konfiguration

Für jede MyCoRe-Anwendung müssen jetzt ein oder mehrere Solr-Kerne angelegt werden. Die Konfiguration der Kerne wird im Abschnitt Solr-Nutzung beschrieben.