Differences

This shows you the differences between two versions of the page.

--- contractmanager:installation [2018/02/10 20:02] – [Einrichtung der Datenbank] janrieke
+++ contractmanager:installation [2022/10/19 21:37] (current) – janrieke
@@ Line 1: / Line 1: @@
 ====== Installationsanleitung ======
-ContractManager baut auf der Jameica-Plattform auf. Sofern Sie Jameica schon installiert haben (z. B. weil Sie Hibiscus nutzen), fahren Sie mit Schritt 2 fort. Andernfalls laden Sie zunächst Jameica herunter: http://willuhn.de/products/jameica/download.php (mindestens Jameica 2.6.4). Achtung: ContractManager benötigt mindestens Java 8 (anders als Jameica, was auch noch mit Java 7 lauffähig ist).
+ContractManager baut auf der Jameica-Plattform auf. Sofern Sie Jameica schon installiert haben (z. B. weil Sie Hibiscus nutzen), fahren Sie mit Schritt 2 fort. Andernfalls laden Sie zunächst Jameica herunter: https://www.willuhn.de/products/jameica/download.php (mindestens Jameica 2.6.4). Achtung: ContractManager benötigt mindestens Java 8 (anders als Jameica, was auch noch mit Java 7 lauffähig ist).
   - Starten Sie Jameica/Hibiscus (durch Ausführen der entsprechenden .exe- oder .sh-Datei). Setzen Sie (sofern noch nicht geschehen) ein Master-Passwort.
   - Gehen Sie im Menü auf „Datei“, „Plugins online suchen…“.
-  - Klicken Sie auf „Plugin-Repositories verwalten“, dann auf „Neues Repository hinzufügen“.
+  - Klicken Sie auf „Repositories bearbeiten“, dann auf „Neues Repository hinzufügen“.
-  - Geben Sie im Eingabefeld ''<nowiki>http://janrieke.de/products/jameica/updates/</nowiki>'' ein und klicken Sie auf „OK“, anschließend auf „Speichern“.
+  - Geben Sie im Eingabefeld ''<nowiki>http://janrieke.de/products/jameica/updates/</nowiki>'' ein und klicken Sie auf „Übernehmen“, anschließend (im Plugin-Repositories-Dialog) auf „Schließen“, dann unten rechts auf „Speichern“.
-  - Doppelklicken Sie auf den neuen Repository-Eintrag mit der eben eingegebenen URI. Eine Liste mit mehreren ContractManager-Plugins erscheint.
+  - Wechseln Sie auf den Reiter „Verfügbare Plugins“.
-  - Wählen Sie die ContractManager-Version aus, die Sie installieren wollen. Rechtsklick darauf und dann „Herunterladen und installieren…“.((Hinweis: Die „devel“- und „SNAPSHOT“-Versionen sind für Test-Zwecke bestimmt und könnten noch größere Fehler enthalten.))
+  - Wählen Sie den neuen Repository-Eintrag mit der eben eingegebenen URI aus. Sofern der ContractManager noch nicht installiert ist, sehen Sie mindestens einen Eintrag für ein ContractManager-Plugin.
+  - Wählen Sie die ContractManager-Version aus, die Sie installieren wollen, und klicken Sie auf „Installieren…“.((Hinweis: Die „devel“- und „SNAPSHOT“-Versionen sind für Test-Zwecke bestimmt und könnten noch größere Fehler enthalten.))
   - Wählen Sie „Ja“, „Ja“, and „Übernehmen“.
   - Starten Sie Jameica neu. ContractManager ist jetzt installiert.
-Sofern die automatische Suche nach Updates in Jameica aktiviert ist, werden Sie über neue ContractManager-Versionen benachrichtigt. Falls nicht, können Sie manuell über "Datei", "Einstellungen", "Updates", "Jetzt nach Updates suchen..." nach Updates suchen.
+Sofern die automatische Suche nach Updates in Jameica aktiviert ist, werden Sie über neue ContractManager-Versionen benachrichtigt. Falls nicht, können Sie manuell über „Datei“, „Einstellungen“, Reiter „Plugins“, Reiter „Updates“ nach Updates suchen.
 ContractManager befindet sich noch im Beta-Stadium; es könnten daher noch Fehler vorhanden sein. Fertigen Sie deshalb regelmäßige Datensicherungen an.
@@ Line 23: / Line 24: @@
 Zunächst muss ein Datenbank-Benutzer für ContractManager erstellt werden. Außerdem benötigt ContractManager eine eigene Datenbank. (Im Folgenden gehen wir davon aus, dass der Datenbankname ''contractmanager'' lautet; der Name kann aber auch anders lauten.) Der Datenbank-Benutzer benötigt vollen Zugriff auf die Datenbank.
-Als nächstes muss ContractManager so konfiguriert werden, dass auch die externe Datenbank benutzt wird.
+Als nächstes müssen die notwendigen Tabellen in der Datenbank angelegt werden.((ContractManager macht dies nicht selbst. Spätere Updates für die Datenbankstruktur in neuen Programmversionen werden aber automatisch durchgeführt.)) Dazu muss das Skript in ''plugins/contractmanager/sql/mysql-create.sql'' auf der gerade erstellten Datenbank ausgeführt werden.
+Zuletzt muss ContractManager so konfiguriert werden, dass auch die externe Datenbank benutzt wird.
 Dazu trägt man in ''cfg/de.janrieke.contractmanager.rmi.ContractDBService.properties'' folgende Zeilen ein:
@@ Line 31: / Line 34: @@
   database.driver.mysql.password=<Passwort des MySQL-Users>
+Die Werte ''<Server-IP>'', ''<Username des MySQL-Users>'' und ''<Passwort des MySQL-Users>'' mit dem Hostnamen oder der IP-Adresse des MySQL/MariaDB-Servers sowie Username und Passwort des MySQL-Benutzers ersetzen.
+Die folgende Zeile muss gelöscht (oder mit ''#'' auskommentiert) werden:
+  database.driver=de.janrieke.contractmanager.server.DBSupportH2Impl
+Die Zeilen, die mit ''database.driver.h2'' beginnen, beziehen sich nur auf die H2-Datenbank. Sie können entfernt werden, sofern die H2-Datenbank nicht mehr benötigt wird (also alle Daten migriert sind).
+==== Migration der H2-Daten ====
+Eine automatische Migration der Daten ist nicht möglich. Man kann aber die lokale H2-Datenbank öffnen und die Daten von dort manuell übertragen. Die Zugangsdaten zur H2-Datenbank finden sich nach dem Start des ContractManagers im Menü unter ContractManager -> Über... -> Datenbankinformationen.