Benutzer-Werkzeuge

Webseiten-Werkzeuge


support:mysql

Dies ist eine alte Version des Dokuments!


Hibiscus im Netzwerk mit MySQL nutzen

Vorbemerkungen

Hibiscus verwendet standardmäßig eine embedded Datenbank (http://www.h2database.com/) mit integrierter Verschlüsselung, die beim ersten Start automatisch eingerichtet wird. Hibiscus unterstützt jedoch auch MySQL. Somit ist es möglich, eine Hibiscus-Datenbank von mehreren Arbeitsplätzen aus gleichzeitig zu nutzen.

Einrichtung

Erstellung der MySQL-Datenbank

Verwenden Sie Ihr bevorzugtes Administrationswerkzeug (z.Bsp. PhpMyAdmin oder MySQL Administrator), um eine Datenbank mit dem Namen „hibiscus“ sowie einen Benutzer anzulegen oder führen Sie folgende Kommandos aus, um Datenbank und Benutzer mit dem Kommandozeilen-Werkzeug „mysql“ („mysql.exe“ unter Windows) anzulegen. Der angelegte Benutzer muss Lese- und Schreibrechte in dieser Datenbank besitzen.

  • Als Benutzer root auf der Datenbank anmelden:

Linux:

mysql -u root -p

Windows: Öffnen Sie zuerst eine Eingabeaufforderung („cmd.exe“) und geben Sie dann ein:

C:\Programme\mysql\bin\mysql.exe -u root -p
  • Datenbank anlegen:
mysql> create database hibiscus;
  • Benutzer anlegen. Wenn die Datenbank im ganzen Intranet erreichbar sein soll, verwenden Sie statt „localhost“ beispielsweise „192.168.1.%“, wenn die IP-Adressen aller PCs in Ihrem LAN mit „192.168.1.“ beginnen oder „%“, wenn keine Einschränkungen gelten sollen.
mysql> CREATE USER 'hibiscus'@'localhost' IDENTIFIED BY '<passwort>';
mysql> GRANT ALL PRIVILEGES ON hibiscus.* TO 'hibiscus'@'localhost';

Erstellen Sie nun die von Hibiscus benötigten SQL-Tabellen manuell. Das zugehörige SQL-Script „mysql-create.sql“ befindet sich im Hibiscus-Programmverzeichnis im Unterverzeichnis „sql“, also in „jameica/plugins/hibiscus/sql/mysql-create.sql“. Beispielhafter Aufruf mit dem Kommandozeilen-Werkzeug „mysql“:

mysql -u hibiscus -p hibiscus < /opt/jameica/plugins/hibiscus/sql/mysql-create.sql

oder für Windows:

C:\Programme\mysql\bin\mysql.exe -u hibiscus -p hibiscus < C:\Programme\jameica\plugins\hibiscus\sql\mysql-create.sql

Erstellung eines Install-Bundles und der Datenbank

Damit Hibiscus auf eine MySQL-Datenbank zugreifen kann, muss eine Konfigurationdatei angepasst werden. Da diese beim ersten Start noch nicht existiert, würde Hibiscus auf jedem Arbeitsplatz unnötig eine Embedded H2-Datenbank anlegen, die anschließend überhaupt nicht gebraucht wird. Bereiten Sie daher mit den folgenden Schritten ein vorkonfiguriertes Bundle vor, welches anschließend einfach 1:1 auf alle Arbeitsplatz-PCs kopiert werden kann.

  • Laden Sie Hibiscus und Jameica herunter. Falls sie ein „heterogenes“ Netz mit Windows- und Linux-Arbeitsplätzen nutzen, dann verwenden Sie die All-In-One-Version von Jameica, welche unter beiden Betriebssystemen lauffähig ist. Andernfalls können Sie die Windows- oder Linux-Version verwenden.
  • Entpacken Sie Jameica wie bei der herkömmlichen Installation in einem beliebigen Verzeichnis. Z.Bsp.: „C:\download\jameica“
  • Entpacken Sie Hibiscus (ebenfalls wie bei der herkömmlichen Installation) im Unterverzeichnis „plugins“ von Jameica. Anschließend sollte sich dort ein Unterverzeichnis „hibiscus“ befinden. Dieses enthält dann alle Dateien und weiteren Unterverzeichnisse von Hibiscus.
  • Erstellen Sie nun manuell ein Verzeichnis „cfg“ im Programm-Verzeichnis von Jameica. In unserem Beispiel wäre dies „C:\download\jameica\cfg“.
  • Erstellen Sie in diesem Verzeichnis eine Datei mit dem Namen „de.willuhn.jameica.hbci.rmi.HBCIDBService.properties“. Öffnen Sie diese mit einem Texteditor und tragen Sie folgenden Inhalt ein:
database.driver=de.willuhn.jameica.hbci.server.DBSupportMySqlImpl
database.driver.mysql.jdbcurl=jdbc\:mysql\://<Server-IP>\:3306/hibiscus?useUnicode\=Yes&characterEncoding\=ISO8859_1
database.driver.mysql.username=<Username des MySQL-Users>
database.driver.mysql.password=<Passwort des MySQL-Users>
  • Ersetzen Sie die Werte <Username des MySQL-Users>, <Server-IP> und <Passwort des MySQL-Users> gegen den Hostnamen oder die IP-Adresse des MySQL-Servers sowie Username und Passwort des MySQL-Benutzers. (Siehe folgender Schritt für die Einrichtung der Datenbank).

Test und Verteilung auf die Arbeitsplätze

Wichtig: Die gerade manuell erstellte Konfigurations-Datei wird nur dann verwendet, wenn noch kein Jameica-Benutzerverzeichnis mit abweichenden Angaben existiert. Prüfen Sie also vor dem ersten Start, ob dieses existiert und benennen Sie es ggf. während des Tests um:

Linux: /home/<username>/.jameica
Windows: C:\Dokumente und Einstellungen\<username>\.jameica
  • Starten Sie nun diese Jameica-Installation durch Aufruf von „jameica.sh“ bzw. „jameica.bat“. Hibiscus sollte nun keine eigene Datenbank erstellen sondern stattdessen direkt auf die MySQL-Datenbank zugreifen.
  • Verteilen Sie nun das vorkonfigurierte Install-Bundle (im Beispiel also „C:\download\jameica“) auf alle teilnehmenden Arbeitsplatz-PCs.
  • Beachten Sie, daß auch auf den anderen Arbeitsplatz-PCs noch kein Jameica-Benutzerverzeichnis existieren darf, da sonst die dort angegebene Datenbank-Konfiguration (welche auf die interne H2-Datenbank verweist) verwendet wird.

Sicherheitshinweise

Nutzen Sie MySQL nur in gesicherten und vertrauenswürdigen Intranets, da sowohl Übertragung als auch Speicherung der Daten von MySQL standardmäßig unverschlüsselt erfolgt. Lesen Sie alternativ die MySQL-Dokumentation zu Grundlegenden SSL-Konzepten sowie der Einrichtung von SSL für MySQL. Die manuelle Erstellung sowie der Import des Server-Zertifikats sollte auf den Arbeitsplätzen jedoch nicht nötig sein, da Jameica einen eigenen Keystore verwendet und den Benutzer automatisch bei Bedarf zum Import des Zertifikats auffordert.



Impressum | Datenschutz
support/mysql.1233662293.txt.gz · Zuletzt geändert: d.m.Y H:i von willuhn