Versionsabhängige Patch-Schritte

Geben Sie im Quellsystem den folgenden Befehl ein, um den CLI-Modus zu starten:

Geben Sie das root-Passwort ein.

Wechseln Sie zum cache mode: CLI|root@HOSTNAME>cachemode

Führen Sie den folgenden Befehl aus, um die aliases Informationen zu erhalten:

CACHE|root@HOSTNAME>get PASSWORD_DATA “Alias_name“ /Path/to/XML_file_to_save/aliases.xml

Erstellen Sie die XML-Datei password_manager.xml

Kopieren Sie den Inhalt der Datei aliases.xml in den Tag IBISPasswordManager der Datei password_manager.xml.

<?xml version="1.0" encoding="UTF-8"?>
<IBISPasswordManager>
    <IBISAlias version="3.2">
        <Attrib>
            <Name>AliasName</Name>
            <Value>Tomcat</Value>
        </Attrib>
        <Attrib>
            <Name>Password</Name>
            <Value>AES-RGSLnzag0+JntHrcQ16ovg==</Value>
        </Attrib>
        <Attrib>
            <Name>UserName</Name>
            <Value>root</Value>
        </Attrib>
    </IBISAlias>
</IBISPasswordManager>

Fügen Sie die Datei password_manager.xml in den Ordner /conf des Sicherungsarchivs ein.

Öffnen Sie das Register Repository.

Navigieren Sie zu dem Global > System > Widgets-Verzeichnis.

Klicken Sie mit der rechten Maustaste auf das Widgets-Verzeichnis.

Wählen Sie aus dem Kontextmenü den Menüpunkt Verzeichnis aktualisieren.

Öffnen Sie das Register Repository.

Navigieren Sie zu dem Global > System > Widgets-Verzeichnis.

Klicken Sie mit der rechten Maustaste auf das Widgets-Verzeichnis.

Wählen Sie aus dem Kontextmenü den Menüpunkt Verzeichnis aktualisieren.

Melden Sie sich bei der INUBIT Workbench als root an.

Öffnen Sie Konfiguration > Deployment.

Öffnen Sie die Datei ibis_deploy.xml.

Kopieren Sie die gewünschten OAuth2-Eigenschaften abhängig von den Modulen oder Systemkonnektoren, die in der Datei ibis_deploy_template.xml hinzugefügt oder aktualisiert wurden.

Klicken Sie auf den Button OK.

Starten Sie die INUBIT Process Engine erneut.

Kopieren Sie die Datei <inubit-installdir>/inubit/server/ibis_root/conf/ibis_deploy_template.xml.

Benennen Sie die Datei in ibis_deploy.xml um.

Entfernen Sie die Datei ibis_deploy.xml.bak.

Starten Sie die INUBIT Process Engine erneut.

Melden Sie sich als Administrator in der INUBIT Workbench an.

Gehen Sie zu Administration > Allgemeine Einstellungen > Portal > Portal Deployment

Öffnen Sie die Option Tasklisten auf dem Portal

Falls Sie die Standard Tasklist nutzen, deployen Sie die Tasklist erneut.

Falls Sie eine eigene Kopie der Tasklist verwenden:

Öffnen Sie die Datei ibis.xml im Verzeichnis <inubit-installdir>/inubit/server/ibis_root/conf.

Ändern Sie die Standardwerte für die Properties CheckValidConnection, noOfRetries und retryInterval.

Speichern Sie Datei ibis.xml im Verzeichnis <inubit-installdir>/inubit/server/ibis_root/conf.

Öffnen Sie die Datei logsDBConfig.xml im Verzeichnis <inubit-installdir>/inubit/server/ibis_root/conf.

Ändern Sie die Standardwerte für die Properties CheckValidConnection, noOfRetries und retryInterval.

Speichern Sie Datei logsDBConfig.xml im Verzeichnis <inubit-installdir>/inubit/server/ibis_root/conf.

Falls der Remote Connector als Service installiert ist und der Patch dafür angewendet wird, stoppen Sie den Remote Connector Service.

Gehen Sie zum Ordner <inubit-installdir>/inubit/remoteConnector/bin.

Falls eine kundenspezifische Konfiguration besteht, benennen Sie die vorhandenen Dateien *.[bat|cmd|sh] nach *_original.[bat|cmd|sh] um, damit Sie ein Backup Ihrer Konfiguration haben.

Benennen Sie die Dateien _patch.[bat|cmd|sh] nach .[bat|cmd|sh] um.

Falls eine kundenspezifische Konfiguration besteht, vergleichen und führen Sie die Dateien _original.[bat|cmd|sh] und .[bat|cmd|sh] zusammen.

Falls nach der Patch-Installation Backup-Dateien _backup.[bat|cmd|sh] erstellt wurden, vergleichen und führen Sie die Dateien *_backup.[bat|cmd|sh] und .[bat|cmd|sh] zusammen.

Falls der Remote Connector als Service installiert ist der Patch dafür angewendet wird,:

Falls die Process Engine als Service installiert ist und der Patch dafür angewendet wird, stoppen Sie den Process Engine Service.

Gehen Sie zum Ordner <inubit-installdir>/inubit/bin.

Falls eine kundenspezifische Konfiguration besteht, benennen Sie die vorhandenen Dateien *.[bat|cmd|sh] nach *_original.[bat|cmd|sh] um, damit Sie ein Backup Ihrer Konfiguration haben.

Benennen Sie die Dateien _patch.[bat|cmd|sh] nach .[bat|cmd|sh] um.

Falls eine kundenspezifische Konfiguration besteht, vergleichen und führen Sie die Dateien _original.[bat|cmd|sh] und .[bat|cmd|sh] zusammen.

Falls die Process Engine als Service installiert ist der Patch dafür angewendet wird,:

Öffnen Sie das Register Repository.

Navigieren Sie zu dem Global > System > Widgets-Verzeichnis.

Klicken Sie mit der rechten Maustaste auf das Widgets-Verzeichnis.

Wählen Sie aus dem Kontextmenü den Menüpunkt Verzeichnis aktualisieren.

Öffnen Sie die Datei <inubit-installdir>/inubit/server/process_engine/bin/setenv.[bat|sh] zum Editieren.

Löschen Sie die -D JVM-Parameter-Einstellungen für JSch. Beispiel: set JVM_PARAMS=%JVM_PARAMS% -DJSch.kex=diffie-group14-sha1

Speichern Sie die Datei setenv.[bat|sh].

Legen Sie ein Backup von setenv.[sh/bat] aus <inubit-installdir>/inubit/server/process_engine/bin an.

Benennen Sie setenv.[sh/bat] in setenv_backup.[sh/bat] um.

Benennen Sie setenv_patch.[sh, bat] in setenv.[sh/bat] um.

Falls Sie die existierende setenv_backup.[sh/bat] geändert haben, passen Sie setenv.[sh/bat] entsprechend an.

Legen Sie ein Backup von start_workbench.[sh/bat] aus <inubit-installdir>/inubit/client/bin und <inubit-installdir>/inubit/bin an.

Benennen Sie start_workbench.[sh/bat] in start_workbench_backup.[sh/bat] um.

Benennen Sie start_workbench_patch.[sh/bat] in start_workbench.[sh/bat] um.

Falls Sie die existierende start_workbench_backup.[sh/bat] geändert haben, passen Sie start_workbench.[sh/bat] entsprechend an.

Legen Sie ein Backup von start_rc.[sh/bat] aus <inubit-installdir>/inubit/remoteConnector/bin an.

Benennen Sie start_rc.[sh/bat] in start_rc_backup.[sh/bat] um.

Benennen Sie start_rc_patch.[sh/bat] in start_rc.[sh/bat] um.

Falls Sie die existierende start_rc_backup.[sh/bat] geändert haben, passen Sie start_rc.[sh/bat] entsprechend an.

Öffnen Sie die Datei <inubit-installdir>/inubit/server/ibis_root/conf/repository.xml zum Bearbeiten.

Gehen Sie zum Eintrag:

<Workspace name="${wsp.name}">
    <FileSystem class="org.apache.jackrabbit.core.fs.local.LocalFileSystem">
        <param name="path" value="${wsp.name}"/>
    </FileSystem>

Ändern Sie param value zu:

Öffnen Sie die Dateien workspace.xml in den beiden Verzeichnissen zum Bearbeiten:

Gehen Sie zum Eintrag:

<FileSystem class="org.apache.jackrabbit.core.fs.local.LocalFileSystem">
    <param name="path" value="${wsp.name}"/>
</FileSystem>

Ändern Sie param value zu:

Löschen Sie die zuvor erstellten leeren Verzeichnisse, die nach den obigen Änderungen nicht mehr benötigt werden:

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.

Sobald alle oben genannten Schritte abgeschlossen sind, 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