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

  A. Benutzungshinweise
  B. Untersttzte 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 
fr den Betrieb unter Linux als auch unter Windows erfolgt 
zustzlich 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 Gre des zip-Archivs nicht unntig zu 
vergrern und eine Bereitstellung unabhngig vom Betriebssystem zu 
ermglichen.
Soll Governikus COM Vibilia inklusive eines JRE bereitgestellt werden,
kann das JRE dem ZIP-Archiv hinzugefgt werden. 
Eine zustzliche Anpassung der Startdatei ist in diesem Fall 
erforderlich. 

================================================================
B. Untersttzte Einsatzszenarien in der Offline-Bereitstellung
================================================================
In der Offline-Variante werden folgende Einsatzszenarien untersttzt:
- Governikus beBPo (SAFE-Justiz): 99010071
- Governikus beBPo (Test SAFE-Justiz): 99010070
================================================================
C. Inhalt
================================================================
Das ZIP-Archiv enthlt u.a. eine Datei zum Ausfhren der 
Anwendung Governikus COM Vibilia und diese Readme-Datei.
 
Fr Windows steht eine ausfhrbare Datei mit der Dateiendung .bat, 
fr 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 ausfhrbare 
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 hinzugefgt werden. 
Eine zustzliche Anpassung der Startdatei  ist in diesem Fall 
erforderlich. Es muss ein originales JRE, welches nicht angepat 
ist, verwendet werden.


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

   sowie den Eintrag fr den PATH 

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


Linux (*.sh):
- Das JRE dem ZIP-Archiv hinzufgen
- In der ausfhrbaren Datei den Eintrag 
  "#export JAVA_HOME=./jre" fr Java-Home anpassen in
  "export JAVA_HOME=./jre"

  sowie den Eintrag fr 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" fr Java-Home anpassen.
  
  Beispiel:
  "set JAVA_HOME=C:\Program Files\Java\..." 

   sowie den Eintrag fr den PATH 

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


Linux (*.sh):
- In der ausfhrbaren Datei den Eintrag 
  "#export JAVA_HOME=./jre" fr Java-Home anpassen.

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

  sowie den Eintrag fr 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 fr 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 lsst sich in 
diesem Fall nicht starten.
 
Ob diese Bibliothek installiert ist, lsst sich mit folgendem 
Aufruf ber die Konsole prfen:

	sudo dpkg -l libopenjfx-jni

Wir empfehlen in diesem Fall die Verwendung eines anderen JDK.

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