An SSL certificate is required to operate BL Banking Web as a HTTPS server. The SSL certificate can be changed at a later date and must be changed when it expires. The currently valid SSL certificate is made known by two entries in the configuration file.

1. Save the new certificate (a PFX or keystore file), usually in the same directory as the old one.
   
2. Navigate to the file config.ini in the installation directory of BL Banking Web.
   

3. Open the config.ini in a text editor. The following entries must be changed:

   sslKeystorePath= Here is the path to the certificate. Example: C\:\Program Files\blbankingweb\conf\my-certificate.pfx
   sslKeystorePassphrase.enc= Here is the encrypted password for the certificate.

4. Replace the path in the entry sslKeystorePath.

5. To specify the new password, change the entry sslKeystorePassphrase.enc to sslKeystorePassphrase and enter the password unencrypted (in plain text).
6. Save the file and restart the application so that the changes are applied.

When the program is started, the server encrypts the password and saves the entry again as sslKeystorePassphrase.enc.

FAQ 231

You can have BL Banking Web updated automatically by running the included Update Check program.

• If you have created an entry in the Start menu during the installation, you can call up the menu item Update Check from there.
• Otherwise you can start the program UpdateCheck.exe directly via the file manager. This is located in the bin folder inside the installation directory, by default in C:\Program Files\blbankingweb\bin.

An Update Wizard will guide you through the update process.

If you have no graphical interface available or only have shell access to the server, you can start Update Check with the flag -c to work in the terminal, under Linux e. g. sh UpdateCheck -c.

You can download the current version of BL Banking Web for your platform directly.

Download links:

Windows: https://www.blbanking.de/current/blbankingweb_windows-x64.exe
Unix (archive): https://www.blbanking.de/current/blbankingweb_unix.tar.gz
Unix (shell script): https://www.blbanking.de/current/blbankingweb_unix.sh
MacOS: https://www.blbanking.de/current/blbankingweb_macos.dmg

• Save the downloaded file in the existing installation directory. That is the directory, where the BL Banking Web executable lies under <Installation directory>/bin/blbankingweb.
• Run the file in this place.
• To update the existing installation, re-install the program in the current installation directory.

In the case of pure terminal access, you must use the -c flag again, e. g. sh blbankingweb_unix_<version-number>.sh -c under Linux.

Note: After the program update is complete, the database may be updated in the background, which may take several minutes. If the BL Banking Web Service is not directly accessible after the update, do not exit it until the database update has been completed. The status of the database update can be followed in the installation directory under logs/application.log.

You can find further information regarding the update in our Intallation Guide for BL Banking Web in Section 5.
The change log and specific update notes can be found online: Revision history BL Banking Web.

FAQ 249

BL Bankingnbsp;Web is a server-based application. All application data is stored in a database, including user data and their keys. An H2 database is supplied, which can be installed locally or on a server.

An external database is generally used for multiple users and larger data volumes. You can find more information in chapter Settings – System settings – General. The following databases are supported:

• MariaDB
• MySQL
• Microsoft SQL Server
• Oracle Database
• PostgreSQL

You can transfer the currently used database to a new installation or migrate to another database.

Check database settings

1. Open Settings – System settings, General tab.
2. Expand the Database settings. The database type can be located in the Database field, the link to the database storage location is in the JDBC URL field.

Backup database

1. Navigate to the storage location of the database.
2. H2 database: Copy the directory and paste it at the destination location.
3. External database: Follow the manufacturer's instructions for backing up or copying the database.

Migrate database

1. Install the new database according to the manufacturer's instructions.
2. Configure the database for external access.
3. Open the port to the database for incoming connections in the firewall on the server.
4. All users must stop working with BL Banking Web.
5. In the database settings of BL Banking Web, click on the button Migrating application data to another database.
6. Enter the new JDBC URL, User and Password of the database.
7. Follow the wizard. Once the migration is complete, users can log in again and enter data in the new database.

FAQ 264

1. Save the following files from the installation directory:

   config.ini

   .. .conf/production.conf

   .. .conf/bl-default.keystore

2. Install BL Banking Web in the new directory as you did for the first installation.

3. Copy the backed-up files to the new installation directory or to the corresponding subdirectories.

FAQ 266

To avoid a security problem, you must adjust a setting in the operating system.

1. Open the Control Panel, then Security – Privacy – Full Disk Access.
2. Unlock the hard disk access (open lock).
3. Click on the plus + and add BL Banking Web.
4. Lock the hard disk access again.

FAQ 267

You can update BL Banking Web if you receive the following message when you start the program: *The new version N.NN.NN is available. You will find the new functions in the Change log. The message does not appear if the setting Inform about new program versions is switched off in your user preferences.

In the case of a server installation (default), the update must be carried out by a system administrator who has access to the server on which BL Banking Web is installed. A data backup is recommended beforehand, especially if you have installed BL Banking Web locally or with an H2 database. Back up the working directory, under Windows by default C:\ProgramData\blbankingweb.

Update check with installation

With an automatic update check, you can check at any time whether an update is available.

1. Exit BL Banking Web, clear the browser history and close the browser.
2. Start the update check from the start menu or from the bin subdirectory of the installation directory, under Windows by default C:\Program Files\blbankingweb\bin. 3 The wizard checks whether a newer version is available for the installed version.
3. If so, download the installation file to a directory of your choice, e.g. Downloads.
4. Select the option Start installation directly afterwards.
5. Follow the wizard through the installation process. Install into the existing installation directory to replace the previous version.
6. Once the installation is complete, restart BL Banking Web. You can continue working with your data and user preferences in the new version.

Download installation file directly

As an alternative to the update check, you can download the current installation file for your operating system at any time via the following links:

Windows: https://www.blbanking.de/current/blbankingweb_windows-x64.exe
Unix (archive): https://www.blbanking.de/current/blbankingweb_unix.tar.gz
Unix (shell script): https://www.blbanking.de/current/blbankingweb_unix.sh
MacOS: https://www.blbanking.de/current/blbankingweb_macos.dmg

Specific information on the update can be found in the Change log

1. Save the downloaded file in the installation directory <installation directory>/bin/blbankingweb, in which the executable program file is located, e.g. blbankingweb.exe. The file name contains the version number, e.g. blbankingweb_windows-x64_N_NN_NN.
2. Execute the installation file in the directory. Update the existing installation as described.

FAQ 268

1. Make sure that nobody is working on the server during the update.
2. Create a data backup of the installation and work data.
3. Open the command line as administrator. Navigate to the server or to the installation directory of BL Banking Web.

4. Start the update check with the -c flag.
   Example for the command under Linux: sh UpdateCheck -c

   Alternatively to the update check, you can download the current installation file for your operating system at any time via the following links:

   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

5. Install the program in the existing installation directory. In the command line, use the -c flag again.
   Example for the command under Linux: "sh blbankingwebunix<version number>.sh -c

6. Wait until the update of the program and, if necessary, an update of the database have been completed (execution in the background, duration several minutes). You can track the update status in the installation directory under logs/application.log.

Note: During the database update, the BL Banking Web service is not directly accessible. Do not stop the service until the update has been completed.

Further information on the update can be found in the installation instructions for BL Banking Web in Section 5.
To install an update with a graphical user interface, see FAQ 268.

FAQ 269