Überblick

Ab Version 26.2 der Lobster Data Platform ersetzt der Lobster Application Wrapper die bisherigen plattformspezifischen Startmechanismen (z. B. execute.sh, manuell registrierte Windows-Dienste oder eigene Init-Skripte) durch eine einheitliche, betriebssystemübergreifende Lösung. Sie müssen dazu einige Schritte zur Einrichtung vornehmen.

Was der Wrapper leistet

Der Wrapper ist eine Java-basierte Anwendung, die Ihre Lobster-Anwendungen als Systemdienste registriert und verwaltet – unter Windows über den Service Control Manager, unter Linux über systemd. Er kann eine oder mehrere Java-Anwendungen parallel starten und überwachen und koordiniert den Neustart Ihres gesamten Clusters, einschließlich aller Lobster-Data-Platform-Instanzen (Node-Controller und Worker-Nodes) sowie DMZ-Server (Primary und Secondaries).

Warum ein Wrapper?

Bisher hing die Art, wie die Lobster Data Platform gestartet und gestoppt wurde, stark vom Betriebssystem und von individuellen Anpassungen ab. Diese heterogenen Betriebsabläufe erhöhten die Abhängigkeit vom Lobster-Support, insbesondere bei Neustarts in Cluster-Setups.

Der Wrapper löst diese Probleme:

• Einheitliche Kommandos: gleiche Befehle unter Windows und Linux. Kein plattformspezifisches Wissen nötig.

• Eigenständiger Betrieb: Sie starten, stoppen und starten Ihre Umgebung neu, wann immer Sie es benötigen. Kein Support-Ticket, keine Wartezeit.

• Cluster-weiter Neustart: Der Wrapper koordiniert den Neustart aller Knoten (Node-Controller, Worker-Nodes) und DMZ-Server (Primary und Secondaries).

• Zentrale Konfiguration: JVM-Parameter und Speichereinstellungen pflegen Sie in einer einzigen Datei (platform.json).

• Multi-Application-Management: Mehrere Java-Anwendungen lassen sich mit demselben Wrapper verwalten.

Was sich ändert

Architektur

Der Wrapper besteht aus folgenden Komponenten:

Log-Ausgabe

Der Wrapper schreibt seine Log-Ausgabe einheitlich in die Datei logs/wrapper.log und zwar sowohl im Dienstbetrieb als auch im Konsolenmodus (--run). Das gilt gleichermaßen für Windows und Linux. Die bisherige Datei console.txt wird nicht mehr erzeugt.

Systemvoraussetzungen

• JDK 11 oder höher ist eingerichtet und über java auf der Kommandozeile erreichbar.

• Lobster Data Platform ≥ 26.2 ist installiert.

• Sie haben Administrator-Rechte (Windows) oder Root-Rechte (Linux).

• Windows: Service Control Manager

• Linux: systemd

Windows-Wrapper: Java-Versionskompatibilität

Unter Windows hängt die Wrapper-Kompatibilität von der installierten Wrapper-Generation und der verwendeten Java-Version ab. Prüfen Sie Ihr Szenario in der folgenden Tabelle.

Weiterführende Informationen:

• Ersteinrichtung → Application Wrapper einrichten

• Migration → How-to: Von einer bestehenden Installation migrieren

• Kommandos und Konfiguration → Referenz

Application-Wrapper einrichten

Diese Anleitung führt Sie Schritt für Schritt durch die Ersteinrichtung des Lobster Application Wrappers. Am Ende läuft Ihre Lobster Data Platform als Systemdienst mit automatischem Start beim Systemboot.

1. Installationsdateien prüfen

Öffnen Sie eine Kommandozeile und wechseln Sie in das Installationsverzeichnis Ihrer Lobster Data Platform. Prüfen Sie, ob die Wrapper-Dateien vorhanden sind:

# Linux
ls -la ./bin/application-wrapper.jar ./bin/platform.json ./bin/wrapper.json ./bin/updater.json

# Windows
dir .\bin\application-wrapper.jar .\bin\platform.json .\bin\wrapper.json .\bin\updater.json

Sie sollten alle vier Dateien sehen: application-wrapper.jar, platform.json, wrapper.json und updater.json. Falls nicht, ist Ihre Installation möglicherweise nicht auf Version 26.2 oder höher aktualisiert.

2. Speichereinstellungen prüfen

Öffnen Sie die Datei ./bin/platform.json in einem Texteditor und prüfen Sie die Heap-Speichereinstellungen:

"-Xms4096M",
"-Xmx4096M"

Passen Sie die Werte an die verfügbaren Ressourcen Ihres Servers an. Setzen Sie -Xms und -Xmx auf den gleichen Wert, um dynamische Speicheranpassungen zur Laufzeit zu vermeiden. Typische Werte liegen zwischen 2048M und 8192M.

3. Bisherige Startmechanismen deaktivieren

Falls Ihre Lobster Data Platform bisher über andere Mechanismen gestartet wurde (z. B. Init-Skripte, manuell registrierte Dienste, Cron-Jobs), deaktivieren Sie diese vor der Wrapper-Installation, um Konflikte zu vermeiden.

4. Dienst installieren

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

Der Wrapper registriert den Dienst und aktiviert den Autostart für Windows und Linux.

5. Dienst starten

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

6. Status prüfen

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

Sie sollten eine Ausgabe sehen, die bestätigt, dass der Dienst läuft.

7. Funktionstest

Melden Sie sich an der Lobster Data Platform an und prüfen Sie, ob die Anwendung wie erwartet funktioniert. Prüfen Sie auch die Datei ./logs/wrapper.log auf Fehler.

How-to: Wrapper verwalten

Von einer bestehenden Installation migrieren

Diese Anleitung beschreibt die Migration zum Wrapper, wenn Ihre Lobster Data Platform bisher über eigene Startskripte oder manuell registrierte Dienste betrieben wurde.

Voraussetzungen

• Lobster Data Platform ≥ 26.2 ist installiert.

• Sie kennen Ihre aktuellen JVM-Parameter (z. B. aus der execute.sh oder execute.bat).

Schritte

1. Aktuelle JVM-Parameter sichern.

   Notieren Sie alle eigenen Java-Parameter aus Ihrer bisherigen execute.sh oder execute.bat.

2. Parameter in platform.json übertragen.

   Öffnen Sie ./bin/platform.json und fügen Sie Ihre Parameter als zusätzliche Einträge im Array jvmArgs hinzu:

   "jvmArgs": [
       ... (bestehende Einträge belassen) ...
       "-Dmein.eigener.parameter=wert",
       "-Dweiterer.parameter=true"
   ]

3. Bisherige Startmechanismen deaktivieren.

   Deaktivieren oder entfernen Sie alle bestehenden Dienste, Init-Skripte und sonstigen Startmechanismen.

    WICHTIG 

   Dieser Schritt ist entscheidend für die Funktionsfähigkeit des Wrappers. Wenn Sie bisherige Startmechanismen nicht deaktivieren, kann die Plattform zwar weiterhin starten. Die Neustart-Funktionalität (--restart-service, --stop-service) funktioniert dann aber nicht. Der Wrapper kann die Anwendung nur dann vollständig steuern, wenn er der einzige Steuerungsmechanismus ist.

4. Dienst installieren und starten.

   java -jar ./bin/application-wrapper.jar --install-service
   java -jar ./bin/application-wrapper.jar --start-service

5. Funktionstest durchführen.

   Prüfen Sie die Anwendung und die Datei ./logs/wrapper.log auf Fehler.

Dienst neu starten

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

Alternativ können Sie den Dienst stoppen und separat wieder starten:

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

Autostart deaktivieren oder aktivieren (nur Linux)

Standardmäßig startet der Dienst automatisch beim Systemboot. Um dieses Verhalten zu ändern:

# Autostart deaktivieren
java -jar ./bin/application-wrapper.jar --disable-service

# Autostart wieder aktivieren
java -jar ./bin/application-wrapper.jar --enable-service

Anwendung im Konsolenmodus starten

Für Tests oder Fehleranalysen können Sie die Anwendung ohne Dienstregistrierung direkt in der Konsole starten:

java -jar ./bin/application-wrapper.jar --run

Die Log-Ausgabe wird – wie im Dienstbetrieb – in logs/wrapper.log geschrieben. Beenden Sie den Prozess mit Strg+C.

Speichereinstellungen ändern

1. Dienst stoppen:

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

2. Die Datei ./bin/platform.json öffnen und die Werte für -Xms und -Xmx anpassen:

   "-Xms8192M",
   "-Xmx8192M"

3. Dienst starten:

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

Eigene JVM-Parameter hinzufügen

Wenn Sie zusätzliche System-Properties oder JVM-Optionen benötigen, fügen Sie diese als weitere Einträge im Array jvmArgs der Datei platform.json hinzu:

"jvmArgs": [
    "-Xms4096M",
    "-Xmx4096M",
    "-server",
    ... (bestehende Einträge) ...
    "-Dmein.eigener.parameter=wert",
    "-Dweiterer.parameter=true"
]

Damit die Änderungen wirksam werden, starten Sie den Dienst anschließend neu.

Shutdown-Timeout anpassen

Beim Stoppen oder Neustarten räumt der Wrapper der Anwendung eine konfigurierbare Zeitspanne für das geordnete Herunterfahren ein. Der Standardwert beträgt 120 Sekunden. Überschreitet die Anwendung das Timeout, erzwingt der Wrapper das Beenden des Prozesses. Bei Plattformen mit vielen gleichzeitigen oder langlaufenden Verarbeitungen kann eine Erhöhung sinnvoll sein, damit offene Transaktionen sauber abgeschlossen werden können.

1. Dienst stoppen:

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

2. Die Datei ./bin/wrapper.json öffnen und den Wert von process.shutdown.timeout (Angabe in Sekunden) anpassen.

3. Dienst starten:

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

Dienst vollständig deinstallieren

# Dienst stoppen
java -jar ./bin/application-wrapper.jar --stop-service

# Dienst deinstallieren
java -jar ./bin/application-wrapper.jar --uninstall-service

Referenz: Kommandos und Konfiguration

Alle Kommandos werden über die Wrapper-JAR-Datei ausgeführt:

java -jar ./bin/application-wrapper.jar <Kommando>

Konfigurationsdatei: platform.json

Pfad: ./bin/platform.json

Die Datei platform.json ist die zentrale Konfigurationsdatei Ihres Anwendungsdienstes. Sie enthält JVM-Parameter, Speichereinstellungen und den Classpath. Legen Sie vor jeder Änderung eine Sicherungskopie an.

Parameter

Speichereinstellungen

Variablen

Konfigurationsdatei: wrapper.json

Pfad: ./bin/wrapper.json

Die Datei wrapper.json enthält die interne Dienstkonfiguration des Wrappers. Für Anpassungen vorgesehen sind ausschließlich die unten aufgeführten Parameter – alle übrigen Einträge (insbesondere die Verweise auf geladene Anwendungen und deren Konfigurationsdateien wie updater.json und platform.json) sind interne Konfiguration und dürfen nicht verändert werden.

Parameter

Empfehlung

Bei Plattformen mit vielen gleichzeitigen oder langlaufenden Verarbeitungen kann ein höherer Wert für process.shutdown.timeout sinnvoll sein, damit offene Transaktionen sauber abgeschlossen werden können, bevor der Prozess hart beendet wird.

Dateiübersicht