Bestehende Installation aktualisieren

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

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-sdi/info.txt.

Update-Hinweise befolgen

Befolgen Sie die Update-Hinweise der aktuellen Version und derer, die Sie im Zuge eines Updates überspringen würden.

Aktualisierung der Web-Applikationen

Die nachfolgende Erläuterung nimmt folgende allgemeinen Versionsbezeichnungen an:

  • [ALT] = die installierte smart.finder SDI Version

  • [NEU] = die neue smart.finder SDI Version

Folgende Schritte sind erforderlich:

  1. Stoppen Sie Apache Tomcat.

  2. Verschieben Sie die Web-Applikationen der Version [ALT] in ein temporäres Verzeichnis.

  3. Entpacken Sie smart.finder SDI [NEU] nach [TOMCAT_HOME]/webapps (bzw. in das Autodeploy-Verzeichnis des Apache Tomcat).

  4. Überprüfen Sie, dass das Property data.directory.location in den Dateien custom-application.properties auf das von Ihnen verwendete User-Home Verzeichnis zeigt.

  5. Ergänzen Sie neue Properties in [USER_HOME]/application.properties und passen Sie ggf. bestehende Werte an. Beachten Sie dafür die Update-Hinweise.

  6. Übernehmen Sie die Capabilities.xml aus dem smartfinder-csw[ALT] in die neue Instanz. Diese finden Sie unter smartfinder-csw[ALT]/WEB-INF/classes/capabilities/Capabilities.xml.

  7. Ergänzen Sie die Properties für den Datenbank-Zugriff im Data-Import Handler entsprechend Ihrer Datenbank. Die Dateien befinden sich unter /smartfinder-search[ALT]/WEB-INF/solr.home/iso/conf und beginnen mit dih-*.

  8. Starten Sie Apache Tomcat.

Die Version [NEU] des smart.finder SDI steht nun grundsätzlich zur Verfügung, lediglich existierende Indexierungs-Jobs fehlen noch.

Aktualisierung des Index

Wird mit einer neuen Version ein Schema-Update ausgerollt, können die aktuellen Indexe nicht mehr verwendet werden. Dann ist es notwendig, die Indexierungsjobs in die neue Version zu übertragen und diese erneut auszuführen, damit die Indexe neu erstellt werden. Dieser Abschnitt beschreibt, wie die Migration durchzuführen ist.

smart.finder SDI besitzt zwei Cores, die die Indexe verwalten: iso und indexingmanagement. Eine Übernahme des Cores iso ist nicht notwendig, da dieser durch die erneute Ausführung der Indexierungs-Jobs wieder hergestellt werden kann.

Die Übernahme der Indexierungs-Jobs lohnt sich nur bei einer Vielzahl von Jobs. Falls Sie nur wenige Jobs verwalten, können Sie diese in der neuen Instanz auch händisch neu eintragen.

Wenn Sie solr.home außerhalb der Webapp smartfinder-search gespeichert haben, müssen Sie den hier lokalisierten Core iso löschen und die neuen Dateien von /solr.home/iso hierhin kopieren.

Installation smart.finder CLI

Die Migration der Indexierungsjobs wird mithilfe der smart.finder CLI durchgeführt. Dabei werden zunächst die Jobs der alten smart.finder SDI Server-Instanz lokal gesichert und anschließend in die neue smart.finder SDI Instanz gespeichert.

Stellen Sie zunächst sicher, dass Sie die smart.finder CLI installiert haben, siehe hierzu Installation der smart.finder CLI.

Die grundsätzliche Verwendung der CLI ist in Kommandozeilenwerkzeug (CLI) beschrieben.

Jobs migrieren

Um die Indexierungsjobs zu migrieren gehen Sie wie folgt vor:

  1. Melden Sie sich an der smart.finder SDI Instanz an, um ein Domain Session Cookie zu erzeugen. Dieses wird temporär auf Ihrem Rechner gespeichert und für alle weiteren Requests automatisch verwendet.

     $ finderctl login -u <server_url>
    Please enter your credentials to login to smart.finder.
    ? Username: admin
    ? Password: [hidden]

    Setzen Sie für die Variablen die folgenden Werte ein:

    <url>

    Die URL zur alten smart.finder SDI Instanz, z.B. https://mysmartfinder-sdi-alt/smartfinder-search

    Eine erfolgreiche Anmeldung wird in der Konsole bestätigt und ein Domain Session Cookie wird temporär lokal gespeichert.

  2. Für das Speichern der Indexierungsjobs der alten smart.finder SDI Instanz geben Sie den folgenden Befehl ein:

    $ finderctl jobs get -u <url> -d <verzeichnis>

    Setzen Sie für die Variablen die folgenden Werte ein:

    <url>

    Die URL zum smart.finder Backend, z.B. https://mysmartfinder-sdi-alt/smartfinder-search.

    <verzeichnis>

    Das Zielverzeichnis, in dem die Indexierungsjobs gespeichert werden, z.B. c:/smartfinder-sdi/jobs.

  3. Senden Sie nun die zuvor gespeicherten Jobs an die neue smart.finder SDI Instanz.

     $ finderctl jobs put -u <url> -d <verzeichnis>
    <url>

    Die URL zur neuen Instanz des smart.finder Backends, z.B. https://mysmartfinder-sdi-neu/smartfinder-search. Die URL ist identisch mit der URL, die für die Konfigurationseigenschaft finder.service.url in der application.properties-Datei von smart.finder SDI eingetragen wurde.

    <verzeichnis>

    Das Quellverzeichnis, in dem die Jobs zuvor gesichert wurden, z.B. c:/smartfinder-sdi/jobs.

  4. Nach erfolgreicher Migration können Sie sich über folgenden Befehl abmelden. Dadurch wird das lokal gespeicherte Domain Session Cookie von ihrem Rechner entfernt:

     $ finderctl logout

Überprüfen der Migration

Rufen Sie den Job-Manager der neuen smart.finder SDI Instanz auf. Hier sollten nun sämtliche Jobs aufgeführt sein, die von der alten Instanz übertagen worden sind.

Führen Sie die Jobs nun erneut über die Oberfläche aus, um die assoziierten Indexe neu zu erzeugen.