Migration von 1.x zu 2.x

Dieser Abschnitt beschreibt das Vorgehen, um von smart.finder SDI mit einer Version 1.x auf den neuen smart.finder SDI zu migrieren. Ein einfaches Update ist nicht möglich. smart.finder SDI muss auf Ihrem System vollständig neu installiert werden.

Um die aktuell verwendete Version ihrer Installation zu ermitteln, geben Sie /info.txt hinter dem Basis-Pfad der Installation ein, z.B. https://<yourserver>/smartfinder-sdi/info.txt.

In der neuen Version wurde die Metadatenhaltung vereinfacht. Um die bestehenden Metadaten weiterhin zu nutzen, überführen Sie diese zunächst in die neue Datenbank. Dazu wird ein Migrationswerkzeug mitgeliefert. Ab der Version 2.3.0 wird auch ein Migrationswerkzeug für Kontakt-Templates angeboten.

Der thematische Browser (Themenbaum) wurde durch den Themenbaum ersetzt und muss daher zukünftig in JSON statt wie bisher in XML konfiguriert werden.

Sämtliche der folgenden Informationen finden Sie auch in den jeweiligen Migrations-Ordnern in der Datei README.txt.

Die nachfolgenden Erläuterungen nehmen folgende allgemeinen Versionsbezeichnungen an:

[ALT] = Ihre installierte smart.finder SDI Version 1.x

[NEU] = Die neue smart.finder SDI Version 2.x

Metadatendokumente

Die Dateien für diese Migration finden Sie unter [RELEASE-ORDNER]\resources\migration\metadata. Gehen Sie wie folgt vor:

  1. Exportieren Sie die Metadaten [ALT] mit Besitzerinformationen.

  2. Installieren Sie die Version [NEU] parallel zur bestehenden gemäß der Installationsanleitung

    Nun können Sie die Migration und den Import der Metadaten mithilfe des Migrationstools durchführen.

  3. Das Migrationstool finden Sie im Ordner resources. Kopieren Sie diesen Ordner auf denselben Host, auf dem Sie smart.finder SDI [NEU] installiert haben. Führen Sie innerhalb dieses Ordners folgende Schritte aus:

    1. Kopieren Sie den JDBC Treiber für ihre Datenbank [NEU] in das lib Verzeichnis.

    2. Passen Sie die Konfigurationseinstellungen in der Datei config\application.properties an:

      spring.datasource.username

      Name des Datenbanknutzers
      spring.datasource.password

      Passwort des Datenbanknutzers
      spring.datasource.url

      JDBC URL, abhängig von der Datenbank
      spring.jpa.database-platform

      Datenbankdialekt ihrer Plattform, abhängig von der Datenbank
      spring.datasource.driver-class-name

      Klassenname des JDBC Treibers, abhängig von der Datenbank

      Zudem müssen Sie die notwendigen security.manager Properties übernehmen. Diese können Sie den Konfigurationsdateien der security.manager Instanz entnehmen, welche von smart.finder SDI [ALT] verwendet wird.

    3. Öffnen Sie eine Konsole und navigieren in den Basis-Ordner migration\metadata.

    4. Führen Sie dort folgenden Befehl aus:

      Unter Windows:

      > bin\start.bat <exported-ZIP-file>

      Unter Linux:
      Stellen Sie sicher, dass bin/start.sh ausführbar ist.

      > ./bin/start.sh <exported-ZIP-file>

Nun ist die Migration der Metadaten abgeschlossen. Informationen über den Erfolg bzw. Probleme während des Imports finden Sie in der Datei logs\import.log.

Kontaktvorlagen (früher: Kontakt-Templates)

Seit Version 2.3.0 ist diese Migration verfügbar. Die Dateien finden Sie unter [RELEASE-ORDNER]\resources\migration\contacts.

Voraussetzung ist, dass die Datenbanken für beide Versionen eingerichtet und zugreifbar sind.

Gehen Sie wie folgt vor:

  1. Kopieren Sie den JDBC Treiber für Ihre Datenbanken [NEU] in das lib Verzeichnis.

  2. Passen Sie die Konfigurationseinstellungen in der Datei config\application.properties an.

    Die Datei ist weitestgehend vorkonfiguriert. Sie müssen lediglich die Zeilen einkommentieren, die für ihre Umgebung zutreffend sind. Folgende Properties müssen in jedem Fall angegeben werden.

    Angaben zur smart.finder SDI 1.x Datenbank [ALT]

    sfsdi1x.user.jdbc.url

    JDBC URL
    sfsdi1x.jdbc.user

    Nutzername
    sfsdi1x.jdbc.pass

    Passwort

    Angaben zur smart.finder SDI 2.x Datenbank [NEU]

    jdbc.url

    JDBC URL
    jdbc.user

    Nutzername
    jdbc.pass

    Passwort

  3. Öffnen Sie eine Konsole und navigieren Sie in den Basis-Ordner migration\contacts. Führen Sie dort folgenden Befehl aus:

    Unter Windows:

    > bin\start.bat

    Unter Linux:
    Stellen Sie sicher, dass bin/start.sh ausführbar ist.

    > ./bin/start.sh

Nun ist die Migration der Kontakte abgeschlossen. Informationen über den Erfolg bzw. Probleme während des Imports finden Sie in der Datei logs\import.log.

Vorschaubilder

Wenn Sie in der Instanz [ALT] die Upload-Funktion des Editors für Vorschaubilder genutzt haben, müssen Sie die Vorschaubilder in die Version [NEU] des Editors kopieren. Standardmäßig liegen die Bilddateien im preview Verzeichnis innerhalb der Editor Webapplikation. Kopieren Sie die Bilder aus dem preview Verzeichnis [ALT] in das preview Verzeichnis [NEU].