Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- support:h2-migration [d.m.Y H:i] – willuhn
+++ support:h2-migration [d.m.Y H:i] (aktuell) – gelöscht willuhn
@@ Zeile 1: / Zeile 1: @@
-====== Migration der Datenbank auf H2-Format ======
-===== Was ist das und wen betrifft das? =====
-Hibiscus verwendete bis Version 1.7 für das Speichern der Benutzerdaten standardmäßig die [[http://mckoi.com/database/|McKoi-Datenbank]]. Mit Version 1.8 wurde das Format auf [[http://www.h2database.com/|H2]] umgestellt, da McKoi nicht mehr weiterenwickelt wird. Benutzer, die Hibiscus erst seit Version 1.8 verwenden, betrifft diese Umstellung nicht. Lies in dem Fall bitte dennoch den Abschnitt [[#Was ist noch zu beachten?]].
-Aufgabe der Migration ist es also, die Benutzerdatenbank im H2-Format neu zu erstellen und alle Daten aus der alten McKoi-Datenbank in das neue System zu übernehmen.
-===== Wie läuft das ab? =====
-Mit dem Update auf Hibiscus 1.8 (bzw. einem entsprechend aktuellen Nightly-Build ab 22.12.2007) wird diese Migration bei Bedarf automatisch gestartet. Hibiscus 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/hibiscus/db | /home/<benutzername>/.jameica/hibiscus/h2db |
-| Windows 2000/XP | C:\Dokumente und Einstellungen\<benutzername>\.jameica\hibiscus\db | C:\Dokumente und Einstellungen\<benutzername>\.jameica\hibiscus\h2db |
-| Windows Vista   | C:\[Users/Benutzer]\<benutzername>\.jameica\hibiscus\db | C:\[Users/Benutzer]\<benutzername>\.jameica\hibiscus\h2db |
-| MacOS           | /Users/<benutzername>/.jameica/hibiscus/db | /Users/<benutzername>/.jameica/hibiscus/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.willuhn.jameica.hbci.rmi.HBCIDBService.properties
-in einem Texteditor. Sie befindet sich im Cfg-Verzeichnis...
-^ Betriebssystem  ^ Verzeichnigs ^
-| 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.willuhn.jameica.hbci.server.DBSupportH2Impl
-Ändere sie in (Gross-Kleinschreibung beachten!):
-  database.driver=de.willuhn.jameica.hbci.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 [[hibiscus@willuhn.de]].
-===== Was ist noch zu beachten? =====
-Die Datei ''de.willuhn.jameica.hbci.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 (mit allen Konten, Aufträgen und Umsätzen) unwiederbringlich verloren. Es existiert keine Möglichkeit, die Datenbank ohne diese Schlüssel wiederherzustellen. Erstelle daher __regelmäßig__ [[support:backup|Backups] des kompletten Benutzerverzeichnisses ''.jameica''!

Impressum | Datenschutz