Versionsabhängige Patch-Schritte

Um auf die gewünschte Version zu aktualisieren, müssen Sie aus der folgenden Liste alle zutreffenden Patch-Schritte ausführen, deren Patch-Level höher als das aktuelle Patch-Level und niedriger oder gleich der Zielversion ist.

Möchten Sie z.B. auf die Zielversion 9.0.18 aktualisieren und ihre aktuelle Version ist 9.0.3, müssen Sie alle Schritte von der Patch-Version 9.0.4 bis einschließlich zur Patch-Version 9.0.18 ausführen.

Falls ein Patch-Schritt mehrfach auftaucht, müssen Sie diesen nur einmalig ausführen (z.B. Tomcat-Updates).

Aufbau der Liste

Patch Version

Patch-Version, der eine manuelle Aktion zum Patchen benötigt. Patchen ist notwendig, wenn Sie von einer niedrigeren Version zur angegebenen oder einer höheren Version patchen.
Voraussetzungen

Bedingungen, die gegeben sein müssen, damit Sie den Patch-Schritt manuell ausführen müssen.
Aktion/So gehen Sie vor

Aktion(en), die ausgeführt werden muss/müssen.

9.0.0

Es sind nur Standard Patch-Schritte erforderlich.

9.0.1

Es sind nur Standard Patch-Schritte erforderlich.

9.0.2

Es sind nur Standard Patch-Schritte erforderlich.

9.0.3

Es sind nur Standard Patch-Schritte erforderlich.

9.0.4

Es sind nur Standard Patch-Schritte erforderlich.

9.0.5

Es sind nur Standard Patch-Schritte erforderlich.

9.0.6

Es sind nur Standard Patch-Schritte erforderlich.

9.0.7

Neue Leaky-Bucket Einstellungen

Verwendung

Die in der Process Engine eingestellte Fehlertoleranz bestimmt, wie schnell die Process Engine sich bei Datenbankverbindungsproblemen herunterfährt.

Die bisherigen Einstellungen führten zu einem Herunterfahren schon bei wenigen Verbindungsabbrüchen. Daher wurden die Default-Einstellungen nun überarbeitet und so gestaltet, dass mehr Verbindungsabbrüche toleriert werden.

So gehen Sie vor

Kopieren Sie die Einstellung aus der vom Patch-Installer erstellten Datei ibis.xml_patch in ihre ibis.xml.

Neue Werte

Alte Werte

Betrifft:

Application - Process Engine

Datenbank-Deadlocks vermeiden

Dieser Patch-Schritt ist optional. Wir empfehlen jedoch dringend, ihn durchzuführen, bevor Sie die Process Engine starten.

Voraussetzungen

Für die regelmäßige Datenbankbereinigung wurde mit INUBIT-22257 eine Batch-Verarbeitung eingeführt. Die Größe des Batches lässt sich konfigurieren, indem die entsprechende Einstellung in die aktuell verwendete Datei logsDBConfig.xml eingefügt wird.

Gehen Sie wie folgt vor

Stoppen Sie die Process Engine (falls noch nicht geschehen).
Öffnen Sie die Datei <inubit-installdir>/inubit/server/ibis_root/conf/logsDBConfig.xml (ggf. logsDBConfig.xml.bak).

Fügen Sie den folgenden Abschnitt innerhalb des Elements <dataEntriesLimit> ein:

<dataEntriesLimit>
        ...
<!-- Chunk-Größe für die Batch-Löschung, um Sperrkonflikte (Lock Contention) bei großen
        DELETE-Operationen zu vermeiden.
        Die Zeilen werden in Teilmengen (Chunks) gelöscht, wobei Zwischen-Commits erfolgen, um
        Sperren freizugeben und gleichzeitige INSERT-Operationen zu ermöglichen.
        Standardwert: 5000 Zeilen pro Chunk
        Tuning: Erhöhen Sie den Wert bei großen Tabellen mit seltenen Löschvorgängen; verringern
        Sie ihn, falls Sperrkonflikte weiterhin auftreten.
        -->
        <batchDeleteChunkSize>5000</batchDeleteChunkSize>
</dataEntriesLimit>

Speichern Sie die Änderungen als Datei logsDBConfig.xml.
Starten Sie die Process Engine.

Betrifft:

Application - Process Engine

Neue Funktion von Keycloak nutzen

Dieser Patch-Schritt ist optional.

Voraussetzungen

Keycloak wurde auf Version 26.6.1 aktualisiert.

Vorgehensweise

Öffnen Sie die Datei <inubit-installdir>/inubit/server/ibis_root/conf/keycloak_template.json.

Fügen Sie den folgenden Abschnitt innerhalb des Elements "documentation": zwischen admin-group-priority und client-ids ein:

"group-description": "If added, fetches the Keycloak group descriptions alongside the group names. If not added, group descriptions are ignored.",

Speichern Sie die Änderungen als Datei keycloak_template.json.

Betrifft:

Application - Installer
Application - Process Engine
Component - User Manager

Virtimo Cluster Manager Update

Mit dieser INUBIT Version wird der Cluster Manager aktualisiert mit der in den Changelogs beschriebenen Verhaltensänderung.

Voraussetzungen

Sie setzen den Virtimo Cluster Manager. Die Patch-Installation wurde noch nicht durchgeführt.

Aktion vor Ausführung des Patch-Installers

Öffnen Sie auf allen Cluster-Knoten deren Konfiguration unter <SUITE-INSTALL-DIR>/inubit/server/ibis_root/conf/clustermanager/virtimo_cluster_config.xml.
Stellen Sie sicher, dass es nur 1 Knoten mit dem höchsten Wert für die Priorität gibt:
```
<properties>
  ...
  <priority>...</priority>
  ...
</properties>
```
Speichern Sie die Änderungen
Aktualisieren Sie den Knoten mit der höchsten Prio zuerst
Fahren Sie diesen Knoten hoch, so dass er dem Cluster wieder beitritt
Aktualisieren Sie nun die restlichen Clusterknoten (einem nach dem anderen)
Anschließend können Sie die vorherige Priotätskonfiguration wieder herstellen

Betrifft:

Application - Cluster Manager