Administrations-Changelog

Diese Seite zeigt Änderungen, die in den Releases der einzelnen Versionen enthalten sind und explizit für Administratoren relevant sind. Als Administrator werden Personen angesehen, die Updates am BPC durchführen und administrative Konfiguration im BPC durchführen.

Für die Auflistung aller Änderungen siehe Changelog.

BPC 4.2.7

Release Datum: 2024-12-16

Mit diesem Update müssen folgende Komponenten aktualisiert werden: BPC Module | OpenSearch Plugin

Neue Funktionen

Verbesserungen

  • OpenSearch Einstellung zum verschieben von Shards auf andere Nodes bei geringem Plattenplatz BPC-9011

    Unterschreitet der freie Plattenplatz definierte Schwellwerte, so werden Shards auf andere Knoten verteilt. Es kann auch vorkommen, dass Indices auf read-only gesetzt werden, um ein voll laufen der Platte zu vermeiden.

    Betrifft: OpenSearch

  • Felder mit dem Typ "object" und "flat_object" sollen durch die Standardkonfiguration im Monitor korrekt dargestellt werden BPC-9144

    Felder die geschachtelte JSON Objekte enthalten, erhalten in der initialen Spaltkonfiguration "formatter" : "jsonStringify". Dadurch werden die Inhalte in Text überführt und im Monitor dargestellt.

    Betrifft: Process Monitoring

Bugs

  • Neu Verteilung von Replikationen im Cluster wird nicht immer ausgelöst BPC-8504

    Es wurde ein Fehler behoben, der dazu führte, dass bei Änderungen der Knoten im BPC Cluster, die einzelnen Replikationsjobs nicht korrekt auf alle verfügbaren Knoten aufgeteilt wurden.

    Betrifft: OpenSearch

  • OpenSearch kann nicht per HTTP angesprochen werden BPC-8800

    Obwohl für die OpenSearch Verbindung mit http konfiguriert wurde, wurden Versucht den TLS Kontext anhand der Konfiguration herzustellen. Wenn diese Konfiguration jedoch nicht korrekt war, dann kam es zu einem Fehler.

    Die Konfiguration wird nun ignoriert, da diese bei http Verbindungen nicht relevant sind.

    Dennoch wird empfohlen an dieser Stelle gesicherte Verbindungen zu nutzen.

    Betrifft: BPC Core

  • Replikation und Tail Sync sorgen für inkonsistenten Datenbestand BPC-9088

    Es gab diverse Probleme, wenn in der Datenbanktabelle die Zeitzone der "Letzte Aktualisierungsspalte" auf UTC gesetzt ist: - Der Tail Sync löschte nicht immer alle Sätze. - Stattdessen aktualisierte er bei jedem Durchlauf alle Sätze. - Das Zusammenspiel mit der Replikation kam ebenfalls durcheinander.

    Betrifft: BPC Core

  • BPC prometheus Metrik bpc_module exportiert falsche Versionsinfos BPC-9119

    Betrifft: BPC Core

Dokumentation

BPC 4.2.6

Release Datum: 2024-11-18

Mit diesem Update müssen folgende Komponenten aktualisiert werden: BPC Module | OpenSearch | OpenSearch Plugin | Java

Sie sollten die Beschreibungen in diesem Abschnitt genau lesen. Es handelt sich um empfohlene Handlungsanweisungen, die bei einem Update angeraten werden.

Neue Funktionen

Verbesserungen

  • Unnötige Fehlerlogs mit MaintenanceModeEnabledException BPC-8784

    Betrifft: BPC Core

Bugs

  • Beim Imitieren wird die Sprache des imitierenden Nutzers im imitierten Nutzer gespeichert BPC-8864

    Beim imitieren anderer Benutzer kann die Sprache nicht mehr im Keycloak Profil des imitierten Users verändert werden. Damit dies funktioniert, muss im Keycloak korrekt konfiguriert werden, dass Impersonator Informationen über einen aktiven Scope mitgegeben werden.

    Betrifft: BPC Core

  • Auswahlmöglichkeit zum Ändern der Sprache wird nicht angezeigt BPC-9012

Interne Abhängigkeiten / Dependency Updates

Sonstiges

  • Update Java BPC-9016

    Betrifft:

BPC 4.2.5

Release Datum: 2024-10-18

Mit diesem Update müssen folgende Komponenten aktualisiert werden: BPC Module | Java

Breaking Changes

Sie sollten die Beschreibungen in diesem Abschnitt genau lesen. Es können Handlungsanweisungen enthalten sein, die Sie für ein Update befolgen müssen.

  • Integration von Keycloak Seiten BPC-8679

    Es wurde versehentlich ein BreakingChange verursacht. Das User Account Plugin zeigt nun trotz aktivierter Option "changeLanguage" die Sprachauswahl nicht mehr an. Die Option musst nun "languageSelector" heißen.

    Sollte Sie auf das BPC 4.2.6 oder neuer aktualisieren, dann wird die Option automatisch umbenannt.

    Siehe auch User Account Menu

  • Benutzerverwaltung über den aktuellen User BPC-8680

    Bei der Konfiguration des Identity Providers vom Typ Keycloak entfällt die Konfiguration eines dediziertes Admin-Users. Alle Aktionen im integrierten Benutzermanagements werden nun im Kontext des aktuellen Benutzers durchgeführt. Dies bedeutet, dass diese Benutzer im Keycloak mit allen nötigen Rollen ausgestattet werden müssen. Durch diese Anpassung können im Auditlog des Keycloaks auch korrekt Aktionen den einzelnen Benutzern zugeordnet werden. Siehe dazu auch für Keycloak als Identity Provider.

    Durch diese Änderung wird nun die maximal gültige Sessionlaufzeit im BPC nicht mehr durch die enstprechende Einstellung im Keycloak beeinflusst. Diese muss nun in der Datei de.virtimo.bpc.core.cfg unter der Einstellung de.virtimo.bpc.core.auth.oidc.sessionExpirationMinutes gesetzt werden. Der Standardwert beträgt umgerechnet 8 Stunden. Ist die Laufzeit im Keycloak kürzer, so wird der Sessionchecker im BPC die Sesssion ebenfalls beenden. Hier kann es jedoch zu einer Verzögerung kommen, wenn für den User noch ein AccessToken vorliegt, der nicht abgelaufen ist.

    Außerdem blockiert das BPC selbst nicht mehr das Impersonieren von Usern mit der Rolle "bpcadmin". Dies muss nun im Keycloak konfiguriert werden und ist unter Imitieren von Benutzern mit Keycloak beschrieben.

    Es ist nun möglich über die integrierte Benutzerverwaltung im Keycloak neue Benutzer anzulegen oder von bestehenden Benutzern Name, E-Mail und Passwort zu ändern.

    Betrifft: BPC Core | Dokumentation

Neue Funktionen

  • LocalStorage soll beim BPC Update automatisch verworfen werden BPC-6268

    Beim Laden des BPCs wird die Versionsnummer des Core-Common-Packages (Fe-Core) ermittelt und im Local Storage hinterlegt. Weicht diese Versionsnummer von derjenigen ab, die beim vorherigen Ladevorgang gespeichert wurde, wird der Local Storage zurückgesetzt.

    Betrifft: BPC Core

  • Integration von Keycloak Seiten BPC-8679

    Es wurde versehentlich ein BreakingChange verursacht. Das User Account Plugin zeigt nun trotz aktivierter Option "changeLanguage" die Sprachauswahl nicht mehr an. Die Option musst nun "languageSelector" heißen.

    Sollte Sie auf das BPC 4.2.6 oder neuer aktualisieren, dann wird die Option automatisch umbenannt.

    Siehe auch User Account Menu

  • Benutzerverwaltung über den aktuellen User BPC-8680

    Bei der Konfiguration des Identity Providers vom Typ Keycloak entfällt die Konfiguration eines dediziertes Admin-Users. Alle Aktionen im integrierten Benutzermanagements werden nun im Kontext des aktuellen Benutzers durchgeführt. Dies bedeutet, dass diese Benutzer im Keycloak mit allen nötigen Rollen ausgestattet werden müssen. Durch diese Anpassung können im Auditlog des Keycloaks auch korrekt Aktionen den einzelnen Benutzern zugeordnet werden. Siehe dazu auch für Keycloak als Identity Provider.

    Durch diese Änderung wird nun die maximal gültige Sessionlaufzeit im BPC nicht mehr durch die enstprechende Einstellung im Keycloak beeinflusst. Diese muss nun in der Datei de.virtimo.bpc.core.cfg unter der Einstellung de.virtimo.bpc.core.auth.oidc.sessionExpirationMinutes gesetzt werden. Der Standardwert beträgt umgerechnet 8 Stunden. Ist die Laufzeit im Keycloak kürzer, so wird der Sessionchecker im BPC die Sesssion ebenfalls beenden. Hier kann es jedoch zu einer Verzögerung kommen, wenn für den User noch ein AccessToken vorliegt, der nicht abgelaufen ist.

    Außerdem blockiert das BPC selbst nicht mehr das Impersonieren von Usern mit der Rolle "bpcadmin". Dies muss nun im Keycloak konfiguriert werden und ist unter Imitieren von Benutzern mit Keycloak beschrieben.

    Es ist nun möglich über die integrierte Benutzerverwaltung im Keycloak neue Benutzer anzulegen oder von bestehenden Benutzern Name, E-Mail und Passwort zu ändern.

    Betrifft: BPC Core | Dokumentation

Bugs

  • Entfernen obsoleter grid_showHeader Konfiguration BPC-8912

    Die Konfiguration grid_showHeader ist obsolet, da diese Fehler verursacht. Das Verhalten vom Header wird seit geraumer Zeit mit dem Parameter moduleHeader_enabled gesteuert. Das Setting wird beim BPC Update automatisch entfernt.

Sonstiges

  • Update Java BPC-8962

    Betrifft:

BPC 4.2.4

Release Datum: 2024-09-23

Mit diesem Update müssen folgende Komponenten aktualisiert werden: BPC Module | OpenSearch Plugin

Verbesserungen

Bugs

  • Opensearch: BpcPlugin - ConcurrentModificationException BPC-8852

    Betrifft: OpenSearch

BPC 4.2.3

Release Datum: 2024-08-26

Mit diesem Update müssen folgende Komponenten aktualisiert werden: BPC Module | Karaf | OpenSearch

Security

Interne Abhängigkeiten / Dependency Updates

BPC 4.2.2

Release Datum: 2024-07-02

Mit diesem Update müssen folgende Komponenten aktualisiert werden: BPC Module | OpenSearch Plugin

Verbesserungen

  • Neuanmeldung bei IP Pinning Problemen ermöglichen BPC-8179

    Kommt es zu einem IP Pinning Fehler, so kann man sich nun nach einem Neuladen der Seite im Browser normal anmelden. Der Fehler wird nicht erneut angezeigt (es sei denn die IP ändert sich erneut).

    Betrifft: BPC Core | BPC Core | BPC Core

Bugs

  • Lücke in Daten bei Reindizierung und verteilter Replikation im Cluster BPC-8503

    Bei der Aktivierung des Wartungsmodus einer einzelnen Node(im Clusterbetrieb) wurden die Replikation teilweise nicht angehalten. Dieses Problem wurde behoben. Beim Update ist es hier besonders wichtig, dass auch OpenSearch aktualisiert wird.

    Betrifft: BPC Core | OpenSearch

BPC 4.2.1

Release Datum: 2024-06-04

Mit diesem Update müssen folgende Komponenten aktualisiert werden: BPC Module | OpenSearch Plugin

Breaking Changes

Sie sollten die Beschreibungen in diesem Abschnitt genau lesen. Es können Handlungsanweisungen enthalten sein, die Sie für ein Update befolgen müssen.

  • Maximaler Arbeitsspeicher für Karaf wird anders konfiguriert BPC-8542

    In aktuellen Karaf Versionen wurden Karaf spezifische Umgebungsvariablen zum setzen des JVM Speichers entfernt und müssen durch eine Alternative ersetzt werden.

    Linux

    Bitte in der bpc.env.sh

    # Karaf
    export JAVA_MIN_MEM=128M
    export JAVA_MAX_MEM=512M

    durch

    # Karaf
    export EXTRA_JAVA_OPTS="$EXTRA_JAVA_OPTS -Xms128m -Xmx512m"

    ersetzen und die Werte entsprechend übernehmen.

    Windows

    Bitte in der bpc.env.cmd

    rem *** Karaf ***
    SET JAVA_MIN_MEM=128M
    SET JAVA_MAX_MEM=512M

    durch

    rem *** Karaf ***
    SET EXTRA_JAVA_OPTS=%EXTRA_JAVA_OPTS% -Xms128m -Xmx512m

    ersetzen und die Werte entsprechend übernehmen.

    Betrifft: Dokumentation |

Verbesserungen

  • Maximaler Arbeitsspeicher für Karaf wird anders konfiguriert BPC-8542

    In aktuellen Karaf Versionen wurden Karaf spezifische Umgebungsvariablen zum setzen des JVM Speichers entfernt und müssen durch eine Alternative ersetzt werden.

    Linux

    Bitte in der bpc.env.sh

    # Karaf
    export JAVA_MIN_MEM=128M
    export JAVA_MAX_MEM=512M

    durch

    # Karaf
    export EXTRA_JAVA_OPTS="$EXTRA_JAVA_OPTS -Xms128m -Xmx512m"

    ersetzen und die Werte entsprechend übernehmen.

    Windows

    Bitte in der bpc.env.cmd

    rem *** Karaf ***
    SET JAVA_MIN_MEM=128M
    SET JAVA_MAX_MEM=512M

    durch

    rem *** Karaf ***
    SET EXTRA_JAVA_OPTS=%EXTRA_JAVA_OPTS% -Xms128m -Xmx512m

    ersetzen und die Werte entsprechend übernehmen.

    Betrifft: Dokumentation |

Bugs

  • Abweichungen in der Konsistenzprüfung der Replikation BPC-8494

    Betrifft: BPC Core

  • Wartungsmodus bei der Orchestrierung von Replikationen berücksichtigen BPC-8584

    Backend Core Version muss zum OpenSearch Plugin passen. Entweder dieses manuell aktualisieren oder die neue OpenSearch Version installieren.

    Betrifft: BPC Core | OpenSearch

Dokumentation

  • Typo bei der Einrichtung als Windows-Dienste BPC-8452

BPC 4.2.0

Release Datum: 2024-04-29

Mit diesem Update müssen folgende Komponenten aktualisiert werden: BPC Module | Karaf | OpenSearch | OpenSearch Plugin

Breaking Changes

Sie sollten die Beschreibungen in diesem Abschnitt genau lesen. Es können Handlungsanweisungen enthalten sein, die Sie für ein Update befolgen müssen.

  • Alte Lizenzdateien abgelöst BPC-4884

    Die JAR-Lizenzdateien (Dateiname bpc-be-license.jar) können nicht mehr verwendet werden und müssen durch XML basierte Lizenzdateien (Dateiname license.xml.bpc) ersetzt werden. Falls Sie noch eine alte JAR-Lizenzdatei nutzen, kontaktieren Sie bitte den Support, um eine neue Lizenzdatei zu erhalten.

    Betrifft: BPC Core

  • Karaf Log Monitor BPC-7550

    Karaf Logs werden nun über einen Monitor bereitgestellt (siehe auch Karaf Log).

    Für das Schreiben der Karaf Logs in den OpenSearch-Index bpc-logs wird die Zusatzkomponente 'Decanter' verwendet. Bei einer neuen Installation des Karafs ist diese Komponente bereits vorinstalliert und es muss nichts gemacht werden. Falls eine vorhandene Karaf-Installation nicht ersetzt werden kann oder soll, dann kann diese auch per Karaf-Konsole nachinstalliert werden (Internet Verbindung notwendig).

    virtimo@bpc()> feature:repo-add decanter
    virtimo@bpc()> feature:install decanter-collector-log

    Für die Konfiguration der Funktion siehe Karaf Log.

    Betrifft: BPC Core | Dokumentation | | Karaf

Sie sollten die Beschreibungen in diesem Abschnitt genau lesen. Es handelt sich um empfohlene Handlungsanweisungen, die bei einem Update angeraten werden.

Neue Funktionen

  • Karaf Log Monitor BPC-7550

    Karaf Logs werden nun über einen Monitor bereitgestellt (siehe auch Karaf Log).

    Für das Schreiben der Karaf Logs in den OpenSearch-Index bpc-logs wird die Zusatzkomponente 'Decanter' verwendet. Bei einer neuen Installation des Karafs ist diese Komponente bereits vorinstalliert und es muss nichts gemacht werden. Falls eine vorhandene Karaf-Installation nicht ersetzt werden kann oder soll, dann kann diese auch per Karaf-Konsole nachinstalliert werden (Internet Verbindung notwendig).

    virtimo@bpc()> feature:repo-add decanter
    virtimo@bpc()> feature:install decanter-collector-log

    Für die Konfiguration der Funktion siehe Karaf Log.

    Betrifft: BPC Core | Dokumentation | | Karaf

  • Health-Endpunkt für Cluster-Master BPC-7915

    Neuer Status-Endpunkt zur Abfrage der Rolle einzelner Knoten im Clusterbetrieb. Über diesen Endpunkt kann nun überprüft werden, ob ein Knoten die "master"-Rolle hat oder nicht. Siehe auch BPC API /cxf/bpc-core/status/clustermaster

    Betrifft: BPC Core | Dokumentation

Verbesserungen

  • Dashboard Modul auf Frontend reduziert BPC-8279

    Bei bestehenden Installationen kann die Datei bpc-be-dashboard.jar ersatzlos entfallen und aus dem KARAF/deploy Verzeichnis gelöscht werden. Das Dashboard Modul besteht nur noch aus der Datei bpc-fe-dashboard.war.

Interne Abhängigkeiten / Dependency Updates

Sonstiges

  • Alte Lizenzdateien abgelöst BPC-4884

    Die JAR-Lizenzdateien (Dateiname bpc-be-license.jar) können nicht mehr verwendet werden und müssen durch XML basierte Lizenzdateien (Dateiname license.xml.bpc) ersetzt werden. Falls Sie noch eine alte JAR-Lizenzdatei nutzen, kontaktieren Sie bitte den Support, um eine neue Lizenzdatei zu erhalten.

    Betrifft: BPC Core