Installation

Systemvoraussetzungen

Installation

1. Entpacke das Archiv auf Deinem Server.
2. Wechsle in das erstellte Verzeichnis "hibiscus-server".
3. Öffne die Datei "cfg/de.willuhn.jameica.hbci.rmi.HBCIDBService.properties" in einem Texteditor und passe die Zugangsdaten zur Datenbank an:

   database.driver.mysql.jdbcurl=jdbc\:mariadb\://<hostname>\:3306/...
   database.driver.mysql.jdbcdriver=org.mariadb.jdbc.Driver
   database.driver.mysql.username=<username>
   database.driver.mysql.password=<password>

   Gib statt "<hostname>" den Hostnamen der Datenbank (z.Bsp. "localhost" wenn sich Server und Datenbank auf dem selben Rechner befinden) ein. Passe außerdem Username und Passwort an.
   Wenn Du keine externe MySQL-Datenbank nutzen möchtest, dann lösche einfach diese Konfigurationsdatei. Der Server wird beim ersten Start automatisch eine verschlüsselte Embedded-Datenbank (H2) erstellen. Die 3 folgenden Schritte zum Erstellen der Datenbank, des Benutzers und der Tabellen sind in dem Fall nicht notwendig.
4. Erstelle anschließend eine neue MySQL-Datenbank mit dem Namen "hibiscus"

   mysql> CREATE DATABASE hibiscus
          CHARACTER SET utf8 COLLATE utf8_general_ci;

   Achte hierbei auf den Zeichensatz "utf8" - verwende nicht "utf8mb4".
5. Lege einen Benutzer in der Datenbank an:

   mysql> CREATE USER '<username>'@'<hostname>'
          IDENTIFIED BY '<password>';
   mysql> GRANT ALL ON hibiscus.* TO '<username>'@'<hostname>';
   mysql> FLUSH PRIVILEGES;
   

6. Erstelle nun die Hibiscus-Tabellen mit dem beiliegenden SQL-Script "mysql-create.sql" - Du findest es im Verzeichnis "plugins/hibiscus/sql":

   cd plugins/hibiscus/sql
   mysql -u <username> -p -h <hostname> hibiscus < mysql-create.sql

7. Starte den Server mit folgendem Kommando:

   ./jameicaserver.sh (Linux)
   jameicaserver (Windows)

   Starte den Server nicht mit Administrator- bzw. Root-Rechten sondern verwende einen unpriviligierten Benutzeraccount.
8. Beim ersten Start des Servers wirst Du zur Vergabe eines neuen Masterpasswortes aufgefordert, welches bei allen folgenden Starts benötigt wird. Wenn Du dieses Passwort nicht immer manuell eingeben möchtest (z.Bsp. weil der Hibiscus Server beim Start des Betriebssystems automatisch geladen werden soll), dann kannst Du es auch im Startkommando mit dem Parameter -p <Passwort> angeben.
9. Öffne das Webfrontend des Servers in einem Browser:

   URL	Beschreibung
   https://<server>:8080/webadmin	Starten und Beenden von Diensten, Log-Ausgaben
   https://<server>:8080/hibiscus	Webfrontend des Payment-Servers
   https://<server>:8080/sensors	System-Monitoring
   https://<server>:8080/soap	Verfügbare SOAP-Webservices
   https://<server>:8080/webadmin/rest.html	Verfügbare REST-Webservices
   https://<server>:8080/xmlrpc/	Verfügbare XML-RPC-Services. Beachte den Slash "/" am Ende der URL. Eine Liste möglicher XML-RPC-Aufrufe findest Du im Wiki.

   Verwende als Benutzername "admin" und als Passwort das beim Serverstart eingegebene Master-Passwort.
10. Öffne https://<server>:8080/hibiscus/passports.html und wähle dort die Art des anzulegenden Bankzugangs (im Zweifel immer PIN/TAN) und gib dann im Absatz "Neue PIN/TAN-Konfiguration anlegen" die Daten des Bankzugangs an. Beim Klick auf "Speichern..." wird der Bankzugang erstellt und initialisiert. Wenn der Vorgang erfolgreich war, werden hier auch die zugeordneten Konten automatisch angelegt.