Symcon-Modul: MySQL Archiv

Zusätzliches Archiv für MySQL Datenbanken.

Dokumentation

Inhaltsverzeichnis

• 1. Funktionsumfang
• 2. Voraussetzungen
• 3. Installation
• 4. Vorbereitungen
• 5. Einrichten der Instanz in IPS
• 6. PHP-Funktionsreferenz
• 7. Parameter
• 8. Anhang
  • 1. GUID der Module
  • 2. Changelog
• 9. Spenden
• 10. Lizenz

1. Funktionsumfang

Variablenveränderungen in einer MySQL-Datenbank speichern.
Auslesen mit ACMYSQL_* PHP-Funktionen (kompatibel mit den AC_* Befehlen).

Achtung:
Dieses 'Archive Control' ersetzt nicht das Original in IPS.
Es wird nicht zur Visualisierung der IPS eigenen Graphen genutzt.
Ebenso kann das Logging-Verhalten nicht über die Einstellungen der Variable angepasst werden, sondern nur in der Instanz 'Archiv MySQL'.
Der Typ Zähler ist aktuell nicht verfügbar.

Um die gespeicherten Daten darzustellen, müssen Umsetzungen von dritten (wie z.B. Highcharts) genutzt werden.
Eine angepasste Highcharts.ips.php ist unter 'docs' beigefügt und kann über die Konfiguration der Instanz in den Objektbaum kopiert werden.

2. Voraussetzungen

• IPS ab Version 5.1
• MySQL Server

3. Installation

IPS 5.1:
Bei privater Nutzung: Über den 'Module-Store' in IPS das Modul MySQL Archiv hinzufügen.

Bei kommerzieller Nutzung (z.B. als Errichter oder Integrator) wenden Sie sich bitte an den Autor.

4. Vorbereitungen

• Der MySQL-Server muss von IPS aus erreichbar sein.
• Es muss ein Benutzer mit allen erforderlichen Rechten vorhanden sein. (Daten & Struktur)

5. Einrichten der Instanz in IPS

• Auf der Willkommen-Seite von IPS dem Link 'Instanz hinzufügen' öffnen.
• In den Schnellfilter MySQL eingeben.
• Den Eintrag 'Archiv MySQL' wählen und mit OK bestätigen.
• Die Instanz über einen weiten Klick auf OK erzeugen.
• Im folgenden Dialog des Konfigurator müssen jetzt erst die Zugangsdaten zum MySQL-Server eingegeben werden.
• Die zu loggenden Variablen müssen über den Button 'hinzufügen' und dann durch einen Klick auf den Stift ausgewählt werden.

6. PHP-Funktionsreferenz

Es sind alle IPS Befehle des Original Archive-Control vorhanden.
Der Prefix muss nur von AC_ gegen ACMYSQL_ ersetzt werden.
Da aktuell keine Zähler unterstützt werden, werden diese Rückgabewerte immer mit 0 übergeben.

7. Parameter

Name	Eigenschaft	Typ	Standardwert	Funktion
Host	Host	string		Hostname / IP-Adresse
Datenbank	Database	string	ips	Name der Datenbank
Benutzername	Username	integer		Benutzername MySQL
Passwort	Password	string		Passwort MySQL
Variablen	Variables	string	{}	JSON-String mit allen VariablenID

8. Anhang

1. GUID der Module

Modul	Typ	Prefix	GUID
Archive Control MySQL	Device	ACMYSQL	{FDCB334A-AFFF-4785-9596-D380252CEE4E}

2. Changelog

Version 3.35:

• Das Anzeigen der Konfiguration konnte fehlschlagen, wenn in einer Tabelle keine Werte vorhanden waren.
• ACMYSQL_GetAggregationVariables konnte fehlschlagen, wenn in einer Tabelle keine Werte vorhanden waren.
• ACMYSQL_ChangeVariableID konnte fehlschlagen,wenn in einer Tabelle keine Werte vorhanden waren.
• ACMYSQL_GetLoggedValues konnte fehlschlagen,wenn in einer Tabelle keine Werte vorhanden waren.
• ACMYSQL_GetAggregatedValues konnte fehlschlagen,wenn in einer Tabelle keine Werte vorhanden waren.

Version 3.31:

• Fix für defekte 3.20 Version.

Version 3.20:

• Release für IPS 5.1 und den Module-Store

Version 3.10:

• Buffer Tread-Safe mit Semaphore abgesichert.

Version 3.00:

• Loggen der Daten von Nachrichtenschlange entkoppelt.

Version 2.50:

• Anpassungen für IPS 5.1

Version 2.00:

• Anpassungen für IPS 5.0
• Modul intern umgebaut
• Konfiguration für WebConsole verbessert

Version 1.02:

• Fixes für IPS 5.0

Version 1.01:

• Erstes offizielles Release

9. Spenden

Die Library ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:

10. Lizenz

IPS-Modul:
CC BY-NC-SA 4.0