This is an old revision of the document!
Table of Contents
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).
- 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“.
- Geben Sie im Eingabefeld
http://janrieke.de/products/jameica/updates/
ein und klicken Sie auf „OK“, anschließend auf „Speichern“. - Doppelklicken Sie auf den neuen Repository-Eintrag mit der eben eingegebenen URI. Eine Liste mit mehreren ContractManager-Plugins erscheint.
- Wählen Sie die ContractManager-Version aus, die Sie installieren wollen. Rechtsklick darauf und dann „Herunterladen und installieren…“.1)
- 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.
ContractManager befindet sich noch im Beta-Stadium; es könnten daher noch Fehler vorhanden sein. Fertigen Sie deshalb regelmäßige Datensicherungen an.
Verwendung mit einer externen Datenbank (MySQL, MariaDB)
Normalerweise speichert ContractManager seine Daten in einer verschlüsselten H2-Datenbank im Benutzerverzeichnis. Alternativ ist seit Version 0.5.3 auch eine Nutzung einer eigenen Datenbank möglich, so dass z.B. von mehreren Rechnern aus auf die Daten zugegriffen werden kann.
Wichtiger Hinweis: Es handelt sich hierbei um ein experimentelles Feature. Es kann sein, dass einige Dinge nicht wie erwartet funktionieren. Zudem werden die Daten nicht (wie bei Verwendung der H2-Datenbank) automatisch beim Schließen von Jameica gesichert. Legen Sie daher regelmäßige Backups der Datenbank an!
Einrichtung der Datenbank
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.