====== JAVA™ am Server installieren ======

^ **:!: ACHTUNG: ANLEITUNG OHNE GEWÄHR.** ^
| Die Firma untermStrich software gmbh übernimmt keine Haftung für etwaige Schäden oder Fehler, die direkt oder indirekt durch die Benutzung oder Nichtbenutzung dieser Anleitung entstehen! |
^ **:!: ACHTEN SIE AUF DIE SICHERHEIT IHRES SERVERS!** ^
| Java muss – wie auch untermStrich – **aktuell gehalten** werden. Dies gilt besonders, wenn der Server aus dem Internet erreichbar ist. |

----

===== Wozu wird Java benötigt? =====

untermStrich nutzt Java für bestimmte serverseitige Aufgaben.

<WRAP center round important 97%>
Wenn am Server **kein Java** eingerichtet ist, können
  * keine **PDF-basierten Auswertungen** erstellt werden,
  * **E-Mails** nicht **entpackt** werden und
  * **XLSX** nicht genutzt werden.
</WRAP>

----

===== Testen =====

Zum Testen wechseln Sie zu **Konfiguration → System → Externe Systeme**:

{{:de:installation:java1.png?nolink&450|Java testen}}

Wählen Sie **Angaben testen**:

{{:de:installation:java2.png?nolink&450|In Ordnung}}

Es muss ein **grüner Haken** erscheinen.

:?: Sie benötigen mindestens **Unternehmer Plus** auf **Konfiguration**, um Zugriff auf **System** zu erhalten.

----

===== Installation =====

===== Windows =====

**Empfohlene Downloads (Temurin / Adoptium)**

  * Java 19 (LTS) Temurin JRE X64 – [[https://adoptium.net/de/temurin/releases/?version=19]]
  * Java 21 (LTS) Temurin JRE X64 – [[https://adoptium.net/de/temurin/releases/?version=21]]

**Vorgehen**

  - Laden Sie die **JRE** oder **JDK** als **ZIP-Datei** herunter (nicht den Installer).
  - Entpacken Sie die ZIP-Datei nach ''C:\java\jdk…''
    * {{:de:installation:inst_java1.png?nolink|}}
  - Hinterlegen Sie den Pfad zur ''C:\java\jdk…\bin\java.exe'' unter Konfiguration > Externe Systeme\\
{{:de:installation:java1.png?nolink&450|Java testen}}

  * Wenn die Datei korrekt entpackt ist, können Sie den Pfad über **Java Pfad auswählen** setzen.
{{:de:installation:inst_java2.png?nolink|}}

<WRAP center round tip 80%>
**Wenn leere PDF oder XLSX erzeugt werden**\\
Auf manchen Systemen ist es notwendig, den
[[de:installation:windows_server_network|Apache unter einem eigenem Benutzer auszuführen]], damit 
Java die PDF- und XLSX-Dateien korrekt erzeugen kann.\\
Auf vielen Systemen ist das wiederum nicht notwendig.
</WRAP>


:!: Wenn Sie den Modify Office Files Server nutzen, passen Sie auch dort den Pfad an:\\
[[de:butler:modify_office_files#modify_office_files_server|Modify Office Files Server anpassen]]

===== macOS =====

  * Java 19 (LTS) Temurin JRE X64 oder aarch64 (M1) – [[https://adoptium.net/de/temurin/releases/?version=19]]
  * Java 21 (LTS) Temurin JRE X64 oder aarch64 (M1) – [[https://adoptium.net/de/temurin/releases/?version=21]]

  - Unter **Operating System** ''macOS'' auswählen.
    * {{:de:installation:java_mac_1.png?300|}}
  - ''JRE'' oder bei Adoptium die ''JDK'' herunterladen ((Von Adoptium gibt es kein getrenntes JRE mehr)) – als ''.pkg''
    * {{:de:installation:java_mac_2.png?500|}}
  - Das Java-''.pkg'' installieren.
    * {{:de:installation:java_mac_3.png?300|}}
  - Den Pfad zur ''java''-Datei unter [[de:setup:setup:sideboard:system:external_systems|Externe Systeme]] eintragen (oder über **Java Pfad auswählen** wählen), z. B.:
    * ''/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home/bin/java''
    * ''/Library/Java/JavaVirtualMachines/temurin-19.jre/Contents/Home/bin/java''



:!: Wenn Sie den Modify Office Files Server nutzen, passen Sie auch dort den Pfad an:\\
[[de:butler:modify_office_files#modify_office_files_server|Modify Office Files Server anpassen]]

===== Ubuntu =====

==== Ubuntu 22.04 ====

<code bash>
## Java 21
sudo apt install openjdk-21-jre-headless
</code>

==== Ubuntu 18.04 / 20.04 ====

<code bash>
## Java 11
sudo apt-get install default-jdk-headless

update-alternatives --config java
# Wählen Sie Java 11 aus
</code>

<WRAP round info 80%>
Hinweis (historisch): In manchen Ubuntu-Repository-Konstellationen wurde „Java 11“
zeitweise intern anders bezeichnet. Falls der Java-Test fehlschlägt, prüfen Sie bitte
die tatsächlich aktive Java-Version am System.
</WRAP>

==== Ubuntu 16.04 ====

<WRAP center round important 80%>
<del>Ubuntu 16.04</del> – veraltet (nur als Alt-Anleitung belassen)
</WRAP>

<code bash>
sudo apt-get install openjdk-8-jre-headless
</code>

===== Andere Linux-Systeme =====

<WRAP center round important 97%>
Kein Support durch untermStrich für nicht-Ubuntu-Systeme!
</WRAP>

==== Ältere SUSE (Alt-Hinweis) ====

Laut Meldung eines Kunden installieren Sie bitte zusätzlich:
  * xorg-x11-fonts-core
  * xorg-x11-fonts
  * fonts-config
  * ft2demos
  * dom4j
  * saxon9

==== Fonts ====

Stellen Sie sicher, dass ''fontconfig'' bzw. ''fonts-config'' installiert ist.

==== GCC_4.2.0 not found ====

Wenn Java installiert ist, der Test aber fehlschlägt, öffnen Sie bitte das Apache ''error_log''.

Wenn Sie die folgende Fehlermeldung erhalten, befindet sich im ''lib''-Pfad des Apache
eine veraltete ''libgcc_s.so.1'':

''java: /.../lib/libgcc_s.so.1: version `GCC_4.2.0' not found (required by /usr/lib/libgcj.so.8rh)''

Auf einem System konnte die Systemdatei ''/lib/libgcc_s.so.1'' über die bestehende Datei kopiert werden.