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.
Teil 1: Simplifier aufrüsten
Option 1: Upgrade mit Standard-Docker-Komposition
Schritt 1 – Simplifier-Instanz herunterfahren
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 – Simplifier-Einrichtungsdateien abrufen
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
zu
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 Protokol. 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
Simplifier starten
docker compose up -d
Option 2: Allgemeine Upgrade-Anweisungen, wenn Sie nicht unser Standard-Docker-Compose-Setup verwenden
Schritt 1: Konfigurieren der Überwachungsdatenbank
Seit Release 8 EHP 2 werden Überwachungsdaten in eine separate Datenbank verschoben. Diese Datenbank muss eine MySQL-Datenbank sein und kann sich auf demselben MySQL-Server wie die Hauptdatenbank von Simplifier befinden, aber auch auf einem anderen MySQL-Server. In jedem Fall muss die Verbindung separat 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 – Reverse Proxy aktualisieren
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 gemeinsames Volume dient. Z.B. kannst du /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: Simplifier Standard Content aktualisieren
Laden Sie den neuesten Standard Content vom Marketplace herunter und importieren Sie ihn 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.
