Home
LabCon Benutzerhandbuch
Contents
1. 49 insert_to_menu htm txt 100 insert_to_side php txt 95 100 IP SUN Sy een 34 E 67 K Konfigurationsblock 50 L labCon_icinga_ClassicMenu php 100 labcon_menu php 95 100 LED EE 13 ern keer een erence eee ee 67 Lost Message Counter 28 L ftersteuerung 73 M MAG seen 26 Management Information Base 43 Measurement Intervall 20 menu hiMml uuu annenne 100 MIB ie 43 100 MID eine 100 Deeg kee 12 20 26 73 Seite 82 101 LabCon Benutzerhandbuch Version 1 15 N Wie UE 100 AGIOS C scscesvecesosseetccsseassscceceseees 89 Node Discover 25 27 PB Se ae 58 P Pils ie 26 POW tree 67 PRESSE er 67 R GC BE 27 Regelkreis 2 2 u0 00040r 73 Remove Offline Devices 27 ROUler ee 11 S oi E 84 ENEE 101 SD Karte ea 13 Send Commande 28 send eege eene 71 Set IPAQ Yo al 60 70 SIGS OM Di ssrcccesscancezsisrergcanonianse 95 100 eege 35 DNMP Agent 43 DNMPD Manager 43 snmptrapd CONnf u unrins 98 Standalone Mode 39 Gieuerungsblock 51 T deeg 67 Transmit Intervall 20 AD DEE 35 46 le E EE 98 IPs re 43 2013 pikkerton GmbH Lite ru 75 INT esse 12 20 26 73 U UAT nenn 67 USB nee 13 VM Vu 67 Ww WORK nee 67 Z ZBG 100 EE 13 ZBS Diensle us 67 ZBS Buzzer
2. D lt N lt 3 O 5 o zige 3 etr 3 8 S 9 5 Eer H kal ga Messung von Strom Spannung Frequenz Leistung und Arbeit ZBS 110 Schalten von Lasten Smart Energy Optional PIR O d d O X Meter p S Bewegungsw chter Optional Temperaturmessung Messung von Strom ZBS 111 Spannung Frequenz Smart Energy Kate dArbeit X d d x x Meter DIN Rail one und Arbel Schalten von Lasten in Messung von Strom Spannung Frequenz x x x S ch nr Leistung und Arbeit v v Schalten von Lasten o x Temperatur Q Bewegung PIR passiv ZBS 12x Infrarot X X Multisensor Luftfeuchtigkeit d d d Luftdruck Helligkeit 2013 pikkerton GmbH Seite 57 101 LabCon Benutzerhandbuch oe e Se Version 1 15 CM L S PIKKERTON Bild Bezeichnung Beschreibung Fis Sf F F Zla Ss SS D KI D a E 3 gt oi lt Ss SZ 8g lt g 3 2 E kal oa 2 D Be Sendet einen Nachricht ZBS 130 bei Tastendruck X X Handheld Blinken als m gliches v v Feedback ZBS 132 berwacht Kontakt Magnetkontakte X X X d d berwachung Glasbruch Lautst rke er Integration Anschluss 140 8 externer Geber o 0O oO oO oO Kunden spezifisch Sensoren Alle unbekannten oder neu angemeldeten die Non ZBS noch nicht identifiziert X X X X x wurden ZigBee Ger te am Koordinator Tabelle 2 LabCon ZigBee Devices 2013 pikkerton GmbH
3. PIKKERTON 8 4 Direkte Bedienung der Devices Es ist m glich die ZigBee Devices ohne die Unterst tzung von Nagios direkt auszulesen bzw zu steuern Das funktioniert ber die Konfigurationsseite vom ZBG 100 Diese befindet sich entweder unter dem Men eintrag Sensor Device im LabCon Nagios Men oder direkt ber die IP Adresse bzw Namen des ZBG 100 unter dem Punkt Settings Phys Devices Home Physical Device Overview Settings N MAC PD ID SN Configured Active LMC Select ZigBee Net gx AV AV AV AV AV AV AN X Nagios a Phys devices B 0013a2004076842d ZBS 110 Test 110NQ ZBS110NQuali Yes 7A 0 x Virt devices H 0012320040767eb5 285 110 Lamp 110V2T106215 Yes 0 x Update re About B 0013a20040669b1a ZBS 110 Not Switch Kuehlschrank Yes gt 1 x B 0013a20040767cf5 ZBS 110 Lamp6 110V2T106219 Yes A o x B 0013a2004066fd89 ZBS 110 Test3 ZBS110000000 Yes A o0 x B 0013a20040669b51 ZBS 110 NoSwitching ZBS110000000 Yes o x B 0013a2004076843b ZBS 110 110V2T106213 Lamp1 Yes D B 0013320040767d81 285 110 110V2T106212 Lamp2 Yes gt x CG 0013320040767de9 ZBS 111 zbs111TESTER ZBS111Tester Yes A 0 x 00132200407e7c42 ZBS 121 MotionDetect ZBS121006182 Yes A o x 0013a200407966a3 ZBS 121 Test 121RH 285121000000 Yes A 7 x 001322004061b5e3 ZBS 130 ZBS130HWO201 Activator Yes gt x Lost Message Counter update interval off Lost Message Counter reset 15 38 05 UTC Wed 14 11 2012
4. 1100 Abbildung 24 Konfigurationsblock ZBS 110 Als dritter Block findet sich der Steuerungsblock Hier befinden sich alle Steuerungen f r das jeweilige Ger t Bei dem ZBS 110 kann man hier beispielsweise das Relais Ein bzw Ausschalten 2013 pikkerton GmbH Seite 51 101 LabCon Benutzerhandbuch e Set Version 1 15 mm Beef a PIKKERTON LEDs Action Description Green LED flashing 20 times BLINK LED ORANGE Orange LED flashing 20 times Resets Action Description Reset and associate device to the network RESET TO DEFAULTS Load factory defaults Abbildung 25 Steuerungsblock ZBS 121 2013 pikkerton GmbH Seite 52 101 LabCon Benutzerhandbuch as Se a Version 1 15 ef e 2 3 ef s PIKKERTON 8 5 webmin Alle Konfigurationseinstellungen die ber LabCon hinaus ver ndert werden sollen k nnen ber das Web Frontend Webmin vorgenommen werden Dieses ist ber https lt zbg_ip gt 10000 zu erreichen Login to Webmin You must enter a username and password to login to the Webmin server on 192 168 8 130 Username root Password E Remember login permanently Login Clear Abbildung 26 Webmin Anmeldeschirm Der Benutzername und das Passwort sind die gleichen wie f r die Anmeldung ber SSH Beim Auslieferungszustand sind dies Benutzer root Passwort rootroot 2013 pikkerton GmbH Seite 53 101 LabCon Benutzerhandbuch c0 garg
5. Collect Answers die jeweilig letzten Antworten der Ger te manuell eingeholt werden Hierf r sind die entsprechenden Handb cher hinzuzuziehen s a Kapitel 12 Enable Joining Es werden alle Router und der Koordinator ge ffnet damit sich neue ZBS Ger te anmelden k nnen Node Discover F hrt einen Node Discover aus worauf sich alle im Netz befindlichen Devices melden Refresh Aktualisiert die Liste der Ger te Remove Offline Devices L scht alle als offline gekennzeichneten Devices aus der Liste Default Sendet ein defaults an alle markierten Devices und setzt diese somit auf die Standarteinstellung zur ck Welche Einstellungen hierbei ver ndert werden kann dem jeweiligen ICD entnommen werden Command Abbildung 13 ZigBee Configuration Phys devices Command 2 Interface Control Document 2013 pikkerton GmbH Seite 27 101 LabCon Benutzerhandbuch c0 e Version 1 15 a ch el A wi S PIKKERTON Send Command Sendet den in das rechts stehende Textfeld eingetragenen Befehl an alle markierten Devices Collect Answers Sammelt alle Antworten von den Devices ein Devices Es kann je nach Netzwerkeinstellungen bis zu 30s dauern u Die Antworten sind die zuletzt empfangenen Daten von den bis die angeforderte Information eintrifft Clear Output Leert das Ausgabefenster der Antworten Ein sogenannter Lost Message Counter LMC z hlt die scheinbar auf d
6. Get Next Go SNMP MIBs Resul MIB Tree Name OlD Abbildung 20 iReasoning MIB Browser In den Browser m ssen jetzt noch die MIBs vom ZBG 100 geladen werden Diese befinden sich im Archiv lt zbg_hostname gt custom config zip Wie dieses erstellt und heruntergeladen werden kann steht im Kapitel 6 5 4 Seite 37 Die MIB Textdateien k nnen dann ber das Men File gt Load MIBs geladen werden 2013 pikkerton GmbH Seite 45 101 LabCon Benutzerhandbuch ep e gg 8 Version 1 15 mm kel a e WI S PIKKERTON Look In mib KM EINE ES CS E PIKKERTON MIB txt E PIKKERTON ZBS 130 MIB txt E PIKKERTON ZBS 132 MIB txt E PIKKERTON ZBS 140 MIB txt PIKKERTON ZBS MIB txt E PIKKERTON ZBS X1X MIB txt E PIKKERTON ZBS X2X MIB txt File Name Files of Type All Files Open Cancel Abbildung 21 MIB Browser Load MIBs Dialog Unter Address muss noch die IP Adresse des ZBG 100 eingetragen werden Die Communities vgl Kap 8 1 1 1 k nnen in dem Dialogfeld Tools gt Options gt Agents angepasst werden 8 1 3 Traps Das ZBG 100 verschickt Traps nachdem Zustands nderungen aufgetreten sind bei denen ein Manager sofort informiert werden muss Dies k nnen berschrittene Alarmschwellen sein oder auch ein Ger t der ZBS Familie welches sich neu am ZBG angemeldet hat Auch die Traps werden mit SNMPv3 verschl sselt und authentifiziert ve
7. Version 1 15 a Ss PIKKERTON 5 2 2 ZigBee Sensoren amp Aktoren der ZBS Familie Dieses Kapitel f hrt die wichtigsten Ger te der ZBS Familie auf Weiterf hrende Information findet man im Internet unter http www pikkerton de zigbee ZigBee html 5 2 2 1 Smart Energy Meter Die Gruppe von Devices dienen zum Messen und teilweise Schalten von Str men Hierzu geh ren unter anderem e der ZBS 110V2 e der ZBS 111 und e der ZBS 112 Abbildung 4 ZBS 112 Die schaltbaren Ger te wie ZBS 110 und ZBS 111 verf gen ber die von pikkerton entwickelte SART Technologie welche die Lebenszeit der Relaiskontakte massiv erh ht 1 http www pikkerton de sart index htm 2013 pikkerton GmbH Seite 14 101 LabCon Benutzerhandbuch Version 1 15 Abbildung 5 ZBS 110V2 Die Ger te ZBS 110 ZBS 111 sowie ZBS 112 verf gen mit der NQ Option ber ein hoch pr zises Messwerk welches Spannungsschwankungen und spitzen detektiert und meldet Abbildung 6 ZBS 111 Dazu wird ca 14 000x pro Sekunde eine entsprechende Messung vorgenommen und einem integrierten DSP und Controller gest tzten Auswertungsalgorithmus zugef hrt 2013 pikkerton GmbH Seite 15 101 LabCon Benutzerhandbuch os e Version 1 15 a z a wi A wi S PIKKERTON 5 2 2 2 ZigBee Multisensor Die ZigBee Multisensoren ZBS 12x gibt es in verschiedensten Ausstattungsvarianten Unterst tze Sensortypen sind derzeit e Temperatur e
8. gt Ze a Version 1 15 3 Ss el A Ss S PIKKERTON Require valid user lt Directory gt In das Icinga Web Frontend wird das Men mit Hilfe eines Skripts eingetragen Das Script icingaWebLabConSetup py im Verzeichnis usr local labcon icingaUtils erzeugt die LabCon Kategorie und die Cronks fiir die einzelnen ZBG 100 Wenn Icinga Web und LabCon entsprechend ihrer Dokumentationen installiert wurden kann das Skript icingaWebLabConSetup py ohne Argumente ausgef hrt werden Sollte dies nicht der Fall sein so m ssen das Quellverzeichnis blicherweise usr local labcon config mit dem Argument s lt Verzeichnis gt und das Zielverzeichnis blicherweise usr local icinga web mit dem Argument d lt Verzeichnis gt angegeben werden 2013 pikkerton GmbH Seite 97 101 LabCon Benutzerhandbuch gt Ze a Version 1 15 3 es el A Ss a PIKKERTON 14 5 2 4 SNMP Trapdienst Der Traphandler muss dem SNMP Dienst bekannt gemacht werden Dazu muss eine Verkn pfung der Trap Handle Datei in das SNMP Verzeichnis verlinkt werden cd usr share snmp In s usr local labcon labcon traphandler py Des weiteren muss nun die Datei etc snmp snmptrapd conf folgenderma en angelegt bzw erweitert werden PLEASE read the snmptrapd conf 5 manual page as well Beschreibung auth v3 TBD disableAuthorization yes authCommunity log execute net public traphandle 1 3 6 1 4 1 23596 51 usr share snmp labcon_tr
9. sselung au erhalb der Funkreichweite geschlossenes Netz etc Die Ger te sind derart konfiguriert dass dieser Netzwerkaufbau zyklisch wiederholt wird falls er nicht erfolgreich durchgef hrt wurde Im Fall von batteriebetriebenen Ger ten wird dieser Scan Zyklus jedoch sukzessive verl ngert um Batterie zu sparen F r das initiale Pairing der Ger te untereinander mag es daher hilfreich sein die Ger te per Hardware Reset zu einem Neustart zu bewegen dann wird der Netzwerk Scan erneut und sofort initiiert Dazu ist der Taster solange zu dr cken bis die LEDs reagieren meist 5 10 Sekunden Die jeweilige LED Farbe ist von Ger t zu Ger t unterschiedlich Ist man sich unsicher ob ein Ger t in das Funknetzwerk aufgenommen wurde oder nicht kann man mit einem einmaligen kurzen Tastendruck eine Nachricht an das Gateway schicken lassen Ob die Nachricht erfolgreich angekommen ist wird ebenfalls signalisiert e 1x gr n Die Nachricht ist erfolgreich zugestellt worden e 1x rot orange Die Nachricht ist nicht erfolgreich zugestellt worden Ger tespezifisches Verhalten ist in den jeweiligen Handb chern der Ger te oder im ZBS Manual beschrieben 2013 pikkerton GmbH Seite 19 101 LabCon Benutzerhandbuch as Se Version 1 15 2 a 2 a 2 PIKKERTON 5 2 4 Timing der Ger te Dieses Kapitel gibt eine bersicht der wichtigsten systeminternen Intervalle 5 2 4 1 Interne konfigurierbare Interval
10. 17 Abbildung 10 bersicht ber MSI bzw TXTJntervalle 20 Abbildung 11 LabCon Be Eed E 24 Abbildung 12 ZigBee Configuration Phys Devices Overview 25 Abbildung 13 ZigBee Configuration Phys devices Command 27 Abbildung 14 Settings Gateway Lost Message Counter 28 Abbildung 15 Virtual Device Uberstcht 29 Abbildung 16 Maske zum Bearbeiten der Einstellung virtueller Sensoren 30 Abbildung 17 Settings Gateway IP Gettngs cee eeeeeeeeeeeeeeeeeee enna 34 Abbildung 18 Communication NM 35 Abbildung 19 Communication CSV Control Gettngs 36 Abbildung 20 iReasoning MIB Browser mumu4044444444 Henn 45 Abbildung 21 MIB Browser Load MIBs Dialog 46 Abbildung 22 Ger te bersicht ana 49 Abbildung 23 Informationsblock ZBS 121 nn Ee 50 Abbildung 24 Konfigurationsblock ZBS 110 u uu44444444444444 HH 51 Abbildung 25 Steuerungsblock ZB 21721 52 Abbildung 26 Webmin Anmeldeschirm 2 22 2 44 4444444444 4 53 Abbildung 27 ZBG Device Nagios Tmmmg ereere 59 Abbildung 28 Settings Download 62 Abbildung 2 LabCon Men u 63 Abbildung 30 Service Groups 64 Abbildung 31 Service Gruppen 65 Abbildung 32 Konfiguration der Gruppenmtolecder ee 68 Abbildung 33 Beispiel L ftersteuerung m 74 Abbildung 34 Beispiel L ftersteuerung ohne Hvsterese 74 Abbildung 35 Generate am
11. 39 06 062 EE INES ee een 39 2013 pikkerton GmbH Seite 4 101 LabCon Benutzerhandbuch er e geg i S Tia Version 1 15 cy hx PIKKERTON 6 6 3 Ee Edel een 39 6064 VG PCS SS nee 40 6 0 5 E E 40 666 E seen ee 41 867 Reis 41 7 Sicherheit een 42 21 1 PRUNE LIT Hiper 42 7 1 2 Kommunikation Uber SNMP MV 42 7 1 3 Sicherheit im Funknetzwerk ZigBee durch AES 42 Ee EE ET E 43 LN SNMP ine ee ee tee ee 43 8 1 1 Berechtoungsmanagement en nnnnnnnnnnnnnnenn nenne 44 8 1 1 1 ena WEE 44 8 1 1 2 SNMEVS ahs cect Seeded een ee 44 8 1 2 SNMP Managern 44 8 13 Ve 46 8 2 CSV Recording Pushing 47 83 Interner Na965 Server ns 48 8 4 Direkte Bedienung der Devices 2424444 49 8 9 WED ee aie a Eere EE Fa 53 H Betrieb unter Nagios Icinga nn 54 9 1 Schnittstelle zu Nagios lcmga Ae 55 9 1 1 ele ele Ee e TEE 55 IE Se ee 56 9 1 3 bersicht ber die Service Gruppen 56 9 1 4 Timing Endger te Gateway Nagios Event basiert 59 9 2 EE e Nei e UE e nenne na 60 TV e een ee 60 9 2 2 Besonderheit bei Work Limit und Load Limit 61 9 2 3 Erstellen der Nagios Konfiguration f r die Devices 62 9 2 4 Gruppen erstellen und kontouteren gt 63 9 2 4 1 Gruppen IN ZIM D leii 65 9 2 4 2 Services den Gruppen zuordnen 44H 68 9 2 4 3 Konfiguration der Gruppenmitglieder 68
12. 9 2 4 4 Templates E e ME 70 9 2 4 4 1 EIERE 70 9 2 4 4 2 Emaill Versand ass 71 9 2 4 4 3 Aktoren auf ZBS Ger ten uuunennenenseeneenn 71 9 2 5 BEiDiele nee ee 73 9 2 5 1 L ftersteuerung Regelkreis mit Hysterese 73 9 2 5 2 Regelkreis ohne Hysierese ereere 74 9 2 5 3 Zugangskontrolle Tuoroffner nennen 75 9 2 6 Gruppierungen erstellen 75 9 2 7 Installation in Die e Ben 75 93 MONItONNO E 77 2013 pikkerton GmbH Seite 5 101 LabCon Benutzerhandbuch 28 e geg Version 1 15 10 Abbildungsverzeichnis ue sn 80 11 StichwortverzeichNi eu ee ee ae ee eee 82 12 Weiterf hrende Informationen 22 24244444444HHHRnRnnnnnn nenn 84 13 Anhang Software und LtGenz Upndate nennen nennen 85 14 Anhang Nagios Installaton A 86 14 1 Ben tigte S8lW re Are 86 142 Erster Il ae engen 87 14 3 e ue e ET 88 14 4 pDpp naoios konfouraton AA 89 14 5 Integration des Gateways in Nagios lomngs HH gt 91 14 5 1 Vorbereitende Ma nahmen s4s444444444444HRRRnRH HR 91 14 5 2 Anpassungen von Nagios auf der Server Seite 93 14 5 2 1 LabCon Kanfiguralion een eege 93 14522 ZBG Namensaufll sung ea nnne 94 145323 E ul e EC e 95 14924 E ee EE 98 14 5 2 5 Apache2 kontouraton nennen 99 14 5 2 6 Anpassung f r Dpnp nagioes seen 99 14 5 2 7 Beschreibung des Inhalts des Archives szbg bostnamez Custom Confg zip 99 14
13. Abbildung 22 Geratetibersicht Uber einen Klick auf die MAC Adresse des gewiinschten Device gelangt man zu der Seite in der die aktuellen Messwerte aufgef hrt man Einstellungen vornehmen und das Ger t steuern kann Die Seite wird beispielhaft anhand eines ZBS 121 nachstehen beschrieben Der oberste Informationsblock beinhaltet sowohl die aktuellen Sensorwerte als auch Informationen wie die Seriennummer Hard und Firmwareversion usw In diesem Block 2013 pikkerton GmbH Seite 49 101 LabCon Benutzerhandbuch gt Be e ag Version 1 15 mm Ss a d Ss 2 PIKKERTON kann auch die ID ge ndert werden Die ID erscheint auf der bersichtsseite und in der Gruppenkonfiguration Dar ber wird das Device identifiziert Sie ist auf 12 Zeichen beschr nkt ZBS Configuration MAC 0013a200407e7c42 PID ZBS 121 SN ZBS121006182 HW 0103 SW 03090316 ell MotionDetect Actual Values Brightness 124 x Brightness_Delta Olx Temperature 25 2 C Temperature Delta 0K RelHumidity N A RelHumidity_Delta N A AirPressure N A AirPressure_Delta N A BatteryVoltage 3 85 V_ BatteryState OK Abbildung 23 Informationsblock ZBS 121 Direkt nach dem Informationsblock folgt der Konfigurationsblock an S mtliche Grenzen und Intervalle lassen sich hier konfigurieren Die ausgegrauten Felder geh ren zu nicht best ckten Optionen dieses Devices z B ein ZBS 121 ohne Luftdruck Damit die ge nderten Werte bernommen werden m ssen die Daten
14. Einstellung virtueller Sensoren 2013 pikkerton GmbH Seite 30 101 LabCon Benutzerhandbuch c0 garg Version 1 15 Ei ur Bas wi PIKKERTON Virtual Device Name Entspricht der ID physischer Sensoren Virtual device service name Entspricht dem Servicenamen eines Sensors z B Temperatur oder BatteryState Upper Lower value threshold Grenzwert bei dessen Verletzung eine Alarmmeldung versendet wird MSI time Zeitintervall in dem der Messwert neu berechnet wird Mathematical operation Mathematische Funktion ber alle Messwerte in Virtual device services selected Sensor Type Filter f r Host Device Virtual oder physical device Host Device Hier werden alle konfigurierten Sensoren mit Ihrer ID aufgelistet Available services Nachdem unter Host Devices ein Sensor Device ausgew hlt worden ist werden hierunter alle verf gbaren Messwerte Dienste angezeigt Sie k nnen per Doppelklick zu den ausgew hlten Messwerten hinzugef gt werden Virtual device services selected Hier werden alle Messwerte angezeigt die zur Berechnung dieses virtuellen Sensors herangezogen werden Es k nnen auch Messwerte von virtuellen v und physischen p Devices vermischt werden 2013 pikkerton GmbH Seite 31 101 LabCon Benutzerhandbuch c0 e Version 1 15 a aa wi A 2 PIKKERTON 6 4 3 Encryption Unter diesem Men eintrag kann die Verschl sselung AES 128 eingestellt werden Unsachgem e Bed
15. Helligkeit e Luftdruck e Luftfeuchtigkeit e Bewegungsmelder bg Abbildung 7 ZBS 121 indoor Obwohl das Ger t in engen Intervallen Messungen vornimmt reichen eine Handvoll uA tausendstel Milliampere f r den jahrelangen und zuverl ssigen Betrieb v llig aus Nach den jeweiligen Messungen werden die Onboard Sensoren komplett abgeschaltet und das Ger t in einen Tiefschlafmodus versetzt Schwellwertverletzungen werden dennoch sofort erkannt und gemeldet Dieses Vorgehen kombiniert schnellste Reaktionszeiten mit l ngster Batteriestandzeit 2013 pikkerton GmbH Seite 16 101 LabCon Benutzerhandbuch ep e een ann Version 1 15 CM Al E PIKKERTON 5 2 2 3 Weitere ZBS Ger te Der ZigBee Handheld ZBS 130 ist ein Taster der bei Bet tigung eine Meldung ber Funk an den Koordinator sendet Typische Anwendungen f r diesen Aktor sind e Zugangskontrolle e Home Automation e Patientennotruf Abbildung 8 ZBS 130 Die ZigBee Kontakt berwachung ZBS 132 wird zur berwachung von T ren und Fenstern eingesetzt Abbildung 9 ZBS 132 2013 pikkerton GmbH Seite 17 101 LabCon Benutzerhandbuch c0 e Version 1 15 a Ss PIKKERTON 5 2 3 Erste Inbetriebnahme der Ger te amp Netzwerkaufbau 5 2 3 1 Gateway Wird das Gateway mit Strom versorgt so arbeitet das Funkmodul unabh ngig vom Bootvorgang Betriebssystem v llig autark Es bietet den m glicherweise schon vorhandenen Endger ten bzw Ro
16. Intervall in dem die Messwerte neu berechnet werden Au erdem werden bei Verletzung von Schwellwerten Alarmnachrichten verschickt Home Add a virtual device Settings Gateway Virtual device filter All ZigBee Net Virtual device name MAC Edit Remove Nagios Current_Sum Current 0000 J xX Phys devices Virt devices Update About Abbildung 15 Virtual Device bersicht Die virtuellen Sensoren k nnen ber die Webseite unter dem Punkt ZigBee Configuration gt Virt Devices gt Add erstellt werden Bestehende Sensoren k nnen mit Edit konfiguriert werden 2013 pikkerton GmbH Seite 29 101 LabCon Benutzerhandbuch CL Wi gg Version 1 15 Pr H PIKKERTON Edit a virtual device On this page you can edit a virtual device Virtual device name Up EEE Virtual device service nameSum J Upper value threshold 000 0 sis m Lower value threshold 500 0 _ i sim gt Virtual device unit Subsumption operation sums Sensor Type Virtual device services selected Virtual device p WW WC H R_Current_F p WW WC D R_Current_F Host devon p WW WC H L_Current_R p WW K_Current_RMS Current Add to Yirtual Device Available services Add to Virtual Device Remove from Virtual Devi The virtual device name and virtual device service name must not contain spaces Virtual sensors are only monitored if configured as members of customized service groups Abbildung 16 Maske zum Bearbeiten der
17. Version 1 15 PIKKERTON 9 Betrieb unter Nagios Icinga F r einen korrekten Betrieb von LabCon in Nagios wird eine Installation gem Kapitel 14 vorausgesetzt Dieses Kapitel behandelt ausschlie lich die Bedienung von LabCon Die Punkte 1 3 werden hier nicht ber cksichtigt 1 Konfiguration des ZBG 100 vgl Kap 6 Weboberfl che des ZBG 100 a Suchen der Devices b Konfiguration der Devices 2 Installation von Nagios und dessen Komponenten vgl Kap 14 Anhang Nagios Installation 3 Integration in Nagios a Download der Konfiguration direkt vom ZBG 100 b Einspielen der Skripte und Anpassen von Nagios 4 Erstellen von Regelkreisen a Auswahl der zu konfigurierenden Ger te b Erstellung von Gruppen c Einstellungen zum Versenden von Emails d Schalten von Ger ten 5 Download der erstellten Konfiguration der Regelkreise und Bereitstellung der Skripte f r Nagios 6 Nagios Neustart 2013 pikkerton GmbH Seite 54 101 LabCon Benutzerhandbuch c0 e Version 1 15 mm PIKKERTON 9 1 Schnittstelle zu Nagios Icinga 9 1 1 Kommunikationsmodell Folgende Tabelle zeigt die Zusammenh nge zwischen LabCon und Nagios bez glich der Begriffe an Hand von zwei Beispielen Nagios Icinga Host Device Ger t Service Sensor Admin Rechner Kommunikation ber SNMP a gt Kommunikation ber ZigBee lt gt Temperatur Strom ZBS 110 Spannung Frequen
18. amp Downloadseite Step 3 3 Generate and Download Nagios Configuration Here you can generate and download the whole Nagios configuration consisting of host config service config and group config Generate After having generated the config file Download the file here http 192 168 8 104 tmp labcon gw_custom_config zip Transfer the file via WinSCP or SSH from here var www tmp labcon gw_custom_config zip Back Abbildung 35 Generate amp Download der Konfiguration Das zum Download angebotene Archiv beinhaltet alle Services und Skripte f r Nagios 2013 pikkerton GmbH Seite 75 101 LabCon Benutzerhandbuch es Set Version 1 15 a kel a E We 2 PIKKERTON Diese m ssen dann in das LabCon Verzeichnis auf dem Nagios Server kopiert werden 2013 pikkerton GmbH Seite 76 101 LabCon Benutzerhandbuch ep a a Se Version 1 15 ef e S wi PIKKERTON 9 3 Monitoring Wie bereits im Kapitel 14 3 pnp4nagios erw hnt wurden die Sensorwerte von LabCon ber das pnp4nagios Plugin in einer Round Robin Database abgelegt Diese Daten k nnen mit Hilfe des selben Plugins angezeigt werden Zu dem Monitoring gelangt man ber das LabCon Seitenmen auf der Nagios Seite LabCon ZBG 100 S Abbildung 36 Seitenmen in Nagios Entweder man gelangt ber den Link Monitoring zu einer bersichtsseite oder ber den Namen der Gruppe direkt zu deren Anzeige Abbildung 37 zeigt
19. ber die Seite Settings ZigBee Net eingestellt werden ber diese Seite kann der Koordinator in zwei verschiedene Betriebsarten eingestellt werden verschl sselte Encrypted Network und unverschl sselte Open Network Kommunikation Dabei ist zu beachten dass nur die Router und End Devices in dem jeweiligen Operationsmodus zu finden sind in dem sie sich selber gerade befinden 2013 pikkerton GmbH Seite 42 101 LabCon Benutzerhandbuch c0 garg Version 1 15 PIKKERTON 8 Standalone Betrieb 8 1 SNMP Die Kommunikation zwischen den LabCon Skripten auf dem Nagios Server und dem ZBG 100 erfolgt Uber SNMP Nach dessen Terminologie haben Nagios und LabCon folgende Bedeutung 1 Das ZBG 100 sammelt Sensordaten ein und stellt diese zur Verf gung Somit ist dieser der SNMP Agent Dar ber hinaus k nnen Agenten bei Alarmen Meldungen sogenannte Traps verschicken damit ein vorher eingestellter SNMP Manager unverz glich Informiert ist 2 Die LabCon Skripte auf dem Nagios Server sowie Nagios selbst und das pnp4nagios Plugin stellen den SNMP Manager dar Dieser sammelt die Informationen vom Agenten in regelm igen Abst nden ein und verarbeitet diese Dar ber hinaus lauscht der Manager auf eingehende Traps F r die berwachung von dem ZBG k nnen aber auch andere Manager als LabCon eingesetzt werden Das Kapitel 8 1 2 SNMP Manager stellt einige vor Die Organisation der Variablen erfolgt in SNMP
20. if downloaded here customized service groups will get ommitted Download the file here http 192 168 8 104 tmp labcon gw_custom_config zip Transfer the file via WinSCP or SSH from here var www tmp labcon gw_custom_config zip Abbildung 28 Settings Download Der Download an dieser Stelle ist nur sinnvoll wenn die Devices nur zum Anzeigen und Speichern der Sensordaten benutzt werden Ee sollen oder die Erstinstallation von LabCon in Nagios vorgenommen wird Ansonsten folgt die Erstellung und Konfiguration von Gruppen und Regeln Dies wird im Kapitel 9 2 beschrieben Wie die Devices in Nagios integriert werden kann im Kapitel 9 2 7 Installation in Nagios nachgelesen werden Wenn neue Devices dem Netzwerk hinzugef gt wurden muss die Ce Konfiguration neu erstellt werden Alte Konfigurationen f r Devices die momentan offline sind bleiben nur erhalten wenn die Checkbox aktiviert ist 2013 pikkerton GmbH Seite 62 101 LabCon Benutzerhandbuch Version 1 15 a PIKKERTON 9 2 4 Gruppen erstellen und konfigurieren Die Webseite f r die Konfiguration der Gruppen befindet sich im LabCon Men unter Configuration auf der Nagios Seite Configuration Config Monitoring Ambient Atmosphere All danke Misc Flags About Abbildung 29 LabCon Men Hinter dem Punkt Sensor Device Config verbirgt sich die Konfiguration der Devices nach Kapitel 9 2 3 Erstellen der
21. in der Dokumentation zu den jeweiligen Devices 2013 pikkerton GmbH Seite 67 101 LabCon Benutzerhandbuch eee Se Version 1 15 B ch a a a 2 PIKKERTON 9 2 4 2 Services den Gruppen zuordnen Wenn unter Host Device ein Device markiert wird werden alle verf gbaren Services unter Available services angezeigt s Abbildung 31 Ein Doppelklick auf den gew nschten Service f gt diesen der Gruppe hinzu Alle aktiven Services der Gruppe befinden sich unter Device service selected 9 2 4 3 Konfiguration der Gruppenmitglieder Von der bersichtsseite der Gruppen gelangt man ber einen Klick auf das Symbol unter Setup zu der Konfigurationsseite der Gruppenmitglieder Hier werden die Aktionen f r Schwellwertverletzung oder Alarmmeldung z B Tastendruck des ZBS 130 eingestellt Es gibt bei einigen Services wie zum Beispiel der Temperatur zwei Schwellwerte Sie stehen f r einen Werte Korridor in dem die Sensorwerte als gut interpretiert werden Bei Verlassen und auch bei Wiedereintreten des Korridors verschiedene Aktionen ausgef hrt werden Wenn mehrere Skripte f r eine Grenze festgelegt sind werden sie von oben nach unten seriell verarbeitet Energy Metering Edit Device Service CableConf Work Load CableMeter01 Work Load ConfRoom Load Work ID PID SN MAC Status CableConf ZBS 112 112V10125237 0013a200408cf944 gt CG TX Time in s 1 65000 default 60 10 S
22. mit einen Grundintervall von dem alle Zeiten abgeleitet werden Bei einer Standartinstallation von Nagios betr gt dieses Intervall 60s Definiert ist dieser Wert in der nagios cfg in der Variablen interval length Anschlie end kann die Voreinstellung und Skripte unter dem Punkt Settings Phys devices generiert und heruntergeladen werden Nagios Configuration Erase Configuration Download Attention If downloaded here customized service groups will get ommitted Download the file here http 192 168 8 130 tmp ZBG 100_custom_config zip Transfer the file via WinSCP or SSH from here var www tmp ZBG 100 custom _config zip Abbildung 44 ZIP File Generierung 2013 pikkerton GmbH Seite 92 101 LabCon Benutzerhandbuch c0 e Version 1 15 a ch el A wi S PIKKERTON 14 5 2 Anpassungen von Nagios auf der Server Seite Hier werden alle Einstellungen beschrieben die vorgenommen werden m ssen damit sich LabCon in Nagios integriert 14 5 2 1 LabCon Konfiguration Die f r die Integration ben tigten Dateien befinden sich nun bereit zum Download auf dem ZBG Dazu muss vorher die Konfiguration des ZBG 100 abgeschlossen sein Die Datei kann mit Hilfe des Buttons Download oder direkt unter folgendem Link http lt ip des ZBG gt tmp lt zbg_hostname gt custom config zip Diese Datei muss entpackt werden der Inhalt nach usr local labcon kopiert werden und die Python Skripte ausf hrbar ge
23. oder unter Verwendung elektronischer Systeme verarbeitet vervielf ltigt oder verbreitet werden Weitergabe sowie Vervielf ltigung dieses Dokuments Verwertung und Mitteilung seines Inhalts sind verboten soweit nicht ausdr cklich gestattet Zuwiderhandlungen verpflichten zu Schadenersatz Alle Rechte f r den Fall der Patent Gebrauchsmuster oder Geschmacksmustereintragung vorbehalten pikkerton GmbH haftet nicht f r technische oder redaktionelle Fehler oder Auslassungen in diesem Dokument Ferner bernimmt sie keine Haftung f r Sch den die direkt oder indirekt auf die Bereitstellung Leistung und Nutzung dieses Materials zur ckzuf hren sind Inhaltliche nderungen dieses Dokuments behalten wir uns ohne Ank ndigung vor Die Informationen in dieser Ver ffentlichung werden ohne Gew hr f r ihre Richtigkeit und Vollst ndigkeit zur Verf gung gestellt Insbesondere enthalten diese Informationen keinerlei zugesicherte Eigenschaften Alle sich aus der Verwendung dieser Informationen ergebenden Risiken tr gt der Benutzer Wir weisen darauf hin dass die im Handbuch verwendeten Soft und Hardware Bezeichnungen und Markennamen der jeweiligen Firmen im Allgemeinen warenzeichen marken oder patentrechtlichem Schutz unterliegen pikkerton GmbH Kienhorststr 70 Telefon 49 0 30 3300724 0 13403 Berlin Telefax 49 0 30 3300724 24 Germany Internet www pikkerton de 2013 pikkerton GmbH Seite 3 101 L
24. und ohne Einfluss des Benutzers selbst ndig auf Weitergehende Infrastrukturen wie Repeater oder separate Router sind nicht n tig Im Fall eines Ausfalls eines Routers wird sich das Netz falls es die r umliche Ausdehnung sowie den Funkkontakt untereinander zulassen selbst heilen Neue Routen werden automatisch etabliert Dieser Mechanismus kann einige Minuten dauern sowohl beim initialen Netzwerkaufbau als auch bei der Reorganisation 2013 pikkerton GmbH Seite 9 101 LabCon Benutzerhandbuch gt Be e gg Version 1 15 mm d effe PIKKERTON Man unterscheidet 3 Arten von ZigBee Ger ten e comes ZigBee Coordinator A ZigBee Router ZigBee End Bir Abbildung 2 bersicht ZigBeo 2013 pikkerton GmbH Seite 10 101 LabCon Benutzerhandbuch c0 e Version 1 15 mm PIKKERTON 5 1 1 Coordinator Der Coordinator ist die Zentrale der sogenannte Master des Funknetzwerks Er beinhaltet im Wesentlichen 2 Funktionen a Beitrittshandling Joining von Routern amp End Devices zum Netzwerk samt Schl sselmanagement b Gateway zur Au enwelt Der Coordinator kann mit beliebig vielen Routern und bis zu 10 End Devices kommunizieren Weitere End Devices erfordern entsprechend einen weiteren Router Der Coordinator ben tigt eine permanente Stromversorgung Im LabCon System ist dies das Ger t ZBG 100 5 1 2 Router Der Router spannt das Netz von der r umlichen Ausdehnung weiter
25. 5 2 7 1 Der Unterordner config 100 14 5 2 7 2 Der Unterordner icinga uurr424444444000 Henn 100 14 5 2 7 3 DerUnterordnermibs unse 100 14 5 2 7 4 Der Unterordner nagios 2 rn 100 14 5 2 7 5 Der Unterordner scpts onee onneeeeeee 101 2013 pikkerton GmbH Seite 6 101 LabCon Benutzerhandbuch 28 garg Version 1 15 PIKKERTON 4 Allgemeines Erl uterung der Symbole Das Symbol Hinweis weist auf notwendige Bestimmungen f r Ce einen fehlerfreien Betrieb hin Es hebt wichtige Details heraus die das Arbeiten erleichtern und gibt Tipps und Ratschl ge f r den optimalen Einsatz von Hard und Software Das Symbol Achtung bezieht sich auf Handlungen die Sch den f r Material oder Ger t zur Folge haben k nnen 2013 pikkerton GmbH Seite 7 101 LabCon Benutzerhandbuch ep a a fe Version 1 15 B a Bas ef s PIKKERTON 5 bersicht ber LabCon LabCon ist ein funkbasiertes System f r das komfortable und performante Echtzeit Monitoring und Kontrollsystem verschiedener Parameter Es basiert prim r auf der Kommunikation via SNMP so dass es sich sehr einfach in anderweitig bestehende Monitoringsysteme wie HP Openview Tivoli Nagios Icinga etc integrieren l sst Peripherie Energy Met Netzqualitatsanalysato LAN SNMP 3 Se A Ss 164 32A Serversysteme Nagios S i eme LAN SNMP 4 LabCon e e e VI IEE
26. Anfrage schnell und ohne Gefahr eines Timeouts beantworten zu k nnen Die Tatsache dass die per SNMP abgefragten Daten demnach unter Umst nden eine begrenzte Aktualit t haben ist entsprechend zu ber cksichtigen Die Aktualit t der Daten kann bei den Ger ten mit permanenter Stromversorgung ber engere TXT Intervalle einfach eingestellt werden Alarm Meldungen s folgendes Kapitel k nnen jedoch zus tzlich eingestellt werden diese werden dann unmittelbar bertragen 2013 pikkerton GmbH Seite 21 101 LabCon Benutzerhandbuch Version 1 15 PIKKERTON 6 Weboberflache des ZBG 100 6 1 Voraussetzungen Die Bedienung ist web basiert Die Bedienung der Frontends wurde mit folgenden Browsern jeweils aktueller Versionen getestet e Firefox e Chrome e Internet Explorer Ce In den Browsern muss Javascript DOM installiert bzw zugelassen sein 2013 pikkerton GmbH Seite 22 101 LabCon Benutzerhandbuch Version 1 15 6 2 Auslieferungszustand Mit folgender Konfiguration wird der ZBG 100 ausgeliefert 2013 pikkerton GmbH IP 192 168 0 100 Subnet 255 255 255 0 Gateway 192 168 0 1 Hostname ZBG 100 root Passwort rootroot Web Benutzer admin admin Web Passwort SNMP v1 und v2c Aut hentifizierung Read Community public Write Community private SNMP v3 Authentifizierung Passwort rootroot Verfahren md5 Zus
27. D 6 5 5 Modbus Die Ger te der ZBS Familie k nnen auch ber Modbus TCP abgefragt werden Sie daf r ben tigte Slave Adresse kann hier eingestellt werden Die spezifischen Registeradressen der einzelnen Ger te werden unter dem Punkt View Register Address angezeigt Abbildung TBD 2013 pikkerton GmbH Seite 37 101 LabCon Benutzerhandbuch Version 1 15 6 5 6 E Mail PIKKERTON S mtliche Messwerte und Alarmmeldungen k nnen per E Mail an einen Empf nger geschickt werden e Enable Mail Schatet das Versenden der E Mails ein bzw aus e Sender E Mail Absender Adresse im Header der E Mail e Receiver E Mail E Mail Empf nger e SMTP x SMTP Mailserver Einstellungen e Apply Changes Speichern und anwenden der Einstellungen e Send Test E Mail Versendet eine Testemail 2013 pikkerton GmbH Seite 38 101 LabCon Benutzerhandbuch c0 e Version 1 15 mm PIKKERTON 6 6 System Hier werden Informationen ber den ZBG 100 angezeigt 6 6 1 Support Information Durch das Bet tigen des Buttons Start werden Informationen zusammengestellt die helfen k nnen einen Fehler im System zu finden Dieser Vorgang kann einige Minuten dauern Sobald er beendet ist wird ein Archiv zum Download angeboten 6 6 2 System Times Hier werden die aktuelle Systemzeit die Laufzeiten des LabCon Dienstes sowie die des ZBG 100 angezeigt 6 6 3 Operating Mode Hier kann entschieden werden im welchen
28. E 802 15 4 os ICINGA ZigBee ke Datenfunk BECH T r Fenster kontaktgebe 20 00 20 990 Personalisierte x Handsende ES e amp ek ent Cn Cee TANT SNMP 3 FFF Netzwerk Infrastruktur Abbildung 1 bersicht LabCon amp Schnittstellen Die Verbindung zur Au enwelt f r die Ger te wie Sensoren und Aktoren ist das ZBG 100 Gateway Dieses sammelt alle Daten der angeschlossenen ZigBee Devices und stellt diese ber SNMP bereit Das bedeutet dass f r die Integration nur ein Host in Nagios konfiguriert werden muss Die daraus resultierenden Services auf dem Host bilden dann die einzelnen Funktionen Sensoren der Devices ab 2013 pikkerton GmbH Seite 8 101 LabCon Benutzerhandbuch e Se ag Version 1 15 Ss Dh u a PIKKERTON 5 1 Der verwendete Funkstandard ZigBee ZigBee ist ein auf IEEE802 15 4 basierender Standard und arbeitet wie WLAN und Bluetooth im sogenannten ISM Band 2 4 GHz Die Nutzung ist lizenzfrei und weltweit m glich 315 915MHz di 315 426MHz AFRICA 4 S a 315 433MHN Ze SH 433 915MHz gt Eine theoretische Bandbreite von 250 kbit s im best case ist f r Sensor und Steuerapplikationen ausreichend Mit einer optionalen 128 Bit AES Verschl sselung und weitergehenden Sicherheitsfeatures ist es hinreichend gegen die verschiedensten Attacken gesichert Die St rken von ZigBee liegen unter anderem im Meshing und Routing So baut sich das Netzwerk transparent
29. Heartbeat interval in s 1 65000 O off default 0 0 s ZBS 112 Service CableConf_Work ry Work Limit Script Parameter Active 1 278 kwhlmsg JJ DI Ren Service CableConf_Load Load Limit Script Parameter Active i Oe 8 Abbildung 32 Konfiguration der Gruppenmitglieder 2013 pikkerton GmbH Seite 68 101 LabCon Benutzerhandbuch 5 Be r Version 1 15 3 es el A Ss S PIKKERTON Pro Korridor k nnen also vier verschiedene Events bearbeitet werden Temperature D Script Limit H e Das berschreiten der oberen Schwelle Upper Fe e Das Wiedereintreten in den normalen N H Bereich H e Das Wiedereintreten in den normalen Lower pf Bereich je N d e Das Unterschreiten der unteren Schwelle Ke In der ersten Spalte der Tabelle Abbildung 32 Nr 2 k nnen die obere und die untere Grenze f r den Korridor eingestellt werden In der n chsten Spalte Abbildung 32 Nr 3 werden die Skripte f r die Aktionen bei ber und Unterschreitung der Grenzen eingestellt Es k nnen beliebig viele Skripte f r eine Grenzverletzung und Richtung eingestellt werden Die Skripte brauchen bergabeparameter die in der dritten Spalte eingetragen werden k nnen Mit Hilfe der letzten Spalte k nnen die einzelnen Skripte aktiviert werden Ein nicht aktives Skript verbleibt zwar in der bersicht wird aber bei der Konfiguration von Nagios nicht ber cksichtigt Mit Submit werden die Grenz
30. LABCON Benutzerhandbuch LabCon Benutzerhandbuch Version 1 15 1 Historie PIKKERTON Version Datum Anderung Status V1 00 29 02 12 Erstellt Freigabe V1 10 07 06 12 Verschiedene Erg nzungen Freigabe V1 11 29 08 12 Verschiedene Korrekturen Freigabe Kapitel 7 und 8 Uberarbeitet und an die LabCon Version 1 05 02 angepasst V1 12 23 11 12 Kapitelstruktur ge ndert Standalone lt gt Betrieb unter Freigabe Nagios V1 13 21 01 13 Kapitel 12 berarbeitet Freigabe VILLA 08 04 13 An SW Version 2 01 01 angepasst Freigabe e Kap 6 3 1 Warnhinweis Communities hinzugef gt e Kap 6 3 2 Warnhinweis ID hinzugef gt e Kap 6 3 2 CSV Beschreibung erweitert e Kap 6 4 3 erweitert e Kap 6 6 CSV Push hinzugef gt e Kap 7 2 2 hinzugef gt e Kap 7 2 4 4 1 Flags angepasst e Kap 7 3 neu erstellt e Kap 12 4 Konfiguration erweitert e Kap 12 5 1 Timing Intervall hinzugef gt V1 15 28 11 13 e Diverse Anpassungen Kapitel 6 7 Vorl ufige Freigabe e Kap 8 neu mit Inhalt von 6 5ff e 8 3 neu eingef gt 2013 pikkerton GmbH Seite 2 101 LabCon Benutzerhandbuch c0 e Version 1 15 a ch wi A wi S PIKKERTON 2 Rechtliches 2013 pikkerton GmbH Alle Rechte auch die bertragung in fremde Sprachen sind vorbehalten Kein Teil dieses Handbuchs darf ohne schriftliche Genehmigung der Firma pikkerton GmbH in irgendeiner Form Druck Fotokopie oder ein anderes Verfahren reproduziert
31. LabCon Seite 87 101 LabCon Benutzerhandbuch G Be e Set Version 1 15 mm Ss a 2 Ss 2 PIKKERTON 14 3 pnp4nagios Dieses Nagios Plugin erm glicht es die von allen Nagios Plugins gelieferten Performancedaten zu analysieren und automatisch in RRD Datenbanken zu speichern und anschlie end zu visualisieren Die Abk rzung RRD steht f r Round Robin Database und bezieht sich auf die Art und Weise in der Daten von RRDtool gespeichert werden Beim Anlegen einer Datenbank einer so genannten RRD Datei wird genug Speicher f r eine angegebene Zeitspanne angelegt Nach dieser Zeitspanne wird die Datenbank nicht erweitert die Datei wird nicht vergr ert sondern die ltesten Daten werden berschrieben Host dauertest Service 110 Raum6 3_TEM2 4 Hours 20 07 12 9 51 20 07 12 13 51 Datasource Wert Er Host dauertest Device ID 110 __Raum6 3 ZBS 110 Service TEM2 10 00 10 20 10 40 11 00 11 20 11 40 12 06 12 20 12 40 13 00 13 20 13 40 Last 24 05 C Min 19 10 C Max 31 52 C Average 23 35 C Higher Threshold 27 8 C HITEM2 A Lower Threshold 10 0 C LOTEM2 Abbildung 42 Temperaturkurve mit pnp4nagios In der Fehler Referenz nicht gefunden wird ein Temperaturverlauf ber 4 Stunden dargestellt Die rote Linie steht dabei f r eine obere Grenze bei deren berschreitung ein oder mehrere Alarme ausgel st bzw Aktionen ausgef hrt werden k nnen 2013 pikkerton GmbH Seite 88 101 LabCon Benu
32. Modus der ZBG 100 laufen soll s Standalone Mode Wenn der ZBG in diesem Modus l uft ist ein lokaler Nagiosserver gestartet Dieser sammelt selbstst ndig die Sensorinformationen ein Diese werden grafisch aufgearbeitet und k nnen ber die Nagios Webseite angezeigt werden Die Seite befindet sich unter https lt ZBG IP gt nagios3 Benutzername nagiosadmin Passwort rootroot e Plugin Mode In diesem Modus ist der Nagiosserver abgeschaltet Alle anderen Dienste wie z B SNMP oder CSV sind von dieser Einstellung unber hrt 2013 pikkerton GmbH Seite 39 101 LabCon Benutzerhandbuch os e Version 1 15 mm PIKKERTON Aus Performance Gr nden empfiehlt es sich ab 10 Sensoren den internen Nagios Server abzuschalten und den Plugin Mode in Verbindung mit einem externen Nagios oder Icinga Server zu verwenden 6 6 4 Web Access Hier kann das Passwort f r die Webseite der Benutzer admin und nagiosadmin ge ndert werden Passwort welches man z B ber ssh ben tigt wird hierbei nicht Die Passwort nderung betrifft nur das Webpasswort Das root ver ndert 6 6 5 Update In diesem Men kann ein Update f r alle Sensoren der ZBS Familie sowie f r das ZBG 100 Gateway durchgef hrt werden e Upload Hier k nnen die verschiedenen Dateien f r die jeweilliegen Ger te hochgeladen werden e Device List Hier stehen alle an dem ZBG 100 angemeldeten Sensoren Auch der ZBG steht als Koordina
33. Nagios Konfiguration f r die Devices Dies ist eine Grundvoraussetzung fiir die Konfiguration der Gruppen Durch das Dr cken auf den Link Group Event Config erscheint folgende Webseite 2013 pikkerton GmbH Seite 63 101 LabCon Benutzerhandbuch ep e gg Version 1 15 B y Bun w PIKKERTON e vw won Step 2 3 Service Group amp Event Setup Here you can configure service group events for the default service groups or create your own customized groups To add a service group click here Service group name Edit RemoveSetup Ambient Atmosphere E Energy Metering Mains Analysis ES Access Control ES Battery Abbildung 30 Service Groups Hier gibt es 6 vordefinierte Gruppen Ambient Atmosphere In dieser Gruppe befinden sich alle Sensoren die das Klima berwachen wie zum Beispiel Luftdruck Temperatur oder Luftfeuchtigkeit Energy Metering In dieser Gruppe befinden sich alle Strom Arbeits und Leistungsmessungen Mains Analysis In dieser Gruppe k nnen Spannung und Frequenzen berwacht werden Access Control In dieser Gruppe k nnen alle Sensoren die f r eine Zugangs berwachung geeignet sind eingestellt werden Dies sind unter anderem die Helligkeitsmessung der Tastendruck des ZBS 130 oder auch die Bewegungserkennung vom ZBS 121 Battery Diese Gruppe dient zur berwachung der Batteriespannung der Kabellos betrieben Ger te wie zum Beispiel der ZBS 121 ode
34. Seite 58 101 LabCon Benutzerhandbuch c0 o garg Version 1 15 D PIKKERTON 9 1 4 Timing Endger te gt Gateway gt Nagios Event basiert Das folgende Beispiel bezieht sich auf einen ZBS 121 Multisensor welcher eine eingestellte Temperaturschwelle von 24 C hat N no d re R RK x RL Es Es Eege A Kee EE e Es d S Se E s 203 EIER ee Ee eebe BY eect SCART ANE een 18 amp A s amp d E Service ok Service critical Service ok Abbildung 27 ZBG Device Nagios Timing Die Abbildung 27 zeigt einen kompletten Zyklus von dem Zustand ausgehend dass sich ein Service lt Temperatur gt im Toleranzbereich befindet lt 24 C diesen verl sst gt 24 C und wieder in diesen zur ckkehrt Der gr n rote Balken steht dabei f r den Zustand den LabCon zu den jeweiligen Zeitpunkten anzeigt 1 Die Temperatur bersteigt 24 C Dieses wird aber erst nach dem Ablauf des MSI Intervalls vom ZBS gemessen und ber Funk an das ZBG gesendet 2 Das ZBG sendet wiederum ein SNMP Trap vgl Kap 8 1 3 an den Trap Receiver vgl Kap 14 5 2 4 Dieser leitet die Nachricht an Nagios weiter wo diese auf ein Kommando Stack landet Von dem Empfang des Funkpaketes bis zur Sendung an Nagios vergeht typischerweise eine Sekunde 3 Der Nagios Reaper verarbeitet den Befehl f hrt die durch LabCon konfigurierten Alarmskripte aus und ndert den Status von OK auf Critical typischer weise 1 2 Sekunden We
35. abCon Benutzerhandbuch 28 e geg i S Tia Version 1 15 mm z ee hx 2 PIKKERTON 3 Inhaltsverzeichnis 1 EE 2 2 PI UU ee ee een 3 GSM Ee 4 4 Allgemeines sense an 7 5 bersicht ber LabtConf 8 5 1 Der verwendete Funkstandard Zobee nenn 9 5 1 1 ee ae E 11 Eeer Ee 11 9 1 3 ENG Deviee E 12 3 2 NOTTS USS CIN soye serorea ee 13 5 2 1 ZigBee Gateway ZBG 100 usmsm04n4a04sa Henne nn 13 5 2 2 ZigBee Sensoren amp Aktoren der ZBS Familie 14 5 2 2 1 Smart Energy Meler 0u 2 see 14 5 2 2 2 ZigBee Mullisersar sense 16 5 2 2 3 Weitere ZBS Ger te nnsen een 17 5 2 3 Erste Inbetriebnahme der Ger te amp Netzwerkaufbau 18 5 2 3 1 OSS AY ee cee eee eee 18 5 2 3 2 Ge Le 19 5 2 4 Timing der Gere ses ek 20 5 2 4 1 Interne konfigurierbare Intervalle in den Endger ten 20 5 2 4 2 Aktualit t der Messwerte zyklisch 21 6 Weboberfl che des ZBG 100 n nn 22 6 1 VOoralsselzungen ee 22 6 2 Auslieferungszusiand rss eu eu 23 603 Hauptmenu E 24 6 4 ZigBee e nett e nenene nrerenan ennenen irten eneee eeee en 25 6 4 1 PINS VIG SS coe ratios en aa ee 25 6 4 2 Virtuelle Devices 29 OAS e 20er 32 6 5 ege iere DEE 34 6 5 1 El eegene ea 34 6 5 2 bleu 35 Dos ON ee Eee ee 36 6 5 4 Nagios nd lcinga e nneeee en 37 6559 ele 37 6596 EMail enee a a a a a cesT eee 38 EB Eeer 39 6 6 1 Support ltere Een
36. aphandler py Bevor der SNMP Dienst neu gestartet werden kann muss die Option TRAPDRUN in der Datei etc default snmpd auf yes gesetzt und der Dienst den Startroutinen hinzugef gt werden insserv snmpd Die Community public muss der Trap Community angepasst werden mit der die Traps an den Server gesendet werden Diese kann Uber SNMP eingestellt werden vgl Kap 8 1 3 Ce Traps werden an den Port 162 UDP versendet Dieser darf nicht durch eine Firewall blockiert sein 2013 pikkerton GmbH Seite 98 101 LabCon Benutzerhandbuch c0 e a Version 1 15 3 Ss el A Ss PIKKERTON 14 5 2 5 Apache2 Konfiguration Die LabCon Konfiguration f r den Apache2 muss in das conf d Verzeichnis des Apache verlink werden cd etc apache2 conf d ln s usr local labcon apache2 labcon conf 14 5 2 6 Anpassung f r pnp4nagios alle ein Damit die Graphen korrekt angezeigt werden m ssen usr local labcon pnp4nagios share templates in Unterverzeichnis verlinkt werden cd usr local pnp4nagios share templates ln s usr local labcon pnp4nagios check snmp cor php In s usr local labcon pnp4nagios check snmp _normal php 14 5 2 7 Beschreibung des Inhalts des Archives lt zbg_hostname gt _ custom _config zip Beschreibung Dateien aus php4nagios Beinhaltet grundlegende Dateien f r die Integration von LabCon in Nagios Download http lt ip des ZBG gt nagiosfiles lt zbg hostname gt custom
37. auf Er h lt f r die direkt an ihm angemeldeten End Devices die Nachrichten vor falls diese f r ein gerade schlafendes End Device bestimmt und daher nicht zustellbar sind Der Router ben tigt eine permanente Stromversorgung Router k nnen entweder mit eigenen Funktionalit ten kombiniert werden vgl die Ger te ZBS 110V2 111 112 oder stehen aber standalone als Router da vgl ZBR 100 2013 pikkerton GmbH Seite 11 101 LabCon Benutzerhandbuch c0 e Version 1 15 mm PIKKERTON 5 1 3 End Device Die End Devices sind meist batteriebetrieben und werden nur selten aktiv a wenn Ihre konfigurierte Schlafzeit abl uft default 28 Sekunden fragen sie den Router an dem sie angemeldet sind ob Nachrichten oder Auftr ge f r sie vorliegen b wenn lokale Events anliegen z B Tastendruck oder erkannte Bewegung c wenn ein in einem vorher definierten Messintervall MSI die lokalen Sensoren angefragt werden und mindestens eine Schwellwertverletzung vorliegt d wenn ein vorher definiertes Sendeintervall TXT sie dazu zwingt alle lokalen Sensoren abzufragen und die Sensordaten an den Coordinator zu schicken Im LabCon System sind das die Ger te ZBS 121 122 130 132 140 141 144 Batteriebetriebene Ger te werden permanent auf Ihre Batteriespannung berwacht Ist die Batterie leer wird dies fr h genug signalisiert um die Batterie auszutauschen bevor das Ger t nicht mehr erreichbar
38. config zip 2013 pikkerton GmbH Seite 99 101 LabCon Benutzerhandbuch c0 e Version 1 15 a ch el A wi S PIKKERTON 14 5 2 7 1 Der Unterordner config Dieser Ordner beinhaltet die Konfiguration von LabCon f r Nagios f r alle freigeschalteten Ger te der ZBS Familie 14 5 2 7 2 Der Unterordner icinga Inhalt e labCon icinga ClassicMenu php PHP Skript f r die Men integration von LabCon in Icinga e insert to menu htm txt Beinhaltet die Erg nzung f r die menu html um LabCon in Icinga zu integrieren 14 5 2 7 3 Der Unterordner mibs Beinhaltet die MIBs Management Information Base des ZBG 100 Gateways und f r die an ihm angemeldeten Ger te Inhalt e PIKKERTON MIB txt e PIKKERTON ZBS 130 MIB txt e PIKKERTON ZBS 132 MIB txt e PIKKERTON ZBS 140 MIB txt e PIKKERTON ZBS MIB txt e PIKKERTON ZBS X1X MIB txt e PIKKERTON ZBS X2X MIB txt 14 5 2 7 4 Der Unterordner nagios Inhalt e labcon_menu php PHP Skript f r die Men integration von LabCon in Nagios ST insert _to_side php txt Beinhaltet die Erg nzung f r die side php um LabCon in Nagios zu integrieren 2013 pikkerton GmbH Seite 100 101 LabCon Benutzerhandbuch s Set Version 1 15 a Ss Oh 3 We S PIKKERTON 14 5 2 7 5 Der Unterordner scripts Dieser Ordner beinhaltet die Skripte die zur Steuerung der Ger te der ZBS Familie ber Nagios LabCon ben tigt werden 2013 pikk
39. die Monitoring bersichtsseite 2013 pikkerton GmbH Seite 77 101 LabCon Benutzerhandbuch e e gg a Version 1 15 mm Ses 2 e We S PIKKERTON Ben Z 8 A 4 IN Default Groups and System Modules Default Groups System Modules Ambient Atmosphere Energy Metering Battery du Mains Analysis Access Control Customized Service Groups There are no customized service groups configured yet Abbildung 37 bersichtsseite f r das LabCon Monitoring Die folgende Abbildung zeigt einen Temperaturverlauf im Zeitraum von 7 Wochen Pnp4nagios bietet die M glichkeit zum einfachen zoomen von Zeitbereichen Dazu k nnen die beiden zeitlichen Grenzen rechts und links beliebig verschoben werden mithilfe der beiden Pfeile an der rechten bzw linken unteren Ecke Man kann aber auch mit Hilfe der Maus zoomen indem man die Maus ber den gew nschten Startwert platziert die rechte Maustaste gedr ckt h lt und sie dann ber die gew nschte Endzeit bringt und dort die Maustaste wieder losl sst Der Taster rechts au en stellt den Standard Zoom zur Zeit sind das die letzten sieben Wochen wieder her Die rote Linie zeigt den oberen Grenzwert an von dem ZBS 110 eine Meldung kommt welche dann zum Ausf hren der LabCon Skripte f hrt Der Zeitraum in dem die Temperatur au erhalb des Grenzwertes liegt ist auf rot eingef rbt 2013 pikkerton GmbH Seite 78 101 LabCon Benutzerhandbuch ep a a e Sep Versio
40. e Broadcast Meldung verschickt worauf sich alle im Netzwerk befindlichen Ger te anmelden m ssen Ger te die nicht zur ZBS Familie geh ren werden als NON_ZBS bezeichnet Diese erscheinen eventuell erst nach einem Node Discover Wenn noch nicht alle Ger te angezeigt werden kann die Anzeige mit Refresh aktualisiert werden Physical Device Overview MAC AV 0013a200407b5d4f 0013a200408cf950 0013a200408cf944 0013a200408a1eba 0013a200408a1ebc 0013a200408668ca Enable Joining 60s PID AV ZBS 110 ZBS 112 ZBS 112 ZBS 121 ZBS 121 ZBS 121 ID SN AV AV ConfRoom 110V2120676 CableMeter01 112V10125235 CableMeter02 112V10125237 MultiSensor1 ZBS121007469 Prod ZBS121007468 ProdWindow ZBS121234567 Node Discover Refresh Lost message counter update interval 0 s Lost message counter reset 08 15 18 UTC Fri 02 11 2012 Abbildung 12 ZigBee Configuration Phys Devices Overview 2013 pikkerton GmbH Configured Active AV AV Yes 7A Yes gt Yes gt Yes gt Yes gt Yes gt remove offline devices LMC Select AN X 0 ox 0 o 0 Seite 25 101 LabCon Benutzerhandbuch c0 e Version 1 15 mm PIKKERTON MAC Die MAC Adresse ist eine eindeutige Adresse des ZigBee Moduls auf den jeweiligen Devices Damit kann jedes Device identifiziert werden Wenn man dem MAC Adressen Link folgt der hinter der Adresse hinterlegt ist ge
41. ein Device ausgew hlt ist stehen unter Available service alle von diesem Device angebotenen Services Aktoren wie zum Beispiel das Schalten von Relais werden an anderer Stelle konfiguriert s Kap 9 2 4 3 Konfiguration der Gruppenmitglieder ber den Button Apply gelangt man wieder zur Gruppen bersicht zur ck 2013 pikkerton GmbH Seite 66 101 LabCon Benutzerhandbuch c0 e Version 1 15 PIKKERTON Folgende Dienste stehen u a zur Verf gung Name Beschreibung BRI Helligkeit Gibt die Helligkeit in Lux an DBRI Delta BRI Helligkeitsdifferenz zwischen der letzten und der aktuellen Messung TEM x Temperatur in C Manche Ger te haben mehrere Temperatursensoren DTEM Delta TEM Temperaturdifferenz zwischen der letzten und der aktuellen Messung HUM Relative Luftfeuchtigkeit in Prozent DHUM Delta HUM Luftfeuchtigkeitsdifferenz in Prozentpunkten zwischen der letzten und der aktuellen Messung PRES Luftdruck in hPa DPRES Delta PRES Luftdruckdifferenz zwischen der letzten und der aktuellen Messung BAT Zustand der Batterie s OK s LOW UBAT Batteriespannung in V POW Relaiszustand s ON OFF FREQ Frequenz in Hz VRMS Spannung in V IRMS Strom in mA LOAD Leistung in W WORK Verbrauch in kWh BUTTON Alarmmeldung fiir Tastendruck Tabelle 3 bersicht ber ZBS Dienste Weitere Informationen zu den Services findet man
42. em drahtlosen Weg verlorene Nachrichten hnlich wie der Packet Loss bei einem Ping blicherweise kommt es hier selten zu h heren Werten Der LMC wird vom System intern errechnet und basiert auf den internen ZigBee Event Countern die jedoch nur selten bertragen werden bspweise in Heartbeat Paketen diese sind in der Low Level Konfiguration der ZBS Ger te einzustellen Sind diese aufgrund eines massiven Batteriesparprogramms weitgehend abgeschaltet so kann ber das folgende LMC Intervall der Wert explizit vom Ger t angefordert werden Es ist zu beachten dass hier Datentelegramme angefordert werden die jeweils auch zus tzlichen Stromverbrauch zur Folge haben Lost Message Counter rgengl fe Je Betsch The last message counter is turned off by entering 0 Reset O Last reset 08 15 18 UTC Fri 02 11 2012 Apply Abbildung 14 Settings Gateway Lost Message Counter 2013 pikkerton GmbH Seite 28 101 LabCon Benutzerhandbuch ep a a et Version 1 15 mm Ss 3 ef s PIKKERTON 6 4 2 Virtuelle Devices Der ZBG 100 bietet die M glichkeit virtuelle Sensoren zu erstellen Diese Sensoren sind mathematische Konstrukte beliebig vieler physischer und virtueller Sensoren Dienste Die zur Verf gung stehenden mathematischen Funktionen lauten e Summe sum e Durchschnitt Mean e Differenz Diff e Minimum Min e Maximum Max Virtuelle Sensoren verhalten sich wie physische Sie haben ein
43. en und Intervalle an die jeweiligen Devices bermittelt und die eingestellten Skripte f r die Konfiguration von Nagios auf dem ZBG 100 Gateway gespeichert 2013 pikkerton GmbH Seite 69 101 LabCon Benutzerhandbuch 28 e Version 1 15 mm PIKKERTON 9 2 4 4 Templates f r Aktoren Die Aktoren werden f r Aktionen nach Grenzverletzung bzw Alarmmeldungen f r die Ausf hrung bestimmter Aktionen ben tigt Ce Die einzelnen Parameter werden durch ein Komma voneinander getrennt Die Reihenfolge ist wichtig 9 2 4 4 1 Flags Set_Flag py Aktionen k nnen mit Hilfe von Flags freigegeben oder gesperrt werden Dies kann zum Beispiel zum scharf schalten von Alarmanlagen o benutzt werden Dieses Skript setz ein Flag mit einer beliebigen Zeichenkette Parameter 1 Name des Flags 2 Einzeilige Zeichenkette Check_Flag py Aktionen k nnen mit Hilfe von Flags freigegeben oder gesperrt werden Dies kann zum Beispiel zum scharf schalten von Alarmanlagen o benutzt werden Dieses Skript berpr ft ein Flag auf mit eine beliebigen Zeichenkette Parameter 1 Name des Flags 2 optional Standardwert f r das Flag falls es noch nicht initialisiert d h bereits von einen anderem Skript gesetzt oder gel scht worden ist 1 Flag gilt als gesetzt 0 Flag nicht gesetzt 2013 pikkerton GmbH Seite 70 101 LabCon Benutzerhandbuch 28 garg Version 1 15 PIKKERTON 9 2 4 4 2 Email Ve
44. erton GmbH Seite 101 101
45. ienung kann dazuf hren dass einzelne Sensoren oder das gesamte Netzwerk nicht mehr funktionieren Um ein Funknetz zu verschl sseln m ssen folgende Schritte vorgenommen werden 1 Wahl eines Netwerk Schl ssels max 32 Zeichen Hexadezimal ohne f hrendes Ox z B 3ac56d 2 Ein Device in das sichere Netzwerk konfigurieren Add to Secure Network 3 Koordinator in das verschl sselte Netzwerk umkonfigurieren Mausklick auf Encrypted Network 4 Warten bis sich das Device angemeldet hat Jetzt werden die Einstellungen automatisch im Device gespeichert 5 F r weitere Devices muss der Koordinator wieder f r das unverschl sselte Netzwerk konfiguriert Open Network und Schritt 2 4 wiederholt werden Network Key Hier kann der Schl ssel f r die Verschl sselung eingetragen werden Disable Encryption Hiermit wird das Gateway zwischen dem verschl sselten und unverschl sselten Modus umgeschaltet Found Joined devices in Encrypted Network Hier werden alle Ger te angezeigt die sich an dem Koordinator Gateway angemeldet haben Diese k nnen dann jeweils einzeln in den anderen Modus konfiguriert werden 2013 pikkerton GmbH Seite 32 101 LabCon Benutzerhandbuch c0 garg Version 1 15 IT wi PIKKERTON Nachdem in dem ZigBee Koordinator dem ZBG 100 die Verschl sselung aktiviert wurde k nnen sich nur noch ZigBee Router und Endger te mit eingeschalteter Verschl sselu
46. in einer Baumstruktur Jeder Knotenpunkt hat eine eigene Nummer Um eine Variable abzurufen wird der Pfad von der Wurzel her angegeben Wenn man zum Beispiel den ZBG Produktnamen abrufen m chte findet man diesen unter dem Knotenpunkt 1 3 6 1 4 1 23596 10 1 0 Um dieses zu vereinfachen gibt es die Management Information Base MIB welche diese Zahlenkette f r den Anwender in einen Namen umwandelt bzw den Namen f r den Manager in eine Zahlenkette Skalare enden immer auf eine Null w hrend Tabellen immer ein Index besitzen Die Sensoren der ZBS Familie sind tabellarisch angeordnet Als Index dient Ihre MAC Adresse 3 Ein Skalar ist eine mathematische Gr e die allein durch die Angabe eines Zahlenwertes charakterisiert ist in der Physik gegebenenfalls mit Einheit 2013 pikkerton GmbH Seite 43 101 LabCon Benutzerhandbuch c0 e Version 1 15 mm PIKKERTON 8 1 1 Berechtigungsmanagement Das ZBG 100 unterst tzt die Protokolle SNMPv1 SNMPv2c und SNMPv3 Die Versionen 1 und 2c sind im Gegensatz zur Version 3 unverschl sselt 8 1 1 1 SNMPv1 und v2c Diese Version wird von fast allen SNMP Managern unterst tzt Die Benutzerauthentifizierung erfolgt ber die so genannte Community Diese sind standardm ig zum Lesen public und zum Schreiben private Diese k nnen aber auch beliebig ge ndert werden s Kap Fehler Referenz nicht gefunden 8 1 1 2 SNMPv3 SNMPv3 verf gt ber zwei Sicherheitsmer
47. ine bestimmte Zeit ab und anschlie end wieder an z B ZBS 110 Parameter 1 ID des ZBS 2 Wartezeit in Sekunden 2013 pikkerton GmbH Seite 72 101 LabCon Benutzerhandbuch 28 e Version 1 15 mm PIKKERTON ZBS_PWR_Cycle_ON py Schaltet ein Relais f r eine bestimmte Zeit an und anschlie end wieder ab z B ZBS 110 Parameter 1 ID des ZBS 2 Wartezeit in Sekunden 9 2 5 Beispiele 9 2 5 1 L ftersteuerung Regelkreis mit Hysterese Als Beispiel der Regelung mit Hysterese dient eine temperaturabh ngige L ftersteuerung Der L fter ist an einem ZBS 110 angeschlossen und die Temperatur wird mit einem ZBS 121 Multisensor bestimmt Die ID des ZBS 110 an der der L fter angeschlossen ist hei t zbs110_fan e 40 C einschalten e 30 C ausschalten Die Temperaturwerte sollen alle 60 min TXT 3600s bertragen werden aber es soll alle 10 min MSI 600s gemessen werden ob eine Schwellwertverletzung vorliegt um die Energie der Batterie zu sparen Der Sensor wird in der Gruppe Ambient Atmosphere gefunden Er wird folgenderma en Konfiguriert 2013 pikkerton GmbH Seite 73 101 LabCon Benutzerhandbuch e Se Version 1 15 Sep a wir a s PIKKERTON Environmental ID PID SN MAC Status ZBS121000000 ZBS 121 ZBS121000000 0013a200407e7b85 Abbildung 33 Beispiel L ftersteuerung 9 2 5 2 Regelkreis ohne Hysterese Die Anforderungen sind analog zum Beispiel L fterste
48. inga ClassicMenu php usr local icinga share labCon icinga_ClassicMenu php In der Datei usr local icinga insert to menu htm txt sind exemplarisch Programmzeilen eingetragen die in der Datei usr local icinga share menu html hinzugef gt werden m ssen Auszug aus der angepassten Datei lt h2 gt Reporting lt h2 gt lt ul gt lt ul gt lt h2 gt LabCon lt h2 gt lt ul name 1labConHostMenu gt lt li class menuli_stylel gt lt select onchange setZbgHostContent name labConHostSelection gt lt select gt lt 1i gt lt ul gt lt script type text javascript src icinga labCon_icinga_ClassicMenu php gt lt script gt lt script type text javascript gt getZbgHostList lt script gt lt h2 gt Configuration lt h2 gt In der Icinga Konfigurationsdatei des Apache2 Servers muss das Folgen von symbolischen Verkn pfungen aktiviert werden Dies wird gemacht indem Options FollowSymLinks in den lt Directory usr local icinga share gt Block der Date etc apache2 conf d icinga conf eingetragen wird Auszug aus der angepassten Datei lt Directory usr local icinga share gt SSLRequireSSL Options None Options FollowSymLinks AllowOverride All Order allow deny Allow from all Order deny allow Deny from all Allow from 127 0 0 1 AuthName Icinga Access AuthType Basic AuthUserFile usr local icinga etc htpasswd users He 2013 pikkerton GmbH Seite 96 101 LabCon Benutzerhandbuch
49. ist 2013 pikkerton GmbH Seite 12 101 LabCon Benutzerhandbuch c0 e Version 1 15 mm PIKKERTON 5 2 Ger te bersicht 5 2 1 ZigBee Gateway ZBG 100 Das frei programmierbare ZigBee Gateway ZBG 100 beinhaltet neben einem GHz Klasse ARM basierten CPU Core mit kr ftiger Peripherie wie Gigabit Ethernet einem SD Card Slot und einen USB Port die man beispielsweise als Speicher f r Datenlogs oder Applikationen nutzen kann und einem 2 4 GHz ZigBee Koordinatormodul Ein 230V Netzteil ist bereits integriert so dass der ZBG 100 einfach in eine Steckdose gesteckt wird und sofort startet A A 7343 A hhh Abbildung 3 ZBG 100 F r den einfachen und schnellen Start ist auf dem ZBG ein Webfrontend verf gbar mit dem alle ZigBee Ger te komfortabel und zuverl ssig konfiguriert werden k nnen Das ZBG verf gt ber zwei LEDs eine Blaue und eine Rote die ber Software angesprochen werden k nnen LabCon nutzt diese um Datenverkehr ber die ZigBee Funkstrecke anzuzeigen Sowohl die USB Schnittstelle als auch der SD Karten Slot k nnen zur Erweiterung des internen Speicherplatzes genutzt werden Es kann aber auch ber diese Schnittstellen ein Linux Betriebssystemen gestartet werden Weiterf hrende Informationen stehen im Datenblatt welches unter http www pikkerton de zigbee ZBG 100 ZigBee Gateway html gefunden werden kann 2013 pikkerton GmbH Seite 13 101 LabCon Benutzerhandbuch ep e garg
50. kmale 1 Passwort gesch tzte Benutzerauthentifizierung 2 Verschl sselung der Rohdaten im Datenpaket F r die Authentifizierung und f r die Verschl sselung k nnen individuelle Passw rter vergeben werden Sie k nnen auch unabh ngig voneinander eingeschaltet werden Sicherheitsmerkmal von SNMPv3 benutzt werden soll werden die gt Wird in der Konfiguration vorgegeben dass mindestens ein SNMP Versionen 1 und 2c automatisch abgeschaltet 8 1 2 SNMP Manager Die Firma iReasoning bietet den SNMP Manager MIB Browser in einer freien bzw kostenlosen Version an Dieser basiert auf Java und ist deshalb auf Windows Mac OS Linux oder anderen Unix Plattformen einsetzbar Unter anderem verf gt diese Version ber folgende Features e SNMP Walk Get Set e Tabellarische MIB Ansicht e Trap Empfanger Sender e SNMP v1 und v2c e bis zu 10 MIBs k nnen aufgel st werden 2013 pikkerton GmbH Seite 44 101 LabCon Benutzerhandbuch Be e Se Version 1 15 mm hd 3 2 D PIKKERTON Die kostenpflichtige Version verf gt ber mehr Features wie zum Beispiel SNMPv3 Es gibt auch noch viele weitere Manager wobei HP Openview und Net SNMP die bekanntesten sind In diesem Handbuch wird nur kurz auf den MIB Browser von iReasoning eingegangen Nach dem ersten Start sieht er wie folgt aus gt iReasoning MIB Browser File Edit Operations Tools Bookmarks Help Address 192 168 8 103 Advanced op e Operations
51. langt man zu der Seite des jeweiligen Sensors Hier kann man die aktuellen Messwerte auslesen Schwellwerte und Intervalle TXT und MSI einstellen sowie ggf das Ger t steuern z B Relais oder LED Zustand ndern PID Die PID ist der jeweilige Ger tetyp der ZBS Familie ID Die ID ist bei Auslieferungszustand die gleiche wie die Seriennummer Sie ist aber frei w hlbar und dient der leichteren Identifizierung bzw Beschreibung des Ger tes z B ID Dataroom4 oder ID Rack5a Die maximale L nge dieses Feldes betr gt 12 Zeichen Aus Kompatibilit tsgr nden sollte hier auf Sonder und Freizeichen verzichtet werden Sobald Nagios Icinga verwendet wird darf keine ID mehrfach verwendet werden Active Mit Active kann man erkennen ob sich das Device gerade im Netzwerk befindet Checkbox Nur f r die Devices hinter denen die Checkbox aktiviert ist wird bei Generate Konfigurationsdateien f r Nagios erstellt Es besteht weiterhin die M glichkeit Klartextbefehle unter Command einzugeben und an ausgew hlte Devices mittels send Command zu senden Diese Kommandos werden ebenfalls an alle in der Checkbox aufgew hlten Ger te geschickt Da die Antwort der Ger te im Batteriebetrieb teilweise bis zu 30s dauern k nnen k nnen zu 2013 pikkerton GmbH Seite 26 101 LabCon Benutzerhandbuch c0 e Version 1 15 a ch a 3 wie PIKKERTON einem wahlfreien Zeitpunkt ber den Punkt
52. le in den Endger ten Alle ZBS Ger te haben bestimmte Zeitintervalle die eingestellt werden k nnen Wakeup every TXT cycle Wakeup every MSI cycle Get Sensor Data amp send Sensor Data Telegram no Check of all Sensor Send Sensor Data Data Telegram Lei wi N wi N Z Threshold lt violation or Kg Les NS recovery N X A Abbildung 10 bersicht ber MSI bzw TXT Intervalle MSI Measurement Intervall Das MSI ist die L nge der Pause zwischen zwei Messungen Messungen bedeuten blicherweise deutlich weniger Stromverbrauch als gesendete Funktelegramme Daher ist es ratsam Telegramm nur dann zu senden wenn es tats chlich erforderlich ist TXT Transmit Intervall Das TXT ist die Pause zwischen zwei Paketen mit Service Messwerten 2013 pikkerton GmbH Seite 20 101 LabCon Benutzerhandbuch garg Version 1 15 mm Ss a Ss 2 PIKKERTON 5 2 4 2 Aktualit t der Messwerte zyklisch Das ZigBee Netzwerk arbeitet in Bezug auf die Messdaten autark und somit komplett asynchron zu Nagios oder SNMP Anfragen Dies ist dadurch begr ndet dass sich insbesondere die batteriebetriebenen Ger te blicherweise in einem Schlafmodus befinden und nur nach bestimmten Zeitintervallen MSI oder TXT aufwachen und Messungen bzw Datensendungen vornehmen um den Eigenverbrauch zu minimieren Die ber das TXT Intervall bertragenen Daten werden in einer zentralen Datenstruktur vorgehalten um eine SNMP
53. macht werden unzip lt zbg _hostname gt custom _config zip chmod atx py chmod a x py mv usr local labcon In der Software Version 1 05 02 muss zus tzlich die Datei ConfigZipper py vom ZBG 100 geladen werden und in das LabCon Verzeichnis kopiert werden sowie das Flag Verzeichnis erstellt werden scp root lt ZBG 100 IP gt var www ConfigZipper py usr local labcon www mkdir usr local labcon flags chmod 777 usr local labcon flags 2013 pikkerton GmbH Seite 93 101 LabCon Benutzerhandbuch c0 e Version 1 15 a ch wi A wi S PIKKERTON 14 5 2 2 ZBG Namensaufl sung Zur eindeutigen Identifizierung der einzelnen ZBG 100 Gateways muss dessen Hostname dem Nagios Server bekannt gegeben werden Dies kann ber zwei unterschiedliche Wege eingerichtet werden In diesem Dokument wird die Einstellung der Namensaufl sung ber die Host Datei beschrieben Eine Alternative ist die Aufl sung ber einen DNS Server Damit alle Services korrekt ablaufen k nnen muss neben der Ce Namensaufldsung auch die reverse Namensaufl sung gew hrleistet sein Die einfachere Variante ist die Namensaufl sung ber die lokale Host Datei etc hosts in dieser Datei muss die Zuordnung zwischen der IP Adresse und dem Hostnamen des ZBG 100 in folgender Notation hinzugef gt werden lt IP Address gt lt Full Qualified Hostname gt lt Short Hostname gt 192 168 0 100 zbg 100 domain zbg 100 2013 pikkerto
54. mittels Apply Button an das Device bertragen werden Dieser Button befindet sich am Ende der Seite 2013 pikkerton GmbH Seite 50 101 LabCon Benutzerhandbuch Version 1 15 H PIKKERTON Register settings Register New Value TXT 60 msi en wn mes dS Threshold settings Threshold New Value HIBRI _ 2000 LOTEM 0 0 HITEM 50 0 mmm i ioo LOHUM N A HIHUM N A onm IA HIPRES N A Current Value Current Value Description TX Time in s 1 65000 default 60 Measure interval in s 1 65000 O off Heartbeat interval in s 1 65000 O off default 0 Quiescence time in s 0 6500 O off Sensitivity f r motion detection default 5 0 1000 lower means higher sensitivity signal gets noisy below 5 Description Minimum for brightness alert in Ix 0 2000 Maximum for brightness alert in Ix 0 2000 Delta for brightness alert in Ix 0 2000 Low threshold for the temperature sensor in C value with decimal point 0 0 50 0 High threshold for the temperature sensor in C value with decimal point 0 0 50 0 Delta for temperature alert in K 0 0 50 0 Minimum for humidity alert in 0 100 Maximal for humidity alert in 0 100 Delta for humidity alert in 0 100 Minimum for pressure alert in hPa 300 1100 Maximum for pressure alert in hPa 300 1100 Delta for pressure alert in hPa 0
55. n 1 15 B a z a H PIKKERTON Zoom 09 06 12 21 41 30 07 12 11 36 Host dauertest Device ID 110 Halle ZBS 110 Service TEM2 30 N iT Week 24 Week 25 Week 26 Week 27 Week 28 Week 29 Week 30 Last 19 64 C Min 9 17 C Max 31 59 C Average 19 30 C M Higher Threshold 27 8 C HITEM2 A Lower Threshold 10 0 C LOTEM2 H 20 10 Abbildung 38 Anzeige des Temperaturverlaufes eines Zeitraumes von 7 Wochen Innerhalb des durchsichtigen Bereiches wurde von pnp4nagios keine Werte gespeichert M gliche Ursachen hierf r sind zum Beispiel wenn entweder der nagios Dienst nicht l uft oder das ZBG ber LAN nicht erreichbar ist Zoom 27 07 12 8 47 30 07 12 13 43 Host dauertest Device ID 110 Halle ZBS 110 Service TEM2 Fri 12 00 Sat 00 00 Sat 12 00 Sun 00 00 Sun 12 00 Mon 00 06 Mon 12 00 Last 22 54 C Min 12 16 C Max 32 04 C Average 21 86 C A Higher Threshold 27 8 C HITEM2 Lower Threshold 10 0 C LOTEM2 Abbildung 39 Anzeige des Temperaturverlaufes eines Zeitraumes von 60h 2013 pikkerton GmbH Seite 79 101 LabCon Benutzerhandbuch Version 1 15 10 Abbildung 1 bersicht LabCon amp Schnittstellen ne 8 Abbildung 2 bersicht Zobee 10 Abbildung 3 ZBG 100 nn seen ee aan 13 Abbildung EN KE 14 Abbildung Eh LEE 15 Abbildung B 2Be ij eer tein see 15 Abbildung 7 ZBS 121 ie reise ee 16 Abbildung E TEE 17 ee lee E KE
56. n GmbH Seite 94 101 LabCon Benutzerhandbuch c0 e Version 1 15 mm PIKKERTON 14 5 2 3 Men integration Nagios Zur Integration von LabCon in Nagios muss die Datei labcon menu php zu der side php des Nagios Servers verlinkt werden In s usr local labcon nagios labcon menu php usr share nagios3 htdocs labcon menu php In der Datei usr local labcon nagios insert to side php txt stehen die Programmzeilen die der Datei usr share nagios3 htdocs side php hinzugef gt werden m ssen Auszug aus der angepassten Datei lt div class navbarsearch gt lt form method get action lt php echo Scfg cgi_base url gt status cgi target lt php echo link target gt gt lt fieldset gt lt legend gt Quick Search lt legend gt lt input type hidden name navbarsearch value 1 gt lt input type text name host size 15 class NavBarSearchItem gt lt fieldset gt lt form gt lt div gt lt div gt lt php try include dirname _ FILE _ labcon_menu php catch Exception Sei echo Exception abgefangen e gt getMessage n gt 2013 pikkerton GmbH Seite 95 101 LabCon Benutzerhandbuch garg Version 1 15 mm Ss Oh Ss 2 PIKKERTON Icinga Die Integration des Men s in die Icinga Classic hnelt der Integration in Nagios Es muss eine Verkn pfung zur labCon icinga _ClassicMenu php hergestellt werden In s usr local labcon icinga labCon_ic
57. n Namens und Inhaltes gesetzt Wenn an der Stelle wenn das Skript Check Flag py abl uft der Inhalt des jeweilige Flags nicht mit der Bedingung bereinstimmt wird der Ablauf der Skripte an dieser Stelle abgebrochen 2013 pikkerton GmbH Seite 60 101 LabCon Benutzerhandbuch garg Version 1 15 mm z 2 PIKKERTON 9 2 2 Besonderheit bei Work Limit und Load Limit Es befindet sich bei der Angabe der Grenzen f r Load Limit und Work Limit ein zus tzliches Dropdown Men mit folgenden Auswahlm glichkeiten e MSG Bei berschreitung des Grenzwertes wird nur eine Trap Meldung versendet e off Bei berschreitung des Grenzwertes schaltet der ZBS sofort das Relais aus und sendet eine Trap Meldung Dabei wird diese selbst ndige Abschaltung deaktiviert Um sie wieder zu aktivieren muss eine Grenze erneut eingestellt werden 2013 pikkerton GmbH Seite 61 101 LabCon Benutzerhandbuch Set Version 1 15 mm wll 2 a Ss a PIKKERTON 9 2 3 Erstellen der Nagios Konfiguration f r die Devices Bevor Gruppen oder Regelkreise erstellt werden k nnen muss festgelegt werden welche Devices und somit welche Services konfiguriert werden sollen Dazu m ssen zun chst die gew nschten Devices ausgew hlt werden ber den Button Generate werden dann die Grundkonfigurationen erstellt und ber Download k nnen sie dann heruntergeladen werden Nagios Configuration Attention
58. name entspricht der MAC Adresse des ZBS Device Das Aufzeichnen der Sensorwerte wird im Kapitel 8 2 n her behandelt Folgende Einstellungen k nnen hier vorgenommen werden e Enable CSV Recording Schaltet das Sichern der Daten in die CSV Dateien ein e Enable CSV Mail Wenn der E Mail Client vom ZBG 100 konfiguriert und eingeschaltet ist k nnen alle CSV Werte auch per Mail verschickt werden Hiermit kann der Versand ein bzw ausgeschaltet werden e Enable CSV Push Schaltet das Senden der Daten ber TCP ein Diese Option schaltet zwangsl ufig das Enable CSV Recording ein e Ip Die IP Adresse an die die Daten gesendet werden s Port Der TCP Port an den die Daten gesendet werden e Rate Zeitlicher Abstand in Sekunden in dem der Push Dienst berpr ft ob neue Daten vorhanden sind 2013 pikkerton GmbH Seite 36 101 LabCon Benutzerhandbuch c0 garg Version 1 15 PIKKERTON 6 5 4 Nagios und Icinga In diesem Untermen werden wichtige Informationen f r den Betrieb einen Icinga nzw Nagiosservers hinterlegt Daten k nnen hier nur im Plugin Mode ge ndert werden Mit dem Button Generate wird ein Archiv namens lt zbg hostname gt custom config zip erstellt In diesem Archiv befinden sich alle Konfigurationen und Skripte die f r eine LabCon Erstinstallation in Nagios Icinga ben tigt werden Dar ber hinaus befinden sich auch die f r SNMP ben tigten MIBs in diesem zip File Abbildung TB
59. ng und dem selben Netzschl ssel verbinden Sind die Netzwerkeinstellungen der ZBS Endger te derart verstellt worden da sie nicht mehr im Netzwerk auftauchen bzw erreichbar sind lassen sie sich mit 7x kurze Tasterbet tigungen derart zur cksetzen da der Coordinator der ZBG sie im open network Modus wieder sehen sollte 2013 pikkerton GmbH Seite 33 101 LabCon Benutzerhandbuch ep e Version 1 15 PIKKERTON 6 5 Communication Unter diesem Men eintrag werden s mtliche Kommunikationsprotokolle eingestellt 6 5 1 LAN IP Unter IP Settings werden Netzwerkeinstellungen vorgenommen IP Settings MAC Address FO AD 4E 00 86 D1 Interface ethO DHCP enable E IP Address 192 168 8 104 Subnet Mask 255 255 255 0 Gateway Address 192 168 8 1 DNS Address 192 168 8 2 Domain pikkerton intern de Hostname NTP Server 192 168 8 1 Abbildung 17 Settings Gateway IP Settings Passen sie den Hostnamen so an dass sich das Ger t eindeutig identifizieren l sst Die IP Adresse muss so gew hlt sein dass der Nagios Server das ZBG 100 Gateway erreichen kann Ein Neustart des Gateways ist nicht erforderlich die Einstellungen werden mit dem Bet tigen der Schaltfl che Apply sofort bernommen 2013 pikkerton GmbH Seite 34 101 LabCon Benutzerhandbuch G Be e Se Version 1 15 B hd e S PIKKERTON 6 5 2 SNMP Unter dem Punkt snmp k nnen die alle
60. nn die Temperatur wieder unter 24 C f llt wiederholen sich die Schritte von 1bis 3 2013 pikkerton GmbH Seite 59 101 LabCon Benutzerhandbuch c0 e Version 1 15 mm PIKKERTON 9 2 LabCon Konfiguration In diesem Kapitel wird die automatisierte Erstellung von LabCon Services und Regeln f r Nagios beschrieben Die einzelnen Aktoren Sensoren werden in Gruppen sortiert mit deren Hilfe dann Regelkreise erstellt bzw Schwellwerte eingestellt werden k nnen Bei Verletzung dieser Grenzen k nnen diverse Skripte einzeln ausgef hrt oder nacheinander kombiniert werden e Versendung einer E Mail e Ausf hren von beliebigen Skripte e Ansteuerung von Aktoren e Setzen oder R cksetzen von Flags 9 2 1 Flags Flags bieten eine einfache M glichkeit sich Zust nde f r sp tere Auswertungen oder Bedingungen zu merken Es kann eine beliebige Zeichenkette in diesem Flag gespeichert werden Der Dateiname entspricht dem globalen Flagnamen Sie k nnen manuell ber die Webseite per Skript durch externe Applikationen oder auch Zeit basiert z B einem CRON Job gesteuert werden Gleichzeitig bieten sie eine einfache Schnittstelle zur Au enwelt bzw anderen Applikationen Flags werden in erster Linie dazu benutzt um verschiedene Vorg nge Ablauf von Skripten bei Schwellwertverletzung abzubrechen bzw weiterlaufen zu lassen Es k nnen aber keine Verzweigungen aufgebaut werden Mit dem Skript set Flag py wird ein Flag beliebige
61. oad Update About pikkerton GmbH 2012 Abbildung 40 Upload Maske f r Update Files Nach einem erfolgreichem Datei Upload wird man aufgefordert das Update durchzuf hren in dem der ZBG 100 neu gestartet wird Dies kann man unter ZigBee Gateway gt Settings gt Gateway gt Reboot amp Uptime machen indem in dem K stchen hinter Reboot ein Kreuz gemacht wird und anschlie en mit Apply best tigt wird 2013 pikkerton GmbH Seite 85 101 LabCon Benutzerhandbuch Version 1 15 PIKKERTON 14 Anhang Nagios Installation Diese Kapitel beschreibt die Installation von LabCon auf einer Debian 7 0 Wheezy 14 1 Ben tigte Software Folgende Pakete werden ben tigt apache2 libapache2 mod php5 build essential libgd2 xpm dev postfix libsnmp dev rrdtool librrds perl snmpd php5 gd nagios3 nagios plugins nagios plugins basic nagios plugins standard pnp4nagios python libsnmp python python pysnmp4 Alle Module sind ber apt get bzw aptitude installierbar 2013 pikkerton GmbH Seite 86 101 LabCon Benutzerhandbuch Version 1 15 14 2 Erster Test PIKKERTON Der Aufruf der Website http localhost nagios zeigt dann nach einer Passwortabfrage folgenden Frame 2013 pikkerton GmbH Nagios Home Documentation Current Status Tactical Overview Map Hosts Services Host Groups Summary Grid Service Groups Summary Grid Abbildung 41 Nagios Men ohne
62. p Download der Konfiguration gt 75 Abbildung 36 Seitenmen in NaQiOS c cccceeeeseeneneeceeeeeeeeneceeceeeeeeeenes 77 Abbildung 37 bersichtsseite f r das LabCon Monitoring 78 Abbildung 38 Anzeige des Temperaturverlaufes eines Zeitraumes von 7 Eeer 79 2013 pikkerton GmbH Seite 80 101 LabCon Benutzerhandbuch e Be das Version 1 15 3 Ss el A a Ss PIKKERTON Abbildung 39 Anzeige des Temperaturverlaufes eines Zeitraumes von 60h 79 Abbildung 40 Upload Maske f r Update FEles nenen 85 Abbildung 41 Nagios Men ohne Lab ong 87 Abbildung 42 Temperaturkurve mit DppAnagios nenne nnnnnnnnnnnne 88 Abbildung 43 Nagios Einstellungen f r Lab ong 91 Abbildung 44 ZIP File Genstierung eeee nenn 92 2013 pikkerton GmbH Seite 81 101 LabCon Benutzerhandbuch Version 1 15 11 Stichwortverzeichnis A Achhve 26 Auslieferungszustand 23 Available service 66 B DAT 67 DH 67 BUTTON 67 BUZZ EE 71 Cc Check Flag pPYy ea 60 70 Checkbox 26 Collect Answers 28 le re 100 Coordinator 11 D DBRI nn 67 Default een 27 DHUM u u 67 RS EE 67 D TEM nn 67 E Enable Jomtmg 27 End Devices nn 12 F Flags men 60 FREQ occ ccececcececcecceeeecececeeeeceeeeeas 67 G Gateway eeens 13 2013 pikkerton GmbH H Host Device una 66 Hostnamen nenn 34 HM 67 Hyslefese een 73 l EIN ee ee 100 Deren 26 50 Informationsblock
63. pV uusee 71 ZBS_LED_Control 72 ZBS_PWR_Control py 72 ZBS_PWR_Cycle_OFF py 72 ZBS_PWR_Cycle_ON py 73 ZB W sense 57 73 ZBS 110V ee 14 a LN KN 14 57 ZBS 2 2 14 57 ZBS A2 nee 73 ZBS IN nee 16 57 ZB 30 eee eee ncn eet nae 17 58 ZBS hs 2 17 58 ZBS E ea 58 Zugangskontrolle 75 EE 70ff lt lt zbg_hostname gt _custom_config zip Ee 99 Seite 83 101 LabCon Benutzerhandbuch e Be ag Version 1 15 mm Beef a PIKKERTON 12 Weiterf hrende Informationen Icinga http www icinga or LabCon im Web http www pikkerton de ITRZ LabCon LabCon htm MIB Browser http ireasoning com mibbrowser shtml Nagios http www nagios or SCP http de wikipedia org wiki Secure Co ZBS Familie http www pikkerton de zigbee ZigBee html ZBG 100 http de wikipedia org wiki SheevaPlu http www pikkerton de zigbee ZigBeeGateways html 2013 pikkerton GmbH Seite 84 101 LabCon Benutzerhandbuch Version 1 15 3 Ss el A Ss a PIKKERTON 13 Anhang Software und Lizenz Update Neue Updates k nnen ber den Link Updates auf der ZBG 100 Konfigurationsseite vorgenommen werden Zuerst m ssen die neuen FW Dateien bzw die Lizenz Datei auf das ZBG hoch geladen werden Dies geschieht ber das Webfrontend You are on host ZBG Freigabetest wo LABCON Home ME Durchsuchen Settings Overview without upl
64. pel 11 11 2012 14 05 27 Damit die csv Dateien nicht den gesamten Platz auf der Partition in Anspruch nehmen werden diese mittels dem Linux Log Rotationsdienst berwacht Die Einstellung der Log Rotation kann in der Datei etc logrotate d labcon ca Log rotation oder ber das Webmin Interface vgl Kap 8 5 vorgenommen werden Diese Dateien k nnen zus tzlich mit dem CVS Push Dienst berwacht werden Dieser berpr ft in einstellbaren Intervallen vgl Kapitel 6 4 S 25 und sendet diese ggf an die eingestellt IP Adresse Die Daten haben folgendes Format lt MAC Adresse gt lt ID gt lt Service gt lt Zeitstempel gt lt Wert gt lt Einheit gt Das sieht beispielsweise f r eine Strommessung wie folgt aus 0013a2004076843b SR FAN R IRMS 2013 04 08 11 24 55 121 mA e MAC Adresse 0013a2004076843b e ID SR FAN R s Service IRMS Strommessung e Wert 121 mA 2013 pikkerton GmbH Seite 47 101 LabCon Benutzerhandbuch Version 1 15 8 3 Interner Nagios Server oe PIKKERTON Im Standalone Mode stellt das ZBG 100 Gateway einen Nagios Server bereit Dieser ist unter folgender Adresse zu erreichen https lt ip addresse gt nagios Benutzername nagiosadmin Passwort rootroot Die Funktion des internen Nagios Servers ist identisch mit einem externen Diese sind in Kapitel 9 n her beschrieben 2013 pikkerton GmbH Seite 48 101 LabCon Benutzerhandbuch G Be e Set Version 1 15 mm Beef ri P
65. r der ZBS 130 Device Connectivity Diese Gruppe dient zur berwachung der Erreichbarkeit aller Ger te auf dem Funkweg 2013 pikkerton GmbH Seite 64 101 LabCon Benutzerhandbuch dat Version 1 15 B a a Ss PIKKERTON 9 2 4 1 Gruppen hinzuf gen Mit dem Button Add k nnen Gruppen hinzugef gt werden Es ffnet sich folgende Maske Add service group On this page you can create yuor service group ZBG 100 p MotionDetect BG 100 p Lamp2 ZBG 100 p Lamp1 BG 100 p Activator ansssssssnsssnssnussssunsnsssnenssssssnssnsssnsunsssssnsnsssnnsnsssssunsnsssnsunsnsssnnsne Fields marked with must be filled Abbildung 31 Service Gruppen 2013 pikkerton GmbH Seite 65 101 LabCon Benutzerhandbuch c0 e Version 1 15 a ch a 3 wi PIKKERTON Zun chst sollte ein Name f r die Gruppe eingegeben werden Dieser darf nur aus folgenden Zeichen bestehen e AZ a z e 0 9 e Unterstrich Die Beschreibung des Gruppe in Nagios unterliegt keiner Beschr nkung hier k nnen auch Frei und Sonderzeichen benutzt werden Unter Host Device stehen alle Devices f r die im Kapitel 9 2 3 Erstellen der Nagios Konfiguration f r die Devices eine Konfiguration f r Nagios erstellt worden ist sowie alle eingerichteten Virtuellen Sensoren Wobei hinter dem Hostnamen steht ob es sich um einen virtuellen v oder physischen p Sensor handelt Wenn in diesem Fenster
66. ration des Gateways in Nagios Icinga 14 5 1 Vorbereitende Ma nahmen Zun chst m ssen auf dem ZBG 100 Einstellungen bez glich des Nagios Servers vorgenommen werden da verschiedene Linux Distributionen auch unterschiedliche Verzeichnisstrukturen haben k nnen Diese Einstellungen nimmt man ber die Webseite des Gateways unter dem Punkt Settings Nagios Vor Nagios Settings PNP4Nagios performace data path usr local pnp4nagios var pe e g usr local pnp4nagios var perfdata PNP4Nagios server path from www root e g pnp4nagios Path to external command file nagios cmd var lib nagios3 rw e g var lib nagios3 rw Timing Interval Length nagios cfg e g 60 Abbildung 43 Nagios Einstellungen f r LabCon 2013 pikkerton GmbH Seite 91 101 LabCon Benutzerhandbuch Version 1 15 PIKKERTON Bezeichnung Beschreibung PNP4Nagios performace data path Das ist der Pfad zu den Datenbanken von pnp4nagios Bei einer Debian Squeeze Standartinstallation liegt dieser unter usr local pnp4nagios var perfdata PNP4Nagios server path from www root Diese Konfiguration gibt an unter welchem Pfad das PNP4Nagios Uber den Webserver zu finden ist z B http localhost pnp4nagios external file Path to command nagios cmd Das external command file wird in der nagios cfg Uber die Variable command_file konfiguriert Timing Intervall Length Nagios Icinga arbeitet
67. rfdata Ab Nagios 3 x ist es durchaus sinnvoll auch die Verarbeitung der Performance Daten f r Hosts einzuschalten Nagios 3 f hrt durch die ge nderte Hostcheck Logik nun auch die Pr fung der Hosts regelm ig aus host_perfdata_command process host perfdata Die referenzierten Commands m ssen nun auch Nagios bekannt gegeben werden Dazu m ssen nderungen an den Definitionen in der Datei etc nagios3 commands cfg anpassen define command command name process service perfdata command line usr bin perl usr local pnp4nagios libexec process perfdata pl define command command name process host perfdata command line usr bin perl usr local pnp4nagios libexec process perfdata pl d HOSTPERFDATA Hinweis process perfdata pl kann nicht unter Kontrolle des ePN embedded Perl Nagios gestartet werden Daher wird das Script explizit mit usr bin perl aufgerufen Wird ePN nicht verwendet oder wird Nagios 3 x verwendet kann auf die Angabe von usr bin perl verzichtet werden Damit auch SNMP Traps von Nagios verarbeitet werden muss eine Kommando Datei angelegt sein die regelm ig vom Server berwacht wird Dies geschieht mit folgenden Einstellungen check external commands 1 command check interval 1 command file var lib nagios3 rw nagios cmd check result reaper frequency 1 2013 pikkerton GmbH Seite 90 101 LabCon Benutzerhandbuch e Be e Se Version 1 15 B a wf Mi P PIKKERTON 14 5 Integ
68. rsand Send_Mail py Sendet eine Email an einen Empf nger Das Skript muss nach der Installation auf dem Nagios Server angepasst werden Es m ssen Ce e Absender e SMTP Server sowie e das Passwort angegeben werden Parameter 1 Email Empf nger 2 Betreff Text der Email 9 2 4 4 3 Aktoren auf ZBS Ger ten ZBS_Buzzer py Steuert den Piezo Buzzer Dieser kann automatisiert mehrfach hintereinander ein bzw ausgeschaltet werden Weitere Informationen zum Buzzer stehen in dem jeweiligen Handbuch des Devices Parameter 1 ID des ZBS 2 Anzahl der Zyklen des Buzzers Ton Pause Ton 3 Dauer des Tones des Buzzers in 100ms 4 Dauer der Pause in 100 ms 5 Frequenz des Tones in Hz optimal 2 4 kHz beim ZBS 130 2013 pikkerton GmbH Seite 71 101 LabCon Benutzerhandbuch c0 e Version 1 15 mm PIKKERTON Beispiel ZBS 130 Buttonl 5 10 20 2000 Auf den ZBS mit der ID Button1 wird der Buzzer 5 mal hintereinander 1s ein und 2s ausgeschaltet Die Frequenz betr gt 2kHz ZBS_LED_Control py L sst eine LED des Ger tes blinken z B ZBS 110 Parameter 1 ID des ZBS 2 Nummer der LED 0 1 3 Anzahl der Zyklen der LED An Aus 4 Dauer der eingeschalteten LED in 100ms 5 Dauer der ausgeschalteten LED in 100ms ZBS_PWR_Control py Schaltet das Relais eines ZBS z B ZBS 110 Parameter 1 ID des ZBS 2 Zustand ON OFF ZBS_PWR_Cycle_OFF py Schaltet ein Relais f r e
69. rsendet sofern v3 ber die ZBG 100 Konfigurationsseite aktiviert wurde 2013 pikkerton GmbH Seite 46 101 LabCon Benutzerhandbuch c0 e Version 1 15 a ch wi A wi S PIKKERTON 8 2 CSV Recording Pushing Das CSV Recording bietet die M glichkeit alle ber ZigBee eingehenden Messwerte abzuspeichern Die Werte werden tabellarisch in einer csv Datei festgehalten und befinden sich im Verzeichnis usr local labcon zbs logs Diese Dateien werden nach dem Typ und der MAC Adresse des jeweiligen ZigBee Sensors benannt Zu jeder Log Datei gibt es noch eine Datei die n here Angaben zu den Sensordaten enth lt Diese endet mit der Bezeichnung header csv Die Headerdatei eines ZBS 121 zZBS 121 0013a200408aleba header csv sieht zum Beispiel folgenderma en aus YEAR MON DAY HOUR MIN SEC BRI 1x TEM C BAT UBAT V Die ersten vier Spalten in der csv Datei stehen somit f r den Zeitstempel der Daten Darauf folgt dann die Helligkeit in lx die Temperatur in C der batteriezustand OK oder LOW sowie die Batteriespannung in Volt Die Bezeichner der Sensordaten stimmen mit den in dem Interface Control Document des jeweiligen Sensors berein Ein Auszug aus der csv Datei zeigt den Aufbau der Daten 2012 11 11 14 5 27 6 21 8 0K 4 19 2012 11 11 14 5 37 4 21 7 0K 4 22 2012 11 11 14 5 47 6 21 7 0K 4 22 Hier sieht man dass die Daten alle 10s empfangen werden Der erste Datensatz tr gt den Zeitstem
70. tand ausgeschaltet SNMP v3 Verschl sselung Passwort rootroot Verfahren sha Zustand ausgeschaltet Tabelle 1 ZBG 100 Auslieferungszustand PIKKERTON Seite 23 101 LabCon Benutzerhandbuch G Be e Se Version 1 15 B ch a 3 EN S PIKKERTON 6 3 Hauptmen Das Hauptmen s Abb 11 der Webseite zeigt f nf Links im Seitenmen es Home Der Startbildschirm e ZigBee Configuration Hier k nnen alle Einstellungen f r das Funknetz sowie f r die einzelnen Sensoren vorgenommen werden e Communication Enth lt s mtliche Einstellungen f r die Kommunikation nach au en bspw IP Adresse SNMP E Mail CVS Push usw e System Unter diesem Punkt k nnen Systeminformationen abgerufen sowie Updates durchgef hrt werden Home Welcome to LabCon ZigBee Configuration Communication System About LABCON Abbildung 11 LabCon Hauptmenti 2013 pikkerton GmbH Seite 24 101 LabCon Benutzerhandbuch Version 1 15 6 4 ZigBee Configuration 6 4 1 Phys devices PIKKERTON Diese Seite dient der Anzeige und Konfiguration der ZigBee Ger te aus der ZBS Familie Nach einem Neu Start des ZBG 100 brauchen die ZBS Ger te Zeit um sich an dem ZigBee Gateway anzumelden Dies kann durchaus mehrere Minuten dauern Je nach Anzahl der Devices ben tigt das ZigBee Netz unterschiedlich lange um sich zu vernetzen Es kann schneller gehen wenn man auf dieser Seite einen Node Discover ND ausl st Dann wird ein
71. tor mit in dieser Liste e File List Hier befinden sich alle Dateien die f r ein Update zur Verf gung stehen 2013 pikkerton GmbH Seite 40 101 LabCon Benutzerhandbuch Version 1 15 6 6 6 Log Hier kann die LabCon Log Datei eingesehen werden 6 6 7 Reboot PIKKERTON Ein Klick auf System Reboot startet das gesamte System neu 2013 pikkerton GmbH Seite 41 101 LabCon Benutzerhandbuch c0 e Version 1 15 mm PIKKERTON 7 Sicherheit 7 1 1 Admin Login https Um auf die Webseite des ZBG 100 zu gelangen muss ein Benutzername und ein Passwort angegeben werden Im Auslieferungszustand sind diese jeweils admin Die Passwortdatei pw inc liegt in dem root Verzeichnis des Webservers var www Die Verbindung zur Webseite des ZBG 100 kann auch mit SSL verschl sselt ber den https Standardport 443 erfolgen 7 1 2 Kommunikation ber SNMP V3 Die Kommunikation zwischen LabCon und dem ZBG 100 kann ber verschl sselte und authentifizierte SNMPv3 Pakete erfolgen N here Informationen hierzu stehen im Kapitel 8 1 1 2 SNMPv3 7 1 3 Sicherheit im Funknetzwerk ZigBee durch AES Das ZigBee Funknetz kann mit AES 128 verschl sselt werden Nachdem in dem ZigBee Koordinator dem ZBG 100 die Verschl sselung aktiviert wurde k nnen sich nur noch ZigBee Router und Endger te mit eingeschalteter Verschl sselung und dem selben Netzschl ssel verbinden Die Verschl sselung kann
72. tzerhandbuch c0 e Version 1 15 a ch wi A wi S PIKKERTON 14 4 pnp4nagios Konfiguration Die LabCon Konfiguration wird in dem Verzeichnis usr local labcon conf abgelegt Dieses muss erstellt werden damit Nagios nach der Konfiguration keine Fehlermeldungen ausgibt mkdir p usr local labcon config Dieser Pfad muss in der etc nagios3 nagios cfg eingetragen werden Dazu muss folgende Zeile hinzugef gt werden cfg dir usr local labcon config Grunds tzlich ist auch in dieser Datei die Verarbeitung der Performance Daten zu aktivieren Bitte beachten Sie dass diese Direktive wahrscheinlich bereits in der Konfigurationsdatei enthalten ist Default ist O process performance data 1 F r jeden Host und jeden Service f r den keine Performance Daten verarbeitet werden sollen ist die Verarbeitung der Performance Daten explizit auszuschalten define service process perf data 0 Weiterhin ist es ab Nagios 3 x m glich in der nagios cfg das Exportieren der Environment Variablen zu deaktivieren Diese sind jedoch f r den Synchronous Mode zwingend erforderlich Daher muss enable environment _macros 1 ebenfalls in der nagios cfg gesetzt sein Zus tzlich wird das Kommando zum Verarbeiten der Performance Daten in der 2013 pikkerton GmbH Seite 89 101 LabCon Benutzerhandbuch c0 e Version 1 15 a ch el A wi S PIKKERTON nagios cfg angegeben service perfdata_command process service pe
73. uerung Regelkreis mit Hysterese au er der Hysterese Jetzt sollen ber 40 C die L fter laufen und darunter ausgeschaltet werden Die Konfiguration sieht dann folgenderma en aus Service ZBS121000000_TEM Script Parameter Active en stot EH mge Oe temperature limit Abbildung 34 Beispiel L ftersteuerung ohne Hysterese 2013 pikkerton GmbH Seite 74 101 LabCon Benutzerhandbuch Set Version 1 15 B wll 2 a Ss a PIKKERTON 9 2 5 3 Zugangskontrolle T r ffner ber den Tastendruck eines ZBS 130 ID zbs_mueller soll wenn der Benutzer zugangsberechtigt ist eine T r ge ffnet Der T r ffner ist an einen Klingeltrafo dieser an einem ZBS 111 ID tuer_buero angeschlossen F r die Zugangsberechtigung werden zwei Flags berpr ft Das erste beinhaltet die Berechtigung f r die Person das zweite ber die Zugangsbeschr nkung ber die Uhrzeit 9 2 6 Gruppierungen erstellen Neben den im Kapitel 9 2 4 Gruppen erstellen und konfigurieren vorgestellten festen Gruppen k nnen beliebig viele eigene Gruppen angelegt werden Dies erm glicht eine verbesserte funktionale bersicht Die Gruppennamen sind frei w hlbar so dass eine Gruppierung nach Funktion Verwendung oder Standort m glich ist 9 2 7 Installation in Nagios Wenn alle Services in den Gruppen konfiguriert sind m ssen die Skripte generiert und herunter geladen werden Uber den Button Next gelangt man zu der Generierungs
74. utern die M glichkeit dem Funknetzwerk beizutreten Per Default ist der Funkverkehr unverschl sselt und der Koordinator das Gateway ohne weitere Aufnahmerestriktionen konfiguriert Das Funknetzwerk vermascht sich selbstst ndig und meldet alle Endger te automatisch an Der Funkverkehr wird mithilfe der beiden LEDs angezeigt a2 Hierbei zeigt die rote LED an wenn Nachrichten empfangen werden Die blaue LED zeigt an wenn Nachrichten vom Gateway ausgehend gesendet werden 2013 pikkerton GmbH Seite 18 101 LabCon Benutzerhandbuch c0 e Version 1 15 mm PIKKERTON 5 2 3 2 Endger te Je nach Endger t Router werden die jeweiligen Betriebszust nde ber ger tespezifische LEDs angezeigt e 2 voneinander unabh ngige LEDs gr n orange e 1 Bicolor LED bzw 2 LEDs in einem Fenster St sseltaster gr n orange e 1 RGB LED rot gr n d Im folgenden ist sowohl die orange als auch die rote LED gemeinsam als rot bezeichnet Nach einem Startvorgang eines Routers oder Endger tes wird ein automatischer Netzwerk Scan initiiert bei dem nach einem passenden offenen Koordinator gesucht wird Erfolg Misserfolg wird durch das LED Blinken angezeigt e 3x gr n Das Ger t hat sich beim Koordinator Gateway erfolgreich angemeldet e 3x rot orange Das Ger t hat keinen Koordinator kein Gateway gefunden bzw sich nicht dort anmelden k nnen m gliche Ursachen hierf r angeschaltete Verschl
75. wichtigen SNMP Einstellungen vorgenommen werden Aus Sicherheitsgr nden m ssen die drei Communities verschieden voneinander sein Zur Zeit wird nur ein Trap Ziel unterst tzt welches hier ebenfalls eingetragen werden kann SNMP Settings SNMP Version 2c zi SNMP Trap Version 2c v Read Community Write Community Trap Community SNMP Trap Address ooo SNMP V3 Encryption Key AdminPrivKey1 SNMP V3 Authentication AdminAuthKey1 General Traps Enable Coldstart Trap Enable OO Download MIBs via ssh or WinSCP from usr local labcon agent_module mib Abbildung 18 Communication SNMP 2013 pikkerton GmbH Seite 35 101 LabCon Benutzerhandbuch ep e e Version 1 15 mm PIKKERTON 6 5 3 CSV CSV Control Settings x Enable CSV Recording for all joined devices The log files can be retrieved through SSH or SCP from the directory usr local labcon zbs_logs x Enable CSV Push If enabled CSV Recording is kept enabled also IP 192 168 8 100 IPv4 conform address x x x x x 0 255 Port 11000 Tcp port number 1024 up to 65535 Rate 1 Least interval for CSV push messages 1 up to 86400 seconds Abbildung 19 Communication CSV Control Settings Der ZBG 100 bietet die M glichkeit s mtliche ber Funk eingehende Messwerte in csv Dateien zu speichern und auch wieder ber eine TCP Verbindung im Klartext zu senden F r jedes Device wird eine eigene Datei genutzt Der Datei
76. z ZBG 100 Temperatur ZBS 121 Luftfeuchtigkeit Bewegung Verschiedene Devices bieten auch eine Alarmierung welche umgehend Uber einen SNMP Trap an den Nagios Icinga Host weitergeleitet werden z B die Ubermittlung von erkannten Bewegungen verletzte Schwellwerte von Sensormesswerten oder aber Tastendr cke auf den Ger ten 2013 pikkerton GmbH Seite 55 101 LabCon Benutzerhandbuch c0 e Version 1 15 mm PIKKERTON 9 1 2 Plugins Die Integration erfolgt in Nagios Icinga ber Plugins Diese werden nach der Konfiguration vgl Kap 9 2 und 6 5 4 zum Download auf dem ZBG 100 bereit gestellt 9 1 3 bersicht ber die Service Gruppen LabCon bietet f r die ZBS Serie verschiedene Gruppen abh ngig von den Eigenschaften der Services Aktoren Folgende Gruppen sind vorgegeben e Ambient Atmosphere Klima e Energy Metering Energieerfassung e Mains Analysis 230V Netzspannungsanalyse e Access Control Zugangskontrolle e Battery Es besteht auch die M glichkeit LabCon um eigene Gruppen zu erweitern Die folgende Tabelle zeigt die ZBS Familie und ihre Zugeh rigkeit zu den Gruppen in Abh ngigkeit ihrer Sensoren Aktoren Legende Optional O d geh rt zu Gruppe X geh rt nicht zur Gruppe 2013 pikkerton GmbH Seite 56 101 LabCon Benutzerhandbuch S ef Version 1 15 mm Ses hb C wi a PIKKERTON 2 P gt Im z gt Ki Bild Bezeichnung Beschreibung s 3 3 a 9 Z al
Download Pdf Manuals
Related Search
Related Contents
Mellanox WinOF VPI Release Notes 1:18 and 1:10 Scale Car ESC`s User Manual V03 R2.cdr - Planet-RC Experiences of dx-pedition to Andaman & Nicobar Islands 8 - Horsch Maschinen GmbH Samsung 198N User Manual Model UA870 UHF Active Directional Antenna User Guide Manuale Utente Integral IN3T8GRZGIX2LV memory module Copyright © All rights reserved.
Failed to retrieve file