--- title: "Upgrade-Vorbereitung" slug: "upgrade-landing-page" tags: ["Java Kompatibilität", "Lobster Data Platform", "Upgrade Anforderungen"] status: "update" updated: 2026-10-27T09:02:09Z published: 2026-10-27T09:02:09Z canonical: "docs.lobstersoftware.com/upgrade-landing-page" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.lobstersoftware.com/llms.txt > Use this file to discover all available pages before exploring further. # 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. > [!WARNING] > **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 | Änderung | Schweregrad | Auswirkung | Details | | --- | --- | --- | --- | | Wechsel auf OpenJDK 21 | 🔴 Pflicht ab 26.4 | OpenJDK 11 hat das End-of-Life erreicht. Ab Release 26.4 ist OpenJDK 21 verpflichtend. Versionen vor 26.4 laufen weiterhin mit OpenJDK 11, 26.3 und 26.2 unterstützen sowohl OpenJDK 21 als auch OpenJDK 11. Siehe auch [/v1/docs/26-3-upgrade-landing-page#upgradepfade-nach-262](/v1/docs/26-3-upgrade-landing-page#upgradepfade-nach-262). **WICHTIG:** - Der Updater bricht die Installation von 26.4 ab, wenn kein OpenJDK 21 erkannt wird. - Wenn Sie auf OpenJDK 21 aktualisieren, müssen Sie auch den neuen Lobster Application Wrapper verwenden. | [Überblick zum Java-Upgrade](/v1/docs/java-upgrade-info) | | Neuer Wrapper-Installationsprozess | 🔴 Pflicht | Ab Release 26.3 wird ein neuer Wrapper verwendet. Die Start-/Stopp-Mechanismen ändern sich. Bestehende Konfigurationen müssen angepasst werden, damit der Application Wrapper richtig funktioniert. | [Lobster Application Wrapper](/v1/docs/application-wrapper) | | JasperReports-Bibliotheken und -Abhängigkeiten | 🔴 Pflicht | Wenn Sie von einer Version vor 26.2.4 migrieren, müssen Sie alle vorhandenen JasperReports-Bibliotheken und -Abhängigkeiten aus dem Ordner `extlib` entfernen, um Classpath-Konflikte zu vermeiden. | | | JDBC-Treiber-Kompatibilität | 🔴 Wichtig | Veraltete Treiber führen unter OpenJDK 21 zu Verbindungsabbrüchen. Betrifft insbesondere MS SQL Server – hier treten wiederholt Probleme auf, wenn der Treiber nicht vor dem Upgrade des JDK aktualisiert wird. | [JDBC-Treiber-Kompatibilität prüfen](/v1/docs/jdbc-drivers) | | Bridge-Systeme | 🟡 Bedingt | Die Bridge verwendet dieselbe Java-Version wie die **Lobster Data Platform**. Beim Upgrade auf 26.4 müssen daher auch Ihre Bridge-Systeme auf OpenJDK 21 angehoben werden. | [Begleitete Bridge-Installation](/v1/docs/creating-a-bridge-connection-on-the-platform) | | JDOM2-Umstellung | 🟡 Bedingt | Betrifft Sie nur, wenn Sie Custom Code (Execute-Scripts, eigene Java-Klassen) verwenden, der JDOM-Klassen importiert. Die Umstellung gilt unabhängig von der eingesetzten Java-Version, also auch unter Java 11. | [JDOM1-zu-JDOM2-Migration](/v1/docs/jdom1-to-jdom2-migration) | | TLS-Standardeinstellungen | 🟡 Bedingt | TLS 1.0 und 1.1 sind unter OpenJDK 21 standardmäßig deaktiviert. Verbindungen zu Altsystemen, die kein TLS 1.2+ unterstützen, schlagen fehl. | [TLS-Java-Änderungen beachten](/v1/docs/tls-java-changes) | | Informix als Hub-Datenbank | 🟡 Nicht unterstützt | Ab Version 26.2 (sowie dem Patch 25.1.11) wurden alle Informix-JDBC-JARs aus `IS/lib` entfernt. Für Nicht-Hub-Szenarien: Treiber unter `IS/extlib` selbst bereitstellen. | [JDBC-Treiber-Kompatibilität prüfen](/v1/docs/jdbc-drivers) | | Zeichenkodierung UTF-8 | 🔵 Hinweis | Die Standardkodierung ist unter OpenJDK 21 immer UTF-8 (auch unter Windows). Prüfen Sie Logdateien, CSV-Exporte und Datenbankimporte, falls Sie bisher keine explizite Kodierung angegeben haben. | [Überblick zum Java-Upgrade](/v1/docs/java-upgrade-info#zeichenkodierung) | ## 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. | Ausgangsversion ↓ | **Zielversion →** | | --- | --- | | **25.1.x LTS** | **26.1.x** | **26.2.x** | **26.3.x** | **26.4.x** | | **>= 4.6.14** | ✅ | 🚫 | 🚫 | 🚫 | 🚫 | | **25.1.x LTS** | | ✅ | ✅ | ✅ | ✅ | | **26.1.x** | N/A | | ✅ | ✅ | ✅ | | **26.2.x** | N/A | N/A | | ✅ | ✅ | | **26.3.x** | N/A | N/A | N/A | | ✅ | | **Unterstützte Java-Version** | Java 11 | Java 11 | Java 11 oder 21 | Java 11 oder 21 | Java 21 | ✅ – 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](/v1/docs/select-your-environment) - [One-Click-Migration von älteren Systemen](/v1/docs/migration-from-older-systems) - [Release Notes](/v1/docs/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](/v1/docs/before-starting-an-update). - [ ] **Upgrade-Pfad prüfen:** Bestimmen Sie Ihren Ausgangspunkt unter [Upgrade-Pfade](/v1/docs/26-3-upgrade-landing-page#upgradepfade-nach-262) und lesen Sie alle kumulativ wichtige [Änderungen](/v1/docs/26-3-upgrade-landing-page#änderungen-auf-einen-blick). ### 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](/v1/docs/before-java-upgrade) 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](/v1/docs/application-wrapper#4-dienst-installieren) - [ ] **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](/v1/docs/jdom1-to-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](/v1/docs/before-starting-an-update#sapbibliotheken) - [ ] **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](/v1/docs/java-version-status-check) ### 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](/v1/docs/select-your-environment#windows) | [Linux](/v1/docs/select-your-environment#linux) | [DMZ](/v1/docs/select-your-environment#dmzkonfiguration) | [Hochverfügbarkeit](/v1/docs/select-your-environment#hochverfügbarkeitsumgebung-ha) - [ ] **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](/v1/docs/ldp-release-26-2-4#ldp7202). - 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](/v1/docs/ldp-release-26-3-0#ldp7645). - Prüfen Sie die **Property** „profile.backup.handler.implementation“, um die neue, optimierte Backup-Performance zu nutzen. Siehe auch: [LDP Release 26.3.0](/v1/docs/ldp-release-26-3-0#ldp5724). ## Bekannte Probleme und Workarounds | Symptom | Ursache | Workaround | | --- | --- | --- | | Verbindungsfehler zu MS SQL Server nach Upgrade | Der JDBC-Treiber ist nicht mit OpenJDK 21 kompatibel (häufig `mssql-jdbc-11.x` oder älter). | Treiber auf `mssql-jdbc-12.6` oder höher aktualisieren. → [JDBC-Treiber-Kompatibilität prüfen](/v1/docs/jdbc-drivers#voraussetzungen) | | TLS-Handshake-Fehler bei Verbindung zu Altsystemen | Gegenstelle unterstützt nur TLS 1.0/1.1, die unter OpenJDK 21 standardmäßig deaktiviert sind. | Gegenstelle aktualisieren. Falls nicht sofort möglich: temporäre Ausnahme in `java.security` konfigurieren. → [TLS-Konfiguration](/v1/docs/tls-java-changes#javastandardeinstellungen) | | `ClassNotFoundException: org.jdom.*` | Custom Code referenziert noch den alten JDOM-1.x-Package-Prefix `org.jdom`. | Imports auf `org.jdom2` umstellen. → [JDOM1-zu-JDOM2-Migration](/v1/docs/jdom1-to-jdom2-migration) | | Dienst startet nicht / Wrapper-Fehler | Alte Startmechanismen (z. B. `execute.sh`) sind nicht deaktiviert, oder eigene JVM-Parameter wurden nicht in `platform.json` übertragen. | Wrapper-Konfiguration gemäß Anleitung aktualisieren. → [Lobster Application Wrapper](/v1/docs/application-wrapper) | | Zeichenkodierung in CSV-Exporten weicht ab | OpenJDK 21 verwendet UTF-8 als Standard statt Cp1252 (Windows). | Kodierung explizit setzen oder temporär `-Dfile.encoding=WINDOWS-1252` als JVM-Parameter verwenden. → [Überblick zum Java-Upgrade](/v1/docs/java-upgrade-info#was-sich-ändert) | ## Geschätzte Downtime | Komponente | Richtwert | | --- | --- | | Plattform-Update einspielen | ca. 1–10 Minuten (abhängig von Festplattengeschwindigkeit und Virenscanner) | | JDK-Wechsel + Wrapper-Anpassung | ca. 5–15 Minuten (manuelle Konfigurationsschritte) | | Neustart der Plattform | Abhängig von Systemgröße und laufenden Jobs. Nutzen Sie `./force_stop`, um die Wartezeit zu begrenzen. | Ziehen Sie im Zweifel die historischen Start-/Stopp-Zeiten Ihres Systems heran, um die voraussichtliche Ausfallzeit realistisch einzuschätzen. ## Zugehörige Ressourcen | Thema | Link | | --- | --- | | Generische Pre-Upgrade-Checkliste | [Vor Beginn eines Upgrades](/v1/docs/before-starting-an-update) | | Umgebungsauswahl und OS-spezifische Schritte | [Installationsanleitung für Ihre Umgebung auswählen](/v1/docs/select-your-environment) | | Java-Upgrade – Überblick und weitere Schritte | [Überblick zum Java-Upgrade](/v1/docs/java-upgrade-info) | | Release- und Update-Richtlinie | [Platform Update Guide](/v1/docs/platform-update-guide) | | Release Notes | [Release Notes](/v1/docs/release-notes) | --- Haben Sie Fragen oder benötigen Sie Unterstützung beim Upgrade? Wenden Sie sich an den Lobster-Support. TLS-Handshake ist die Aushandlung zu Beginn einer TLS-Verbindung: Beide Seiten einigen sich auf Verfahren, und der Server weist sich mit seinem Zertifikat aus, das die Gegenseite prüft. Schlägt der TLS-Handshake fehl, kommt keine Verbindung zustande; bei AS2 etwa wird die Nachricht nicht zugestellt.