Versionsabhängige Patch-Schritte

Die INUBIT Process Engine ist gestartet

Sie sind mit einer Workbench mit der Process Engine verbunden

Sie haben Zugriff auf das Repository

Die Process Engine wurde gestartet.

Sie sind in die Workbench mit einem System-Administrator eingeloggt.

Wechseln Sie auf den Reiter Repository.

Im Navigationsbaum wählen Sie folgenden Pfad aus: Global > System > Widgets.

Öffnen Sie das Kontextmenü auf dem Ordner Widgets mit einem Rechtsklick.

Wählen Sie die Aktion Update directory.

Das Verzeichnis und alle Unterverzeichnisse werden aktualisiert.

Im Anschluss sind die fehlenden Ordner und ihr Inhalt sichtbar.

Öffnen Sie die Datei jetty.xml

Finden Sie den Abschnitt mit der Beschriftung "Set Response Headers", der ungefähr so aussieht:

    <!-- ==================== -->
    <!-- Set Response Headers -->
    <!-- ==================== -->
    <Call name="insertHandler">
        <Arg>
            <New id="RewriteHandler" class="org.eclipse.jetty.rewrite.handler.RewriteHandler">
                <Set name="rules">
                    <Array type="org.eclipse.jetty.rewrite.handler.Rule">
                           ...
                    </Array>
                </Set>
            </New>
        </Arg>
    </Call>

Finden Sie das Item-Element "header-csp".

Ergänzen Sie im Element <Set name="value"> hinter script-src den Wert 'unsafe-inline'.

Das Item-Element sollte dann wie folgt aussehen:

<Item>
  <New id="header-csp" class="org.eclipse.jetty.rewrite.handler.HeaderPatternRule">
    <Set name="pattern">/*</Set>
    <Set name="name">Content-Security-Policy</Set>
    <Set name="value">script-src 'self' 'unsafe-eval' 'unsafe-inline'; connect-src 'self'; img-src 'self' data:; style-src 'self' 'unsafe-inline'; font-src 'self'; frame-ancestors 'self'; form-action 'self'; worker-src 'self' blob: ;</Set>
  </New>
</Item>

Speichern und schließen Sie die Datei

Jetzt können Sie das BPC/Karaf wieder starten

Stoppen Sie den BPC

Führen Sie das Patch-Installationsprogramm aus und aktualisieren Sie die BPC-Installation

Navigieren Sie zum Ordner <bpc_install_dir>/bpc.

Sichern Sie alle notwendigen Dateien und Ordner im Unterordner elasticsearch

Entfernen Sie das Unterverzeichnis elasticsearch

Starten Sie den BPC

Öffnen Sie in BPC die Registerkarte "Konfiguration der INUBIT WebApp-Module".

Wählen Sie die Modulinstanz aus, in der das Inline-JavaScript wieder aktiviert werden soll

Setzen Sie in der Konfiguration des jeweiligen Moduls die Eigenschaft "SanitizeHTML" auf den Wert false (Checkbox deselektieren).

Loggen Sie sich mit der Workbench auf der Process Engine ein

Wechseln Sie auf den Tab Administration > Allgemeine Einstellungen

Wählen Sie in der Baumstruktur links Portal > Portalserver aus

Überprüfen Sie den Wert für die Option "API Key für die BPC-Verbindung"

Sollte der Wert gefüllt sein, brauchen Sie nichts weiter zu tun

Sollte der Wert leer sein, fahren Sie hier fort

Klicken Sie rechts auf den "…​"-Button in der gleichen Tabellenzeile

Im sich öffnenden Dialog "API Key für die BPC-Verbindung" wählen Sie einen API-Key über das Dropdown aus oder klicken Sie auf den Button Neu

Sobald ein neuer API-Key angezeigt wird, schließen Sie den Dialog über Klick auf den Button OK

Klicken Sie in der Toolbar auf den Speichern Button → Der BPC API-Key ist nun gesetzt und auf der Process Engine entsprechend aktualisiert

Process Engine ist gestartet.

Sie sind als Systemadministrator mit einer Workbench angemeldet.

Wechseln Sie zur Registerkarte Repository

Wählen Sie im Navigationsbaum den folgenden Pfad: Global > System > Mapping Templates > IS Configuration

Öffnen Sie das Kontextmenü, indem Sie mit der rechten Maustaste auf den Ordner IS Configuration im Baum klicken

Klicken Sie auf die Aktion Verzeichnis aktualisieren

Melden Sie sich als System Administrator mit der INUBIT Workbench an.

Öffnen Sie im Burger-Menü Konfiguration > Systemdiagramme.

Öffnen Sie die Datei systemdiagram_config.xml.

Übernehmen Sie alle OAuth2-Properties aus der Datei <inubit-installdir>/inubit/server/ibis_root/conf/systemdiagram_config_template.xml.

Klicken Sie auf die Schaltfläche OK.

Starten Sie die INUBIT Process Engine neu

Stoppen Sie die Process Engine

Sichern Sie die H2-Datenbankdatei mit dem folgenden Kommando:

java -cp h2-<old-driver-version>.jar org.h2.tools.Script -url jdbc:h2:/<path-to-old-db-file>/<database-name> -user <username> -script backup.zip -options compression zip

Entfernen Sie die folgenden Dateien:

Führen Sie den Patch-Installer aus

Stellen Sie den gesicherten H2-Datenbankinhalt wieder her:

java -cp h2-<new-driver-version>.jar org.h2.tools.RunScript -url jdbc:h2:/<path-to-new-db-file>/<database-name> -user <username> -script backup.zip -options compression zip

Lesen Sie Keycloak Migration Guide, um mehr über die neuesten Migrationsänderungen zu erfahren.

Stoppen Sie den Keycloak-Server, falls dieser ausgeführt wird.

Lesen Sie Preparing for upgrading und führen Sie die beschriebenen Schritte aus.

Führen Sie den Virtimo Digitalization Suite Patch-Installer aus und aktualisieren Sie auf die neueste Keycloak-Version.

Lesen Sie Migrating the database und befolgen Sie die Schritte zur Datenbankmigration.

Lesen Sie die restlichen Abschnitte wie Migrate themes und befolgen Sie die Anweisungen.

Starten Sie den Keycloak-Server.

Melden Sie sich bei der Keycloak-Administratorkonsole an, navigieren Sie zu „Realm Settings“ und ändern Sie den Wert von "Unmanaged attribute" auf "Enabled".

Navigieren Sie zu "Authentication" und dann zur Registerkarte "Required Actions".

Ändern Sie den Wert von "Verify Profile" auf "off".

Stoppen Sie die Process Engine

Entfernen Sie die anbieterspezifische JMS JAR-Datei aus <inubit-installdir>/inubit/server/process_engine/webapps/ibis/WEB-INF/lib

Starten Sie die Process Engine

Stoppen Sie die Process Engine

Benennen Sie plugin.xml.bak in plugin.xml unter <inubit‑installdir>/server/ibis_root/conf> um.

Fügen Sie in die plugins.xml die Details zum JSON-Formatter-Plugin hinzu:

<Plugin>
    <Name>JSON Formatter</Name>
    <PluginGroup>Utilities</PluginGroup>
    <ClientJavaClass>de.virtimo.inubit.plugins.jsonformatter.JSONFormatterClient</ClientJavaClass>
    <ClientComment>JSON Formatter</ClientComment>
    <ServerJavaClass>de.virtimo.inubit.plugins.jsonformatter.JSONFormatter</ServerJavaClass>
    <ServerComment>JSON Formatter</ServerComment>
    <Image>icons/60x40.colored/json_formatter.svg</Image>
    <PluginComment/>
    <LastUpdateUser>root</LastUpdateUser>
    <LastUpdateTime>25.09.2024 10:00:00</LastUpdateTime>
</Plugin>

Benennen Sie die profile.xml.bak in profile.xml unter <inubit‑installdir>/server/ibis_root/conf> um.

Fügen Sie den folgenden Eintrag zu allen Profilen hinzu, die dieses Plugin benötigen:

<Use>JSON Formatter</Use>

Speichern Sie alle Änderungen

Starten Sie die Process Engine

Stoppen Sie die Process Engine

Ändern Sie den folgenden Eintrag in <inubit-installdir>/inubit/server/ibis_root/log/log4j2.properties und geben Sie den absoluten Pfad zum Zielordner an, in dem die Datei as4gateway.log erstellt werden soll:

# Log ins <inubit-installdir>/inubit/server/ibis_root/log
property.basePath=${env:CATALINA_BASE}/../ibis_root/log

Speichern Sie alle Änderungen

Starten Sie die Process Engine