DE - bab technologie

b.a.b-technologie gmbh
DataWarehouse 2
Dokumentation
Anleitungsversion III.b
Stand 04/2011
Datum: 2. Mai 2013
DE
Inhaltsverzeichnis
Dokumentation
DataWareHouse 2.0
b.a.b – technologie gmbh
im INHOUSE Dortmund
Rosemeyerstr. 14
44139 Dortmund
[email protected]
Tel.: +49 (0) 231 – 476 425 - 30
Fax.: +49 (0) 231 – 476 425 - 59
www.bab-tec.de
DataWarehouse 2.0
b.a.b-technologie gmbh
2
Inhaltsverzeichnis
Dokumentation
DataWarehouse 2.0
INHALTSVERZEICHNIS
1
Einführung ............................................................................................................................................ 5
2
Voraussetzungen ................................................................................................................................. 5
3
DataWarehouse 2 starten ................................................................................................................... 6
3.1
3.2
4
Neue Datenbank anlegen ............................................................................................... 6
Datenbank auswählen..................................................................................................... 7
Datenbank Verbindung im eibPort erstellen ................................................................................... 9
4.1
4.2
4.3
Datenbank ....................................................................................................................... 9
Tabelle anlegen ............................................................................................................. 10
Datenbank Verbindung überprüfen ............................................................................. 10
5
Data Warehouse 2 Lizensieren ........................................................................................................ 12
6
Datenbank Auswertung ................................................................................................................... 13
6.1
eibPorts Konfigurieren ................................................................................................... 13
6.1.1 Manuelle Konfiguration............................................................................................. 14
6.1.2 Automatische Konfiguration (via Netzwerk) ............................................................ 14
7
Abfrage starten ................................................................................................................................. 15
7.1
7.2
7.3
Zeitparameter................................................................................................................ 15
Adressfilter ..................................................................................................................... 15
Starten der Abfrage ....................................................................................................... 16
8
Daten exportieren / Auswerten ...................................................................................................... 17
9
Analyse ............................................................................................................................................... 18
10
Wichtige Hinweise zum Umgang mit der Datenbank .................................................................. 19
10.1
10.2
10.3
11
Benutzerrechte für den Datenbankbenutzer ............................................................... 19
Sortierfunktion zur Leistungsoptimierung .................................................................... 20
Event Scheduler aktivieren............................................................................................ 20
Hinweis zur Funktionalen Sicherheit: ............................................................................................. 22
DataWarehouse 2.0
b.a.b-technologie gmbh
3
Inhaltsverzeichnis
Dokumentation
DataWareHouse 2.0
Abbildungsverzeichnis
Abbildung 1: DataWarehouse 2 - Assistent ............................................................................................... 6
Abbildung 2: Datenbankverbindungsassistent ......................................................................................... 7
Abbildung 3: Datenbankverbindung im eibPort ....................................................................................... 9
Abbildung 4: eibPort - Datenbank Status ............................................................................................... 11
Abbildung 5: Menü Hilfe Lizenz................................................................................................................ 12
Abbildung 6: Datenbank auswählen ........................................................................................................ 13
Abbildung 7: DataWarehouse - eibPort Konfigurieren.......................................................................... 13
Abbildung 8: Neue Abfrage ...................................................................................................................... 15
Abbildung 9: Adressfilter........................................................................................................................... 16
Abbildung 10: Analyse - Statistiken ......................................................................................................... 18
Abbildung 11: Meldung "Event Scheduler inaktiv" ............................................................................... 20
DataWarehouse 2.0
b.a.b-technologie gmbh
4
Dokumentation
DataWarehouse 2.0
1
Einführung
EINFÜHRUNG
Der eibPort besitzt einen internen Ringspeicher von 20.000 Telegrammen. Bei einem Ringspeicher wird
für das neueste Telegramm da s Älteste gelöscht. Je nachdem wie viel Telegrammverkehr in der Anlage
herrscht und ob der eibPort einen Aufzeichnungsfilter enthält, ist dieser innerhalb von wenigen Stunden
aufgebraucht.
Um eine Telegrammaufzeichnung auch über einen längeren Zeitraum aufbauen zu können, müssen die
Daten aus dem eibPort auf ein externes Medium abgelegt werden. Dazu bietet die eibPort Firmware
eine MySQL Datenbankverbindung. Die Daten werden dabei automatisch auf einen externen
Datenbankserver geschrieben. Um diese Daten am besten zu Organisieren und einer eventuellen
Auswertung zuzuführen, dient die eibPort Zusatzsoftware „DataWarehouse 2“.
2
VORAUSSETZUNGEN
Damit die hier beschriebenen Funktionen der DataWarehouse 2 und des eibPorts genutzt werden
können ist ein MySQL Server im Netzwerk erforderlich. Die Dokumentation über dessen Installation soll
hier nicht behandelt werden, da dies von Server zu Serversoftware unterschiedlich ist, und zu jedem
Derivat bereits ausreichend gute Installationsanleitungen existieren. Die DataWarehouse 2 stellt
folgenden Anforderungen an den MySQL Server:
MySQL Version: >= 5.1.12
Außerdem muss der „root“ – User bzw. ein Benutzer mit „SUPER“ Privilegien bekannt sein, damit die
DataWarehouse 2 die Datenbank und den entsprechenden Benutzer anlegen kann. Ein aktuelles
Installationspaket eines MySQL Servers inklusive Anleitung gibt es hier:
http://www.mysql.de
Dort kann der sogenannte „Community Server“ heruntergeladen werden.
DataWarehouse 2.0
b.a.b-technologie gmbh
5
Dokumentation
DataWareHouse 2.0
DataWarehouse 2 starten
3
DATAWAREHOUSE 2 STARTEN
Als Java Programm kann die „DataWarehouse 2“ direkt gestartet werden. Über einen Assistenten stellen
Sie eine Verbindung zu einer bestehenden Datenbank her oder legen eine neue Datenbank auf einem
bestehenden Server an.
Abbildung 1: DataWarehouse 2 - Assistent
3.1
NEUE DATENBANK ANLEGEN
Wechseln Sie in das Fenster „Datenbank anlegen“ und machen die erforderlichen Angaben. Diese sind:
Server Host / Server Port
Die IP-Adresse oder der Hostname des Datenbankservers. Die Port Nummer wird darunter eingetragen.
Der Standardport für MySQL ist 3306.
Admin Benutzer / Admin Passwort
Der Admin Benutzer ist der „root“ Benutzer des Datenbankservers. Nur er hat die Rechte Neue Benutzer
und Datenbanken anzulegen. Dieser Benutzer wird beim Erstellen des Datenbankservers angelegt.
Hinweis: Stellen Sie zuvor sicher das der Datenbankadministrator „root“ die erforderlichen
Rechte besitzt. Es kann sein dass der root Benutzer ohne Passwort angelegt ist, und nur die
Rechte hat von Lokal aus auf den Server zuzugreifen. Es sollte ein Passwort vergeben sein, und der
Benutzer von allen Hosts aus zuzugreifen dürfen (‚%‘).
Datenbank Name
Legt fest welchen Namen die neue Datenbank bekommt.
Datenbank Benutzer / Passwort
Ist das Benutzerkonto welches die DataWarehouse 2 benutzt. Die Benutzerdaten werden an dieser
Stelle festgelegt.
Durch einen Klick auf „OK“ wird die definierte Datenbank mit Benutzerkonto auf dem Server angelegt.
Scheitert der Vorgang wird eine entsprechende Fehlermeldung ausgegeben. Kontrollieren Sie dennoch
auf Ihrem Datenbank Server ob alles korrekt erstellt wurde (insbesondere der Benutzerrechte).
DataWarehouse 2.0
b.a.b-technologie gmbh
6
Dokumentation
DataWarehouse 2.0
3.2
DataWarehouse 2 starten
DATENBANK AUSWÄHLEN
Stellt die Verbindung zu einer bereits bestehenden Datenbank her. Außerdem kann eine
Datenbankverbindung geändert werden. Für den Verbindungsassistenten brauchen Sie folgende
Angaben:
Abbildung 2: Datenbankverbindungsassistent
Datenbank Verbindung
Geben Sie der Verbindung einen Namen.
Server Host
Die IP-Adresse oder der Hostname des Rechners auf dem die Datenbank installiert ist.
Server Port
Die Portnummer auf dem der MySQL Server kommuniziert. Standard ist 3306.
Data Warehouse Benutzer / Passwort
Der Benutzer-Account über den die DataWarehouse 2 mit dem Datenbankserver kommuniziert.
Verbindung Testen
Testen Sie Ihre Verbindungsangaben. Falls die Verbindung nicht hergestellt werden kann erscheint eine
Fehlermeldung mit entsprechenden Informationen.
Datenbank Name
Um hier eine Auswahl treffen zu können, muss der obige Verbindungstest erfolgreich verlaufen sein. Es
können dann alle zugehörigen Datenbanken ausgewählt werden.
Tabelle: Telegrammaufzeichnung
Für die spätere Auswertung ist es wichtig dass hier die richtige Tabelle ausgewählt wird. Hier muss
immer die Tabelle der Telegrammaufzeichnung ausgewählt werden. In der vordefinierten
Tabellenstruktur ist das die Tabelle mit dem Namen „eib_tele“!
Die Tabellenstruktur der DataWarehouse 2 Datenbank sieht folgendermaßen aus:
dw_eibport
dw_knx_data
dw_knx_groupaddress
dw_knx_grouprange
dw_queries
eib_tele
eib_tele_JJJJ_MM (J = Jahr / M = Monat)
DataWarehouse 2.0
b.a.b-technologie gmbh
7
DataWarehouse 2 starten
Dokumentation
DataWareHouse 2.0
Hinweis: Die Datenbank sortiert nach Ablauf jeden Tages die Tagestelegramme in ein
Monatsverzeichnis. Diese werden automatisch erstellt und dienen der besseren Performanz.
Weiter Informationen dazu finden Sie im letzten Kapitel.
Ist die Datenbank Verbindung erfolgreich angelegt erscheint diese in der Übersicht und ist in Zukunft
dort gespeichert. Um in die Auswertungsoberfläche zu gelangen muss die Verbindung einfach doppelt
geklickt werden.
DataWarehouse 2.0
b.a.b-technologie gmbh
8
Dokumentation
DataWarehouse 2.0
4
Datenbank Verbindung im eibPort erstellen
DATENBANK VERBINDUNG IM EIBPORT
ERSTELLEN
Nachdem die Datenbank mittels des Assistenten erfolgreich eingerichtet wurde, muss der eibPort
veranlasst werden diese Datenbank mit Daten zu beschreiben. Wechseln Sie dazu in die
Konfigurationsoberfläche „System“ (ConfigTool) > „Datenbank“ des eibPorts.
Abbildung 3: Datenbankverbindung im eibPort
4.1
DATENBANK
Konfigurieren Sie die Datenbankverbindung in dem Sie eine Rechtsklick im linken Fenster tätigen und
die Auswahl „Datenbankverbindung hinzufügen“ wählen.
Die Datenbank Verbindung benötigt folgende Parameter:
Beschreibung
Eine eindeutige Beschriftung der Verbindung.
Aktivieren
Aktiviert oder Deaktiviert die Verbindung.
Datenbanktyp
Es kann nur der Typ „MySQL“ ausgewählt werden.
Host
Die IP-Adresse oder der Hostname des Datenbank Servers.
Port
Der Port auf dem der Datenbankserver kommuniziert. Standardeinstellung ist 3306.
Datenbank
Bezeichnet den Datenbank Namen. Diesen haben Sie festgelegt als Sie die Datenbank über den
Datenbankassistenten angelegt haben.
Benutzername / Kennwort
Tragen Sie hier die Daten des Datenbankbenutzers ein, den Sie in der DataWarehouse 2 angelegt
haben. Drücken Sie dann unterhalb auf den „Speichern“ Button.
DataWarehouse 2.0
b.a.b-technologie gmbh
9
Dokumentation
DataWareHouse 2.0
Datenbank Verbindung im eibPort erstellen
4.2
TABELLE ANLEGEN
Um später die richtigen Daten in der Datenbank zu haben, muss dem eibPort mitgeteilt werden in
welche Tabelle er schreiben soll. Klicken Sie dazu wieder auf die neu angelegte Datenbank-verbindung
mit der rechten Maustaste und wählen „Tabelle hinzufügen“. Bei der Konfiguration haben Sie folgende
Parameter:
Bechreibung
Eine eindeutige Bezeichnung der Tabelle (z.B. „Telegrammaufzeichnung“).
Aktivieren
Standardmäßig ist jede neu-angelegte Tabelle aktiviert. Auf Wunsch kann Sie deaktiviert werden.
Typ / Name
Der eibPort bietet 3 verschiedene Datenbanktypen:
Telegramme: Schreibt die Telegrammaufzeichnung in die Datenbank. Standardname „eib_tele“.
Status Nachrichten: Schreibt die Adresszustandstabelle in die Datenbank. Standardname „s_table“.
Log Nachrichten: Schreibt das eibPort Systemlog in die Datenbank. Standardname „ep_log“.
Für die Auswertung der Telegrammdaten ist nur die Tabelle „eib_tele“ interessant.
Generiere SQL Anweisung
Um auf einem Datenbank Server die erforderliche Struktur anzulegen kann mittels dieser Funktion eine
SQL Anweisung generiert werden. Diese kann dann kopiert und auf dem Datenbankserver ausgeführt
werden. Für die DataWarehouse 2 ist das nicht nötig, das Anlegen der Datenstruktur ist bereits durch
das Programm geschehen.
Speichern
Die Einstellungen müssen über den „Speichern“ Button gespeichert sein, bevor der eibPort in die
Datenbank schreibt.
4.3
DATENBANK VERBINDUNG ÜBERPRÜFEN
Um die Verbindung vom eibPort zum Datenbankserver zu überprüfen gibt es ein kleines cgi Script im
eibPort welches über eine Webseite aufgerufen werden kann. Tippen Sie dazu in die Adresszeile Ihres
Browser folgende Adresse:
http://<eibPort_IP>/cgi-bin/db_statecgi
Nachdem Sie „Enter“ gedrückt haben wird eine Seite aufgerufen die Ihnen den „eibPort database
status“ ausgibt. Dort finden Sie Informationen über den Status der Verbindung. Ist die Verbindung mit
der Tabelle „eib_tele“ erfolgreich hergestellt worden sieht die Ausgabe etwas so aus:
DataWarehouse 2.0
b.a.b-technologie gmbh
10
Dokumentation
DataWarehouse 2.0
Datenbank Verbindung im eibPort erstellen
Abbildung 4: eibPort - Datenbank Status
Angezeigt wird sowohl der Status der Verbindung zur Datenbank als auch der Verbindungsstatus zur
entsprechenden Tabelle. Dabei wird angegeben ob die Verbindung aktiviert ist „Status: enabled“ und
ob die Verbindung aktiv ist bzw. ob die Verbindung erfolgreich ist „Active?: yes“.
Kann die Verbindung nicht hergestellt werden wird in der Zeile „Active?“ ein „no“ angezeigt und in der
Zeile darunter eine Fehlermeldung. Z.B.: „Access denied…“ wegen falscher Benutzerdaten. Überprüfen
Sie dann die Einstellungen im eibPort, ändern Sie sie ggf. und speichern die Verbindung neu ab. Um
danach erneut den Datenbankstatus abzufragen, muss wieder der oben genannte URL aufgerufen
werden.
DataWarehouse 2.0
b.a.b-technologie gmbh
11
Dokumentation
DataWareHouse 2.0
Data Warehouse 2 Lizensieren
5
DATA WAREHOUSE 2 LIZENSIEREN
Um eine gültige Lizenz in die DataWarehouse 2 zu laden nutzen sie bitte das Menü „Hilfe“ > „Lizenz“
im Hauptfenster der DataWarehouse 2. Das Hauptfenster öffnet sich, sobald eine Datenbank-verbindung
ausgewählt wurde.
Abbildung 5: Menü Hilfe Lizenz
Eine Lizenz für die DataWarehouse 2 kann über [email protected] angefordert werden. Ohne Lizenz
können Sie keine Daten aus der DataWarehouse 2 exportieren.
DataWarehouse 2.0
b.a.b-technologie gmbh
12
Dokumentation
DataWarehouse 2.0
6
Datenbank Auswertung
DATENBANK AUSWERTUNG
Ist wie oben beschrieben eine Datenbankverbindung zu einer bestehenden Datenbank angelegt und
befinden sich entsprechenden Daten in dieser, kann eine Auswertung angelegt werden. Klicken Sie dazu
doppelt auf die Verbindung um in das Hauptfenster der DataWarehouse 2 zu gelangen.
Abbildung 6: Datenbank auswählen
6.1
EIBPORTS KONFIGURIEREN
Damit die DataWarehouse 2 die Telegrammdaten richtig interpretieren kann werden die Informationen
über die verschiedenen Datentypen benötigt. Dazu dienen die ESF Daten (ETS Adressdatei) die auch der
eibPort verwendet. Sie werden in die Datenbank geladen und mit den Telegrammdaten verknüpft.
Einmal geladen stehen Sie in Zukunft immer zur Verfügung.
Wählen Sie dazu in der DataWarehouse 2 das Menü „Datenbank“ > „eibPorts konfigurieren“. Es werden
Ihnen automatisch alle eibPorts angezeigt die in die ausgewählte Datenbank schreiben. Dabei erscheint
der eibPort Name und die entsprechende Seriennummer. Um die ESF Daten zu in die Datenbank zu
laden stehen Ihnen zwei Möglichkeiten zur Verfügung:
Abbildung 7: DataWarehouse - eibPort Konfigurieren
DataWarehouse 2.0
b.a.b-technologie gmbh
13
Dokumentation
DataWareHouse 2.0
Datenbank Auswertung
6.1.1
MANUELLE KONFIGURATION
Die Adressdaten werden manuell, z.B. von der Festplatte des Client Rechners in die DataWarehouse2
geladen. Die Verknüpfung findet automatisch statt.
eibPort Name
Nutzen Sie am besten denselben Namen wie für den eibPort selbst.
ESF Daten importieren
Die ESF Daten kommen aus der ETS und enthalten die Informationen über Bezeichner und Datentyp der
Adressen. Wählen Sie hier die entsprechende Datei aus (mit der Endung *.esf). Die importierten Daten
werden im Fenster „ESF Daten“ angezeigt. Mit „OK“ bestätigen Sie den Vorgang, die Datei wird in der
Datenbank gespeichert.
6.1.2
AUTOMATISCHE KONFIGURATION (VIA NETZWERK)
Diese Funktion erlaubt es Ihnen die Adressdatei direkt vom eibPort (falls dort vorhanden) in die
DataWarehouse 2 zu laden. Dazu muss der Hostname oder die IP-Adresse und der http Port des eibPorts
angegeben werden.
Parameter einlesen
Die ESF Daten werden automatisch aus dem gewähltem eibPort übertragen. Die Daten werden dann im
Fenster „ESF Daten“ angezeigt. Durch das Klicken der „OK“ Taste wird die Auswahl bestätigt und in die
Datenbank geschrieben.
DataWarehouse 2.0
b.a.b-technologie gmbh
14
Dokumentation
DataWarehouse 2.0
7
Abfrage starten
ABFRAGE STARTEN
Um eine Auswertung von bestimmten Telegrammdaten erzeugen zu können,
muss eine Abfrage der Datenbank nach Gruppenadresse(n) und Zeitraum
erfolgen. Eine Abfrage wird über den Reiter „Neue Abfrage“ gestartet. Dort
werden Zeitraum und Gruppenadressen bestimmt.
7.1
ZEITPARAMETER
Für die Auswahl des Zeitraums stehen entweder das Monatsarchiv oder eine
beliebige definierbare Zeitspanne zur Verfügung.
Monatsarchiv
Die Monatsarchive werden von der Datenbank automatisch erzeugt. Sofort nach
Ende des ersten Tages eines Monats wird das neue Monatsarchiv geschrieben.
Dies erfolgt durch einen sogenannten „Event Scheduler“ um 0:05 automatisch
jeden Tag.
Neben den Monatsarchiven gibt es noch die Auswahl „Live Aufzeichnung“. Hier
befinden sich alle Telegramme des heutigen Tages.
Hinweise: Bitte beachten Sie unbedingt die Hinweise zu Event Scheduler am
Ende dieses Dokuments um seine einwandfreie Funktion zu gewährleisten.
Abbildung 8: Neue
Abfrage
Zeitspanne
Über dieses Menü wählen Sie aus einer Kalenderübersicht beliebige Zeiträume aus, die dann nach den
gewünschten Gruppenadressen gefiltert werden.
7.2
ADRESSFILTER
Im Adressfilter befinden sich alle Gruppenadressen die für die Auswertung hinzugefügt wurden. Über
„Hinzufügen“ öffnet ein Auswahlmenü in der Geräte(es können auch mehrere eibPorts in eine
Datenbank schreiben) und Adressen ausgewählt werden können.
eibPort auswählen
In jede Datenbank können mehrere eibPorts schreiben. Die Datenbank kann die Informationen anhand
der eibPort - Seriennummern unterscheiden, die in jedem Datensatz enthalten ist. Um es für den
Benutzer einfacher zu machen wird außerdem der eibPort Name angezeigt, sofern vorhanden.
Manuelle Adresseingabe
Geben Sie die Gruppenadresse, den richtigen Datentyp und ein Beschreibung der Gruppenadresse an.
DataWarehouse 2.0
b.a.b-technologie gmbh
15
Dokumentation
DataWareHouse 2.0
Abfrage starten
Abbildung 9: Adressfilter
ESF Adressauswahl
Die Adressinformationen hat die Datenbank über den Menüpunkt „Datenbank“ > „eibPorts
konfigurieren“ erhalten. Zum Auswahl einer Adresse diese mit der Maus markieren und auf „OK“ klicken.
Es kann immer nur eine Adresse gleichzeitig ausgewählt werden
7.3
STARTEN DER ABFRAGE
Haben Sie einen Zeitraum definiert und eine oder mehrere Gruppenadressen ausgewählt, können Sie
über den Button „Abfrage starten“ die entsprechenden Daten aus der Datenbank filtern. Je nachdem
wie umfangreich Ihre Abfrage aufgebaut ist, und wie viel Rechenleistung Ihr Datenbankserver besitzt,
kann diese Abfrage etwas Zeit in Anspruch nehmen.
Sie erhalten als Ausgabe ein Fenster namens „Neue Abfrage 1“. Alle Daten werden untereinander
aufgelistet und nach Zeit sortiert. Über den Button „Spalten Auswählen“ wird bestimmt welche Spalten
angezeigt werden.
DataWarehouse 2.0
b.a.b-technologie gmbh
16
Dokumentation
DataWarehouse 2.0
8
Daten exportieren / Auswerten
DATEN EXPORTIEREN / AUSWERTEN
Die DataWarehouse 2 versteht sich zunächst als ein Zusatzprogramm um die aufkommenden Daten zu
organisieren und gemäß der ETS Information richtig zu interpretieren. Außerdem dient Sie dazu die
Werte die einer grafischen Auswertung zugeführt werden sollen aus der Datenbank abzurufen und zu
exportieren. Eine direkte grafische Auswertung in der DataWarehouse 2 selber ist zwar in der Zukunft
angedacht, aber zurzeit nicht implementiert.
Exportieren
Die zuvor über die definierte Abfrage zusammengetragenen Daten werden als „Comma Seperated
Value“ – Datei (*.CSV) exportiert. Als universelles Format können diese Daten dann von weiteren
Programmen genutzt werden um eine grafische Auswertung daraus zu generieren (z.B. in Microsoft™
Excel).
Auswerten
In Zukunft soll es möglich sein über sogenannte ‚Plugins‘ eine Auswertung direkt aus der DataWarehouse
2 selber möglich zu machen. Kunden und Interessierte sollen hier die Möglichkeit haben selber Plugins
für die DataWarehouse 2 zu entwickeln.
DataWarehouse 2.0
b.a.b-technologie gmbh
17
Analyse
9
Dokumentation
DataWareHouse 2.0
ANALYSE
Der Menüpunkt „Analyse“ bietet ein paar vorgefertigte Datenbankabfragen im Sinne einer Analyse.
Damit ist es möglich einige generelle Statistiken über die Datenbank bzw. über den Telegrammverkehr
in der Anlage abzufragen.
Abbildung 10: Analyse - Statistiken
Datenbank Statistik
Zeigt eine Übersicht über die verschiedenen Tabellen (Monatsarchive), wie viele Telegramme darin
vorhanden sind und wie viel Speicherplatz diese verbrauchen.
KNX Gruppenadressen
Fragt eine Telegrammstatistik sortiert nach Gruppenadressen ab. Die Abfrage kann entweder für die Live
Aufzeichnung (heutiger Tag) oder für die einzelnen Monatsarchive erfolgen.
Physikalische Adressen
Hier wird die Telegrammstatistik nach Physikalischen Adressen sortiert. Die Abfrage erfolgt entweder für
die Live Aufzeichnung (heutiger Tag) oder für die einzelnen Monatsarchive. Die Angabe „Virtuelle GA“
beschreibt die Physikalische Adresse auf der alle virtuellen Adressen des eibPorts gesendet werden.
Telegramm-Statistik
Stellt eine Telegrammstatistik gruppiert nach Monaten oder einzelnen Tagen her. Wenn ein
einzelner Tag gewählt wird, wird die Gesamttelegrammlast in 1h Blöcke unterteilt. Wird ein
Monat gewählt werden diese nach Tagen unterteilt.
DataWarehouse 2.0
b.a.b-technologie gmbh
18
Dokumentation
DataWarehouse 2.0
10
Wichtige Hinweise zum Umgang mit der Datenbank
WICHTIGE HINWEISE ZUM UMGANG MIT DER
DATENBANK
Die Datenbank muss verschiedene Anforderungen erfüllen, damit die sd mit optimaler Performance
arbeiten kann. Dazu nicht nur eine Tabelle erstellt und täglich um 0:05 startet eine Optimierung der
aufgezeichneten Daten. Wenn sich bereits Telegramme in der Aufzeichnung befinden, kann das erste
Sortieren je nach Anzahl der Daten und Leistung des Datenbankservers durchaus einige Stunden dauern.
Während dieser Zeit darf der Datenbankserver nicht heruntergefahren werden. Vor einem
Herunterfahren sollte Sie vorsichtshalber eine Datenbanksicherung durchführen.
Die Kriterien für den optimalen Betrieb lassen sich folgendermaßen aufteilen:
Telegrammaufzeichnung
Dieser Teil besteht aus zwei Komponenten: Zuerst wird eine Funktion angelegt, mit der dynamisch neue
Aufzeichnungstabellen erstellt werden können, danach wird eine erste Aufzeichnungstabelle erstellt, in
die der eibPort Telegramme schreiben kann.
Data Warehouse Userspace
Die Data Warehouse speichert Einstellungen und ESF Daten in der Datenbank. Dazu werden einige
zusätzliche Tabellen angelegt.
Sortiermodule
Die Sortierprozeduren optimieren die aufgezeichneten Daten indem sie nach Monaten aufgeteilt und
gespeichert werden.
Sortierevent
Täglich um 0:05 werden die Sortiermodule aufgerufen. Dazu wird ein Event angelegt was automatisch
durch den MySQL Server aufgerufen wird und die Optimierung startet. Damit die tägliche Optimierung
vorgenommen wird, muss der Event Scheduler gestartet sein!
Um diese Voraussetzungen zu schaffen muss der DataWarehouse 2 Datenbank Benutzer die unten
beschriebenen Rechte auf den dem Datenbankserver besitzen.
10.1
BENUTZERRECHTE FÜR DEN
DATENBANKBENUTZER
Der DataWarehouse 2 Datenbankbenutzer braucht folgende Berechtigungen:
SELECT
INSERT
UPDATE
DELETE
DROP
CREATE
INDEX
ALTER
CREATE_ROUTINE
ALTER_ROUTINE
EXECUTE
EVENT
Diese können entweder über „phpMyAdmin”, „MySQL Administrator” oder über die Kommandozeile
vergeben werden.
Die Befehle für die Kommandozeile sind:
DataWarehouse 2.0
b.a.b-technologie gmbh
19
Wichtige Hinweise zum Umgang mit der Datenbank
Dokumentation
DataWareHouse 2.0
CREATE USER '_username_'@'%' IDENTIFIED BY '_password_';
GRANT
SELECT, INSERT, UPDATE, DELETE,
DROP, CREATE, INDEX, ALTER, CREATE ROUTINE, ALTER ROUTINE, EXECUTE, EVENT
ON '_datenbank_'.* TO '_username_'@'%';
Wir empfehlen diese Einstellungen über das Webinterface wie „phpMyAdmin“ zu machen.
10.2
SORTIERFUNKTION ZUR
LEISTUNGSOPTIMIERUNG
Wenn die DataWarehouse 2 die Datenbank "vorbereitet" hat, gibt es eine Tabelle in die der eibPort
seine Daten schreibt: „eib_tele“. Damit in der Tabelle nicht zu viele Daten stehen, die kleinere Server
mit wenig RAM (z.B. NAS Festplatten) ausbremsen, werden die Datensätze täglich umsortiert. Dazu
startet nachts um 0:05 eine Sortierfunktion (siehe „Event Scheduler“). Die Datensätze werden damit in
Monatsarchive unterteilt.
Die Tabellen werden dann wie folgt benannt: „eib_tele_2010_01“, „eib_tele_2010_02“,
„eib_tele_2010_03“ usw. In diesen Tabellen werden bei einer durchschnittlicher Telegrammlast (4
Telegramme / Sekunde) etwa 10 Millionen Datensätze pro Monat anfallen.
Hinweis: Auf einem wenig leistungsfähigen Server sollte nur ein eibPort in eine Datenbank
loggen, wobei durchaus mehrere Datenbanken auf einem Server laufen können. Auf einem
leistungsfähigeren Server können auch mehrere eibPorts problemlos in eine Datenbank
schreiben.
10.3
EVENT SCHEDULER AKTIVIEREN
Der Event Scheduler wird benötigt um die Umsortierung der Daten jede Nacht zu veranlassen. Er kann
nur aktiviert werden, wenn der Datenbank Benutzer sog. “SUPER” – Rechte hat. Dieser Parameter geht
verloren wenn der MySQL Server neugestartet wird. Um den Event Scheduler beim Serverstart zu
aktivieren muss die Konfiguration geändert werden.
Abbildung 11: Meldung "Event Scheduler inaktiv"
Auf der Synlogy DiskStation
Greifen Sie per ssh (Windows = Putty) auf die DiskStation zu. Der ssh Dienst der DiskStation muss
ggf. erst aktiviert werden.
Öffnen Sie die Datei „/usr/syno/etc/rc.d/S21mysql.sh“ mit dem Texteditor „vi“. Tippen Sie also:
vi /usr/syno/etc/rc.d/S21mysql.sh <Enter>
DataWarehouse 2.0
b.a.b-technologie gmbh
20
Dokumentation
DataWarehouse 2.0
Wichtige Hinweise zum Umgang mit der Datenbank
Gehen Sie mit den Cursor Tasten zu der Zeile „MYSQL_ARGS=“. Das sind die ‚Arguments‘ mit
denen der MySQL Server startet. Um im „vi“ Änderungen am Text vorzunehmen müssen Sie
zunächst durch die Eingabe von „i“ in den sog. „insert“ Modus wechseln.
Fügen Sie „--event-scheduler=1“ in diese Zeile ein, so dass es folgendermaßen aussieht:
MYSQL_ARGS=”-—max_allowed_packet=8M -–event-scheduler=ON”
Haben Sie den Eintrag geändert beenden Sie den „insert“ – Modus durch Drücken der „Esc“ –Taste
und geben ein „:wq“ (Doppelpunkt, W, Q). Dadurch speichern Sie die Änderung und verlassen den
„vi“.
Nach Änderung der Argumente muss der MySQL Server neugestartet werden, das erreichen Sie mit
folgendem Kommando:
„/usr/syno/etc/rc.d/S21mysql.sh restart“
Hinweis: Bitte beachten Sie, dass diese Einstellung bei einem Firmware Update zurückgesetzt wird.
Schließen Sie danach einfach die Putty Console über das „X“ oder geben Sie „exit“ ein. Das Programm
„Putty“ können Sie hier herunterladen: http://www.putty.org/. Außerdem finden Sie im Internet
zahlreiche Dokumentation über den Text Editor „vi“.
Unter Ubuntu:
Öffnen Sie Konfigurationsdatei
„/etc/mysql/my.cnf“
Fügen Sie die Zeile „event-scheduler=1“ in die Sektion “Fine Tuning” ein. Der MySQL Server kann
mit dem Kommando “service mysql restart” neugestartet werden.
Unter xampp Version 1.7.3
Öffnen Sie die die Konfigurationsdatei
„\xampp-win32-1.7.3\xampp\mysql\bin\my.ini
mit einem Texteditor. Fügen Sie die Zeile „event-scheduler=1“ in die Sektion „[mysqld]“ ein,
speichern Sie ab und starten Sie den MySQL Server neu.
DataWarehouse 2.0
b.a.b-technologie gmbh
21
Hinweis zur Funktionalen Sicherheit:
11
Dokumentation
DataWareHouse 2.0
HINWEIS ZUR FUNKTIONALEN SICHERHEIT:
Diese Software dient zur Protokollierung von Daten des KNX- Bussystems. Sie dient somit zur
Datensammlung von Werten die aus Anwendungen der Risikoklasse III und IV (nach IEC 65A (SEC) 123)
erzeugt werden. Sollten Daten aus höheren Risikoklassen aufgezeichnet werden, so sind vom Betreiber
der Software geeignete Maßnahmen zur Risikoverminderung zu treffen.
Eine Haftung, sowie Schadensersatzansprüche für unmittelbare und mittelbare Folgen durch
Fehlfunktion der Software sind hiermit ausgeschlossen.
Siehe auch Handbuch Gebäudesystemtechnik Grundlagen des ZVEI/ZVEH.
DataWarehouse 2.0
b.a.b-technologie gmbh
22