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: 

Version 26.3 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 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.

Siehe auch:

• Upgrade-Pfad bestimmen

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

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 ihn 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.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. → Wrapper-Installation (26.3)

• 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. 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: 26.3.x

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