Installationsanleitung für Ihre Umgebung auswählen

Installationstyp

Klicken Sie auf den entsprechenden Link, um zum richtigen Abschnitt des Handbuchs zu gelangen.

Lokale Installation | Cloud/Managed

Upgrades von lokalen Installationen

Upgrade auf 26.2: Zusätzliche Pflichtschritte
Version 26.2 bringt zwei Änderungen, die unabhängig von Ihrer Java-Version wirksam werden und daher beachtet werden müssen:
JDOM1 → JDOM2-Migration: Alle Custom Scripts und Java-Klassen mit org.jdom-Imports müssen angepasst werden — auch unter Java 11. → JDOM1-zu-JDOM2-Migration
Der neue Application Wrapper ist eine Java-basierte Anwendung, die Ihre Lobster-Anwendungen als Systemdienste registriert und verwaltet → Lobster Application Wrapper
Lesen Sie auch den Überblick zum Java-Upgrade, bevor Sie weitermachen.

Schritt 1: Upgrade-Pfad bestimmen

Aktuelle Version	Zielversion	Pfad
_data 4.6.14 oder höher / _pro 4.12 oder höher	25.1.x	Direktes Upgrade (siehe Upgrade von 4.x auf 25.1.x)
25.1.x (aktueller Patch)	26.x	Direktes Upgrade
25.0	26.1	Zunächst auf 25.1-LTS aktualisieren, danach direktes Upgrade auf 26.2
_data (unterhalb von 4.6.14) / _pro (unterhalb von 4.12)	25.1.x → 26.1	Zunächst auf _data 4.6.14 und _pro 4.12 aktualisieren, anschließend One-Click-Migration auf 25.1-LTS, dann Upgrade auf 26.1
26.1.x	26.2	Siehe: 26.2: Upgrade-Vorbereitung

Lobster Bridge
Wenn Sie Lobster Bridge einsetzen, aktualisieren Sie nach dem Plattform-Upgrade alle Bridges über die Schaltfläche „Lobster Bridge aktualisieren". Dies stellt die Kompatibilität mit Version 26.1.x sicher.

Weitere Informationen zu Quartals-Releases und LTS-Versionen: Versionsrichtlinie: Quartals-Releases und LTS

Schritt 2: Java-Anforderungen prüfen

Der kostenlose LTS-Support für JDK 11 ist ausgelaufen. Installieren Sie daher OpenJDK 21, bevor Sie auf Version 26.2 oder höher upgraden. Weiterführende Informationen: Java-Versionsstatus überprüfen.

Plattformversion	Erforderliches Java
4.6.x, 25.x, 26.1	JDK 11
26.2	JDK 21 (empfohlen) oder JDK 11

Empfohlene OpenJDK-Distribution zum Download:

Adoptium Eclipse Temurin^®, JDK 11-LTS – nur noch übergangsweise; der kostenlose LTS-Support ist bei den meisten Distributionen ausgelaufen.
Adoptium Eclipse Temurin^®, JDK 21-LTS – empfohlen.

Hinweis
Das JDK sollte entpackt (nicht per OS-Installer) bereitgestellt werden. Der Pfad wird ausschließlich über die Lobster-Startskripte gesetzt (siehe unten). Das entkoppelt die JVM von OS-Paketupdates und erlaubt einen schnellen Rollback.

Java-Pfad

Windows: Legen Sie den Pfad zum Java-Arbeitsverzeichnis in ./bin/hubenv.bat und ./etc/wrapper.conf fest.
Linux: Legen Sie den Pfad zum Java-Arbeitsverzeichnis in ./bin/hub.sh fest.

Schritt 3: Konfiguration auswählen

Windows | Linux | DMZ | Hochverfügbarkeit

26.2 — Application Wrapper einrichten
Ab Version 26.2 verwaltet der Lobster Application Wrapper den Dienst unter Windows und Linux einheitlich. Nach dem Upgrade von 26.1 auf 26.2 muss der Dienst einmalig über den Wrapper installiert werden, bevor Sie ihn starten können. Deaktivieren Sie zuvor die bisherigen Startmechanismen (Windows-Dienst „Lobster Integration Server" bzw. lobster.service unter systemd).
java -jar ./bin/application-wrapper.jar --install-service
java -jar ./bin/application-wrapper.jar --start-service
Die vollständige Einrichtung und Migration beschreibt der Artikel Lobster Application Wrapper. Die folgenden Abschnitte beschreiben den laufenden Betrieb für jedes Betriebssystem.

Windows

Bis Version 26.1:

Beenden Sie den Windows-Dienst „Lobster Integration Server“.
Öffnen Sie eine Eingabeaufforderung als Administrator.
Führen Sie cd <install-dir>\bin aus.
Führen Sie hub.bat aus.
Warten Sie, bis das Update abgeschlossen ist. Der Fortschritt wird in der Konsole angezeigt.
Drücken Sie Strg+C und warten Sie, bis das System heruntergefahren ist.
Starten Sie den Windows-Dienst „Lobster Integration Server“ neu.

Ab Version 26.2:

Der Dienst wird über den Lobster Application Wrapper verwaltet. Die Kommandos sind unter Windows und Linux identisch.

Öffnen Sie eine Eingabeaufforderung als Administrator und wechseln Sie in das Installationsverzeichnis.

Stoppen Sie den Dienst:

java -jar ./bin/application-wrapper.jar --stop-service

Warten Sie, bis der Dienst vollständig heruntergefahren ist.
Starten Sie den Dienst — das Update wird beim Start automatisch eingespielt:
```
java -jar ./bin/application-wrapper.jar --start-service
```

Prüfen Sie den Dienststatus:

java -jar ./bin/application-wrapper.jar --service-status

Den Fortschritt können Sie in ./logs/wrapper.log und ./logs/console.txt verfolgen.

Linux

Nachdem die Patches in ./etc/update/patches heruntergeladen wurden (wie in der Checkliste vor dem Upgrade beschrieben), genügt es, den Dienst zu beenden und neu zu starten. Das Update wird beim Neustart automatisch eingespielt.

Bis Version 26.1:

Zum Beenden des Dienstes geben Sie systemctl stop lobster.service in der Befehlszeile ein.
Zum Starten des Dienstes geben Sie systemctl start lobster.service ein.
Den Fortschritt können Sie in ./logs/console.txt⁣ verfolgen.

Ab Version 26.2:

Der Dienst wird über den Lobster Application Wrapper verwaltet. Die Kommandos sind unter Windows und Linux identisch.

Wechseln Sie in das Installationsverzeichnis. Stellen Sie sicher, dass Sie über Root-Rechte verfügen.

Stoppen Sie den Dienst:

java -jar ./bin/application-wrapper.jar --stop-service

Warten Sie, bis der Dienst vollständig heruntergefahren ist.
Starten Sie den Dienst – das Update wird beim Start automatisch eingespielt:
```
java -jar ./bin/application-wrapper.jar --start-service
```

Prüfen Sie den Dienststatus:

java -jar ./bin/application-wrapper.jar --service-status

Den Fortschritt können Sie in ./logs/wrapper.log und ./logs/console.txt verfolgen.

DMZ-Konfiguration

Achtung
Gegebenenfalls muss eine Firewallregel hinzugefügt werden. In gruppierten DMZ-Umgebungen muss jeder Knoten https://api.lobster-world.com/ unabhängig erreichen können.

Die DMZ-Komponente kann Updates nur dann automatisch beziehen, wenn Ihre Lizenz dies erlaubt. Standard-DMZ-Lizenzen unterstützen automatische Updates.

Beenden Sie das interne Lobster-System.
Beenden Sie die DMZ.
Aktualisieren Sie die DMZ.
Starten Sie die DMZ neu.
Aktualisieren Sie das interne System.
Starten Sie das interne System neu.

Hochverfügbarkeitsumgebung (HA)

Achtung
Gegebenenfalls muss eine Firewallregel hinzugefügt werden. In gruppierten HA-Umgebungen muss jeder Knoten https://api.lobster-world.com/ unabhängig erreichen können.
Alle Knoten müssen beendet werden, bevor ein einzelner Knoten aktualisiert wird.

Hochverfügbarkeitssysteme sind auf unterbrechungsfreien Betrieb ausgelegt und schützen in den meisten Szenarien vor ungeplanten Dienstausfällen. Software-Updates auf HA-Systemen folgen einem abgestimmten Wartungsverfahren über alle Knoten hinweg, das je nach Upgrade variiert. Lesen Sie die jeweiligen Versionshinweise, um sich über etwaige Ausnahmen vom Standard-Upgrade-Verfahren zu informieren.

Zugehörige Themen

Weitere Informationen finden Sie unter High-Availability-Architektur – Übersicht.
Lesen Sie Patchen im laufenden Load-Balancing-Betrieb in einem neuen Tab.

Cloud/Managed-Update

Von Ihrer Seite ist kein Handeln erforderlich.

Die Updates, inklusive JDK, werden automatisch verwaltet und durchgeführt. Bei spezifischen Fragen wenden Sie sich an den Lobster-Support. Weitere Informationen finden Sie im Abschnitt Software-Update-Richtlinie der Lobster-Cloud-Dokumentation.