Migration

Bei einem Update auf eine Version mit einer höheren zweiten Versionsnummernstelle können Änderungen am Datenbank-Schema notwendig sein. Für diesen Fall wird ein Kommandozeilen-Tool ausgeliefert, dem die aktuell verwendete Version, die Version auf die migriert werden soll und die Verbindungsdaten zur Datenbank übergeben werden. Das Programm führt die Änderungen an der Datenbank dann sukzessiv bis zur gewünschten Version durch.

Das Tool wird als Main-Klasse des migration-tool-[VERSION].jar ausgeführt. Dieses Jar befindet sich unter im Unterordner migration des Auslieferungspaket.

Zum Ausführen des Tools kann folgendes Kommando (Windows OS) verwendet werden:

java -cp migration-tool-[VERSION].jar de.signotec.ssu.migration.DBMigration

Das Tool fragt vor dem Start alle notwendigen Parameter ab. Das sind der Reihenfolge nach:

1. Die Angabe zur aktuell verwendeten Version

2. Die Angabe zur Version, auf die migriert werden soll

3. Die Verbindungs-URL zur Datenbank

4. Ein Benutzername für die Datenbank

5. Ein Passwort für den angegebenen Benutzer

6. Der Package-Name des zu verwendenden JDBC-Treibers

7. Die Angabe des, von Hibernate zu verwendenden SQL-Dialekts, als Package-Namen

• Der verwendete Datenbankbenutzer benötigt das Recht, Tabellen des signoSign/Universal-Schemas zu ändern.

• Die Parameter für die Datenbankverbindung können aus der Hibernate-Konfiguration entnommen werden.

• Die verwendete Datenbank muss gestartet sein, damit die Migration durchgeführt werden kann. Das bedeutet, wenn SSU im Auslieferungszustand verwendet wird, muss SSU gestartet werden, damit die H2-Datenbank läuft.