GIP Datenbank
Vorrausetzungen
- Java 8 mit installierter Java Cryptography Extension
- Muss auch nach jedem Update neu installiert werden
- Windows (für das Startskript; muss für Linux angepasst werden)
Installation
Installation der Java Cryptography Extension (JCE)
Zertifikate importieren
- Zertifikate können mit dem Java-
keytool importiert werden
- Es müssen alle 3 Stammzertifikate der Uni Mannheim/des DFN mit unterschiedlichem Alias in den Keystore importiert werden
- Der private key der zur Erstellung des certificate request verwendet wird muss sich im Keystore befinden
- Das ausgestellte Zertifikat muss mit dem gleichen Alias wie der private ke importiert werden
- Sonst sollte sich kein Zertifikat im Keystore befinden
Anwendung starten
- Hierfür muss der Pfad zum Zertifikatspeicher, die Passwörter für diesen und das Mailkonto, und der Speicherort des geheimen PGP-Schlüssel angegeben werden:
gip-database.bat -Dplay.server.https.keyStore.path=PATH/TO/KEYSTORE -Dplay.server.https.keyStore.password=KEYSTORE-PASSWORD -Dplay.mailer.password=MAIL-PASSWORD -Dapp.gpg.secret=SECRET-PGP-KEY-LOCATION
- siehe auch HTTPS einrichten
- Bei erfolgreichem Start sollte die letzte Zeile ungefähr lauten:
[info] p.c.s.NettyServer - Listening for HTTP on /0:0:0:0:0:0:0:0:443
- Die Eingabeaufforderung bleibt geöffnet so lange der Server läuft. Die Anwenung lässt sich durch
STRG + C stoppen.
Nach dem ersten Starten (Datenbank noch leer; einmalig, wird nicht nach Updates benötigt)
- Anwendung über den Link
[SERVER-URL]/init initialisieren (z.B. https://localhost/init)
- Login-Daten werden dort angezeigt
- Mitarbeiter-Login verwenden um einen neuen Benutzer mit sicherem Passwort anzulegen
- Standardbenutzer löschen
Backup der Datenbank und Anhänge
- Die Datenbank befindet sich im Ordner
db innerhalb des Installationsordners
- Dateianhänge befinden sich im Ordner
attachments innerhalb des Installationsordners (noch nicht Teil der Anwendung)
Zurücksetzen der Datenbank
- Hierfür muss das Skript
reset_database.bat im Installationsordner der Anwendung gestartet werden. Die Anwendung darf hierbei nicht laufen. ACHTUNG: Es wird kein Backup erstellt!
Anpassung der Mailadressen und Mailtexte
- Mailadressen
- Die Mailadressen können in der Datei
[INSTALLATIONSORDNER]/conf/application-prod.conf angepasst werden
- Die
to-Adresse muss genau eine EMailadresse sein
- Im
cc sind mehrere Adressen durch ; getrennt erlaubt
- Mailtexte
- Die Mailtexte können in der Datei
[INSTALLATIONSORDNER]/conf/messages angepasst werden
- Format/Syntax:
- Ein Zeilenumbruch kann durch
\n\ erzeugt werden.
{0}, {1}, … sind Platzhalter für Daten oder Namen, die automatisch eingefügt werden. Diese dürfen nicht entfernt oder hinzugefügt werden.
- Leerzeichen oder Tabs am Anfang einer Zeile werden genau so in die Mail übernommen.
Versionierung
- Neue Major Version (z.B. 2.3.1 -> 3.0.0): API-/ Datenbankänderungen, neue Features, Bugfixes
- Unbedingt ein Backup der Datenbank durchführen!
- Neue Minor Version (z.B. 2.3.1 -> 2.4.0): Neue Features, Bugfixes
- Neue Patch Version (z.B. 2.3.1 -> 2.3.2): Bugfixes
Dokumentation der Implementierung