Versioning of the internal BPC configuration

The BPC stores its configuration internally in OpenSearch under the index bpc-configuration. The status of this configuration is assigned a fixed version number internally. This is stored internally as model_version in the index and is a natural number that is incremented in the event of an update.

If the internal configuration changes during a BPC update, thereby increasing the version number, the BPC automatically migrates the existing configuration to the new version and stores the new version number in the index.

Affected versions

The internal configuration was updated in the following BPC versions.

BPC 5.0.0

Potential effects on operation

The version of the internal configuration has an effect on some aspects of operation.

Deployment

It is not possible to perform a Deployment from a BPC with a higher model_version to a BPC with a lower model_version.

However, it is possible to perform a deployment from a BPC with a lower model_version to a BPC with a higher model_version. If necessary, adjustments to the configuration are performed automatically.

Downgrade

It requires additional steps to downgrade the BPC if the target version of the BPC uses a lower model_version.

See: Downgrade Guide

Read out the current version number

The version number is stored in the metadata of the index bpc-configuration.

This can be viewed directly in the BPC at OpenSearch indices view. It is contained in the mapping information of the index and is called model_version.

Illustration 1. Version number in the mapping view of the bpc-configuration index

Alternatively, this information can also be queried directly via OpenSearch at the URL https://SERVER:PORT/bpc-configuration?pretty. This information can also be found there at model_version.

Beispielaufruf mit CURL

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

Ausgabe des Beispielaufrufes mit CURL (gekürzt)

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

Examples of authentication against OpenSearch can be found on the Direct OpenSearch access page.