Upgrade von MC 25-01 auf MC 25-03

Einleitung

Diese Dokumentation ist in 2 Teile unterteilt:

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-03 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-03, 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.2501

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.

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

SIMPLIFIER_HOSTNAME	Simplifier Hostname, FQDN, ohne Protokoll. Um auf Simplifer zuzugreifen, muss https://${SIMPLIFIER_HOSTNAME} verwendet werden
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)
DB_PASSWORD	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-/Moduldatenbanken verwendet.
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.
INSTANCE_PREFIX	Präfix für alle Container. Sollte dem Instanztyp dieser Umgebung ähneln. Typische Werte sind: dev, qa, prod
PUBLIC_PORT_HTTP	Öffentlicher Port für die HTTP-Route. Standardwert 80.
PUBLIC_PORT_HTTPS	Öffentlicher Port für HTTPS-Route. Standardwert 443.
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_TIME	Zu welcher Zeit soll der Workflow-Archivierungsauftrag ausgeführt werden? Format: hh:mm
WF_ARCHIVE_INTERVAL	Veraltet. Verwenden Sie dies nicht.
WF_ARCHIVE_MAX_AGE_COMPLETED	Veraltet. Verwenden Sie dies nicht.
WF_DT_JVM_HEAP_GB	Wie viel Heap-Speicherplatz für Workflow-Entwurfszeit in GB
LAUNCHPAD_JVM_HEAP_GB	Wie viel Heap-Speicherplatz für Launchpad in GB
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)
TRACKING_BEHAVIOR	Standard: Zustimmung – jeder Benutzer wird um Zustimmung gebeten. Ein – Das Tracking wird aktiviert, ohne dass eine Einwilligung eingeholt wird. Aus – Tracking ist deaktiviert

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 25-03 durchzuführen, schließen Sie Simplifer und ändern Sie den Namen des Container-Images von

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

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

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