Upgrade-Vorbereitung

Diese Seite fasst alle Anforderungen, Pflichtmaßnahmen und weiterführenden Ressourcen zusammen, die Sie für ein erfolgreiches Upgrade auf die Lobster Data Platform Version 26.3 und höher benötigen. Lesen Sie sich die Abschnitte der Reihe nach durch, bevor Sie das Upgrade in Ihrer Produktivumgebung starten.

 WICHTIG:

Ein Upgrade kann spezifische Anpassungen und Installationen erfordern, die teils unabhängig von einem Java-Upgrade vor dem Upgrade des Produktivsystems in einer Testumgebung umgesetzt und geprüft werden müssen. Ein Upgrade ohne Beachtung dieser Schritte kann dazu führen, dass die Plattform nicht neu gestartet werden kann oder Verbindungen zu Datenbanken und Drittsystemen fehlschlagen.

Änderungen auf einen Blick

Upgrade-Pfade

Bestimmen Sie anhand der folgenden Tabelle, welche zusätzlichen Schritte für Ihren Ausgangspunkt gelten. Wenn Sie eine oder mehrere Zwischenversionen übersprungen haben, müssen Sie die dort dokumentierten Änderungen kumulativ berücksichtigen.

✅ – empfohlen, 🚫 – nicht empfohlen, N/A – not applicable

 WICHTIG: Ab Version 26.3 ist Java 21 die empfohlene Laufzeitumgebung. Java 11 wird in dieser Version zwar weiterhin unterstützt, der reguläre Herstellersupport für Java 11 ist jedoch ausgelaufen. Ab Version 26.4 wird nur Java 21 unterstützt.

Siehe auch:

• Installationsanleitung für Ihre Umgebung auswählen

• One-Click-Migration von älteren Systemen

• Release Notes

Schritt-für-Schritt-Checkliste

Die folgende Checkliste führt Sie durch alle erforderlichen Maßnahmen. Arbeiten Sie die Schritte in der angegebenen Reihenfolge ab.

Schritt 1 – Vorbereitung

• Backup erstellen: Sichern Sie das vollständige Lobster-Installationsverzeichnis und die Repository-Datenbank. → Vor Beginn eines Upgrades.

• Upgrade-Pfad prüfen: Bestimmen Sie Ihren Ausgangspunkt unter Upgrade-Pfade und lesen Sie alle kumulativ wichtige Änderungen.

Schritt 2 – Abhängigkeiten prüfen und aktualisieren

• Auf Java 21 wechseln (ab 26.3 empfohlen, ab 26.4 Pflicht): Arbeiten Sie die Java-21-Upgrade: Checkliste ab. Sie führt Sie durch JDK-Bereitstellung, JDBC-Treiber-Kompatibilität und TLS-Einstellungen.

• Wrapper-Konfiguration anpassen: Ab 26.3 wird ein neuer Wrapper für die Startfunktion verwendet. Der neue Wrapper verwendet die Dateien platform.json und wrapper.json, nicht mehr wrapper.conf. Übertragen Sie Ihre bisherigen Einstellungen in diese neuen Dateien. → Lobster Application Wrapper

• Custom Code auf JDOM2 migrieren: Betrifft Sie nur, wenn Sie Execute-Scripts oder eigene Java-Klassen verwenden, die JDOM-Klassen importieren. Die Umstellung ist auch unter Java 11 erforderlich. → JDOM1-zu-JDOM2-Migration

• SAP-Bibliotheken sichern: Falls Sie SAP-Konnektivität nutzen, sichern Sie die Bibliotheken vor dem Upgrade und stellen Sie sie danach wieder her. → SAP-Bibliotheken

• Externe Treiber in ./extlib aktualisieren: Diese werden während des Updates nicht verändert. Prüfen Sie Versionen und ersetzen Sie sie bei Bedarf vor dem Upgrade.

Schritt 3 – Staging-Test

• Vollständiges Upgrade auf dem Testsystem durchführen: Spielen Sie das Plattform-Update, den Java-Wechsel, die Treiberaktualisierung und die Wrapper-Änderung gemeinsam in einer Nicht-Produktivumgebung ein.

• End-to-End-Szenarien testen:

  • Datenbankzugriff (alle verwendeten Datenbanktypen)

  • Reporting- und BI-Integrationen

  • SAP-Konnektivität (sofern relevant)

  • TLS-gesicherte Verbindungen zu Drittsystemen

  • Execute-Scripts und Custom Code mit JDOM-Nutzung

  • CSV-/Dateiexporte auf korrekte Zeichenkodierung prüfen

• Java-Versionsstatus in der UI prüfen: Nach dem Neustart darf das Java-Icon in der System-Info-Leiste kein rotes Ausrufezeichen mehr anzeigen. → Java-Versionsstatus überprüfen

Schritt 4 – Produktiv-Upgrade

• Wartungsfenster einplanen: Koordinieren Sie das Fenster mit Ihrem Team. Legen Sie es in eine Zeitraum mit geringem Datenaufkommen.

• Upgrade durchführen: Folgen Sie der Schritt-für-Schritt-Anleitung für Ihre Umgebung: Windows | Linux | DMZ | Hochverfügbarkeit

• Post-Upgrade-Verifikation: Prüfen Sie nach dem Neustart:

  • Plattform-Versionsnummer in der UI entspricht der installierten Zielversion

  • Java-Icon ohne rotes Ausrufezeichen

  • Logdatei ./logs/console.txt: keine ClassNotFoundException, kein NoSuchMethodError, kein TLS-Handshake-Fehler

  • Alle Datenbankverbindungen erreichbar (Verbindungstest in der UI)

  • Mindestens ein repräsentativer Job erfolgreich durchgelaufen

• Beachten Sie außerdem folgende wichtige Änderungen und Hinweise:

  • Prüfen Sie die JasperReports-Bibliotheken, falls Sie nicht von Version 26.2.4 oder höher kommen. Siehe auch: LDP Release 26.2.4.

  • Wenn Sie den bisherigen OpenAPI-Viewer von bestimmten Hosts aus nutzen möchten, prüfen Sie die Property „hub.datawizard.api.viewer.whitelist”. Siehe auch: LDP Release 26.3.0.

  • Prüfen Sie die Property „profile.backup.handler.implementation“, um die neue, optimierte Backup-Performance zu nutzen. Siehe auch: LDP Release 26.3.0.

Bekannte Probleme und Workarounds

Geschätzte Downtime

Ziehen Sie im Zweifel die historischen Start-/Stopp-Zeiten Ihres Systems heran, um die voraussichtliche Ausfallzeit realistisch einzuschätzen.

Zugehörige Ressourcen

Haben Sie Fragen oder benötigen Sie Unterstützung beim Upgrade? Wenden Sie sich an den Lobster-Support.