[[Vorlage(Ausbaufähig, "Die Installation aus den Paketquellen fehlt im Artikel.")]]

[[Vorlage(Getestet, jammy, focal, bionic)]]

{{{#!vorlage Wissen
[:Paketquellen_freischalten/PPA: Verwenden eines PPAs]
[:Packprogramme: Archive entpacken]
[:Terminal: Ein Terminal öffnen]
[:Programme starten:]
}}}
[[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] 11 wurde erfolgreich unter [:Bionic:] getestet. Die Verwendung von Hibiscus mit [:Java#OpenJDK:OpenJDK] 13 wurde erfolgreich unter [:Eoan:] getestet. Unter [:Focal:] erfolgreich mit [:Java#OpenJDK:OpenJDK] 14 getestet.
Unter [:Hirsute_Hippo:] erfolgreich mit [:Java#OpenJDK:OpenJDK] 17 und nur mit dem Theme "Pop" getestet.
Information zum Themes "Pop" [https://blog.system76.com/post/160209210968/making-ubuntu-pop Blog-Pop]. {en} (Die jeweils mitinstallierte OpenJDK sollte später nicht deinstalliert werden, auch wenn eine neuere LTS-Version von java verfügbar ist, sonst kann Hibiscus evtl. nicht mehr gestartet werden.)

= Installation =
==1. via PPA ==
'''Achtung:''' Das angegeben PPA enthält nur funktionierende Pakete bis Ubuntu 21.04.

Unter '''Ubuntu 22.04''' kann man ggf. direkt aus den Paketquellen installieren:
{{{#!vorlage Befehl
sudo apt install hibiscus
}}}
Bei der Nutzung der nachfolgenden Quelle wird zuerst Jameica 2.8 bzw. 2.10.1 als Abhängigkeit installiert.

Das Paket '''hibiscus-ppa''' installiert unter Bionic Beaver Open-JDK-11 und unter Focal Fossa Open-JDK-14 und Treiber für HBCI-Kartenleser sowie Jameica als Abhängigkeit. Es empfiehlt sich nach einer Neuinstallation einen Neustart des PCs durchzuführen.

Das Paket '''hibiscus-orig''' installiert nur Jameica, Java und eventuelle Treiber für Geräte müssen nachinstalliert werden.


[[Vorlage(PPA, marko-preuss/hibiscus)]]

=== Installation inkl. Open-JDK-11, 13, 14 oder 17, Treiber für HBCI-Kartenleser, Jameica ===

Nach dem Aktualisieren der Paketquellen kann das folgende Paket installiert werden:
{{{#!vorlage Paketinstallation
hibiscus-ppa, ppa
}}}


=== Installation nur Hibiscus ===

Nach dem Aktualisieren der Paketquellen kann das folgende Paket installiert werden:
{{{#!vorlage Paketinstallation
hibiscus-orig, ppa
}}}

Nach der Installation sind die ersten Schritte in [:Hibiscus/Einrichten:] erklärt.

{{{#!vorlage Hinweis
Zur Kontrolle bzw. Änderung der aktuellen Java-Version benutzt man 
`sudo update-alternatives --config java`
}}}


== 2. Manuelle Installation ==
 
Eine manuelle Installation erlaubt die Installation der neusten Version von Jameica, Hibiscus wird ''später'' als Plugin zugefügt. 

{{{#!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.10.2.zip''' im Verzeichnis ''Downloads'' speichern. [https://www.willuhn.de/products/jameica/releases/current/jameica/jameica-linux64-2.10.2.zip 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.10.2.zip -d /opt/
}}}

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

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. 


= Aktualisierung =

Bei einer Aktualisierung aus dem PPA bleiben die Benutzerdaten / Passwort erhalten. Auch bei einer Systemaktualisierung, wie z.B. von 18.04 auf 20.04, bleiben die Benutzerdaten erhalten und man kann direkt weiterarbeiten, falls die Software schon zur Verfügung steht.

= Benutzung =

Einige Hinweise zur Benutzung von Hibiscus sind in [:Hibiscus/Benutzung:] erklärt.

= 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
 * [github:willuhn/hibiscus:Quellcode] {en}

# tag: Büro, Internet, Finanzverwaltung, Java, online-banking