Zentrale Konfigurationsdatei

In der Datei kann auch die Umgebungsvariable JAVA_HOME gesetzt werden. Dies sorgt dafür, dass OpenSearch und auch Karaf die dort definierte Java-Version nutzen. Im Auslieferungszustand wird in den bpc.env Dateien JAVA_HOME nicht gesetzt.

Über das Setzen der Variablen OPENSEARCH_JAVA_OPTS und EXTRA_JAVA_OPTS kann die Zuweisung von Arbeitsspeicher für OpenSearch und Karaf gesetzt werden.

Siehe dazu auch Systemanforderungen

Über die Variablen OPENSEARCH_JAVA_OPTS für OpenSearch und EXTRA_JAVA_OPTS für Karaf können auch Systemproperties gesetzt werden. Solche Systemproperties werden wie folgt gesetzt -D<name>=<wert>.

Soll zum Beispiel die Standard-Zeitzone der JVM (Java Virtual Machine) auf 'Europe/Berlin' gesetzt werden, dann wird -Duser.timezone=Europe/Berlin zum bestehenden Wert der Variable hinzugefügt.

Innerhalb der Datei können über das Setzen der PORT_OFFSET Variable alle Ports auf einmal geändert werden. Alternativ können auch einzelne Ports über das Setzen einzelner Variablen gesetzt werden.

Es wird empfohlen, die Keystore- und Truststore-Dateien außerhalb vom Karaf und OpenSearch, an einer zentralen Stelle, abzulegen. Dies erleichtert zukünftige Updates, da so OpenSearch und Karaf aktualisiert werden können, ohne dass die Konfiguration von TLS wiederholt werden muss.

Die bpc.env ist so anzupassen, dass der Karaf die Dateien findet und für OpenSearch ein passender Link angelegt wird. Der Link für OpenSearch ist leider nötig, da der Prozess nicht auf Dateien außerhalb seines Ordners zugreifen darf.

Beachten Sie, dass bei dieser Konfiguration OpenSearch und Karaf dieselben Keystore und Truststore Dateien nutzen. Das bedeutet, dass darin alle nötigen Zertifikate mit den passenden Aliases abgelegt sein müssen, die für beide Systemkomponenten nötig sind.

Siehe auch: Sichere Verbindung (TLS/HTTPS)

In der bpc.env wird über die Umgebungsvariable EXTRA_JAVA_OPTS eine zusätzliche Datei für java.security.properties referenziert. Diese Datei heißt custom.java.security und sollte im gleichen Verzeichnis wie die bpc.env liegen. In der Datei custom.java.security können die security.properties überschrieben werden. So ist es z.B. möglich DNS-Einstellungen oder TLS-Parameter zu ändern. Die bereitgestellte custom.java.security enthält bereits einige Einstellungen zur Härtung von TLS-Verbindungen.

Falls eine Oracle-Datenbank genutzt wird, kann der Ort der tnsnames.ora-Konfigurationsdatei angegeben werden. Die Konfiguration erfolgt über die Umgebungsvariable oracle.net.tns_admin, welche in der KARAF_SYSTEM_OPTS eingefügt wird, z.B.:

Stellen Sie sicher, dass das Modul PAX JDBC Feature Installer installiert ist.

Nach dem Kopieren des zu verwendenden JDBC-Treibers in das [karaf]/deploy-Verzeichnis müssen Sie normalerweise die pax-jdbc-Features über die Karaf-Shell händisch installieren (siehe auch Datenbanken). Beispiel: feature:install pax-jdbc-oracle

Bei der Ausführung des feature:install-Kommandos versuchen einige der pax-jdbc-Features, JDBC-Treiber für Sie herunterzuladen und zu installieren. Dies ist jedoch nicht immer die Treiberversion, die Sie benötigen.

Über die Umgebungsvariable KARAF_PAX_JDBC_FEATURES_TO_INSTALL kann die Installation automatisiert werden, indem Sie die zu installierenden pax-jdbc-Features in einer durch Kommata getrennten Liste angeben.

Wenn Sie über das [karaf]/deploy-Verzeichnis eigene JDBC-Treiber bereitstellen, dann markieren Sie diese Einträge mit (*). Dann werden die zugehörigen pax-jdbc-Features erst installiert, wenn Ihr mitgelieferter JDBC-Treiber bereits als sogenanntes Wrapped Bundle zur Verfügung steht.

Beispiel:

In diesem Szenario sollen vom BPC auf Oracle, SQLite, Microsoft SQL Server und MariaDB Datenbanken zugegriffen werden. Dafür sollen die notwendigen pax-jdbc Features automatisch installiert werden.

Hier wird pax-jdbc-sqlite sofort installiert, falls noch nicht geschehen.
pax-jdbc-oracle, pax-jdbc-mssql und pax-jdbc-mariadb werden hingegen erst installiert, wenn der zugehörige JDBC-Treiber vom Karaf als sogenanntes Wrapped Bundle zur Verfügung steht.

Wenn Sie die jetty.xml anpassen müssen, um z.B. HTTP Header zu ändern, sollten Sie wie folgt vorgehen.

Anschließend sollte Ihr INSTALLATIONSVERZEICHNIS wie folgt aussehen:

Die Konfigurationseinstellungen des Karaf sind im Verzeichnis [karaf]/etc auf diverse Dateien verteilt. Bei einem Karaf-Update geht leicht der Überblick verloren, was zuvor angepasst und in der neuen Version wieder nachgezogen werden muss.
Ein einfaches Überschreiben all dieser Konfigurationsdateien ist nicht zielführend, da somit evtl. neu hinzugekommene Optionen ggf. nicht korrekt gesetzt sind.

Über Umgebungsvariablen können spezifische Werte in den Konfigurationsdateien überschrieben werden. Dabei muss sich der Name der Umgebungsvariable an folgendem Aufbau orientieren: (NAME DER KONFIGURATIONSDATEI)_(NAME DER OPTION).
Bitte dabei die Großschreibung beachten und Leer- und Sonderzeichen durch Unterstriche ersetzen.

Siehe auch Karaf Dokumentation.

Zur Verdeutlichung siehe Beispiel 1: Setzen des SSH Ports und Beispiel 2: Setzen der OpenSearch Hosts.