Voraussetzungen

Es ist eine PostgreSQL-Datenbank mit einem Benutzer erforderlich, der Datenbankobjekte ändern darf. Der Foreign Data Wrapper muss auf derselben Server-Instanz installiert sein, auf der der Server, der die Datenbank betreibt, läuft.

Bitte belassen Sie das Standardverzeichnis „PG_HOME“ unter „/var/lib/pgsql“ und vermeiden Sie eine Verlagerung. Erstellen Sie außerdem keine zusätzlichen Einhängepunkte innerhalb dieses Verzeichnisses (z. B. das Einhängen von „/var/lib/pgsql/17/data“ von einem anderen Gerät). Eine solche Änderung der Struktur kann zukünftige PostgreSQL-Upgrades erheblich erschweren. Hängen Sie stattdessen „/var/lib/pgsql“ direkt von einem anderen Gerät ein oder verwenden Sie zusätzliche Tablespaces, wie unten beschrieben.

Beispiel: Erstellen Sie die Datenbank infosim, die der Rolle infosim gehört:

export DB_NAME=infosim

mkdir -p /var/lib/pgsql/custom/user_tblspc/${DB_NAME}_tblspc/tab_space/${DB_NAME} \
 /var/lib/pgsql/custom/user_tblspc/${DB_NAME}_tblspc/idx_space/${DB_NAME} && \
 chown -R postgres:postgres /var/lib/pgsql/custom/user_tblspc

psql -Upostgres -c "CREATE ROLE $DB_NAME WITH LOGIN PASSWORD '$DB_NAME';"

psql -Upostgres -c "CREATE TABLESPACE ${DB_NAME}_tab OWNER $DB_NAME \
LOCATION '/var/lib/pgsql/custom/user_tblspc/${DB_NAME}_tblspc/tab_space/$DB_NAME';"

psql -Upostgres -c "CREATE TABLESPACE ${DB_NAME}_idx OWNER $DB_NAME \
LOCATION '/var/lib/pgsql/custom/user_tblspc/${DB_NAME}_tblspc/idx_space/$DB_NAME';"

psql -Upostgres -c "CREATE DATABASE $DB_NAME WITH OWNER $DB_NAME TEMPLATE template0 \
TABLESPACE ${DB_NAME}_tab ENCODING 'UTF8' LC_COLLATE 'de_CH.UTF-8' LC_CTYPE 'de_CH.UTF-8';"

Standardinstallation

RPM aus dem SKOOR-Repo installieren

Wenn StableNet FDW für eine bestimmte SKOOR-Major-Version (z. B. 8) installiert werden soll, verwenden Sie

dnf install "eranger-stablenet-fdw-8.*"

Andernfalls verwenden Sie

dnf install "eranger-stablenet-fdw"

Konfiguration

Nach einer Konfigurationsänderung muss der PostgreSQL-Server neu gestartet werden.

systemctl restart postgresql-17

Konfigurationsdatei

/etc/stablenet-fdw/stablenet-fdw.conf

Mindestkonfiguration

Die folgenden Einstellungen müssen vorgenommen werden, um eine funktionierende Installation zu erhalten.

[global]
default_user =
                                        # Default user name for the StableNet® API.
                                        # This is used in case no authorization
                                        # is provided by the SQL client.
default_password =
                                        # Default password for the StableNet® API.
                                        # This is used in case no authorization
                                        # is provided by the SQL client.

Bei einigen älteren Oracle-Versionen muss die Oracle-Client-Bibliothek auf dem System installiert sein. Installieren Sie diese mit dem neuesten Oracle Instant Client-Installationsprogramm und konfigurieren Sie den Pfad

#oracle_client_lib_dir =
                                        # Path to the Oracle client library directory.
                                        # This is used to load the Oracle client library
                                        # for the Oracle database connection.
                                        # If omitted, the thin client is used which might have
                                        # problems connectiong to older Oracle databases.

[webservice]                            # use te form werbservice_<server_id>
                                        # to configure multiple StableNet® servers
                                        # (see below).
url =
                                        # URL of the StableNet® API
                                        # Usually something like https://<stablenet-host>:5443/api/1
database_connection =
                                        # Connection string to the StableNet® database.
                                        # This is used for the measurement data sync.
                                        # The connection string must be in the format:
                                        # MySQL: mysql+pymysql://<user>:<password>@<host>:3306/<database>
                                        # Oracle: oracle+oracledb://<user>:<password>@<host>:1521/?service_name=<service>
                                        # Connection info can be found on the StableNet server in
                                        # /opt/stablenet/snmw/wildfly/standalone/configuration/standalone.xml (<datasources>).
                                        # It's usually a good idea to use a different user and service than the one used by StableNet.

Messung / Metrikfilterung

Um die Menge der Daten zu begrenzen, die aus der StableNet-Datenbank synchronisiert werden müssen, kann es sinnvoll sein, einige Filter zu konfigurieren oder bestimmte Messungstypen vollständig zu deaktivieren.

#sync_ping_data = true
# Sync ping measurement data from the StableNet® database.
# Defaults to true.
#sync_snmp_data = true
# Sync SNMP measurement data from the StableNet® database.
# Defaults to true.
#sync_usrscript_data = true
# Sync usrscript measurement data from the StableNet® database.
# Defaults to true.
#sync_external_data = true
# Sync external measurement data from the StableNet® database.
#sync_derived_data = false
# Sync derived measurement data from the StableNet® database.
#ping_measurement_filter =
# Filter for the ping measurement.
#snmp_measurement_filter =
# Filter for the SNMP measurement.
#snmp_indexes =
# List of SNMP indexes to be used for the SNMP measurement.
# This is the number part of the metric key, e.g. #1234 -> 1234
#snmp_state_agg_measurements =
# Comma separated list of template name / metric_key pairs of measurements
# which should have state aggregation enabled.
# Example: Interface Relative IPMPLS 64Bit#1234,template2#5678
#usrscript_measurement_filter =
# Filter for the usrscript measurement.
#usrscript_indexes =
# List of usrscript indexes to be used for the usrscript measurement.
# This is the number part of the metric key, e.g. #1234 -> 1234
#usrscript_state_agg_measurements =
# Comma separated list of template name / metric_key pairs of measurements
# which should have state aggregation enabled.
# Example: Interface Relative IPMPLS 64Bit#1234,template2#5678
#external_measurement_filter =
# Filter for the external measurement.
#external_indexes =
# List of external indexes to be used for the external measurement.
# This is the number part of the metric key, e.g. #1234 -> 1234
#external_state_agg_measurements =
# Comma separated list of template name / metric_key pairs of measurements
# which should have state aggregation enabled.
# Example: Y.1731#1234,template2#5678
#derived_measurement_filter =
# Filter for the derived measurement.
#derived_indexes =
# List of derived indexes to be used for the derived measurement.
# This is the number part of the metric key, e.g. #1234 -> 1234
#derived_state_agg_measurements =
# Comma separated list of template name / metric_key pairs of measurements
# which should have state aggregation enabled.
# Example: Y.1731#1234,template2#5678

Aufbewahrungsrichtlinien

Es kann für jedes Aggregat festgelegt werden, wie lange die Daten gespeichert werden.

[retention_days]

#raw = 1
#minutely = 1
#5_minutely = 14
#15_minutely = 31
                                        # ~1 month
#hourly = 93
                                        # ~3 months
#daily = 365
                                        # ~1 years
#weekly = 365
                                        # ~1 years
#monthly = 1825
                                        # ~5 years
#quarterly = 1825
                                        # ~5 years
#yearly = 3650
                                        # ~10 years

Erweiterte Einstellungen

Es gibt noch einige weitere Optionen, mit denen sich der StableNet-FDW feinabstimmen lässt. Diese Einstellungen sind direkt in der Konfigurationsdatei beschrieben.

Verwendung von Umgebungsvariablen

Optionen können auch über Umgebungsvariablen mit dem Präfix „STABLENET_FDW_WEBSERVICE_“ und dem Optionsnamen in Großbuchstaben angegeben werden (z. B. STABLENET_FDW_WEBSERVICE_URL). Für die Einstellungen unter „global“ muss „GLOBAL“ aus dem ENV-Schlüssel weggelassen werden (z. B. STABLENET_FDW_DEFAULT_USER).

url ist die Basis-URL des StableNet®-API-Webdienstes. Sie hat in der Regel die Form https://<host>:5443/api/1.

Mehrere StableNet-Server

Mehrere StableNet®-Instanzen können mithilfe mehrerer webservice-Abschnitte mit eindeutigen server_id-Suffixen definiert werden. Der server_id wird als interne Kennung verwendet, um z. B. die passende Autorisierungszeichenfolge von SKOOR Auth abzurufen. Es sollte ein geeigneter server_name festgelegt werden, der zur Identifizierung des Servers in den Fremd- und Aggregattabellen dient. Dies kann auch über Umgebungsvariablen konfiguriert werden (z. B. STABLENET_FDW_WEBSERVICE_URL_TEST, STABLENET_FDW_WEBSERVICE_SERVER_NAME_TEST).

[webservice_production]
server_name = Production Server
url = https://stablenet.prod:5443/api/1
database_connection = ...

[webservice_staging]
server_name = Staging Server
url = https://stablenet.staging:5443/api/1
database_connection = ...

Entsprechender Eintrag in SKOOR Auth (/etc/opt/eranger/eranger-auth.conf)

[provider.1]
type = stablenet
name = StableNet®
webservice_url_production = https://stablenet.prod:5443/api/1
webservice_url_staging = https://stablenet.staging:5443/api/1

Initialisierung von Fremdtabellen

Initialisieren Sie die vom Foreign Data Wrapper benötigten Fremdtabellen.

/opt/stablenet-fdw/init-foreign-tables.sh -h <host> -p <port> -d <database> -U <user> -o <owner>

z. B.

/opt/stablenet-fdw/init-foreign-tables.sh -U postgres -h localhost -p 5432 -d infosim -o infosim

Dieser Befehl sollte nach jeder Aktualisierung von eranger-stablenet-fdw ausgeführt werden, um neue Tabellendefinitionen abzurufen.

Verbindung testen

psql -h localhost -p 5432 -U infosim -d infosim -c "SELECT * from stablenet.stablenet_info;"

Dies sollte die Anzahl der Geräte in der verbundenen StableNet®-Instanz zurückgeben.

Dokumentation

Einrichtung