Anzeige APCUPSD Statusmeldungen

Einsatz:

Einbindung von APC UPS via APCUPSD Statusmeldungen in IP-Symcon. Das Script sendet eine "STATUS"-Anfrage an den APCUPSD via ClientSocket und wertet die Daten aus.
Zur Verarbeitung in IPS ist es notwendig, die empfangenen Datensätze zu dekodieren. Jede APC UPS verfügt über eine individuelle ID, die als Kennzeichnung einer UPS dient. Damit ist es möglich, das gleiche Script für mehrere APC-UPS im Netzwerk einzusetzen. Dieses Script wird durch einen zeitgesteuerten IPS-Event (bei mir alle 2min) zyklisch aufgerufen.
Die Scripte bietet z.Z. eine Implementierung für die wichtigsten Parameter, kann aber leicht erweitert werden. Desweiteren wurde eine dynamische Erstellung und Verwaltung der IPS-Variablen sowie von zusätzlichen Variablenprofilen integriert.

Sourcecode: (V0.9 13.11.2011)

• apcregvar.phps Script

Funktion:

Das Script implementiert die Auswertung der Status-Daten eines oder mehrerer APCUPSD-Installationen und wird gewöhnlich über einen Timer (in IPS "zyklisches Ereignis") gestartet. Dazu wird kurzzeitig eine Socketverbindung zu den konfigurierten APCUPD-Instanzen aufgebaut, ein Status-Befehl gesendet und das Ergebnis verarbeitet.
Für jede UPS wird eine neue IPS-Kategorie in den IPS-Baum eingefügt und dort für viele übermittelte Parameter spezifische Variablen selbstständig angelegt, die sich anschliesssend beliebig weiterverarbeiten lassen. Leider sind die Variablen zwischen den Modellgruppen unterschiedlich, so das ggfls. eine Anpassung der Schlüsselwörter im Script vorgenommen werden muss. Defaultseitig vorhandene Variablen, die nicht von der USV gefüllt werden können, werden wieder gelöscht. Ausnahme: "NominalPower(NOMPOWER)" wird nur von wenigen UPS bereit gestellt, wird aber zur Berechnung der aktuellen Leistung benöigt. Es wird versucht, diesen Wert aus der Modellbezeichnung und einer Equivalenztabelle (array $nomvalues) zu ermitteln, ansonsten wird ein default Wert eingesetzt, dessen Variablenwert in IPSymcon geändert werden kann.
Den Variablen wurden gängige Variablenprofile zugewiesen, wobei nicht im IPS-Standard enthaltene Profile dynamisch angelegt werden. Damit können die APC Statusdaten auch im Webfront automatisch visualisiert werden Weiterhin werden alle Meldungen in Logfiles geschrieben werden.
Das Regvar-Script kann man auch über die Konsole ausführen.

Installation

Für jede UPS ist ein APCUPSD auf einem anderen Host und/oder Port zukonfigurieren. APCUPSD ist für viele Betriebssysteme erhältlich. Host bzw. IP-Adresse und Port (default 3551) sind zu notieren. Testweise sollte nun das Programm "apcaccess" aus der APCUPSD-Installation (im "bin" bzw "/sbin"-Verzeichnis) mit dem Host und Port aufgerufen werden, z.B.

 apcaccess status localhost:3551

IPS-Konfiguration:

Dann wird in IPSymcon für jede APCUPSD-Installation eine IPS-Clientsocket-Instanz und eine zugehörige RegisterVariablen-Instanz mit der jeweiligen ClientSocket-Instanz als Parent angelegt.

IPS-Instancen

In der Clientsocket-Instanz sind die notierten Werte für Host bzw. IP-Adresse und Port einzutragen. Zum Eintragen muss die Checkbox "Socket öffnen" aktiviert werden. Im späteren Betrieb ist der Clientsocket normalerweise geschlossen und wird nur zeitweise durch das Script für die Abfrage geöffnet.

IPS-Client Socket

Es ist ein neues Script mit dem Inhalt von apcregvar.phps zu erstellen und in jeder "Registervariable"-Instance als Ziel zuzuweisen.
Am Anfang des Scriptes sind die IDs der RegisterVariablem-Instancen einzutragen, deren zugeordnete Clientsocket-Instancen abgefragt werden sollen.

 $regvars=array(39883,39131);

Spezielle Konfiguration

Am Enfang des Scriptes befindet sich eine Konfigurationssection, in der einige Optionen gesetzt werden können.

Kategorie- und Variablennamen: Die Namen der angelegten Kategorien kann man ändern, nicht aber deren Hierarchie und die Namen der Variablen. Die Masterkategorie wird in der globalen Variablen geändert. Der Parent der Masterkategorie ist per Default die IP-Symcon-Root (ID=0). Diese kann aber ebenfalls auf eine andere existierende! Kategorie geändert werden, sodass der Variablenbaum an beliebiger Stelle eingehängt werden kann.

 $GLOBALS['parent']=0; //parent ID of master category
 $GLOBALS['catname']='APCUPSD'; //master category name
 

$GLOBALS['idname']='SERIALNO';

 $logfile="";

• 1. Die USV liefert den Wert als Parameter "NOMPOWER"
• 2. Wenn sie das nicht liefert, wird aus der Modelbezeichnung die erste 3-4stellige Zahl extrahiert. Diese gibt bei APC i.d.R. die mathematische Scheinleistung an, die nominelle Leistung ist in den Datenblättern geringer angegeben und folgt auch keiner konkreten Formel, ist aber ca. Divisor 1.4-1.5 je nach Modell. Deswegen gibt es das Array §nomvalues, mit der mit der Zahl aus der Modellbezeichnung der Werten aus dem Datenblatt ermittelt werden kann. Dieses Array kann man bei fehlenden Geräten ergänzen
• 3. Ist bis jetzt immer noch keine Zahl ermittelt worden, wird der Defaultwert 500W eingesetzt.
• 4. Wurde die IPS Variable NomPower einmal gesetzt oder geändert, wird dieser Wert verwendet.

Index
Disclaimer

© 2010-2011 Thomas Dreßler
Alle Rechte vorbehalten

letzte Änderung 13.11.2011