Migrations der Datenbank ins H2-Format

Wie läuft das ab?

Mit dem Update auf JVerein 1.0 (bzw. einer Entwicklerversion ab 02.12.2007) wird diese Migration bei Bedarf automatisch gestartet. JVerein erkennt hierbei selbst, ob noch die alte McKoi-Datenbank verwendet wird und führt die Datenübernehme nach eine Sicherheitsabfrage selbst durch. Der Benutzer muss hierbei also nichts manuell konfigurieren sondern lediglich den Anweisungen folgen.

Die neue Datenbank wird in folgendem Verzeichnis angelegt (insofern nicht explizit ein abweichendes Benutzerverzeichnis angegeben wurde):

Betriebssystem	Alte McKoi-Datenbank	Neue H2-Datenbank
Linux	/home/<benutzername>/.jameica/jverein/db	/home/<benutzername>/.jameica/jverein/h2db
Windows 2000/XP	C:\Dokumente und Einstellungen\<benutzername>\.jameica\jverein\db	C:\Dokumente und Einstellungen\<benutzername>\.jameica\jverein\h2db
Windows Vista	C:\[Users/Benutzer]\<benutzername>\.jameica\jverein\db	C:\[Users/Benutzer]\<benutzername>\.jameica\jverein\h2db
MacOS	/Users/<benutzername>/.jameica/jverein/db	/Users/<benutzername>/.jameica/jverein/h2db

Die alte McKoi-Datenbank wird von dem Migrationsvorgang nicht gelöscht sondern bleibt zu Backup-Zwecken erhalten.

Was ist, wenn etwas schief geht?

Falls es bei der Migration wider Erwarten zu einem Fehler kommen sollte und die Benutzerdaten verloren gegangen sind, kann die Datenmigration rückgängig gemacht und wieder auf die alte McKoi-Datenbank gewechselt werden. Öffne hierzu die Datei

 de.jost_net.jverein.rmi.JVereinDBService.properties

in einem Texteditor. Sie befindet sich im Cfg-Verzeichnis...

Betriebssystem	Verzeichnis
Linux	/home/<benutzername>/.jameica/cfg
Windows 2000/XP	C:\Dokumente und Einstellungen\<benutzername>\.jameica\cfg
Windows Vista	C:\[Users/Benutzer]\<benutzername>\.jameica\cfg
MacOS	/Users/<benutzername>/.jameica/cfg

...und enthält folgende Zeile:

 database.driver=de.jost_net.jverein.server.DBSupportH2Impl

Ändere sie in (Gross-Kleinschreibung beachten!):

 database.driver=de.jost_net.jverein.server.DBSupportMcKoiImpl

Beim nächsten Start von Hibiscus wird nun wieder die Sicherheitsabfrage zum Start der Datenmigration erscheinen. Beantworte die Abfrage mit Nein, um vorerst weiterhin mit der alten Datenbank arbeiten zu können. Melde den Fehler jedoch bitte per Mail an heiner@jverein.de.

Was ist noch zu beachten?

Die Datei de.jost_net.jverein.rmi.HBCIDBService.properties enthält unter anderem folgenden Parameter:

 database.driver.h2.encryption.encryptedpassword=....

Er enthält das verschlüsselte Passwort der H2-Datenbank. Zusammen mit dem bei jedem Start eingegebenen Master-Passwort und der Datei jameica.keystore (befindet sich ebenfalls im Cfg-Verzeichnis) sind die Benutzerdaten in der Datenbank geschützt. Geht nur eine dieser drei Informationen verloren, dann ist auch die komplette Benutzerdatenbank unwiederbringlich verloren. Es existiert keine Möglichkeit, die Datenbank ohne diese Schlüssel wiederherzustellen. Erstelle daher regelmäßig Backups des kompletten Benutzerverzeichnisses .jameica!