Update einer bestehenden Installation

Diese Seite beschreibt, wie Sie eine bestehende Installation auf eine neuere Version aktualisieren.

Vor dem Update

Beachten Sie die Update-Hinweise in den Release Notes der aktuellen Version sowie aller Versionen, die zwischen der aktuellen und der bislang bei Ihnen installierten Version liegen.

Ermitteln der aktuell verwendeten Version

Um die Versionsnummer einer bestehenden Installation zu prüfen, geben Sie /info.txt hinter dem Basis-Pfad der Installation ein, z.B. https://<yourserver>/smartfinder/info.txt.

Auf Version 2.3.0

Es müssen keine besonderen Einstellungen beachtet werden. Die bestehenden Indexe können mit der Version verwendet werden.

Auf Version 2.2.0

Es müssen keine besonderen Einstellungen beachtet werden. Die bestehenden Indexe können mit der Version verwendet werden.

Von smart.finder 2.0.9 nach 2.1.0

Wenn Sie ihren bestehenden Index weiter verwenden möchten, müssen Sie lediglich die Property solr.solr.home auf den Speicherort des Index zeigen lassen. Starten Sie danach den Tomcat neu. Nun sollten alle Suchergebnisse sowie die Indexierungs-Jobs wieder verfügbar sein.

Falls für einen Core die Suchverschläge nicht angezeigt werden, geben Sie folgendes Kommando im Browser ein:

https://<yourserver>/smartfinder-search/<CORENAME>/suggest?suggest.build=true

Danach werden die Vorschläge wieder angezeigt.

Von smart.finder 2.0.x nach 2.0.3

Durch das Update auf Apache Solr 8.6.2 hat sich die interne Initialisierung des Backend-Dienstes geändert. Dadurch sind folgende Schritte notwendig:

  • der JNDI-Eintrag solr/home in /META-INF/context.xml, welcher auf das Verzeichnis der Indexes verweist, wird nicht mehr verwendet. Hierzu wird ein neues Property solr.solr.home bereitgestellt.

    Falls Sie den Ort des solr.home geändert haben, müssen Sie diese Änderungen mithilfe der Property solr.solr.home bekannt machen.

  • In den Konfigurationsdateien der verwendeten Cores [SOLR_HOME]/[CORE_NAME]/conf/solrconfig.xml müssen Sie sicherstellen, dass das XML-Element luceneMatchVersion den Wert 8.6.2 aufweist:

    solrconfig.xml
    <?xml version="1.0" encoding="UTF-8" ?>
    <config>
        <luceneMatchVersion>8.6.2</luceneMatchVersion>
    [...]
    </config>

    Falls Sie eine angepasste Datei verwenden, stellen Sie sicher, dass der Wert übereinstimmt.

Von smart.finder 1.6.x nach 2.0.x

Durch das Update von Apache Solr 7 auf Apache Solr 8.x, welches ein entsprechendes Apache Lucene Update enthält, haben sich die Schemata für das Index-Management und den Standardcore core0 geändert. smart.finder 2.0.x kann daher nicht mit einem Index arbeiten, der mit smart.finder 1.6.x erstellt wurde. Um den Index mit smart.finder 2.0.x neu zu erstellen, wird ein Migrationswerkzeug mitgeliefert. Dieses befindet sich im Verzeichnis /resources/migration der smart.finder Distribution.

Für die Migration muss das Zielsystem (d.h. smart.finder 2.x) im Sicherheitsmodus INTEGRATED laufen. Nach erfolgter Migration der Daten kann der Sicherheitsmodus geändert werden.

Die folgenden Schritte werden empfohlen:

  1. Installieren Sie smart.finder 2.0.x parallel zur bestehenden smart.finder 1.6.x Installation. Dies kann entweder in derselben Tomcat-Instanz geschehen oder durch die Verwendung von zwei verschiedenen Tomcat-Instanzen.

  2. Öffnen Sie im Verzeichnis /resources/migration die Datei config.properties in einem Texteditor.

    1. Ändern Sie die Werte der Properties entsprechend Ihrer Umgebung.

    2. Speichern Sie die Datei.

  3. Öffnen Sie einen Command Prompt (Windows) oder eine Shell (Linux) im Verzeichnis /resources/migration und geben Sie die folgende Anweisung ein:

    java -jar ct-finder-migration.jar -cf config.properties

    Stellen Sie sicher, dass eine korrekte Java-Installation zugänglich ist. Wenn Sie den Dateinamen der Konfigurationsdatei geändert haben (gegeben durch den Parameter -cf), müssen Sie den neuen Namen der Properties-Datei verwenden.
    Nach Abschluss der Migration wurden alle Indexierungsjobs in den smart.finder 2.0.x kopiert.

  4. Öffnen Sie den smart.finder Jobmanager 2.0.x in Ihrem Webbrowser. Sie können nun die Jobs neu starten oder, falls vorhanden, den angehängten Scheduler die Arbeit erledigen lassen. Dadurch wird die Indexierung neu angestoßen und der Index im Ziel-Core neu aufgebaut.

Alternative Migration
Wenn Sie lediglich einen oder zwei Indexierungsjobs in der alten smart.finder-Instanz haben, können Sie die Jobs auch manuell über die Jobmanager-Oberfläche Ihres Browsers erneut eingeben, siehe Anlegen von Indexierungs-Jobs

Das oben beschriebene Migrationswerkzeug eignet sich in erster Linie für den Fall, dass Sie eine große Anzahl vorhandener Indexierungsjobs mit vielen unterschiedlichen Einstellungen haben.

Schemaanpassungen

Falls Sie Änderungen in den Dateien /WEB-INF/solr.home/<CORENAME>/schema.xml sowie /WEB-INF/solr.home/<CORENAME>/solrconfig.xml vorgenommen haben, müssen Sie diese Änderungen entsprechend in die neue smart.finder 2.0.x Instanz übernehmen.

Mit smart.finder 2.0.x wird ein separater Core für die map.apps Smart Search Extension ausgeliefert. Sie können diesen für Dokumente aus einer Smart Search Indexierung verwenden, haben aber nach wie vor die Möglichkeit, alle Dokumente im Default-Schema core0 zu belassen. Falls Sie das Smart Search Schema verwenden möchten, müssen Sie die angepassten Teile aus dem core0-Schema übernehmen.