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).

Stoppen Sie die Process Engine

Öffnen Sie <inubit-installdir>/inubit/server/ibis_root/conf/patchLogsDB.xml

Navigieren Sie zu dem Abschnitt, der Ihre konfigurierte Datenbankvariante widerspiegelt

Wenden Sie alle SQL-Anweisungen an

Starten Sie die Process Engine

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

Loggen Sie sich mit einem System Administrator Account an der Workbench ein

Öffnen Sie das Burger Menü > Konfiguration > Partnermanagement…​+ Der Konfiguration-Editor öffnet sich

Navigieren Sie im Baum zu "Config/Protocols"

Suchen Sie nach den Protocol-Knoten, mit dem Namen "AS4"+ Es existiert ein Knoten für "inbound" und ein Knoten für "outbound"

Öffnen Sie beide Knoten und fügen Sie unterhalb des Properties-Knoten folgendes hinzu:

<Property name="IsCPALookupDynamic" displayName="AS4IsCPALookupDynamic" type="Boolean">true</Property>
<Property name="AS4CPAFileContent" displayName="AS4CPAFileContentTitle"/>

Schließen Sie den Editor mit "OK"+ Die Änderungen werden gespeichert und Sie können jetzt im Partnermanagement diese Properties mit den entsprechenden Werten belegen.

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 Workbench

Lokalisieren Sie in der Process Engine die Datei <inubit-installdir>/inubit/server/process_engine/webapps/ibis/WEB-INF/lib/plugin-utility-jsonformatter.jar

Legen Sie diese Datei in Ihrer Worbench-Installation ab unter <workbench-installdir>/inubit/client/lib/ext

Starten Sie die Workbench

Stoppen Sie die Process Engine

Ändern Sie den folgenden Eintrag in <inubit-installdir>/inubit/server/ibis_root/conf/as4/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

Erforderlichen Skripte einrichten

Dienst installieren

Beenden Sie die Process Engine (falls noch nicht geschehen).

Öffnen Sie die Datei logsDBConfig.xml.

Fügen Sie abhängig von Ihrer verwendeten Datenbank den folgenden Abschnitt unterhalb des <tables>-Elements hinzu:

<workFlowErrorData tableName="inubitWorkflowErrorData">
    <statements>
        <createTable>CREATE TABLE inubitWorkflowErrorData(is_id BIGINT NOT NULL
            AUTO_INCREMENT,is_server VARCHAR(256),is_serverId VARCHAR(256),is_dateTime
            BIGINT,is_workflowName VARCHAR(256),is_moduleName VARCHAR(256),is_IsErrorKey
            VARCHAR(256),is_IsErrorString VARCHAR(1024),is_errorMailContent
            VARCHAR(1024),is_processId VARCHAR(255),PRIMARY KEY(is_id))
        </createTable>
    </statements>
</workFlowErrorData>

<workFlowErrorData tableName="inubitWorkflowErrorData">
    <statements>
        <createTable>CREATE TABLE inubitWorkflowErrorData(is_id NUMBER GENERATED BY DEFAULT AS
            IDENTITY PRIMARY KEY,is_server VARCHAR2(50),is_serverId VARCHAR2(255),is_dateTime
            NUMBER(19),is_workflowName VARCHAR2(255),is_moduleName VARCHAR2(255),is_IsErrorKey
            VARCHAR2(255),is_IsErrorString VARCHAR2(1024),is_errorMailContent
            VARCHAR2(1024),is_processId VARCHAR2(255))
        </createTable>
    </statements>
</workFlowErrorData>

<workFlowErrorData tableName="inubitWorkflowErrorData">
    <statements>
        <createTable>CREATE TABLE inubitWorkflowErrorData (is_id SERIAL PRIMARY KEY, is_server
            varchar(50), is_serverId varchar(255), is_dateTime BIGINT, is_workflowName varchar(255),
            is_moduleName varchar(255), is_IsErrorKey varchar(255), is_IsErrorString
            varchar(1024),is_errorMailContent varchar(1024),is_processId varchar(255))
        </createTable>
    </statements>
</workFlowErrorData>

<workFlowErrorData tableName="inubitWorkflowErrorData">
    <statements>
        <createTable>CREATE TABLE inubitWorkflowErrorData (is_id BIGINT NOT NULL GENERATED ALWAYS AS
            IDENTITY (START WITH 1 INCREMENT BY 1), is_server VARCHAR(256), is_serverId
            VARCHAR(256), is_dateTime BIGINT, is_workflowName VARCHAR(256), is_moduleName
            VARCHAR(256), is_IsErrorKey VARCHAR(256), is_IsErrorString
            VARCHAR(1024),is_errorMailContent VARCHAR(1024),is_processId VARCHAR(255), PRIMARY KEY
            (is_id))
        </createTable>
    </statements>
</workFlowErrorData>

<workFlowErrorData tableName="inubitWorkflowErrorData">
    <statements>
        <createTable>CREATE TABLE inubitWorkflowErrorData (is_id BIGINT AUTO_INCREMENT PRIMARY KEY,
            is_server VARCHAR(256), is_serverId VARCHAR(256), is_dateTime BIGINT, is_workflowName
            VARCHAR(256), is_moduleName VARCHAR(256), is_IsErrorKey VARCHAR(256), is_IsErrorString
            VARCHAR(1024),is_errorMailContent VARCHAR(1024),is_processId VARCHAR(255))
        </createTable>
    </statements>
</workFlowErrorData>

<workFlowErrorData tableName="inubitWorkflowErrorData">
    <statements>
        <createTable>CREATE TABLE inubitWorkflowErrorData (is_id BIGINT NOT NULL AUTO_INCREMENT,
            is_server VARCHAR(256), is_serverId VARCHAR(256), is_dateTime BIGINT, is_workflowName
            VARCHAR(256), is_moduleName VARCHAR(256), is_IsErrorKey VARCHAR(256), is_IsErrorString
            VARCHAR(1024),is_errorMailContent VARCHAR(1024),is_processId VARCHAR(255), PRIMARY KEY
            (is_id))
        </createTable>
    </statements>
</workFlowErrorData>

<workFlowErrorData tableName="inubitWorkflowErrorData">
    <statements>
        <createTable>CREATE TABLE inubitWorkflowErrorData (is_id BIGINT NOT NULL IDENTITY(1,1),
            is_server VARCHAR(256), is_serverId VARCHAR(256), is_dateTime BIGINT, is_workflowName
            VARCHAR(256), is_moduleName VARCHAR(256), is_IsErrorKey VARCHAR(256), is_IsErrorString
            VARCHAR(1024),is_errorMailContent VARCHAR(1024),is_processId VARCHAR(255), PRIMARY KEY
            (is_id))
        </createTable>
    </statements>
</workFlowErrorData>

Speichern Sie die Änderungen in der Datei logsDBConfig.xml.

Starten Sie die Process Engine