26.2: 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.2 benötigen. Arbeiten Sie die Abschnitte der Reihe nach durch, bevor Sie das Upgrade in Ihrer Produktivumgebung starten.

Wichtig

Version 26.2 beinhaltet spezifische Anpassungen und Installationen, 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 neugestartet werden kann oder Verbindungen zu Datenbanken und Drittsystemen fehlschlagen.

Änderungen auf einen Blick

Upgrade-Pfade nach 26.2

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.

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.

Phase 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 in der Tabelle oben und lesen Sie alle kumulativ erforderlichen Upgrade Notes.

Phase 2 – Abhängigkeiten prüfen und aktualisieren

• OpenJDK 21 bereitstellen – Entpacken Sie OpenJDK 21 parallel zum bestehenden JDK 11 in ein eigenes Verzeichnis; überschreiben Sie JDK 11 nicht. Eine systemweite Installation per OS-Installer ist nicht nötig und wird aus Sicherheits- und Rollback-Gründen nicht empfohlen. → Upgrade von Java 11 auf Java 21

• JDBC-Treiber aktualisieren – Prüfen Sie für jede konfigurierte Datenbankverbindung, ob der eingesetzte JDBC-Treiber mit OpenJDK 21 kompatibel ist. Aktualisieren Sie bei Bedarf. → JDBC-Treiber-Kompatibilität prüfen

  Bekanntes Problem mit Microsoft SQL Server: Bei Kunden mit MS SQL Server treten wiederholt Verbindungsfehler auf, wenn der JDBC-Treiber nicht vor dem Plattform-Upgrade aktualisiert wird. Stellen Sie sicher, dass Sie mindestens mssql-jdbc-12.6 verwenden. Ab Version 12.6 unterstützt die darin befindliche jre11-Variante auch Java 17 und Java 21.

• Wrapper-Konfiguration anpassen – ab 26.2 wird ein neuer Wrapper für die Startfunktion verwendet. Bestehende wrapper.conf-Dateien müssen angepasst werden. → Wrapper-Installation (26.2)

• 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

• TLS-Kompatibilität prüfen – identifizieren Sie Systeme, die nur TLS 1.0 oder 1.1 unterstützen, und planen Sie deren Aktualisierung. → TLS-Java-Änderungen beachten

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

Phase 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

Phase 4 – Produktiv-Upgrade

• Wartungsfenster einplanen – koordinieren Sie das Fenster mit Ihrem Team. Planen Sie es in eine Zeit 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: 26.2.x

  • Java-Icon ohne rotes Ausrufezeichen

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

  • Alle Datenbankverbindungen erreichbar (Verbindungstest in der UI)

  • Mindestens ein repräsentativer Job erfolgreich durchgelaufen

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.