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

    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.

    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.

    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.

    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

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

    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