Release Notes 3.1
What’s New
Unterstützung Apache Solr 9.10
Mit dieser Version wird Apache Solr 9.10.x unterstützt. Die Vorgängerversion Apache Solr 9.9.0 ist nicht kompatibel mit smart.finder SDI 3.1.0. Die notwendigen Schritte zur Aktualisierung von Apache Solr 9.9.0 auf 9.10.x entnehmen Sie den Update-Hinweisen.
Grundsätzliche Informationen zur Installation von Apache Solr finden Sie unter Benötigte Software.
Informationen zur Konfiguration von smart.finder SDI in Ihrer Apache Solr Instanz finden Sie unter Apache Solr Konfiguration.
Index Schema Updates
Die zentralen Konfigurationsdateien des iso-Indexes wurden überarbeitet. Daher ist eine Aktualisierung im SOLR_HOME erforderlich.
Die wichtigsten Änderungen sind im Folgenden beschrieben:
Synonyme
Die Verarbeitung von Synonymen im Schema des iso-Indexes wurde optimiert. Dabei wird nun unterschieden zwischen:
-
Synonymen für die Volltextsuche
-
Synonymen für die Facettierung
Hierfür werden im Verzeichnis SOLR_HOME/iso/conf/lang zwei separate Dateien bereitgestellt:
-
synonyms_common.txt: enthält Synonyme für die allgemeine Volltextsuche -
synonyms_facets.txt: enthält Synonyme für die Facettenverarbeitung
Doppelte Einträge in Dokumentfeldern
In der Vergangenheit konnte es vorkommen, dass Felder innerhalb von Dokumenten doppelte Werte enthielten. Dies stellt zwar keinen funktionalen Fehler dar, führt jedoch zu unnötigem Speicherverbrauch ohne zusätzlichen Nutzen.
Um dies zu vermeiden, wurde ein UniqFieldsUpdateProcessorFactory eingeführt, der für definierte Felder doppelte Werte entfernt, bevor die Dokumente in den Index geschrieben werden.
Der entsprechende Prozessor ist in der Datei SOLR_HOME/iso/conf/solrconfig.xml konfiguriert:
<!-- 3b. Removes duplicate values found in fields matching the specified conditions. The existing field values
are iterated in order, and values are removed when they are equal to a value
that has already been seen for this field. -->
<processor class="UniqFieldsUpdateProcessorFactory">
<str name="fieldName">source</str>
<str name="fieldName">format</str>
</processor>Update-Hinweise
| Falls Sie bei dem Update mehrere Versionen überspringen, befolgen Sie bitte auch alle Update-Hinweise der dazwischenliegenden Versionen. |
Aktualisierung Apache Solr
Zur Aktualisierung von Apache Solr auf Version 9.10.x gehen Sie wie folgt vor:
-
Apache Solr stoppen
-
Sichern relevanter Daten und Verzeichnisse der aktuellen Installation:
-
SOLR_HOMEVerzeichnis, dieses befindet sich standardmäßig unter[SOLR_INSTALL_DIR]/server/solr. -
Die Konfigurationsdateien
/etc/default/solr.in.sh(Linux) oder[SOLR_INSTALL_DIR]/bin/solr.in.cmd(Windows)
-
-
Aktualisieren Sie Apache Solr auf die Version 9.10.x. Solr bietet kein In-Place-Upgrade – die neue Installation muss parallel angelegt werden.
-
Überprüfen Sie, dass die zuvor gesicherten Dateien in den aktualisierten Ordnern nach wie vor vorhanden sind.
-
Starten Sie Apache Solr
-
Überprüfen Sie die Installation (z.B. Admin UI)
Aktualisierung des Suchindex
Die Konfiguration des iso Indexes muss aktualisiert werden, da sich die Verarbeitung der Synonyme geändert hat.
Gehen Sie hierzu wie folgt vor:
-
Apache Solr Dienst stoppen
-
Sichern Sie die alten Dateien unter
[SOLR_HOME]/iso -
Löschen den Inhalt des Verzeichnisses unter
[SOLR_HOME]/iso. -
Kopieren Sie die aktuellen Dateien von
[RELEASE-ORDNER]/resources/solr/cores/isonach[SOLR_HOME]/iso -
Falls Sie zuvor Änderungen an
[SOLR_HOME]/iso/conf/solrconfig.xmlvorgenommen haben, vergleichen Sie die Dateien und übernehmen Sie die neuen Passagen selektiv. -
Apache Solr Dienst starten
-
Indexierung neu anstoßen, um den
isoIndex erneut zu befüllen.
Abkündigungen
Die Nutzerverwaltung durch den security.manager (Enterprise Edition) wird in einer der nächsten Versionen eingestellt und durch den con terra Technologies Identity Service ersetzt.
Bekannte Einschränkungen
Folgende Einschränkungen sind zum Zeitpunkt der Veröffentlichung bekannt.
Fehlerhafte Umlaute in den Facetten
Umlaute werden in den Facetten fehlerhaft dargestellt.
- Maßnahme
-
Starten Sie den Tomcat-Prozess mit der folgenden zusätzlichen Java-Option:
-Dfile.encoding=UTF-8Kombination map.apps Smart Search und smart.finder SDI
map.apps Smart Search und smart.finder SDI können nicht gemeinsam betrieben werden.
- Maßnahme
-
Öffnen Sie die Datei /smartfinder-search/WEB-INF/classes/spring-security-config.xml und suchen folgenden Abschnitt:
<bean id="customFilters" class="org.springframework.web.filter.CompositeFilter">
<property name="filters">
<list>
<ref bean="removePermissionQuery"/>
<ref bean="documentFilter"/>
</list>
</property>
</bean>Entfernen Sie die Zeile <ref bean="removePermissionQuery"/>.
Speichern Sie die Datei und starten Sie den Web-Context neu.
Erkennung Domain Cookies
Erkennung des Domain Cookies schlägt in den Komponenten smartfinder-editor und smartfinder-search fehl.
- Maßnahme
-
Ändern Sie den Wert des Properties
security.sso.cookie.domainin den verwendetenapplication.propertiesso, dass dieser nicht mit einem.startet:
security.sso.cookie.domain=.example.com #FALSCH
security.sso.cookie.domain=example.com #KORREKTSpeichern Sie die Datei(en) und starten Sie die betreffenden Web-Contexte neu.
Dokumentation JNDI Konfiguration
Dokumentation der JNDI Konfiguration im Data Import Handler ist nicht korrekt.
- Maßnahme
-
Die korrekte Syntax lautet:
<dataSource name="db" jndiName="java:comp/env/jdbc/sfsdi"/>+
Der Wert von jndiName dient hier nur als Beispiel und muss durch einen gültigen Wert entsprechend ihrer Umgebung ersetzt werden.
Sonstiges
-
Der Typ gco:dateTime wird momentan nicht für ISO Metadaten unterstützt.
-
service.monitor Anbindung nicht vorhanden
-
PDF: Das PDF-Dokument eines Metadatensatzes ist nicht vollständig und enthält bspw. die neu ergänzten Metadatenelemente des Editors nicht.