Versionierung der internen BPC Konfiguration

Das BPC legt seine Konfiguration intern im OpenSearch unter dem Index bpc-configuration ab. Der Stand dieser Konfiguration wird intern mit einer festen Versionsnummer versehen. Diese wird intern als model_version am Index hinterlegt und ist eine natürliche Zahl, die im Falle eines Updates hochgezählt wird.

Kommt es bei einem BPC Update vor, dass sich die interne Konfiguration ändert und damit die Versionsnummer erhöht, dann migriert das BPC automatisch die bestehende Konfiguration auf den neuen Stand und hinterlegt die neue Versionsnummer im Index.

Betroffene Versionen

In folgenden BPC Versionen kam es zu einer Aktualisierung der internen Konfiguration.

Potenzielle Auswirkungen auf den Betrieb

Die Version der internen Konfiguration hat Auswirkungen auf einige Aspekte im Betrieb.

Deployment

Es ist nicht möglich, ein Deployment von einem BPC mit einer höheren model_version auf ein BPC mit einer niedrigeren model_version durchzuführen.

Es ist jedoch möglich, von einem BPC mit einer niedrigeren model_version ein Deployment auf ein BPC mit einer höherem model_version durchzuführen. Dabei werden, falls nötig, Anpassungen an der Konfiguration automatisch durchgeführt.

Downgrade

Es erfordert zusätzliche Schritte ein Downgrade des BPC durchzuführen, wenn die Zielversion des BPC eine niedrigere model_version verwendet.

Siehe dafür: Downgrade Guide

Auslesen der aktuellen Versionsnummer

Die Versionsnummer ist in den Metadaten des Index bpc-configuration hinterlegt.

Diese kann direkt im BPC unter OpenSearch Indizes-Ansicht eingesehen werden. Sie ist in den Mapping-Informationen des Index enthalten und heißt dort model_version.

Abbildung 1. Versionsnummer in der Mappingansicht des bpc-configuration Index

Alternativ kann diese Information auch direkt über OpenSearch, unter der URL https://SERVER:PORT/bpc-configuration?pretty abgefragt werden. Dort ist diese Information ebenfalls unter model_version zu finden.

Beispielaufruf mit CURL

curl --insecure -u USER:PASSWORT 'https://localhost:9200/bpc-configuration?pretty'shell

Ausgabe des Beispielaufrufes mit CURL (gekürzt)

{
  "bpc-configuration_1739522947935" : {
    "aliases" : {
      "bpc-configuration" : { }
    },
    "mappings" : {
      "_meta" : {
        "model_version" : 24
      }
    }
  }
}json

Für die Authentifizierung gegen OpenSearch finden sich Beispiele auf der Seite Direkter OpenSearch Zugriff.