Überblick aller Update-Hinweise

2.6

Neue erforderliche Solr Properties

Ab Version 2.6.1 müssen aufgrund von Änderungen in Apache Solr zwei neue Systemvariablen wie folgt gesetzt werden.

System Properties
solr.enableRemoteStreaming=true
solr.enableStreamBody=true

Hier z.B. für Linux:

Setzen von System Properties in Java/Tomcat
export JAVA_OPTS="$JAVA_OPTS -Dsolr.enableRemoteStreaming=true -Dsolr.enableStreamBody=true"

Java Unterstützung

Wenn Sie Java 17 oder höher verwenden, beachten Sie: Vor dem Start des Tomcat-Prozesses muss die Java-Option --add-opens=java.base/java.math=ALL-UNNAMED zusätzlich festgelegt werden. Diese Einstellung wird von der Komponente smartfinder-csw benötigt. Je nachdem, ob Tomcat als Systemprozess oder über die Kommandozeile/Shell gestartet wird, kann dies auf unterschiedliche Art und Weise geschehen.

Beispiel für Linux-Umgebung via Shell: export JAVA_OPTS="$JAVA_OPTS --add-opens=java.base/java.math=ALL-UNNAMED"

2.5

Tomcat 10 Unterstützung

Dieses Release ist das erste Release smart.finder SDI mit dem Tomcat 10 unterstützt wird. Ein Betrieb mit Tomcat 9 ist ab dieser Version nicht mehr möglich. Details dazu sind in diesem Artikel beschrieben: Tomcat 10 und Java 21 Unterstützung in con terra Technologies Produkten

Vor dem Start des Tomcat-Prozesses muss die Java-Option --add-opens=java.base/java.math=ALL-UNNAMED zusätzlich festgelegt werden. Diese Einstellung wird von der Komponente smartfinder-csw benötigt. Je nachdem, ob Tomcat als Systemprozess oder über die Kommandozeile/Shell gestartet wird, kann dies auf unterschiedliche Art und Weise geschehen.

Beispiel für Linux-Umgebung via Shell: export JAVA_OPTS="$JAVA_OPTS --add-opens=java.base/java.math=ALL-UNNAMED"

2.4

Wegfall des führenden Punktes in Cookie-Domäne

In früheren Versionen von smart.finder SDI musste der Cookie-Domäne in der Konfigurationseinstellung security.sso.cookie.domain ein Punkt vorangestellt werden. Dieser Punkt ist jetzt nicht mehr gültig. Die Domäne muss also ohne führenden Punkt angegeben werden und den Regeln in RFC 6265 entsprechen.

Beispiel:

security.sso.cookie.domain=mysub.domain.com

Schemata wurden aktualisiert

Sowohl das Schema für den iso Core als auch den indexingmanagement Core wurden in der aktuellen Version geändert. Es ist daher eine Migration der Indexierungs-Jobs sowie eine Neuindexierung der Quellen notwendig, siehe Aktualisierung Index.

Dies gilt auch für den Fall, dass Sie ein Update von Version 2.4.0 auf Version 2.4.1 durchführen.

Bundle sfsdi_external-map-viewer nicht mehr obligatorisch bei Verwendung des sfsdi_linked-resources Bundles

Das Bundle sfsdi_external-map-viewer, das es erlaubt Kartendienste mit Hilfe von map.apps SDI in einem externen Kartenfenster anzuzeigen, wurde bisher durch das Bundle sfsdi_linked-resources automatisch gestartet. Daher war es nicht erforderlich das Bundle in der app.json-Datei explizit aufzulisten. Es war jedoch auch nicht möglich das Bundle vom Laden auszuschließen.

Ab Version 2.4 wird das Bundle sfsdi_external-map-viewer nur gestartet, wenn es tatsächlich gewünscht ist. Daher ist es jetzt notwendig, das Bundle in der app.json-Datei unter allowedBundles explizit anzugeben:

{
    "load": {
        "allowedBundles": [..., "sfsdi_external-map-viewer"]
    }
}

2.3

Für das Update von Version 2.2 auf Version 2.3 sind keine besonderen Update-Hinweise zu beachten.

2.2

Für das Update von 2.1 auf 2.2 müssen Sie keine Update-Hinweise beachten.

Umbenennung

Beachten Sie die Umbenennung der WAR-Dateien mit dieser Auslieferung.

2.1

Einen Überblick über sämtliche Properties finden Sie in den Web-Applikationen jeweils in der Datei /WEB-INF/classes/default-application.properties.

Folgende Properties sind für das Update relevant. Ergänzen Sie diese in Ihrer globalen application.properties Datei.

  • secman.db.jdbc.driver

  • secman.db.jdbc.url

  • secman.db.jdbc.username

  • secman.db.jdbc.password

  • secman.db.hibernate.dialect

  • secman.db.use

  • usermgr.type

  • mailing.host

  • mailing.port

  • mailing.username

  • mailing.password

  • mailing.senderaddress

Wenn der Zugriff auf die security.manager Datenbank per JNDI erfolgt, ist folgende Property notwendig:

  • secman.db.jndi.name

Wenn der UserManager ldap oder hybrid ist, ist folgende Property notwendig:

  • usermgr.ldapstorage

Die globale Datei application.properties finden Sie in ihren User-Home Verzeichnis. Das User-Home ist mit dem Property data.directory.location in der custom-application.properties definiert. Diese Datei finden Sie unter dem Pfad /WEB-INF/classes.

Eine ausführliche Erklärung der Properties finden Sie unter Konfigurationsdateien.

2.0

2.0.2

Beachten Sie für das Update auf Version 2.0.2 Folgendes:

  • Installationen mit Oracle oder Microsoft SQL Server Datenbank: nur die Backend-Services (iso, Editor und CSW) sind zu aktualisieren

  • Installationen mit PostgreSQL: Die Backend-Services und der Client sind zu aktualisieren

Durch das Update ist es erforderlich, im Manager Indexierungs-Jobs den Data Import Handler erneut anzulegen und aktiv anzustoßen.

Richten Sie nur den Data Import Handler ein, um die Datenbank kontinuierlich zu indexieren. Beachten Sie das neue Property catalog.name bei der Vergabe des Job-Namens.

Eine detaillierte Anleitung hierzu finden Sie im Kapitel Indexierungs-Jobs im Abschnitt Datenimport.

Hibernate-Dialekt für PostgreSQL

Falls Sie smart.finder SDI mit PostgreSQL verwenden, müssen Sie einen neuen Hibernate-Dialekt für den Zugriff auf die Datenbank konfigurieren:

db.hibernate.dialect=de.conterra.sdi.common.db.dialect.PostgreSQL9MapDialect

Nehmen Sie dies in der Datei application.properties vor. Falls Sie Metadatenbestände aus smart.finder SDI 1.x übernommen haben, führen Sie das Migrationstools erneut aus.

Data Import Handler konfigurieren

Prüfen Sie die korrekte Definition der Datenbank-Parameter des entsprechenden Data Import Handler in [TOMCAT_HOME]/webapps/ct-finder-iso-webapp-[VERSION]/WEB-INF/solr.home/iso/conf.

Neues Property

Es wurde ein neues Property für den Namen des lokalen Datenbestandes eingeführt:

catalog.name

Der Name des lokalen Katalogs.

Dieser Name wird in der Facette Katalog für die Metadatendokumente ausgegeben, die zum lokalen Datenbestand gehören, also in der Datenbank gespeichert sind.

Dieses Property ist in der Datei data.directory.location=$\{user.home\}/.smartfinder/application.properties einzutragen.

Standardwert: Lokaler Datenbestand
Schema: catalog.name=Meine\ Daten

2.0.1

Um lokale Dokumente von Dokumenten aus externen Quellen unterscheiden zu können, wurde ein zusätzliches Feld dem Schema hinzugefügt. Aus diesem Grund ist der Re-Import der alten Metadaten (inkl. Benutzerinformationen) erforderlich. Mit dem Migrationstool können Sie nun auch Benutzer-/Sichtbarkeitsinformationen übernehmen.

Anpassung des Indexierungsschemas

Die angepasste Schema-Datei befindet sich nach dem Deployment im Tomcat unter /smartfinder-search/WEB-INF/solr.home/iso/conf/schema.xml.

schema.xml
<?xml version="1.0" encoding="UTF-8" ?>
<schema name="iso" version="1.6">
    <uniqueKey>id</uniqueKey>
    <fields>
		[...]
		<field name="local" type="boolean" indexed="true" stored="true" multiValued="false" required="true" default="false"/>
		[...]
    </fields>
    <types>
		[...]
        <fieldType name="boolean" class="solr.BoolField" sortMissingLast="true" omitNorms="true"/>
		[...]
    </types>
</schema>

Falls Sie Änderungen in den Dateien /WEB-INF/solr.home/iso/conf/schema.xml vorgenommen haben, müssen Sie diese Änderungen entsprechend übernehmen. Stellen Sie sicher, dass sowohl Feldtyp boolean als auch Feld local übereinstimmen.

Existierende Indexierungsjobs bleiben erhalten, die Jobs müssen zwecks Neuindexierung nach dem Update/der Migration erneut ausgeführt werden.