Upgrade von Simplifier 9 auf Simplifier 10

Einführung

Diese Dokumentation ist in 2 Teile gegliedert:

Teil 1 beschreibt die eigentliche Aktualisierung der Container und wird in zwei Varianten angeboten
- Option 1 für den Fall, dass Sie unser empfohlenes Docker-Compose-Setup verwenden.
- Option 2, falls Sie eine benutzerdefinierte Einrichtung haben. Er beschreibt die relevanten Änderungen, die mit Simplifier 10 einhergehen, in allgemeiner Form.
Teil 2 beschreibt Schritte, die unabhängig vom Container-Orchestrierungsmodus durchgeführt werden müssen.

Lesen Sie unbedingt unsere Versionshinweise und Migrationshinweise für Simplifier 9, bevor Sie mit dem Upgrade Ihrer Instanz beginnen.

Teil 1: Aktualisierung des Simplifiers

Option 1: Upgrade mit Standard-Docker-Komposition

Schritt 1 – Herunterfahren der Simplifier-Instanz

Wechseln Sie in das Verzeichnis, in dem Sie die Datei docker-compose abgelegt haben. Wechseln Sie in diesen Ordner:

cd docker-compose

Um Simplifier zu beenden, führen Sie

docker compose -f simplifier-standalone.yml down

Schritt 2 – Abrufen der Simplifier-Setup-Dateien

Tipp: Wenn Sie docker-compose.yml geändert haben, erstellen Sie eine Sicherungskopie von docker-compose.yml und fügen Sie Ihre Änderungen in die neue Version ein.

Sie können dafür
git

stash

und
git

stash pop

verwenden.

Um eine Kopie zu erstellen und Ihre Änderungen rückgängig zu machen:
git

stash
 gitrestore docker-compose.yml

Aktualisieren Sie den Inhalt und wechseln Sie zum neuen Versionszweig:

Git-Pull
git checkout --track origin/release/LTS

Der Dateiname simplifier-standalone.yml wurde in docker-compose.yml geändert, um den Docker-Standards zu entsprechen. Sie können jetzt den Parameter -f <filename> weglassen, um docker compose-Befehle auszuführen.

Schritt 3 .env aktualisieren

Mit dieser Version wurden keine neuen Funktionen hinzugefügt oder entfernt. Sie können die Zeile

VEREINFACHER_VERSION=9

VEREINFACHER_VERSION=10

und lassen den Rest unverändert.

Optional: eine Liste aller env-Variablen mit einer kurzen Beschreibung. Ändern Sie diese nach Bedarf.

SIMPLIFIER_HOSTNAME	Simplifier Hostname, FQDN, ohne Protokoll. Für den Zugriff auf Simplifer muss https://${SIMPLIFIER_HOSTNAME} verwendet werden.
DB_PASSWORT	MySQL-Datenbank-Passwort
DB_ROOT_PASSWORD	Passwort für den MySQL-Root-Benutzer
DB_NAME	Datenbankname für die Simplifier-Datenbank. Wird als Präfix für alle Plugin/Modul-Datenbanken verwendet.
VEREINFACHER_VERSION	Version von Simplifier, die Sie installieren möchten. Sie sollten dies nicht ändern. Wenn Sie eine andere Version von Simplifier haben möchten, schauen Sie sich bitte den entsprechenden Zweig an
HOST_DATA_PATH	Pfad, unter dem alle Daten auf dem Host gespeichert sind.
PLUGINLISTE	Liste aller Plugins, die gestartet werden sollen. Technisch gesehen ist die Workflow-Engine kein Plugin, daher wird sie hier nicht erwähnt
VEREINFACHER_JVM_HEAP_GB	Wie viel Heap-Speicherplatz für Simplier App Server in GB
TZ	Zeitzone. Nur im Workflow-Kontext verwendet
WF_RT_JVM_HEAP_GB	Wie viel Heap-Speicherplatz für Workflow Runtime in GB
WF_ARCHIVE_ENABLED	Informationen zu archivbezogenen Einstellungen finden Sie in dieser Dokumentation.
WF_ARCHIVE_INTERVAL
WF_ARCHIVE_MAX_AGE_COMPLETED
WF_ARCHIVE_TIME
WF_DT_JVM_HEAP_GB	Wie viel Heap-Speicherplatz für Workflow Designtime in GB
LAUNCHPAD_JVM_HEAP_GB	Wie viel Heap-Speicherplatz für Launchpad in GB
FEATURE_SSBO_JS_DEBUGGING	Soll das experimentelle Feature “Debuggen von serverseitigen Business Objekten” aktiviert werden? (Weiterlesen)
DEBUG_CHROME_DEV_TOOLS_EXPOSED_PORT	Port, der für die Verbindung zum Debugger verwendet wird. Dieser Port muss in Ihrer Firewall-Einrichtung geöffnet sein.(Mehr lesen)
PDFPLUGIN_SECURITY_ALLOW_JAVASCRIPT	Sollte die Ausführung von Javascript in PDF-Vorlagen erlaubt sein?(Mehr lesen)
DYNAMIC_TAB_TITLES_ENABLED	Soll die experimentelle Funktion “Dynamische Tab-Icons und Tab-Titel” aktiviert werden? (Weiterlesen)

Schritt 4

Neue Bilder ziehen

docker compose pull

Start Vereinfacher

docker compose up -d

Option 2: Allgemeine Upgrade-Anweisungen, wenn Sie nicht unser Standard-Docker-Compose-Setup verwenden

Schritt 1: Konfigurieren der Überwachungsdatenbank

Seit der Version 8 EHP 2 werden die Überwachungsdaten in eine separate Datenbank übertragen. Bei dieser Datenbank muss es sich um eine MySQL-Datenbank handeln, die sich auf demselben MySQL-Server wie die Hauptdatenbank des Simplifiers, aber auch auf einem anderen MySQL-Server befinden kann. In beiden Fällen muss die Verbindung gesondert konfiguriert werden.

Um diese Datenbank zu konfigurieren, müssen die folgenden Umgebungsvariablen gesetzt werden:

- MONITORING_DBMS=mysql // feste Zeichenfolge
- MONITORING_DB_HOST=<Hostname>
- MONITORING_DB_PORT=<Hafen>  // MySQL verwendet standardmäßig 3306
- MONITORING_DB_USER=<dbUserName>
- MONITORING_DB_PASS=<Passwort>
- MONITORING_DB=<DatenbankName>

Die Datenbank muss auf dem konfigurierten MySQL-Server vorhanden sein.

Schritt 2 – Aktualisieren Sie den Reverse-Proxy

Erweitern der Konfiguration header access-control-expose-headers

OData-Version muss zu access-control-expose-headers hinzugefügt werden. Die vollständige Liste lautet nun

access-control-expose-headers: remainingTokenLifetime,OData-Version

Erweitern Sie die Konfiguration header-access-control-allow-headers

OData-MaxVersion, OData-Version müssen zu access-control-allow-headers hinzugefügt werden. Die vollständige Liste ist jetzt

access-control-allow-headers: DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization,SimplifierToken,SimplifierApp,SimplifierModule,SimplifierModuleInterface,SimplifierClientBusinessObject,SimplifierClientBusinessObjectFunction,sap-cancel-on-close,sap-contextid-accept,MaxDataServiceVersion,DataServiceVersion,Content-Length,SimplifierApiKey,OData-MaxVersion,OData-Version,MIME-Version,X-CSRF-Token

Schritt 3 – Freigegebenen Ordner erstellen

Es ist ein neuer Ordner erforderlich, der als freigegebenes Volume fungiert. Sie können z.B. /var/lib/simplifier/shared erstellen:

mkdir /var/lib/simplifier/shared

Sie müssen diesen Pfad in den Simplifier-Container und in den Workflow-Designtime-Container einbinden.

Für den Simplifier-Container:

/var/lib/simplifier/shared:/opt/Vereinfacher/gemeinsam

Für den Workflow-Entwurfszeit-Container :

/var/lib/simplifier/shared:/home/workflowDesigntime/shared

Sie können /var/lib/simplifier/shared in einen beliebigen Ordner ändern, den Sie bevorzugen. Sie müssen die Mount-Ziele /opt/simplifier/shared und /home/workflowDesigntime/shared unverändert lassen!

Teil 2: Aktivitäten nach dem Upgrade

Schritt 1: Aktualisierung des Standardinhalts des Simplifiers

Laden Sie die neuesten Standardinhalte vom Marketplace herunter und importieren Sie sie in Ihre Simplifier-Instanz. Stellen Sie sicher, dass Sie die Importszenarien „Alles überschreiben“ oder „Unverändert überspringen“ (empfohlen) verwenden.

Schritt 2: Implementierung der in den Release- und Migrationshinweisen genannten Änderungen

Folgen Sie unseren Release Notes und Migration Notes und setzen Sie die dort beschriebenen notwendigen Änderungen um.

Aktueller Release