Aktualisierung einer bestehenden Installation

Update-Hinweise befolgen

map.apps Smart Search Extension ist sehr eng mit smart.finder gekoppelt. Daher ist das Vorgehen bei der Aktualisierung einer bestehenden Installation ähnlich. Bitte befolgen Sie daher die für smart.finder Server relevanten Update-Hinweise der smart.finder Dokumentation.

Smart Search Bundle aktualisieren

Um die Smart Search Bundles zu aktualisieren, führen Sie die folgenden Schritte aus:

  1. Navigieren Sie im Browser zum map.apps Manager.

  2. Öffnen Sie den Reiter Bundles.

  3. Klicken Sie auf + Hochladen und laden Sie die JAR Datei mit der neuen Bundleversion hoch.

Migration der Indexierungsjobs

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

Wenn Sie lediglich einen oder zwei Indexierungs-Jobs in der alten smart.finder Instanz erzeugt haben, können Sie die Jobs auch manuell über die Jobmanager-Oberfläche Ihres Browsers erneut eingeben, siehe Anlegen von Indexierungs-Jobs. Das im Folgenden beschriebene Migrationstool lohnt sich erst bei einer größeren Anzahl Indexierungs-Jobs.

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

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

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

smart.finder Server Authentifizierung prüfen

Überprüfen Sie, welche Authentifizierungsmethode in der neuen smart.finder Instanz konfiguriert ist. Diese Information können Sie der Datei [USER_HOME]/.mapapps/application.properties entnehmen. Suchen Sie das Property security.mode:

Jobs migrieren

Jobs mit Sicherheitstoken migrieren

  1. Erzeugen Sie ein Sicherheitstoken für den Zugriff auf Ihre smart.finder Server-Instanz. Geben Sie folgenden Befehl in die Kommandozeile ein.

     $ finderctl generate-token
Generate an authentication token for managing indexing jobs.

✔ Username: ·
✔ Password: ·

Your authentication token is:
[...]

    Benutzen Sie hier die Anmeldedaten, die Sie auch für die Anmeldung an der smart.finder Instanz verwenden. Daraufhin wird ein Sicherheitstoken erzeugt und auf der Konsole ausgegeben.

  2. Merken Sie sich dieses Sicherheitstoken für die weiteren Anfragen an die smart.finder Instanz.

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

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

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

    <url>

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

    <verzeichnis>

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

    <token>

    Das zuvor erzeugte base64-kodiertes Token.

  4. Senden Sie nun die zuvor gespeicherten Jobs an die neue smart.finder Server Instanz.

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

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

    <token>

    Das generierte Sicherheitstoken.

    <url>

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

    <verzeichnis>

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

  1. Melden Sie sich an der smart.finder 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 Instanz, z.B. https://mysmartsearch-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 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://mysmartsearch-alt/smartfinder-search.

    <verzeichnis>

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

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

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

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

    <verzeichnis>

    Das Quellverzeichnis, in dem die Jobs zuvor gesichert wurden, z.B. c:/smartsearch/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 auf. Hier sollten nun sämtliche Jobs aufgeführt sein, die von der alten Version übertagen worden sind. Führen Sie die Jobs nun erneut über die Oberfläche aus, um die assoziierten Indexe neu zu erzeugen.

Anpassungen der Indexierungsschemata

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 Server-Instanz übernehmen.

Seit smart.finder 2.0.0 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.