IBA ibaPDA-Data-Store-Kafka Bedienungsanleitung

Marke: IBA

Modell: ibaPDA-Data-Store-Kafka

Typ: Bedienungsanleitung

ibaPDA-Data-Store-Kafka

Daten Streaming zu Apache Kafka-Cluster

Handbuch

Ausgabe 1.3

Messsysteme für Industrie und Energie

www.iba-ag.com

Hersteller

iba AG

Königswarterstraße 44

90762 Fürth

Deutschland

Kontakte

Zentrale +49 911 97282-0

Telefax +49 911 97282-33

Support +49 911 97282-14

Technik +49 911 97282-13

E-Mail [email protected]

Web www.iba-ag.com

Weitergabe sowie Vervielfälgung dieser Unterlage, Verwertung und Mieilung ihres Inhalts

sind nicht gestaet, soweit nicht ausdrücklich zugestanden. Zuwiderhandlungen verpichten zu

Schadenersatz.

Der Inhalt dieser Druckschri wurde auf Übereinsmmung mit der beschriebenen Hard- und

Soware überprü. Dennoch können Abweichungen nicht ausgeschlossen werden, so dass für

die vollständige Übereinsmmung keine Garane übernommen werden kann. Die Angaben in

dieser Druckschri werden jedoch regelmäßig aktualisiert. Notwendige Korrekturen sind in den

nachfolgenden Auagen enthalten oder können über das Internet heruntergeladen werden.

Die aktuelle Version liegt auf unserer Website www.iba-ag.com zum Download bereit.

Version Datum Revision Autor Version SW

1.3 03-2023 GUI neu, Zerkate, Topics st, mm 8.0.0

Windows® ist eine Marke und eingetragenes Warenzeichen der Microso Corporaon. Andere

in diesem Handbuch erwähnte Produkt- und Firmennamen können Marken oder Handelsnamen

der jeweiligen Eigentümer sein.

1.3 3

ibaPDA-Data-Store-Kaa Inhalt

Inhalt

1 Zu diesem Handbuch .........................................................................................................4

1.1 Zielgruppe und Vorkenntnisse .................................................................................. 4

1.2 Schreibweisen ............................................................................................. .............. 5

1.3 Verwendete Symbole ................................................................................................ 6

2 Einleitung ..........................................................................................................................7

2.1 Systemvoraussetzungen ........................................................................................... 8

3 KonguraonderDatenaufzeichnung ...............................................................................9

3.1 Datenaufzeichnung hinzufügen ................................................................................ 9

3.2 Datenaufzeichnung Kaa-Cluster ........................................................................... 10

3.2.1 Typ Kaa................................................................................................................. 11

3.2.2 Typ Event Hub ......................................................................................................... 16

3.3 Puer ...................................................................................................................... 16

3.4 Konguraon der Topics ......................................................................................... 20

4 Signalauswahl .................................................................................................................23

5 Trigger-Einstellung...........................................................................................................25

6 Diagnose ......................................................................................................................... 29

6.1 Status der Datenaufzeichnung ....................... ......................................................... 29

6.2 Diagnose der Datenaufzeichnung ........................................................................... 30

7 Anhang ........................................................................................................................... 31

7.1 Beschreibung der Datenformate ............................................................................ 31

7.1.1 Datenformat JSON (gruppiert) ................................................................................ 31

7.1.2 Datenformat JSON (pro Signal) ............................................................................... 33

7.1.3 Datenformat AVRO (pro Signal) .............................................................................. 35

8 Support und Kontakt ....................................................................................................... 37

4 1.3

Zu diesem Handbuch ibaPDA-Data-Store-Kaa

1 Zu diesem Handbuch

Diese Dokumentaon beschreibt die Funkon und Anwendung der Datenaufzeichnung

ibaPDA-Data-Store-Kaa.

Diese Dokumentaon ist eine Ergänzung zum ibaPDA-Handbuch. Informaonen über alle wei-

teren Eigenschaen und Funkonen von ibaPDA nden Sie im ibaPDA-Handbuch bzw. in der

Online-Hilfe.

Grundlegende Informaonen zur Datenaufzeichnung in ibaPDA nden Sie im ibaPDA-Handbuch

Teil 5.

1.1 Zielgruppe und Vorkenntnisse

Diese Dokumentaon wendet sich an ausgebildete Fachkräe, die mit dem Umgang mit elekt-

rischen und elektronischen Baugruppen sowie der Kommunikaons- und Messtechnik vertraut

sind. Als Fachkra gilt, wer auf Grund seiner fachlichen Ausbildung, Kenntnisse und Erfahrungen

sowie Kenntnis der einschlägigen Besmmungen die ihm übertragenen Arbeiten beurteilen und

mögliche Gefahren erkennen kann.

Im Besonderen wendet sich diese Dokumentaon an Personen, die mit Projekerung, Test,

Inbetriebnahme oder Instandhaltung der unterstützten Datenbanken, Cloud- bzw. Cluster-Sto-

rage-Technologie befasst sind. Für den Umgang mit ibaPDA-Data-Store-Kaa sind folgende Vor-

kenntnisse erforderlich bzw. hilfreich:

■ Betriebssystem Windows

■ Grundkenntnisse ibaPDA

■ Grundkenntnisse Datenbanken, Cloud- bzw. Cluster-Storage-Technologie

1.3 5

ibaPDA-Data-Store-Kaa Zu diesem Handbuch

1.2 Schreibweisen

In dieser Dokumentaon werden folgende Schreibweisen verwendet:

Akon Schreibweise

Menübefehle Menü Funkonsplan

Aufruf von Menübefehlen Schri 1 – Schri 2 – Schri 3 – Schri x

Beispiel:

Wählen Sie Menü Funkonsplan – Hinzufügen – Neu-

er Funkonsblock

Tastaturtasten <Tastenname>

Beispiel: <Alt>; <F1>

Tastaturtasten gleichzeig drücken <Tastenname> + <Tastenname>

Beispiel: <Alt> + <Strg>

Grasche Tasten (Buons) <Tastenname>

Beispiel: <OK>; <Abbrechen>

Dateinamen, Pfade Dateiname, Pfad

Beispiel: Test.docx

6 1.3

Zu diesem Handbuch ibaPDA-Data-Store-Kaa

1.3 Verwendete Symbole

Wenn in dieser Dokumentaon Sicherheitshinweise oder andere Hinweise verwendet werden,

dann bedeuten diese:

Gefahr!

WennSiediesenSicherheitshinweisnichtbeachten,danndrohtdieunmiel-

bareGefahrdesTodesoderderschwerenKörperverletzung!

■ Beachten Sie die angegebenen Maßnahmen.

Warnung!

WennSiediesenSicherheitshinweisnichtbeachten,danndrohtdiemögliche

GefahrdesTodesoderschwererKörperverletzung!

■ Beachten Sie die angegebenen Maßnahmen.

Vorsicht!

WennSiediesenSicherheitshinweisnichtbeachten,danndrohtdiemögliche

GefahrderKörperverletzungoderdesSachschadens!

■ Beachten Sie die angegebenen Maßnahmen.

Hinweis

Hinweis, wenn es etwas Besonderes zu beachten gibt, wie z. B. Ausnahmen von

der Regel usw.

Tipp

Tipp oder Beispiel als hilfreicher Hinweis oder Gri in die Trickkiste, um sich die

Arbeit ein wenig zu erleichtern.

AndereDokumentaon

Verweis auf ergänzende Dokumentaon oder weiterführende Literatur.

1.3 7

ibaPDA-Data-Store-Kaa Einleitung

2 Einleitung

Für unterschiedliche Zwecke und Methoden der Datenspeicherung stehen verschiedene Arten

der Datenaufzeichnung in ibaPDA zur Verfügung. Je nachdem, welche Lizenzen im Lizenzcont-

ainer freigeschaltet sind, werden im Dialog verschiedene Arten der Datenaufzeichnung zur Kon-

guraon angeboten.

Die vorliegende Dokumentaon beschreibt den Aufzeichnungstyp "Kaa-Cluster zeitbasierte

Datenaufzeichnung". Dieser Aufzeichnungstyp schreibt zeitbasierte Daten in einen Kaa-Clus-

te r.

Die Architektur von Apache Kaa besteht aus einem Cluster-Rechnerverbund. In diesem Rech-

nerverbund speichern sogenannte Broker empfangene Nachrichten mit einem Zeitstempel in

sogenannten Topics.

Topics können in mehrere im Cluster verteilte Paronen aufgeteilt und repliziert werden. Als

Producer sind Anwendungen, die Nachrichten in einen Kaa-Cluster schreiben. Dabei werden

die Nachrichten an den Leader gesendet, die Replikaon mit den Followern erledigen die Broker

untereinander. Consumer sind Anwendungen, die Nachrichten vom Kaa-Cluster lesen.

ibaPDA hat in einer Kaa-Umgebung die Rolle eines Producers: Die Datenaufzeichnung sendet

Nachrichten an den Cluster.

Weiterführende Informaonen zu Apache Kaa nden Sie unter

■ hps://kaa.apache.org/

■ hps://www.conuent.io/what-is-apache-kaa

Die Auswahl der Signale, die in den Topics aufgezeichnet werden sollen, ist in Kapitel ì Signal-

auswahl, Seite 23 beschrieben.

Die Daten können konnuierlich oder getriggert aufgezeichnet werden, siehe Kapitel ì Trig-

ger-Einstellung, Seite 25.

8 1.3

Einleitung ibaPDA-Data-Store-Kaa

2.1 Systemvoraussetzungen

Folgende Systemvoraussetzungen sind für die Verwendung der Datenaufzeichnung in einem

Apache Kaa-Cluster erforderlich:

■ ibaPDA v8.0.0 oder höher

■ Lizenz für ibaPDA-Data-Store-Kaa

Die Lizenzen sind gestaelt nach der Anzahl der Signale, die in den Kaa-Cluster geschrieben

werden sollen. Die Anzahl der genutzten Datenaufzeichnungen ist nicht beschränkt.

Bestell-Nr. Produktbezeichnung Beschreibung

30.670160 ibaPDA-Data-Store-Kaa-16 Zusatzlizenz zum Schreiben von Daten in ei-

nen Kaa-Cluster, max. 16 Signale

30.670161 ibaPDA-Data-Store-Kaa-64 Zusatzlizenz zum Schreiben von Daten in ei-

nen Kaa-Cluster, max. 64 Signale

30.670162 ibaPDA-Data-Store-Kaa-256 Zusatzlizenz zum Schreiben von Daten in ei-

nen Kaa-Cluster, max. 256 Signale

30.670163 ibaPDA-Data-Store-Kaf-

ka-1024

Zusatzlizenz zum Schreiben von Daten in ei-

nen Kaa-Cluster, max. 1024 Signale

30.670171 upgrade-ibaPDA-Data-Sto-

re-Kaa-16 to 64

Lizenz für Erweiterung von 16 auf 64 Signale

30.670172 upgrade-ibaPDA-Data-Sto-

re-Kaa-64 to 256

Lizenz für Erweiterung von 64 auf 256 Signale

30.670173 upgrade-ibaPDA-Data-Sto-

re-Kaa-256 to 1024

Lizenz für Erweiterung von 256 auf 1024 Sig-

nale

Tab. 1: Verfügbare Lizenzen für die Kaa-Cluster Datenaufzeichnung

1.3 9

ibaPDA-Data-Store-Kaa Konguraon der Datenaufzeichnung

3 KonguraonderDatenaufzeichnung

3.1 Datenaufzeichnunghinzufügen

Den Dialog für die Konguraon der Datenaufzeichnung önen Sie über das Hauptmenü

Konguraon – Datenaufzeichnung oder mit dem Buon in der Hauptsymbolleiste.

Um eine neue Aufzeichnung hinzuzufügen, klicken Sie auf den blauen Link Datenaufzeichnung

hinzufügen in der Baumstruktur. Alternav klicken Sie mit der rechten Maustaste auf einen Auf-

zeichnungsknoten in der Baumstruktur und wählen Sie Datenaufzeichnung hinzufügen aus dem

Kontextmenü.

Wählen Sie Kaa-Cluster zeitbasierte Datenaufzeichnung für die Aufzeichnung zeitbasierter Da-

ten in einen Apache Kaa-Cluster.

10 1.3

Konguraon der Datenaufzeichnung ibaPDA-Data-Store-Kaa

3.2 DatenaufzeichnungKaa-Cluster

Allgemein

Verriegelt

Sie können eine Datenaufzeichnung verriegeln, um ein versehentliches oder unautorisiertes Än-

dern der Einstellungen zu verhindern.

Akv

Akvieren Sie die Datenaufzeichnung, um Daten aufzuzeichnen. Sie können jedoch verschiede-

ne Aufzeichnungen kongurieren und nicht benögte Aufzeichnungen deakvieren.

Datenaufzeichnungsindex

Eindeuger Index aller vorhandenen Kaa-Cluster-Datenaufzeichnungen. Sie müssen diesen

Index beispielsweise in der virtuellen Funkon DataStoreInfoKaa() referenzieren, um Diagno-

sedaten für eine besmmte Kaa-Cluster-Datenaufzeichnung zu erzeugen.

NamederDatenaufzeichnung

Hier können Sie einen Namen für die Datenaufzeichnung eintragen.

Idenkator

Der Idenkator ist ein oponaler, textbasierter Wert für die in den Cluster geschriebenen Da-

tensätze. Dieser Wert kann bei der anschließenden Verarbeitung der Daten nützlich sein, um

zwischen mehreren ibaPDA-Systemen zu unterscheiden, die in denselben Cluster schreiben.

1.3 11

ibaPDA-Data-Store-Kaa Konguraon der Datenaufzeichnung

Verbindung

Library Version

Anzeige der in ibaPDA enthaltenen Library Version (nur zur Informaon). ibaPDA verwendet die

Open-Source-Bibliothek librdkaa.

Typ

Zwei Typen stehen zur Auswahl

■ Kaa: Generischer Kaa-Cluster, siehe Kapitel ì Typ Kaa, Seite 11

■ Event Hub: für die Verbindung mit einem Microso Azure Event Hub mit akvierter Kaf-

ka-Unterstützung, siehe Kapitel ì Typ Event Hub, Seite 16

3.2.1 TypKaa

Folgende Einstellungen sind für den Typ Kaa erforderlich:

Cluster-Adresse

Tragen Sie hier Hostname und Port des Brokers im Kaa-Cluster ein. Wenn Sie mehrere Broker

gleichzeig adressieren wollen, trennen Sie die einzelnen Einträge durch Kommas (z. B. 'hostna-

me1:9092, hostname2:9092, hostname3:9092').

Cluster-Verbindungssicherheit

Unterschiedliche Verschlüsselungs- und Authenzierungsmethoden werden unterstützt. Je

nach ausgewählter Opon sind weitere Eingaben erforderlich.

■ PLAINTEXT

Daten werden im Klartext ausgetauscht, keine weiteren Eingaben

■ SSL

Für die SSL-Kommunikaon sind Zerkate erforderlich. Sie können Zerkate im zentralen

Zerkatspeicher in ibaPDA abgelegen und verwalten. Detaillierte Informaonen zum Zerkat-

speicher nden Sie im ibaPDA-Handbuch.

Im Drop-down-Menü Client Zerkat stehen die verwendbaren Zerkate zur Auswahl. Darüber

hinaus stehen weitere Oponen zur Auswahl.

Kein Zerkat: Es wird kein Zerkat verwendet. Dies führt jedoch normalerweise dazu,

dass die Validierung fehlschlägt.

Zerkate verwalten: Önet den zentralen Zerkatspeicher, in dem die Zerkate zentral

in ibaPDA verwaltet werden können.

12 1.3

Konguraon der Datenaufzeichnung ibaPDA-Data-Store-Kaa

Neues Zerkat erzeugen: ibaPDA erzeugt ein neues selbstsigniertes Zerkat. Die notwen-

digen Einstellungen nehmen Sie im sich önenden Dialog vor. Nach erfolgreichem Erzeugen

des Zerkats ist das neue Zerkat ausgewählt.

Geben Sie einen Namen für das Zerkat ein. Den voreingestellten Namen können Sie än-

dern.

Die Eingabe einer Applicaon URI ist oponal. Stellen Sie die Laufzeit ein und wählen den

Algorithmus aus. Zur Auswahl stehen SHA-256, SHA-384 und SHA-512.

Sie müssen ein Kennwort vergeben, um ein Zerkat zu erzeugen. Um das Kennwort für

den privaten Schlüssel einzugeben, klicken Sie auf den Buon <…>. Im folgenden Dialog

müssen Sie das Kennwort aus Sicherheitsgründen zweimal eingeben. Das Kennwort können

Sie beliebig vergeben, es muss keine weiteren Anforderungen erfüllen.

AkvierenderSSL-Verikaon

Wenn Sie die SSL-Verikaon akvieren, wird das Zerkat des Kaa-Servers automasch veri-

ziert. Dazu muss unter den Zerkaten in ibaPDA das Aussteller-Zerkat vorhanden sein, mit

dem das Kaa-Server-Zerkat signiert wurde.

Hinweis

NutzungvonverkeetenSSL-Zerkaten

Sie können in ibaPDA auch verkeete Zerkate imporeren. Beim Import (z. B.

als PEM-Datei oder PFX-Datei) werden die verkeeten Zerkate in einzelne Zer-

kate aufgeteilt. Nach dem Import eines verkeeten Zerkats exiseren daher

mehrere einzelne Einträge unter den Zerkaten.

Wenn das Kaa-Server-Zerkat über eine Kee von Aussteller-Zerkaten sig-

niert wurde und Sie gleichzeig die SSL-Verikaon nutzen wollen, ist die Kon-

guraon des Keystores im Kaa-Server wichg: Wenn der Keystore neben dem

Kaa-Server-Zerkat auch die komplee Kee der Aussteller-Zerkate ent-

hält, dann muss nur das Zerkat der Root CA in ibaPDA vorhanden sein. Wenn

der Keystore dagegen ausschließlich das Kaa-Server-Zerkat enthält, muss in

ibaPDA die vollständige Kee der Aussteller-Zerkate vorhanden sein, damit

die Verizierung möglich ist.

1.3 13

ibaPDA-Data-Store-Kaa Konguraon der Datenaufzeichnung

■ SASL/PLAINTEXT

Wählen Sie den SASL-Authenzierungsmechanismus aus:

PLAIN (alle Daten werden im Klartext ausgetauscht)

SCRAM-SHA-256

SCRAM-SHA-512

Geben Sie den Benutzername sowie das Kennwort für die Anmeldung am Kaa-Cluster in den

entsprechenden Feldern ein.

■ SASL/SSL

Wie bei SASL/PLAINTEXT wählen Sie den SASL-Mechanismus aus und geben Benutzername und

Kennwort ein. Im Drop-down-Menü Client Zerkat stehen die verwendbaren Zerkate zur

Auswahl.

Für die Akvierung und Nutzung der SSL-Verikaon gelten ebenfalls die Hinweise aus dem Ab-

schni zur Cluster-Verbindungssicherheit mit SSL.

Schema Registry-Adresse

Akvieren Sie diese Opon, wenn im Kaa-Cluster eine Schema Registry genutzt wird. Tragen

Sie dann hier Hostname und Port der Schema Registry ein. Je nach genutzter Verbindungssi-

cherheit muss die Adresse mit "hp://" oder "hps://" beginnen. Standardmäßig ist diese Op-

on deakviert.

Schema Registry-Verbindungssicherheit

ibaPDA unterstützt unterschiedliche Methoden für die Verbindungssicherheit. Je nach ausge-

wählter Opon sind weitere Eingaben erforderlich.

■ HTTP

Keine weitere Eingabe erforderlich

14 1.3

Konguraon der Datenaufzeichnung ibaPDA-Data-Store-Kaa

■ HTTPS

Für die HTTPS-Kommunikaon sind Zerkate erforderlich. Im Drop-down-Menü Client Zer-

kat stehen die verwendbaren Zerkate zur Auswahl.

Die Auswahl eines Zerkats sowie die Akvierung und Nutzung der SSL-Verikaon erfolgen

wie bereits bei der Cluster-Verbindungssicherheit mit SSL beschrieben.

■ HTTP+Authencaon

Diese Methode erfordert die Eingabe von Benutzername und Kennwort.

■ HTTPS+Authencaon

Wie HTTPS, zusätzlich ist die Eingabe von Benutzername und Kennwort erforderlich.

Telegramm-Timeout

Zeit in Sekunden, die ibaPDA auf eine Antwort aus dem Kaa-Cluster wartet. Der Wert ent-

spricht dem Parameter message.meout.ms in der Bibliothek librdkaa.

Acknowledgement-Modus

■ Kein: Datennachrichten werden als konnuierlicher Strom geendet, jedoch ohne Bestägung,

ob der Leader sie empfangen hat oder nicht. Dies ist der schnellste Modus, aber es ist nicht

garanert, dass der Broker die Daten erfasst hat.

■ Leader: ibaPDA wartet, bis der Topic-Leader die Erfassung der gesendeten Daten bestägt.

Wenn der Leader nach dem Senden der Bestägung ausfällt und bevor die Follower den Da-

tensatz repliziert haben, gehen die Daten verloren.

■ Alle: ibaPDA sendet keine neuen Daten, bis der Topic-Leader und die Follower die jeweilige

Aufzeichnung der Daten bestägt haben.

Der Wert entspricht dem Parameter acks in der Bibliothek librdkaa.

1.3 15

ibaPDA-Data-Store-Kaa Konguraon der Datenaufzeichnung

Message Batching Time

Zeit in Millisekunden, die ibaPDA wartet, um Nachrichten zu senden. Wenn der Wert 0 ist, wer-

den Nachrichten so schnell wie möglich an den Kaa-Cluster gesendet. Wenn der Wert auf z. B.

100 ms eingestellt ist, werden alle 100 ms Pakete mit gepuerten Nachrichten gesendet. Dies

erhöht die Latenzzeit, verringert aber den Verarbeitungsaufwand sowohl auf der Seite von

ibaPDA als auch auf der Cluster-Seite.

Der Wert entspricht dem Parameter linger.ms in der Bibliothek librdkaa.

ZusätzlicheParameter

Sie können zusätzliche Parameter der Bibliothek librdkaa kongurieren.

In der Tabelle sind bereits angelegte Parameter mit Namen und Wert aufgelistet. Neben der Lis-

te benden sich Buons mit folgenden Funkonen:

Parameter hinzufügen

Geben Sie in die Spalten Schlüssel und Wert den Namen und einen Wert ein.

Markierten Parameter löschen

Parameter imporeren

Sie können Parameter aus einer CSV-Datei imporeren, indem Sie im Dateibrowser

die CSV-Datei auswählen.

Parameter exporeren

Sie können Parameter in eine CSV-Datei exporeren. Geben Sie einen Dateinamen ein

und wählen einen Speicherort aus.

Hinweis

In der Liste kongurierte Parameter haben immer Vorrang und überschreiben

ggf. andere Einstellungen.

Die Dokumentaon der in der Bibliothek librdkaa verfügbaren Parameter n-

den Sie unter:

hps://github.com/edenhill/librdkaa/blob/master/CONFIGURATION.md

16 1.3

Konguraon der Datenaufzeichnung ibaPDA-Data-Store-Kaa

3.2.2 TypEventHub

Folgende Einstellungen sind für den Typ EventHub erforderlich:

ConneconString

Den Connecon-String entnehmen Sie den Eigenschaen des Event Hubs im Microso Azure

Portal.

Telegramm-Timeout

Zeit in Sekunden, die ibaPDA auf eine Antwort aus dem Event Hub wartet.

Mit dem Buon <Verbindung testen> können Sie die Verbindung zum Event Hub testen.

AkvierenderSSL-Verikaon

Für die SSL-Verikaon ist das aktuelle CA-Root-Zerkat "DigiCert Global Root G2" erforderlich,

da Azure-Dienste Zerkate damit signieren. Bei der Installaon von ibaPDA wird dieses Zer-

kat automasch im Zerkatsspeicher abgelegt.

3.3 Puer

Die Datenaufzeichnung nutzt einen Speicherpuer und zusätzlich einen oponal akvierbaren

Dateipuer.

Die Beschreibung gilt für alle Typen von Datenaufzeichnungen, die Daten zu externen Systemen

transferieren und bei denen es zu temporären Problemen bei der Erreichbarkeit und verfügba-

ren Bandbreite kommen kann, wie zum Beispiel:

■ ibaHD zeitbasiert/ereignisbasiert/längenbasiert

■ DB/Cloud zeitbasiert

■ Kaa-Cluster zeitbasiert

■ MQTT zeitbasiert

■ MindSphere zeitbasiert

■ InuxDB zeitbasiert

Daten, die an das Zielsystem gesendet werden sollen, durchlaufen immer den ibaPDA-inter-

nen Speicherpuer. Bei bestehender Verbindung zum Zielsystem werden die Daten aus dem

Speicherpuer sofort dorthin gesendet. Geht die Verbindung verloren oder können die Daten

nicht schnell genug verschickt werden, dann bleiben die Daten im Speicherpuer erhalten. Der

Speicherpuer liegt im RAM des ibaPDA-Rechners, ist daher limiert und üchg. Wird z. B. die

Erfassung neu gestartet, gehen die gepuerten Daten verloren. Wächst der Speicherpuer bei

1.3 17

ibaPDA-Data-Store-Kaa Konguraon der Datenaufzeichnung

laufender Erfassung über die kongurierte Größe hinaus an, werden die ältesten Werte gelöscht

und gehen somit verloren.

Zur Verbesserung kann zusätzlich ein Dateipuer akviert werden, der weitaus größere Daten-

mengen puern kann. Die Daten werden dabei in Dateien in einem Verzeichnis eines lokalen

Laufwerks des ibaPDA-Servers gespeichert. Bei akviertem Dateipuer werden Daten aus dem

überlaufenden Speicherpuer in den Dateipuer übertragen. Wird die Erfassung beendet oder

neu gestartet (z. B. durch Anwenden einer geänderten IO-Konguraon), werden Daten, die sich

evtl. zu diesem Zeitpunkt im Speicherpuer benden, ebenfalls in den Dateipuer übertragen.

Nach Wiederherstellung der Verbindung zum Zielsystem werden immer die ältesten Daten zu-

erst gesendet. Neuere Werte werden währenddessen dem Puer hinzugefügt. Wenn beim Start

der Erfassung noch gepuerte Daten im Dateipuer vorhanden sind, werden diese genauso be-

rücksichgt und verarbeitet. Die Daten werden in dem Format gespeichert, das zum Zeitpunkt

der Puerung in der Datenaufzeichnung konguriert war, und sie werden auch in diesem For-

mat bei Wiederherstellung der Verbindung gesendet.

Im Knoten Puer der jeweiligen Datenaufzeichnung nehmen Sie die Konguraon der Puerung

vor. Die nachfolgende Abbildung zeigt die Puerkonguraon am Beispiel der DB/Cloud zeitba-

sierten Datenaufzeichnung.

Speicherpuer

Der Speicherpuer ist immer akviert. Er kann nicht deakviert werden, da zu übertragende Da-

ten immer den Puer durchlaufen, bevor sie an das Zielsystem weitergegeben werden.

18 1.3

Konguraon der Datenaufzeichnung ibaPDA-Data-Store-Kaa

MaximaleGröße

Geben Sie hier die maximale Gesamtgröße für im Speicher gepuerte Elemente ein. Wenn die

maximale Größe überschrien wird, gibt es 2 Möglichkeiten:

■ Wenn die Dateipuerung deakviert ist, wird das älteste Element im Speicher gelöscht (und

ist damit für immer verloren).

■ Wenn die Dateipuerung akviert ist, wird der älteste Teil des Puerspeichers in eine Puer-

datei verschoben.

Speicherpuerregelmäßigspeichernalle…s

Diese Opon kann nur akviert werden, wenn der Dateipuer akviert ist. Wenn die Opon ak-

viert ist, wird der gesamte Speicherpuer periodisch in eine Puerdatei ausgelagert.

Geben Sie eine Dauer ein, nach der der Speicherpuer regelmäßig gesichert wird. Sie muss zwi-

schen 10 s und 600 s liegen.

Mit dieser Opon können Sie erreichen, dass möglichst wenig Daten bei einem Systemausfall

verloren gehen.

AktuelleSpeicherkonguraon

Anzeige, welche Zeitspanne ungefähr mit den kongurierten Einstellungen im Speicherpuer

zwischengespeichert werden kann. Angabe in d.hh:mm:ss.

Dateipuer

Dateipuerverwenden

Standardmäßig wird der Dateipuer nicht verwendet. Hier können Sie die Dateipuerung ak-

vieren.

AktuelleDateikonguraon

Anzeige, welche Zeitspanne ungefähr mit den kongurierten Einstellungen im Dateipuer zwi-

schengespeichert werden kann. Angabe in d.hh:mm:ss.

Dateiverzeichnis

Im Feld Dateiverzeichnis können Sie einen Speicherort für die Dateien wählen. Sie können das

Verzeichnis direkt in das Texeld eingeben oder über den Browse-Buon <…> auswählen. Das

kongurierte Dateiverzeichnis muss sich auf einer lokalen Festplae des ibaPDA-Server-Rech-

ners benden.

Das gleiche Dateiverzeichnis kann für mehrere Datenaufzeichnungen verwendet werden, da die

Puerdateien einer Datenaufzeichnung einen eindeugen Namen haben. Dateien aus verschie-

denen Datenaufzeichnungen können somit anhand ihres Namens unterschieden werden.

MaximalePuergröße

Sie können die maximale Gesamtgröße der Puerdateien einer Datenaufzeichnung kongurie-

ren. Die Puerdateien selbst haben die Dateierweiterung .buf, die Index-Datei zur Verwaltung

der Puerdateien hat die Endung .info. Die maximale Größe ist die Gesamtgröße aller dieser Da-

teien. Wenn die maximale Puergröße überschrien wird, wird die älteste Puerdatei gelöscht.

1.3 19

ibaPDA-Data-Store-Kaa Konguraon der Datenaufzeichnung

WeiterePuereinstellungen

MaximaleZeit

Gespeicherte Daten, die älter als die maximale Zeit sind, werden nicht an das Zielsystem über-

tragen. Dateien, die älter als die Maximalzeit sind, können gelöscht werden. Sie können einen

Wert zwischen 1 und 1000 Stunden eingeben.

DiagnoseSpeicherpuer/DiagnoseDateipuer

ZuletztenerntesElement

Zeigt an, wann das letzte Element aus diesem Teil des Puers genommen wurde.

Füllstand

Der Füllstand gibt jeweils an, welcher prozentuale Anteil der Puergröße aktuell mit gepuerten

Daten gefüllt ist.

UnverarbeiteterAnteil

Im Dateipuer werden Elemente, die an das Zielsystem übertragen wurden, nicht sofort ge-

löscht. Erst wenn eine Puerdatei vollständig gelesen ist, wird sie gelöscht. Es ist also möglich,

dass nur ein Teil einer Puerdatei noch nicht übertragene Daten enthält. Der Füllstand bezieht

sich auf die vorhandenen Puerdateien, der "unverarbeitete Anteil" gibt dagegen den prozentu-

alen Anteil der noch nicht übertragenen Daten im Dateipuer wieder.

20 1.3

Konguraon der Datenaufzeichnung ibaPDA-Data-Store-Kaa

3.4 KonguraonderTopics

Im Kaa-Cluster sind in der Regel mehrere Topics deniert, die vom Cluster-Administrator er-

stellt werden. Es ist nicht möglich Topics von ibaPDA aus im Cluster anzulegen oder zu löschen.

Wenn Sie den Knoten Topics markieren, wird die Liste der Topics angezeigt, die von der Daten-

aufzeichnung beschrieben werden sollen.

Buons zur Konguraon der Topics:

Topic-Liste von Kaa-Cluster herunterladen (Verbindung zum Cluster erforderlich)

Neues Topic manuell hinzufügen

Markiertes Topic enernen

Markierte Zelleninhalte in die Zwischenablage kopieren

Daten aus der Zwischenablage in Zellen einfügen

Markiertes Topic nach oben verschieben

Markiertes Topic nach unten verschieben

Hinweis

Mit den Tasten <Umsch> und <Strg> können Sie mehrere Zellen markieren und

kopieren/einfügen/löschen.

Wenn Sie JSON als Datenformat wählen, können Sie einstellen, ob digitale Signale als 1/0 oder

true/false gesendet werden.

Sie können die zu übertragenden Daten verringern, wenn Sie die Opon Nur geänderte Werte

senden akvieren.

Die Opon Kompaktes JSON-Format verringert die übertragene Datenmenge ebenfalls und ent-

fernt Füllzeichen, wie z. B. mehrfache Leerzeichen, Zeilenumbrüche usw., aus dem Telegramm.

Seite wird geladen ...

IBA ibaPDA-Data-Store-Kafka Bedienungsanleitung

Marke: IBA

Modell: ibaPDA-Data-Store-Kafka

Typ: Bedienungsanleitung

PDF herunterladen

Bericht

IBA ibaPDA-Data-Store-Kafka Bedienungsanleitung

IBA ibaPDA-Data-Store-Kafka Bedienungsanleitung

Verwandte Artikel