Installation mit vorkonfiguriertem BPC

Mit/nach der Installation kann direkt ein vorkonfiguriertes BPC gestartet werden. Es können sowohl Modul- und Modulinstanzeinstellungen als auch vorkonfigurierte OpenSearch-Indizes importiert werden. Dies ist insbesondere im Kubernetes/Container-Umfeld sinnvoll.

Modul- und Modulinstanzeinstellungen importieren

Modul- und Modulinstanzeinstellungen können über das Deployment als JSON-Datei exportiert werden und nach der Installation importiert werden. Der folgende Abschnitt erklärt die Vorbereitung und Durchführung.

Voraussetzung und Vorbereitung

Es wird eine vorhandene BPC Installation benötigt, deren Konfiguration als Grundlage für das neue System verwendet werden soll. Dazu von diesem die benötigten Konfigurationen per Deployment in eine JSON-Datei (Deployment Target) exportieren.

Anwendung

Die zuvor per Deployment erzeugte JSON-Datei umbenennen. Sie muss die Dateiendungen .bpc-deployment-export bekommen. Diese nun in dem neu aufgesetzten System in das [KARAF]/deploy Verzeichnis kopieren. Die darin enthaltenen Konfigurationen werden automatisch importiert.

Hinweise:

Es wird alle 3 Sekunden nachgeschaut, ob im Verzeichnis [KARAF]/deploy eine Datei mit dieser Dateiendungen vorliegt
Es können nur Deployment-Exports importiert werden, bei denen ALLE verwendeten Module geladen sind. Wenn der Karaf z.B. gerade hochfährt, dann wird es in 3 Sekunden nochmals probiert usw.

Dateiendungen

Wie oben erwähnt muss die zu importierende Datei initial die Dateiendung .bpc-deployment-export haben.

Nach der Verarbeitung wird diese Import-Datei umbenannt, sodass nicht immer wieder die gleiche Datei verarbeitet wird. Sie wird eine der folgenden Dateiendungen bekommen:

.processed - nach erfolgreicher Verarbeitung
.empty - wenn die Importdatei keine Modulinfos enthält
.invalid_json - wenn die Importdatei kein gültiges JSON enthält
.error - wenn während der Überprüfung, ob alle relevanten Module geladen sind, ein Fehler auftrat
.error_on_import - wenn es während des Imports zu einem Problem kam

OpenSearch-Indizes importieren

Neben Modul- und Instanzeinstellungen können auch OpenSearch-Indizes importiert werden. Im Folgenden beschreiben wir die Vorbereitung und Durchführung.

Voraussetzung und Vorbereitung

Um einen OpenSearch-Index zu importieren, müssen Sie eine Export-Datei im JSON-Format anlegen. Diese muss die Dateiendung .bpc-index-export besitzen und ist wie folgt aufgebaut:

{
    "indexAlias": "index-name",
    "mappings": {
        //...
    },
    "data": {
        "1" : {"processid":1,"textfield":"Test","numberfield":1337,"lastupdate":"2025-12-04T12:00:00.000Z"},
        "2" : {"processid":2,"textfield":"Hallo Welt","numberfield":1338,"lastupdate":"2025-12-04T12:00:01.000Z"},
        "3" : {"processid":3,"textfield":"Foo Bar","numberfield":999,"lastupdate":"2025-12-05T12:00:01.000Z"}
    }
}

Das Feld indexAlias ist der Alias des zu erstellenden Index.

Das Feld mappings enthält das Mapping des Index welches man im Frontend unter Administration→Core Services→Indizes→Mapping Anzeigen sehen kann.

Unter data werden die einzelnen OpenSearch-Dokumente gespeichert. Dabei ist der Schlüssel der Einträge (im Beispiel "1", "2", "3") die Dokumenten-Id, und der Wert das Dokument.

Anwendung

Die erstellte JSON-Datei muss mit der Dateiendung .bpc-index-export umbenannt werden. Diese nun in dem neu aufgesetzten System in das [KARAF]/deploy Verzeichnis kopieren. Der beschriebene Index wird erstellt und mit den jeweiligen Daten befüllt, sofern noch kein Index mit diesem Namen existiert.

Hinweise:

Es wird alle 3 Sekunden nachgeschaut, ob im Verzeichnis [KARAF]/deploy eine Datei mit dieser Dateiendung vorliegt

Dateiendungen

Wie oben erwähnt muss die zu importierende Datei initial die Dateiendungen .bpc-index-export haben.

Nach der Verarbeitung wird diese Import-Datei umbenannt, sodass nicht immer wieder die gleiche Datei verarbeitet wird. Sie wird eine der folgenden Dateiendungen bekommen:

.processed - nach erfolgreicher Verarbeitung
.invalid_json - wenn die Importdatei kein gültiges JSON enthält
.error - wenn während des Imports ein Fehler auftritt
.index_already_exists - wenn der beschriebene Index schon existiert

Keywords: