[[Vorlage(Getestet, jammy, focal, noble, plucky)]]

{{{#!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.

[[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:] und weiter unter [:Plucky:] 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. 

== 2. Manuelle Installation ==
 
Eine manuelle Installation erlaubt die Installation der neusten Version von Jameica, Hibiscus wird ''später'' als Plugin zugefügt. Die Jameica Version 2.10.5 wurde erfolgreich mit Oracle Java 24 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 ''"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