[[Vorlage(Getestet, jammy, focal, noble, questing, resolute)]] {{{#!vorlage Wissen [:Packprogramme: Archive entpacken] [:Terminal: Ein Terminal öffnen] [:Programme starten:] [:Java:] }}} [[Inhaltsverzeichnis()]] [[Bild(./hibiscus.png, 48, align=left)]] [https://www.willuhn.de/products/hibiscus/ Hibiscus] {de} ist ein freier und quelloffener Online-Banking-Client für das [wikipedia:Homebanking_Computer_Interface:HBCI]-Protokoll, der dank Java sowohl unter Linux als auch unter Windows und Mac OS X läuft. Hibiscus basiert auf [github:hbci4j/hbci4java:HBCI4Java] {en} und läuft als Plugin in [https://www.willuhn.de/products/jameica/ Jameica] {de}. Dieser Artikel beschäftigt sich mit der Installation der beiden Komponenten Jameica und Hibiscus. Hinweise zur Verwendung sind unter [:Hibiscus/Einrichten:] und im [https://www.willuhn.de/wiki/doku.php?id=handbuch Handbuch] {de} zu finden. Hibiscus kann optional auch mit einem Chipkartenleser benutzt werden. Das Gerät ist separat einzurichten, siehe hierzu Artikel [:HBCI Kartenleser:]. [[Bild(./hib-1.png, 150, align=right)]] = Voraussetzungen = Hibiscus basiert auf [:Java:] und läuft in dem Programm Jameica als Plugin. Die Installation von Java wird im Artikel [:Java/Installation:] beschrieben. Die Verwendung von Hibiscus mit [:Java#OpenJDK:OpenJDK] 21 wurde erfolgreich unter [:Noble:] getestet, weiterhin ist die Verwendung mit [:Java#OpenJDK:OpenJDK] 25 erfolgreich unter [:25.10:Questing] getestet. = Installation = ==1. aus den Paketquellen == Ab '''Ubuntu 22.04''' kann man direkt aus den Paketquellen installieren. {{{#!vorlage Paketinstallation hibiscus, universe }}} Nach der Installation wird Hibiscus mit dem Befehl {{{jameica}}} gestartet. {{{#!vorlage Hinweis Seit Anfang Oktober 2025 sind die Banken verpflichtet die IBAN Nummer mit dem Namen des Kontoinhabers abzugleichen. Hibiscus kann den Vergleich erst ab der Version 2.12.0. vornehmen. Diese Version wurde auf der [https://www.willuhn.de/products/jameica/download.php Herstellerseite] {de} Ende Oktober veröffentlicht. Die aktuelle Version bei den Ubuntu-Quellen ist 2.10.4. Mit dieser Version können die Kontoauszüge abgerufen werden. Überweisungen sind nicht möglich. Deshalb wird empfohlen die nachstehend manuelle Installation vorzunehmen. }}} == 2. Manuelle Installation == Eine manuelle Installation erlaubt die Installation der neusten Version von Jameica (Empfehlung des Autors O. Willuhn), Hibiscus wird ''später'' als Plugin zugefügt. Z.B. wurde Jameica Version 2.10.5 mit Oracle Java 24 und Jameica 2.12.0 mit openjdk version "21.0.8" erfolgreich getestet. {{{#!vorlage Hinweis Bei der manuellen Installation wird nur Jameica installiert. Hibiscus wird nach der Installation als Plugin installiert. Informationen zum HBCI-Kartenleser sind im Artikel [:HBCI Kartenleser:] (Installation) zu finden. }}} == Installation Jameica == Auf der [https://www.willuhn.de/products/jameica/download.php Herstellerseite] {de} prüfen, ob sich ggf. die Versionsnummer verändert hat. Ist dies nicht der Fall, kann folgendes genutzt werden. {{{#!vorlage Warnung Fremdpakete können das System gefährden. }}} Die Datei '''jameica-linux64-2.x.y.zip''' im Verzeichnis ''Downloads'' speichern. [https://www.willuhn.de/products/jameica/download.php Download] {de} {dl} Anschließend entpackt [2] man die Datei im Terminal [3] in das Verzeichnis [:opt:/opt/], mit folgendem Befehl: {{{#!vorlage Befehl sudo unzip Downloads/jameica-linux64-2.x.y.zip -d /opt/ # hierbei für x,y die aktuellen Versionsnummern benutzen }}} {{{#!vorlage Hinweis Ist eine alte Hibiscus Installation vorhanden, beim Entpacken die Option [[Vorlage(Tasten, a)]] A-Taste wählen und die [[Vorlage(Tasten, enter)]] Entertaste drücken, um die alten Dateien zu überschreiben. Die vorhandenen Benutzerdaten gehen hierbei nicht verloren. }}} {{{#!vorlage Hinweis Eine manuell installierte Version nach '''opt''', ersetzt nicht die zuvor installierte Version aus den Quellen! Diese muss zuerst entfernt werden, die vorhandenen Benutzerdaten werden hierbei nicht entfernt! Im Terminal mit der [[Vorlage(Tasten, j)]] J-Taste bestätigen. }}} Entfernen mit folgendem Befehl: {{{#!vorlage Befehl sudo apt-get remove jameica }}} Nach der manuellen Installation sind die ersten Schritte in [:Hibiscus/Einrichten:] erklärt. = Installation des Plugins Hibiscus = Nach dem ersten Start von Jameica wird das Begrüßungsfenster angezeigt. Später, nach Installation des Plugins' Hibiscus, startet Hibiscus immer gleich das Anwendungsprogramm. Hier sind nun einige Eingaben erforderlich. 1. Im rechten unteren Bereich, einen [[Vorlage(Tasten, lmt)]] Linksklick auf „Online-Updates aktivieren“ ausführen. Wenn ein Update zur Verfügung steht, kommt beim Start eine Meldung. 1. Im rechten oberen Bereich, einen [[Vorlage(Tasten, lmt)]] Linksklick auf „Plugins Online suchen“ ausführen. Das Fenster von Hibiscus wird sich weiter öffnen. Im rechten Bereich wird das Plugin Hibiscus angezeigt, hier steht auch die aktuelle Version. Im aktuellen Fall ist das die „2.10.6“, das Plugin wird durch einen [[Vorlage(Tasten, lmt)]] Linksklick auf „Installieren“ auf dem Computer installiert. Nach dem [[Vorlage(Tasten, lmt)]] Linksklick auf „Installieren“ kommt noch einmal eine Sicherheitsabfrage, hier wird auch die Versionsnummer nochmals angezeigt. Die Installation vom Hibiscus Plugin mit einem [[Vorlage(Tasten, lmt)]] Linksklick auf „OK“ ausführen. Hibiscus wird das Plugin installieren. Nachdem das Plugin Hibiscus installiert ist, Hibiscus schließen. Nun Hibiscus neu starten, hiermit ist die Installation des Plugins abgeschlossen. = Benutzung = Einige Hinweise zur Benutzung von Hibiscus sind in [:Hibiscus/Benutzung:] erklärt. = Problembehandlung = == Encryption error in file "/home/USER/.jameica/hibiscus/h2db/hibiscus.he.db" [90049-197] == Bei einer Installation über die Paketquellen kann es u.U. zu so einer Meldung kommen (mögliche Ursache: Update auf eine inkompatible Version). Erste Maßnahme: Sicherheitskopie des Ordners /home/User/.jameica erstellen! Unter Jameica ''"Datei -> Backups verwalten..."'' findet man die letzten automatisch erstellten Backups. Da könnte man versuchen, eines davon wiederherzustellen. Sollte das nicht funktionieren, kann es helfen, die Jameica-Version der Linux-Distribution zu deinstallieren und stattdessen Jameica von [https://www.willuhn.de/products/jameica/download.php www.willuhn.de] herunterzuladen. = Links = * [https://www.willuhn.de/products/hibiscus/ Projektseite] {de} * [https://www.willuhn.de/products/hibiscus/download.php Aktuelle Versionen] {de} * [https://www.willuhn.de/wiki/doku.php?id=support:faq Hibiscus FAQ] {de} - häufige Fragen und Antworten; bei Problemen zuerst hier schauen * [https://www.willuhn.de/wiki/doku.php?id=handbuch Hibiscus Handbuch] {de} * [https://www.willuhn.de/wiki/doku.php?id=start#betriebssystem-spezifisch Hibiscus Handbuch betriebssystem-spezifisch] {de} * [https://www.willuhn.de/wiki/doku.php Hibiscus Wiki] {de} - Dokumentation * [https://www.willuhn.de/wiki/doku.php?id=handbuch:sonstiges:installation_unter_linux_fuer_experten Installation unter Linux für Experten] {de} * [github:willuhn/hibiscus:Quellcode] {en} # tag: Büro, Internet, Finanzverwaltung, Java, online-banking, Chipkartenanwendung