One-Click-Migration von älteren Systemen

Prev Next

Wechseln Sie auf die Plattform, bevor Sie auf 26.x aktualisieren

Zugang zum Update-Center

  • Ältere 4.6-Systeme erfordern möglicherweise eine Aktivierung, um auf Updates zugreifen zu können. Wenden Sie sich an Ihren Lobster-Ansprechpartner, wenn das Update im Update-Center nicht angezeigt wird.

  • Das bisherige Portal portal.lobster.de wurde am 31. Dezember 2025 abgeschaltet und vollständig durch das Update-Center ersetzt. Dort können Sie mit den aktuellen Updates aller unterstützten Versionen die benötigte Lobster-Version gezielt auswählen und herunterladen.

Vor der Migration

Mehrstufige Migration für 4.x-Systeme erforderlich

Direkte Migrationen von 4.x auf 26.x werden nicht unterstützt. Sie müssen zunächst auf 25.1.x migrieren und anschließend auf 26.x aktualisieren. Ihr System muss sich auf Version 4.6.14 oder höher befinden, bevor Sie auf die aktuelle Version 25.1.x aktualisieren.

  • Stellen Sie sicher, dass Sie Version 4.6.14 oder höher verwenden, bevor Sie auf 25.1.x migrieren.

  • Arbeiten Sie die Checkliste vor dem Upgrade vollständig durch, einschließlich der Datensicherung der SAP-Bibliotheken.

  • Führen Sie die Installationen _data und _pro zusammen, sofern beide vorhanden sind. Nach einer Migration der _data-Installation kann die _pro-Installation nicht mehr in die Plattform übernommen werden.

  • Nach der Migration auf die Lobster Data Platform müssen _data-HA-Kunden einen zusätzlichen Ordner im gemeinsamen Dateisystem freigeben: ./PRO/config/files

  • Prüfen Sie, ob Sie eine erneuerte dedizierte DMZ-Lizenz erhalten haben, sofern eine DMZ im Einsatz ist.

Nach dem Wechsel auf 25.1.x

Browser-Cache leeren

Leeren Sie den Browser-Cache vor der Anmeldung. Die erste Anmeldung nach der Migration auf Lobster Data 25.1 kann einen Moment in Anspruch nehmen.

Datenbank-Neukodierung

MySQL-Tabellen werden während der Migration automatisch auf utf8mb4 umkodiert. Protokollmeldungen zu Tabellen, die aufgrund gemischter Sortierregeln nicht migriert werden können, sind nicht ungewöhnlich und können ignoriert werden.

Startskripte überprüfen

Der Updater passt die Verweise auf Klassen in den Startskripten automatisch an. Prüfen Sie, ob diese Änderung vorgenommen wurde:

Vorher

  • com.ebd.hub.update.UpdateInstaller

Neu

  • de.lobster.updater.LobsterInstaller

hub.bat (Windows)

Wenn die Datei genau so aussieht, fahren Sie fort.

set UPDATE="%JAVA_HOME%\bin\java" -cp bin/updater.jar -Djava.io.tmpdir="%HUB_HOME%\tmpIO" de.lobster.updater.LobsterInstaller

execute.sh (Linux)

Wenn die Datei genau so aussieht, fahren Sie fort.

$JAVA -cp bin/updater.jar -Djava.io.tmpdir=$HUB_HOME/tmpIO de.lobster.updater.LobsterInstaller $HUB_HOME

Wenn Sie abweichende Inhalte in diesen Dateien vorfinden und sich nicht sicher sind, wie Sie die Datei korrigieren können, wenden Sie sich zur Klärung an den Support.

Plattformübergreifende Migration

Wenn Sie Ihre Installation auf eine andere Plattform migrieren möchten (zum Beispiel von Windows auf Linux), wenden Sie sich bitte an den Support.

Benutzeroberfläche der Plattform konfigurieren

Die Benutzeroberfläche erfordert ab Version 25.1.x einen Verweis auf den HTTP-Server, um die Webanwendung bereitstellen zu können. Ältere 4.x-_data-Installationen mit einer _pro-Installation enthalten diese Einstellung nicht. Ohne diese ist die Benutzeroberfläche nach der Migration nicht erreichbar.

Überprüfen Sie in PRO/config/etc/systemManagers/de.lobster.scm.rest.WebAppManager.xml, ob die Eigenschaft httpServerName vorhanden ist: <Set name="httpServerName">Main Server</Set>.

Falls diese Zeile fehlt, fügen Sie sie hinzu und starten Sie den Dienst neu.

Migration von HA-Systemen von _data auf die Lobster Data Platform

Der Umstieg von 4.6.x auf die Lobster Data Platform erfordert ein vollständiges Herunterfahren des Clusters. Diese Ein-Klick-Migration aktualisiert die Datenbank automatisch, um neue Plattformfunktionen zu unterstützen; allerdings muss der gesamte Cluster während dieses Vorgangs offline bleiben.

Warten Sie, bis der Node-Controller vollständig gestartet ist und seine Migrationen abgeschlossen hat, bevor Sie mit der Aktualisierung der Worker-Knoten und DMZs beginnen. Sobald die Migration abgeschlossen ist, gilt für zukünftige Wartungsarbeiten der übliche rollierende Aktualisierungsprozess.

Update-Reihenfolge

  1. Alle Systeme beenden.

  2. Aktualisieren und neu starten: NodeController und primäre DMZ.

  3. Aktualisieren und neu starten: Arbeitsknoten und sekundäre DMZ-Systeme.

Validierung

Führen Sie nach der Migration die folgenden Prüfungen durch:

  • Die Plattform muss fehlerfrei starten. Prüfen Sie die Dienstprotokolle auf Fehler oder Stack-Traces.

    • Windows: ./logs/wrapper.log

    • Linux: ./logs/console.txt

  • Verbindungen prüfen: Partnerkanäle und verwendete Kommunikationsprotokolle (SFTP, OFTP, AS2, SMB, Datenbanken usw.).

  • Profile testen: Führen Sie vorhandene Testfallprofile aus, die die wichtigsten Funktionen abdecken. Für eine strukturierte Validierung empfiehlt sich der Profile test manager.

  • Prüfen Sie die aktuellen error.log-Dateien auf Auffälligkeiten im Vergleich zum Zustand vor dem Upgrade.

Nächster Schritt

Führen Sie kein Upgrade auf 26.x durch, bevor 25.1.x nicht läuft und vollständig validiert wurde.

SAP-Bibliotheken

Aufgrund von Lizenzbeschränkungen werden SAP-Bibliotheken nicht mehr mit neuen Releases ausgeliefert. Wenn Ihr System die SAP-Konnektivität verwendet, sichern Sie die folgenden Dateien vor jedem Upgrade manuell und stellen Sie sie danach wieder her.

Alte Layouts (bestehende Installationen vor der Migration)

Bei älteren Hubs sind möglicherweise sowohl JCo 3 als auch (optional) die alte RFC-Bibliothek vorhanden. Verwenden Sie diese Tabelle für ältere 4.x-Systeme, bei denen SAP bereits an den klassischen Speicherorten konfiguriert ist:

Plattform

Dateien

Speicherort

Linux

libsapjco3.so, libsapjcorfc.so

is/lib/shared/linux

Windows

sapjco3.dll, sapjcorfc.dll

is/lib/shared/win

Fehlerbehebung beim Upgrade von 4.x auf 25.1.x

Symptom

Ursache

Lösung

Anmeldung schlägt nach der Migration fehl.

Veralteter Browser-Cache

Browser-Cache leeren und erneut versuchen.

ClassCastException mit Verweis auf JettyLoggerFactory beim Start (Windows).

Veraltete Jetty-Protokollbibliotheken

Inhalt von is/lib/jetty/logging löschen und neu starten.

Das System verbleibt im Emergency-Halt-Modus.

Systemstart wurde nicht erfolgreich abgeschlossen.

forceUnlockEmergencyHalt in startup.xml prüfen.

Benutzeroberfläche nach der Migration von 4.x nicht zugänglich.

Einige ältere 4.x-Installationen enthalten die Eigenschaft httpServerName nicht.

Siehe oben: Benutzeroberfläche der Plattform konfigurieren

Start schlägt nach plattformübergreifender Migration fehl.

Falsche Reihenfolge beim Laden der Bibliotheken

Ladereihenfolge der Bibliotheken in hub.bat, execute.sh und wrapper.conf angleichen.

SAP-Verbindung nach dem Upgrade unterbrochen.

SAP-Bibliotheken wurden nicht gesichert.

SAP-Bibliotheken aus der Datensicherung wiederherstellen (siehe SAP-Bibliotheken).

DMZ bezieht keine Updates.

Lizenzbeschränkung

DMZ-Lizenz überprüfen.

Rollback

Wir raten ausdrücklich von einem Downgrade ab.

Falls dennoch ein Rollback auf die vorherige Version erforderlich sein sollte, kann dies ausschließlich durch die vollständige Wiederherstellung des Installationsverzeichnisses und der Datenbank aus den vor der Migraton erstellten Datensicherungen erfolgen. Die alleinige Wiederherstellung aus den während des Update-Vorgangs intern erzeugten Dateien ist nicht ausreichend. Wenden Sie sich für Unterstützung an den Lobster-Support.