Migrieren einer Derby-Datenbank in das H2-Format – Acrolinx GmbH

Betrifft

Software	Version
Acrolinx Server	4.3, 4.4, 4.5, 4.6, 4.7, 5.0, 5.1, 5.2, 5.3, 5.4, 5.5, 5.6, 2018.10

Zum Testen der Analytics-Funktionen wird Acrolinx standardmäßig mit einer Berichtsdatenbank ausgeliefert. In früheren Serverversionen wurde dafür eine Apache Derby-Datenbank installiert. In Version 4.0 hat Acrolinx die standardmäßig installierte Datenbank in H2 geändert. Wenn Sie die Standarddatenbank verwenden, verbessert dieses neue Datenbankformat die Leistung. Die Standarddatenbank sollte jedoch auch weiterhin nur für Test- und Demonstrationszwecke verwendet werden. Acrolinx unterstützt verschiedene externe Datenbanken , die besser für den produktiven Einsatz geeignet sind.

Wenn Sie bereits die Standarddatenbank verwenden, müssen Sie die vorhandene Datenbank zur neuen H2-Datenbank migrieren. Während der Migration müssen Sie die alte Derby-Datenbank sichern und die Sicherung in der neuen H2-Datenbank wiederherstellen. Diese Migration ist nur notwendig, wenn Sie die standardmäßge Apache Derby-Datenbank verwenden. Wenn Sie eine externe Datenbank verwenden, müssen Sie die Migration nicht durchführen.

So migrieren Sie die Berichtsdaten von der Derby-Datenbank zu einer H2-Datenbank

Aktualisieren Sie Ihre Acrolinx-Installation auf Version 4.0.
Weitere Informationen zur Aktualisierung finden Sie im Acrolinx Server Administrationshandbuch .
Stoppen Sie alle Server.
Öffnen Sie Ihr Overlay der folgenden Datei: persistence.properties

Erstellen Sie eine neue Version dieser Datei am folgenden Speicherort, wenn Sie noch kein Overlay erstellt haben:

%ACROLINX_CONFIGURATION_ROOT%\server\bin\

Bearbeiten Sie nicht die installierte Version der Datei. Bearbeiten Sie stattdessen immer das Overlay im Konfigurationsverzeichnis.
Aktualisieren Sie die Eigenschaften für die Berichtsdatenbank entsprechend dem folgenden Beispiel:
```
reporting.dbType=DERBY

reporting.jdbcUser=admin

reporting.jdbcPassword=k7hWFD2IJ4dIln35D

reporting.jdbcUrl=jdbc:derby:reports;territory=de_DE
```
Wenn Sie die Verbindungsdetails noch nie eingegeben haben, weil Sie immer die Standarddatenbank verwendet haben, müssen Sie das Auskommentieren der entsprechenden Zeilen möglicherweise erst rückgängig machen.
Starten Sie den Hauptserver.
Melden Sie sich am Dashboard an und sichern Sie die Berichtsdatenbank.
1. Navigieren Sie zu Analytics > Administration > Sichern und Wiederherstellen .
2. Klicken Sie auf Neue Sicherung erstellen .
  
  Nach Abschluss der Sicherung wird die neue Sicherung in der Tabelle Verfügbare Sicherungen angezeigt.
  
  Die Sicherungsdatei wird im folgenden Verzeichnis auf dem Servercomputer gespeichert:
  
  <INSTALL_VER>\server\www\output\analytics\backup
  
  Wenn Sie die Sicherungen an einem anderen Ort speichern möchten, können Sie auch auf Herunterladen in der Spalte Aktionen klicken.
  
  Klicken Sie auf Abbrechen neben dem Fortschrittsbalken, um die Sicherung abzubrechen.
Stoppen Sie den Hauptserver.
Öffnen Sie Ihr Overlay der folgenden Datei: persistence.properties
Kommentieren Sie die Verbindungsdetails aus, die Sie in Schritt 4 eingegeben haben, und speichern Sie die Datei.
Starten Sie den Hauptserver.
Melden Sie sich am Dashboard an und stellen Sie die Sicherung der Berichtsdatenbank wieder her.
1. Suchen Sie die Sicherung im Abschnitt Verfügbare Sicherungen und klicken Sie in der Spalte Aktionen auf Wiederherstellen .
  
  Um eine Sicherung wiederherzustellen, die auf einem anderen Computer oder im Netzwerk gespeichert ist, müssen Sie zunächst die Sicherung auf den Server hochladen .
2. Geben Sie im Sicherheitsdialog das Wort ja ein und klicken Sie auf OK .
  
  Tipp: Diese Sicherheitsabfrage ist eine zusätzliche Vorsichtsmaßnahme, die verhindert, dass die Berichtsdatenbank versehentlich überschrieben wird. Bei der Wiederherstellung werden alle Berichtsdaten mit den Daten aus der Sicherung überschrieben.
Die Daten aus der Derby-Datenbank werden jetzt in die neue H2-Datenbank übertragen.
Starten Sie den Hauptserver neu.