The difference between the MSI version and the portable version is, on the one hand, which Java is used to run DATA Boreum and, on the other hand, how DATA Boreum is updated.
The Windows installation file (MSI) installs Governikus DATA Boreum with the automatic update function, i.e. every time DATA Boreum is started, it checks for an up-to-date version. Port 443 must be enabled for the update query. The automatic update is described in chapter 3.4. In addition, a separate Java runtime environment (JDK) is installed for DATA Boreum, which is delivered via the MSI file. This means that DATA Boreum is independent of any other Java versions that may exist. You can therefore also update these Java versions without affecting DATA Boreum. Path specifications for these other JDKs or possibly set JAVA_HOME environment variables also do not affect the JDK of DATA Boreum. The JDK supplied with the MSI version is a free open-source version for which there are no restrictions or licence fees.
The portable versions are Governikus DATA Boreum portable version and Governikus DATA Boreum Integration Edition portable version. These versions can be used for the Linux and Windows operating systems. A macOS-compatible app is provided for macOS. These versions are only available in the offline version. Offline in this context means that DATA Boreum does not establish a connection to the Governikus KG update server, but starts with the available resources. The offline or portable version requires a Java runtime environment (JDK). You can use a JDK that already exists on the operating system, or you can unpack a JDK as a ZIP file in the directory of the portable version. The portable DATA Boreum versions are started with a batch file.
· Operating system JDK: You must have installed a JDK prior to starting DATA Boreum for the first time and this JDK must be added to the path specification of the operating system so that DATA Boreum can access the JDK. This variant becomes problematic if several Java applications are installed and different Java versions or Java providers are expected.
· JDK-ZIP: Create a new jre64 directory in the directory in which you have unpacked DATA Boreum. Unpack the JDK in this directory. Enter the variable JAVA_HOME and the path to this JDK in the DATA_Boreum.bat/.sh file. This procedure makes DATA Boreum independent of any JDK already installed in the operating system. We recommend this variant if several Java applications are installed and different Java versions or Java providers are expected.
Differences between the operating systems
· Windows: With Windows operating systems, DATA Boreum can be started with or without the console, see next section.
· Linux: The console is always displayed for Linux operating systems.
· macOS: The console is never displayed for macOS.
Start without console for Windows operating systems
The portable version of DATA Boreum is started with the script DATA_Boreum.bat for Windows. The default setting is that only the DATA Boreum application is started with this start script. DATA Boreum is called up quickly and DATA Boreum is available with all its functions. In addition, the directory in which you have unpacked the portable version of DATA Boreum contains the file DATA Boreum (without file extension). This file is a shortcut to the DATA_Boreum.bat file and can simply be copied to the desktop for quick access to DATA Boreum. The DATA Boreum icon will also be displayed.
Start with console for Windows operating systems
It is also possible to start a console together with DATA Boreum. The activities of DATA Boreum are then logged in this console. The following illustration shows a Windows console with an example output.
Figure 1: Windows console with example output
The console is not required for the functions of DATA Boreum. If you want to start DATA Boreum with the console, you can do this by making a change in the start script.
· Edit batch file: Edit the file DATA_Boreum.bat with an ASCII editor, for example with the Windows app "Editor" or the free programme "Notepad++".
- Delete the comment command rem in the line below rem Ausfuerung mit sichtbarer Konsole.
- Insert the comment command rem at the beginning of the line rem Konsole wird ausgeblendet.
- Save the file DATA_Boreum.bat. The corresponding lines in the file then look like this:
rem Ausfuerung mit sichtbarer Konsole
java %JAVA_OPTS% de.bos_bremen.ecard.client.gui.SignerMainStarter -normal
rem Konsole wird ausgeblendet
rem start javaw %JAVA_OPTS% de.bos_bremen.ecard.client.gui.SignerMainStarter -normal exit