Upgrade von MC 24-11 auf MC 25-01

Einleitung

Diese Dokumentation gliedert sich in 2 Teile:

Teil 1 beschreibt das eigentliche Update der Container und gibt es in zwei Varianten
- Option 1, falls Sie unser empfohlenes Docker Compose-Setup verwenden.
- Option 2 für den Fall, dass Sie ein benutzerdefiniertes Setup haben. Er beschreibt die relevanten Änderungen, die mit dem Simplifier MAKERS CHOICE 25-01 einhergehen, in allgemeiner Weise.
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 MAKERS CHOICE 25-01, bevor Sie mit dem Upgrade Ihrer Instanz beginnen.

Teil 1: Upgrade von Simplifier

Option 1: Upgrade mit dem standardmäßigen Docker Compose

Schritt 1 – Herunterfahren der Simplifier-Instanz

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

cd docker-compose

Um Simplifier zu stoppen, führen Sie

docker compose down

Schritt 2 – Abrufen der Simplifier-Setup-Dateien

Hinweis: Wenn Sie docker-compose.yml geändert haben, erstellen Sie eine Sicherungskopie der docker-compose.yml und fügen Sie Ihre Änderungen der neuen Version hinzu.

Sie könnten und

git stash pop

dafür verwenden.

git stash

So erstellen Sie eine Kopie und machen Ihre Änderungen rückgängig:

git stash
git restore docker-compose.yml

Aktualisieren Sie den Inhalt, und wechseln Sie zum neuen Release-Zweig:

git pull
git checkout --track origin/release/MC

Schritt 3: .env aktualisieren

Erstellen Sie eine Kopie Ihrer .env-Datei

cp .env .env.2411

Kopieren Sie die Vorlage als neue .env-Datei.

cp .env.template .env

Bearbeiten der neuen .env-Datei

nano .env

Sie müssen die ersten 4 Einträge an Ihre Bedürfnisse anpassen:

# these 4 variables need to be changed
SIMPLIFIER_HOSTNAME=example.simplifier.cloud
INITIAL_ADMIN_PASSWORD=MyAdminSecret12
DB_PASSWORD=MySecret123
DB_ROOT_PASSWORD=MySuperSecret

Es wird empfohlen, diese Werte auf die Werte festzulegen, die Sie in Ihrer vorherigen .env-Datei verwendet haben. DB-Passwörter werden nicht automatisch geändert, wenn Sie sie hier ändern.

Aufmerksamkeit: Das Anfangspasswort des Benutzers ‘admin’ wird ebenfalls geändert, wenn es noch auf ‘admin’ gesetzt ist und nie geändert wurde. Weitere Informationen finden Sie in der Variablenliste unten.

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

Umgebungsvariable	Beschreibung
SIMPLIFIER_HOSTNAME	Simplifier Hostname, FQDN, ohne Protokoll. Um auf Simplifer zugreifen zu können, muss https://${SIMPLIFIER_HOSTNAME} verwendet werden
DB_PASSWORD	Passwort für die MySQL-Datenbank
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-/Moduldatenbanken verwendet.
INITIAL_ADMIN_PASSWORD	Initiales Passwort für den Benutzeradministrator. Wenn das Admin-Konto existiert und sein Passwort nie geändert wurde, muss die Umgebungsvariable INITIAL_ADMIN_PASSWORD gesetzt werden, andernfalls stoppt Simplifier den Bootvorgang und protokolliert eine Nachricht, in der die Variable erwähnt wird. Die Variable wird ignoriert, wenn das Passwort für admin geändert wurde (auch wenn es wieder auf den Standardwert zurückgesetzt wurde)
SIMPLIFIER_VERSION	Version von Simplifier, die Sie installieren möchten. Daran sollten Sie nichts ändern. Wenn Sie eine andere Simplifier-Version haben möchten, schauen Sie sich bitte stattdessen den entsprechenden Zweig an
HOST_DATA_PATH	Pfad, in dem alle Daten auf dem Host gespeichert sind.
PLUGIN-LISTE	Liste aller Plugins, die gestartet werden sollen. Technisch gesehen handelt es sich bei der Workflow Engine nicht um ein Plugin, daher wird sie hier nicht erwähnt
SIMPLIFIER_JVM_HEAP_GB	Wie viel Heap-Speicherplatz für Simplier App Server in GB
TZ	Zeitzone. Wird 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 zum Herstellen einer Verbindung mit dem Debugger verwendet wird. Dieser Port muss in Ihrem Firewall-Setup geöffnet sein. (Weiterlesen)
PDFPLUGIN_SECURITY_ALLOW_JAVASCRIPT	Sollte die Ausführung von Javascript in PDF-Vorlagen erlaubt sein? (Weiterlesen)
DYNAMIC_TAB_TITLES_ENABLED	Sollen die dynamischen Tab-Icons und Tab-Titel aktiviert werden? (Weiterlesen)

Schritt 4

Starten Sie den Simplifier

docker compose up -d

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

Um ein Upgrade auf Simplifier MAKERS CHOICE 24-11 durchzuführen, schließen Sie Simplifer und ändern Sie den Namen des Container-Images von

simplifierag/simplifier:2411
simplifierag/launchpad:2411
simplifierag/workflow-designtime:2411
simplifierag/workflow-runtime:2411

simplifierag/simplifier:2501
simplifierag/launchpad:2501
simplifierag/workflow-designtime:2501
simplifierag/workflow-runtime:2501

Sie müssen die Umgebungsvariable ‘INITIAL_ADMIN_PASSWORD’ setzen, sonst wird der Bootvorgang gestoppt, wenn der Admin-Benutzer noch das alte Standardpasswort hat

Teil 2: Vorgehensweisen nach dem Upgrade

Schritt 1: Aktualisieren des Simplifier-Standardinhalts

Laden Sie die neuesten Standardinhalte aus dem Marketplace herunter und importieren Sie sie in Ihre Simplifier-Instanz. Stellen Sie sicher, dass Sie die Importszenarien ‘Alle überschreiben’ oder ‘Unverändert überspringen’ (empfohlen) verwenden.

Schritt 2: Versionshinweise und Migrationshinweise

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

Aktueller Release