Installation und Update

Wo muss ich Änderungen eintragen, wenn es ein neues SSL-Zertifikat für BL Banking Web gibt?

Ein SSL-Zertifikat ist nötig, um BL Banking Web als HTTPS-Server zu betreiben. Das SSL-Zertifikat kann nachträglich geändert werden, zwingend nach Ablauf der Gültigkeit. Das aktuell geltende SSL-Zertifikat wird durch zwei Einträge in der Konfigurationsdatei bekannt gemacht.

Speichern Sie das neue Zertifikat (eine PFX- bzw. Keystore-Datei), normalerweise im selben Verzeichnis wie das alte.
Navigieren Sie zu der Datei config.ini im Installationsverzeichnis von BL Banking Web.
Öffnen Sie die config.ini in einem Texteditor. Folgende Einträge müssen geändert werden:

sslKeystorePath= Hier steht der Pfad zum Zertifikat. Beispiel: C\:\Program Files\blbankingweb\conf\my-certificate.pfx
sslKeystorePassphrase.enc= Hier steht das verschlüsselte Passwort für das Zertifikat.
Ersetzen Sie die Pfadangabe im Eintrag sslKeystorePath.
Um das neue Passwort anzugeben, ändern Sie den Eintrag sslKeystorePassphrase.enc zu sslKeystorePassphrase und tragen das Passwort unverschlüsselt ein (im Klartext).
Speichern Sie die Datei und starten die Anwendung neu, damit die Änderungen übernommen werden.

Beim Programmstart verschlüsselt der Server das Passwort und speichert den Eintrag wieder als sslKeystorePassphrase.enc.

Wie kann ich BL Banking Web aktualisieren?

Sie können BL Banking Web automatisch updaten lassen, indem Sie das mitgelieferte Programm Update Check ausführen:

Wenn Sie bei der Installation einen Eintrag ins Startmenü angelegt haben, können Sie von dort den Menüpunkt Update Check aufrufen.
Alternativ können Sie das Programm UpdateCheck.exe direkt über den Dateimanager starten. Es befindet sich im Unterordner bin des Installationsverzeichnisses, standardmäßig C:\Program Files\blbankingweb\bin.

Ein Update-Assistent führt Sie durch den Update-Prozess.

Falls Sie keine grafische Oberfläche zur Verfügung haben oder nur über die Kommandozeile auf den Server zugreifen, können Sie den Update Check mit dem Flag -c in der Kommandozeile starten, unter Linux z. B. sh UpdateCheck -c.

Sie können die aktuelle Version von BL Banking Web für Ihre Plattform auch jederzeit herunterladen.

Downloadlinks:

Windows: https://www.blbanking.de/current/blbankingweb_windows-x64.exe
Unix (Archiv): https://www.blbanking.de/current/blbankingweb_unix.tar.gz
Unix (Shell-Skript): https://www.blbanking.de/current/blbankingweb_unix.sh
MacOS: https://www.blbanking.de/current/blbankingweb_macos.dmg

Speichern Sie die heruntergeladene Datei im bestehenden Installationsverzeichnis, also dem Verzeichnis, in dem das BL Banking Web-Executable unter <Installationsverzeichnis>/bin/blbankingweb liegt.
Führen Sie die Datei dort aus.
Installieren Sie das Programm in das bestehende Installationsverzeichnis, um die Installation zu aktualisieren.

Im Falle eines reinen Terminal-Zugriffs müssen Sie wieder das Flag -c verwenden, unter Linux z. B. sh blbankingweb_unix_<Versionsnummer>.sh -c.

Hinweis

Nach Abschluss des Programmupdates wird ggf. im Hintergrund ein Update der Datenbank durchgeführt, das einige Minuten dauern kann. Falls der BL Banking Web-Dienst nach dem Update nicht direkt erreichbar ist, beenden Sie ihn nicht, bis das Datenbank-Update abgeschlossen ist. Der Status des Datenbank-Updates kann im Installationsverzeichnis unter logs/application.log verfolgt werden.

Weitere Informationen zum Update finden Sie in der Installations-Anleitung für BL Banking Web im Abschnitt 5.
Das Änderungsprotokoll sowie spezifische Hinweise zum Update finden Sie online: Änderungsprotokoll BL Banking Web.

Kann ich als Administrator Anwendungs- und Benutzerdaten in eine neue Installation übernehmen?

BL Banking Web ist eine serverbasierte Anwendung. Alle Anwendungsdaten werden in einer Datenbank gespeichert, auch die Benutzerdaten und deren Schlüssel. Mitgeliefert wird eine H2-Datenbank, die lokal oder auf einem Server installiert werden kann.

Für mehrere Benutzer und größere Datenmengen wird in der Regel eine externe Datenbank genutzt. Informationen dazu finden Sie in Kapitel Einstellungen – Systemeinstellungen – Allgemein. Unterstützt werden folgende Datenbanken:

MariaDB
MySQL
Microsoft SQL Server
Oracle Database
PostgreSQL

Sie können die aktuell genutzte Datenbank in eine neue Installation übernehmen oder in eine andere Datenbank migrieren.

Datenbankeinstellungen prüfen

Öffnen Sie Einstellungen – Systemeinstellungen, Registerkarte Allgemein.
Klappen Sie die Datenbankeinstellungen auf. Der Datenbanktyp steht im Feld Datenbank, der Link zum Speicherort der Datenbank im Feld JDBC URL.

Datenbank sichern

Navigieren Sie zum Speicherort der Datenbank.
H2-Datenbank: Kopieren Sie das Verzeichnis und fügen Sie dieses am Zielort wieder ein.
Externe Datenbank: Folgen Sie der Anleitung des Herstellers zum Sichern bzw. Kopieren der Datenbank.

Datenbank migrieren

Installieren Sie die neue Datenbank nach Anleitung des Herstellers.
Konfigurieren Sie die Datenbank für externen Zugriff.
Öffnen Sie in der Firewall auf dem Server den Port zur Datenbank für eingehende Verbindungen.
Alle Benutzer müssen die Arbeit mit BL Banking Web beenden.
Klicken Sie in den Datenbankeinstellungen von BL Banking Web auf den Button Anwendungsdaten in andere Datenbank migrieren.
Geben Sie die neue JDBC URL, Benutzer und Passwort der Datenbank ein.
Folgen Sie dem Assistenten. Nach Abschluss der Migration können sich die Benutzer wieder anmelden und Daten in der neuen Datenbank erfassen.

Ich möchte ein Update für BL Banking Web installieren, kann aber das vorhandene Installationsverzeichnis nicht nutzen. Welche Dateien aus der alten Installation benötige ich?

Sichern Sie aus dem Installationsverzeichnis folgende Dateien:

config.ini

.. .conf/production.conf

.. .conf/bl-default.keystore

Installieren Sie BL Banking Web wie bei der ersten Installation in das neue Verzeichnis.
Kopieren Sie die gesicherten Dateien in das neue Installationsverzeichnis bzw. in die entsprechenden Unterverzeichnisse.

Mein Betriebssystem ist MacOS in der Version Catalina. Muss ich für die Installation von BL Banking Web etwas beachten?

Um ein Sicherheitsproblem zu vermeiden, müssen Sie im Betriebssystem eine Einstellung anpassen.

Öffnen Sie die Systemsteuerung, dann Sicherheit – Datenschutz – Festplattenvollzugriff.
Entsperren Sie den Festplattenzugriff (Schloss öffnen).
Klicken Sie auf das Plus + und fügen BL Banking Web hinzu.
Sperren Sie den Festplattenzugriff wieder.

Wie kann ich BL Banking Web aktualisieren?

Sie können BL Banking Web aktualisieren, wenn Sie beim Programmstart folgende Meldung erhalten: Die neue Version N.NN.NN ist verfügbar. Sie finden die neuen Funktionen im Änderungsprotokoll. Die Meldung erscheint nicht, wenn in Ihren Benutzervorgaben die Einstellung Über neue Programmversionen informieren ausgeschaltet ist.

Im Fall einer Serverinstallation (Standard) muss das Update von einem Systemadministrator durchgeführt werden, der Zugriff auf den Server hat, auf dem BL Banking Web installiert ist. Vorab ist eine Datensicherung empfehlenswert, insbesondere wenn Sie BL Banking Web lokal bzw. mit einer H2-Datenbank installiert haben. Sichern Sie das Arbeitsverzeichnis, unter Windows standardmäßig C:\ProgramData\blbankingweb.

Update-Check mit Installation

Mit einem automatischen Update-Check können Sie jederzeit prüfen, ob ein Update verfügbar ist.

Beenden Sie BL Banking Web, leeren Sie den Browserverlauf und schließen Sie den Browser.
Starten Sie den Update-Check aus dem Startmenü oder aus dem Unterverzeichnis bin des Installationsverzeichnisses, unter Windows standardmäßig C:\Program Files\blbankingweb\bin.
Der Assistent prüft, ob zu der installierten Version eine neuere vorhanden ist.
Wenn ja, laden Sie die Installationsdatei in ein Verzeichnis Ihrer Wahl herunter, z. B. Downloads.
Wählen Sie die Option Installation direkt im Anschluss starten.
Folgen Sie dem Assistenten durch den Installationsprozess. Installieren Sie in das vorhandene Installationsverzeichnis, um die vorige Version zu ersetzen.
Nach Abschluss der Installation starten Sie BL Banking Web wieder. In der neuen Version können Sie mit Ihren Daten und Benutzervorgaben weiterarbeiten.

Installationsdatei direkt herunterladen

Alternativ zum Update-Check können Sie die aktuelle Installationsdatei für Ihr Betriebssystem jederzeit über folgende Links herunterladen:

Windows: https://www.blbanking.de/current/blbankingweb_windows-x64.exe
Unix (Archiv): https://www.blbanking.de/current/blbankingweb_unix.tar.gz
Unix (Shell-Skript): https://www.blbanking.de/current/blbankingweb_unix.sh
MacOS: https://www.blbanking.de/current/blbankingweb_macos.dmg

Spezifische Hinweise zum Update finden Sie im Änderungsprotokoll

Speichern Sie die heruntergeladene Datei im Installationsverzeichnis <Installationsverzeichnis>/bin/blbankingweb, in dem die ausführbare Programmdatei liegt, z. B. blbankingweb.exe. Der Dateiname enthält die Versionsnummer, z. B. blbankingweb_windows-x64_N_NN_NN.
Führen Sie die Installationsdatei in dem Verzeichnis aus. Aktualisieren Sie die bestehende Installation wie beschrieben.

Wie kann ich als Administrator ein Update installieren, wenn ich per Kommandozeile auf den Server zugreife?

Stellen Sie sicher, dass während des Updates niemand auf dem Server arbeitet.
Erstellen Sie eine Datensicherung von Installations- und Arbeitsdaten.
Öffnen Sie als Administrator die Kommandozeile. Navigieren Sie zum Server bzw. in das Installationsverzeichnis von BL Banking Web.
Starten Sie den Update-Check mit dem Flag -c.
Beispiel für den Befehl unter Linux: sh UpdateCheck -c

Alternativ zum Update-Check können Sie die aktuelle Installationsdatei für Ihr Betriebssystem jederzeit über folgende Links herunterladen:

Windows: https://www.blbanking.de/current/blbankingweb_windows-x64.exe
Unix (Archiv): https://www.blbanking.de/current/blbankingweb_unix.tar.gz
Unix (Shell-Skript): https://www.blbanking.de/current/blbankingweb_unix.sh
MacOS: https://www.blbanking.de/current/blbankingweb_macos.dmg

Installieren Sie das Programm in das bestehende Installationsverzeichnis. In der Kommandozeile verwenden Sie dafür wieder das Flag -c.
Beispiel für den Befehl unter Linux: "sh blbankingwebunix<Versionsnummer>.sh -c
Warten Sie, bis das Update des Programms und ggf. ein Update der Datenbank abgeschlossen sind (Ausführung im Hintergrund, Dauer mehrere Minuten). Sie können den Update-Status im Installationsverzeichnis unter logs/application.log verfolgen.

Hinweis

Während des Datenbank-Updates ist der Dienst BL Banking Web nicht direkt erreichbar. Beenden Sie den Dienst auf keinen Fall, solange das Update noch nicht abgeschlossen ist.

Weitere Informationen zum Update finden Sie in der Installationsanleitung für BL Banking Web in Abschnitt 5.
Zum Installieren eines Updates mit grafischer Oberfläche siehe FAQ .