================================================================
    ReadMe-Datei zur Bereitstellung von Governikus COM Vibilia
======================
    Unterstützte Java-Versionen: OpenJDK 11/17             
================================================================

  A. Benutzungshinweise
  B. Unterstützte Einsatzszenarien in der Offline-Bereitstellung
  C. Inhalt
  D. Installationshinweise
  E. Hinweise zur Einbindung eines Oracle JRE
  F. Hinweis zu nativen Bibliotheken
  G. Bekannte Probleme

================================================================
A. Benutzungshinweise
================================================================

Diese Readme-Datei richtet sich an den Administrator der Anwendung 
Governikus COM Vibilia.

Die Bereitstellung von Governikus COM Vibilia als ZIP-Archiv 
für den Betrieb unter Linux als auch unter Windows erfolgt 
zusätzlich zur Bereitstellung als Installervariante.

Die Bereitstellung erfolgt als ZIP-Datei. In der Online-Variante
werden die Anwendungsressourcen vom Downloadserver heruntergeladen, 
in der Offline-Variante sind die Anwendungsressourcen bereits im ZIP 
enthalten.
In beiden Varianten wird kein Java Runtime Environment (JRE) im ZIP-
Archiv mitgeliefert, um die Größe des zip-Archivs nicht unnötig zu 
vergrößern und eine Bereitstellung unabhängig vom Betriebssystem zu 
ermöglichen.
Soll Governikus COM Vibilia inklusive eines JRE bereitgestellt werden,
kann das JRE dem ZIP-Archiv hinzugefügt werden. 
Eine zusätzliche Anpassung der Startdatei ist in diesem Fall 
erforderlich. 

================================================================
B. Unterstützte Einsatzszenarien in der Offline-Bereitstellung
================================================================
In der Offline-Variante werden folgende Einsatzszenarien unterstützt:
- Governikus beBPo (SAFE-Justiz): 99010071
- Governikus beBPo (Test SAFE-Justiz): 99010070
================================================================
C. Inhalt
================================================================
Das ZIP-Archiv enthält u.a. eine Datei zum Ausführen der 
Anwendung Governikus COM Vibilia und diese Readme-Datei.
 
Für Windows steht eine ausführbare Datei mit der Dateiendung .bat, 
für die Nutzung unter Linux eine Datei mit der Endung .sh bereit.

================================================================
D. Installationshinweise
================================================================
Das ZIP-Archiv wird auf dem PC des Nutzers entpackt. 
Die Anwendung wird über einen Doppelklick auf die ausführbare 
Datei gestartet. 

================================================================
E. Hinweise zur Einbindung eines Oracle-JRE
================================================================
1. Bereitstellung eines JRE
Soll Governikus COM Vibilia inklusive eines JRE bereitgestellt 
werden, kann das JRE dem ZIP-Archiv hinzugefügt werden. 
Eine zusätzliche Anpassung der Startdatei  ist in diesem Fall 
erforderlich. Es muss ein originales JRE, welches nicht angepaßt 
ist, verwendet werden.


Windows (*.bat):
- Das JRE dem ZIP-Archiv hinzufügen
- In der Batch-Datei den Eintrag 
  "rem set JAVA_HOME=%cd%/jre" für Java-Home anpassen in
  "set JAVA_HOME=%cd%/jre" 

   sowie den Eintrag für den PATH 

   "rem set PATH=%JAVA_HOME%/bin" anpassen in
   "set PATH=%JAVA_HOME%/bin"


Linux (*.sh):
- Das JRE dem ZIP-Archiv hinzufügen
- In der ausführbaren Datei den Eintrag 
  "#export JAVA_HOME=./jre" für Java-Home anpassen in
  "export JAVA_HOME=./jre"

  sowie den Eintrag für den PATH

  "#export PATH="$JAVA_HOME/bin:$PATH" anpassen in
  "export PATH="$JAVA_HOME/bin:$PATH"


2. Nutzung eines bereits lokal installierten JRE

Windows (*.bat):
- In der Batch-Datei den Eintrag 
  "rem set JAVA_HOME=%cd%/jre" für Java-Home anpassen.
  
  Beispiel:
  "set JAVA_HOME=C:\Program Files\Java\..." 

   sowie den Eintrag für den PATH 

   "rem set PATH=%JAVA_HOME%/bin" anpassen in
   "set PATH=%JAVA_HOME%/bin"


Linux (*.sh):
- In der ausführbaren Datei den Eintrag 
  "#export JAVA_HOME=./jre" für Java-Home anpassen.

  Beispiel:
  "export JAVA_HOME=/home/tester/Programme/..."

  sowie den Eintrag für den PATH

  "#export PATH="$JAVA_HOME/bin:$PATH" anpassen in
  "export PATH="$JAVA_HOME/bin:$PATH"

================================================================
F. Hinweis zu nativen Bibliotheken
================================================================
Hinweis zu den nativen Bibliotheken (Signieren mit Signaturkarten) 
in der Offline-Variante:
Die Bereitstellung ist für die Nutzung unter JRE 64-Bit vorbereitet 
(Windows und Linux).
	 
================================================================	 
G. Bekannte Probleme
================================================================
Unter Ubuntu 20.04 kann es bei der Verwendung des JRE aus dem 
System-Repository zu einem Konflikt kommen, wenn die Bibliothek 
"libopenjfx-jni" installiert ist. Die Anwendung lässt sich in 
diesem Fall nicht starten.
 
Ob diese Bibliothek installiert ist, lässt sich mit folgendem 
Aufruf über die Konsole prüfen:

	sudo dpkg -l libopenjfx-jni

Wir empfehlen in diesem Fall die Verwendung eines anderen JDK.

================================================================
    ReadMe-Datei zur Bereitstellung von Governikus COM Vibilia        
================================================================