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
Betrifft: BPC Core | Dokumentation | BPC Core | BPC Core
-
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 Einstellungde.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
Betrifft: BPC Core | Dokumentation | BPC Core | BPC Core
-
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 Einstellungde.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 ParametermoduleHeader_enabled
gesteuert. Das Setting wird beim BPC Update automatisch entfernt.Betrifft: BPC Core | Process Monitoring | Process Monitoring
BPC 4.2.4
Release Datum: 2024-09-23
Mit diesem Update müssen folgende Komponenten aktualisiert werden: BPC Module | OpenSearch Plugin
Verbesserungen
-
Versionsinformationen als prometheus Metriken BPC-8871
Betrifft: BPC Core | Dokumentation
-
Siehe System Monitoring (Metriken für Prometheus) BPC-8904
Betrifft: BPC Core | Dokumentation
-
HTML Content Modul - Schreibrechte je Instanz vergeben BPC-8699
Für das HTML Content Modul können nun instanzspezifische Rollen zum Editieren vergeben werden: htmlcontent_editor_<MODUL_ID> Siehe auch: HTML Content Modul (Benutzerdefinierte Inhalte)
Betrifft: BPC Core | Dokumentation | BPC Core
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
-
cxf-rt-rs-service-description:3.5.8 | CVE-2024-29736 BPC-8743
Betrifft: Data Analysis | BPC Core | | Forms | Process Monitoring | | Karaf
-
JSESSIONID deaktivieren BPC-8632
JSESSIONID Cookie wurde deaktiviert
Betrifft: BPC Core
Interne Abhängigkeiten / Dependency Updates
-
Aktualisieren Sie OpenSearch entsprechend der Updateanleitung
Betrifft: BPC Core | Forms | OpenSearch | Dokumentation | OpenSearch
BPC 4.2.2
Release Datum: 2024-07-02
Mit diesem Update müssen folgende Komponenten aktualisiert werden: BPC Module | OpenSearch Plugin
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.
Siehe auch Zentrale Konfigurationsdatei und Karaf
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.
Siehe auch Zentrale Konfigurationsdatei und Karaf
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
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 (Dateinamelicense.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
Empfohlene Anpassungen
Sie sollten die Beschreibungen in diesem Abschnitt genau lesen. Es handelt sich um empfohlene Handlungsanweisungen, die bei einem Update angeraten werden. |
-
Update OpenSearch BPC-8408
Aktualisieren Sie OpenSearch entsprechend der Updateanleitung
Betrifft: BPC Core | Forms | OpenSearch | Dokumentation | OpenSearch
Neue Funktionen
-
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 demKARAF/deploy
Verzeichnis gelöscht werden. Das Dashboard Modul besteht nur noch aus der Dateibpc-fe-dashboard.war
.Siehe empfohlene Dateien
Betrifft: Process Dashboard | Karaf | Dokumentation | Process Dashboard |
Interne Abhängigkeiten / Dependency Updates
-
Aktualisieren Sie OpenSearch entsprechend der Updateanleitung
Betrifft: BPC Core | Forms | OpenSearch | Dokumentation | OpenSearch
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 (Dateinamelicense.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