================================================================
    ReadMe-Datei zur Bereitstellung von Governikus COM Vibilia
======================
    Unterstützte Java-Versionen: Oracle Java 8, OpenJDK 11             
================================================================

  A. Benutzungshinweise
  B. Inhalt
  C. Installationshinweise
  D. Hinweise zur Einbindung eines Oracle JRE
  E. Hinweis zu nativen Bibliotheken 

================================================================
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. 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.

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

================================================================
D. Hinweise zur Einbindung eines OpenJDK 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.

Z. B. 

* Java 8 32b: von https://jdk.java.net/java-se-ri/8-MR3 -> Download "Windows 10 i586 Java Development Kit"
* Java 11 32b: von https://adoptium.net/releases.html?variant=openjdk11 -> Temurin 11 -> Operating System: Windows -> Architecture: x86 -> Download JRE .zip 

* Vibilia-Online-3.0.2.zip nach Ordner "Vibilia-Online-3.0.2" entpacken.
* Java ZIP "OpenJDK11U-jre_x86-32_windows_hotspot_11.0.14_9.zip" in "Vibilia-Online-3.0.2" ablegen und mit Option "Hier entpacken" entpacken. Ausgepackte Java Ordner "jdk-11.0.14+9-jre" in jre umbenennen.


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\jre1.8.0_201" 

   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/jre1.8.0_201"

  sowie den Eintrag für den PATH

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

================================================================
E. 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).
Wenn Sie ein JRE 32-Bit verwenden, müssen Sie folgende Anpassungen 
vornehmen:
   - Windows: Aus dem Unterordner "windows -> 32bit" muss die Datei
     "jsb.dll" kopiert und auf oberster Ebene gegen die vorhandene 
     Datei getauscht werden. 
   - Linux: Aus dem Unterordner linux-> 32bit" muss die Datei
     "libjsb.so" kopiert und auf oberster Ebene gegen die vorhandene 
     Datei getauscht werden.

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