Home

User Manual LabCon

Contents

1. control BIDEK carac CSV Control settings O 2013 pikkerton GmbH Page 73 95 LabCon Handbook 8 e ae Version 1 14 a Ss a 2 wi PIKKERTON I IGINA EE REE TO 94 Hee tdt 28 40 information block 40 Inisert bMenu IMI Lossius 94 Ing 10 Ee Eur EE 88 95 eu e E 23 IRMS pr EcT 56 L labCon icinga ClassicMenu phip uuiiina inr rrr nitate nnn nk nta i 94 labcon menu PPD Mot Tc 88 95 EDAD ti 56 Lost Message OUR aid 25 M MA ve 27 40 Hele iio 94 EE 34 94 Mrs 94 MSI Measurement Inten 18 N wie e 95 GE Ire WEE 82 Node Disco tenen eten bekeren hanen smeken dln te 28 Node Discover MD tenere eeen enten aen 27 Non EE 47 P Password Settings san 24 EEE X 27 EE 56 PRES E 56 R A xU IE LL LL UM NL LM 28 Remove Offline DCVIC CS m eds 29 S A 0 e 31 76 86 2013 pikkerton GmbH Page 74 95 LabCon Handbook 8 e ae Version 1 14 a 2 2 2 a PIKKERTON rj M 95 Send COMMAND e agder dn 29 siae Ni E 59 sli cose mcm 49 59 JEF 88 95 SNMP ue E 24 sila nd 34 SOPP ON vs 91 T LE 56 TAPE P TH aaan need 91 Re 37 TXT Transmit Internal 18 U UB EE 56 Vv VI 56 WwW Eeer 56 Z ZBS o steenen ben eeen eee deed 56 F Ee EE 60 EBS EED Gonda aes ae 61 ZBS LED Eerad 61 ZBS PWR Cont E 61 ZBS
2. Figure 30 LabCon Menu Under sensor device control config you can see the configuration of the devices as explained in ch 7 2 3 Creating Nagios Configurations for Devices This is a basic requirement for the configuration of groups Pressing the link group event config displays the following web page 2013 pikkerton GmbH Page 52 95 LabCon Handbook Ten Version 1 14 A y Das a PIKKERTON v 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 ES Ambient Atmosphere ES Energy Metering E Mains Analysis ES Access Control ES Battery Figure 31 Service Groups The 6 predefined groups Ambient Atmosphere Contains all the sensors that monitor the environment such as air pressure temperature or humidity Energy Metering Contains all the power energy and performance measurements Mains Analysis Voltage and frequency can be monitored Access Control All sensors which are suitable for access control can be set These are amongst other things the brightness measurement the keystoke of the ZBS 130 or the motion sensor from ZBS 121 Battery Monitors the voltage of the battery operated wireless devices such as the CSE 121 or the CSE 130 Device Connectivity Monit
3. Temperature Dee Script Limit E O Crossing the upper threshold Upper Sa B O Re entering the normal range 2 La L Re entering the normal range AN 3 O Falling below the lower threshold Lower SW as In the first column of the table Figure 33 No 2 the upper and lower limits can be set for the corridor In the next column Figure 33 No 3 the scripts for actions above and below the limits are set Any number of scripts can be set for boundary violations and direction The scripts need transfer parameters which you can enter in the third column Using the last column each script can be activated Although an inactive script remains in the overview it is not included in the configuration of Nagios The limits and intervals are transmitted to the respective devices and the set scripts for configuring Nagios on the ZBG 100 gateway are stored with Submit 7 2 4 4 Templates for Actuators The actuators are needed for certain actions following a limit violation or an alert Ce The individual parameters are separated by a comma The order is important 2013 pikkerton GmbH Page 58 95 LabCon Handbook 28 s Version 1 14 Di PIKKERTON 7 2 4 4 1 Flags Set Flag py Actions can be enabled or disabled by means of flags This can for example be used when arming an alarm system This script checks the flag with a string of characters Parameter 1 Flags name 2 Single string
4. command file var lib nagios3 rw nagios cmd check result reaper frequency 1 2013 pikkerton GmbH Page 83 95 LabCon Handbook ao ee Version 1 14 a Ss PIKKERTON 12 5 Integration of Gateways in Nagios Icinga 12 5 1Preparatory Measures First set ZBG 100 to the Nagios server since various Linux distributions may also have different directory structures This can be done on the gateway website Settings Nagios Nagios Settings PNPANagios performace data path Jusr local pnp4nagios var pe e g usr local pnp4nagios var perfdata PNPANagios 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 Figure 46 Nagios Settings in LabCon 2013 pikkerton GmbH Page 84 95 LabCon Handbook e Se di W I Version 1 14 E e a PIKKERTON Name Description PNP4Nagios This path leads to the various pnp4nagios databases In a performace data path standard Debian Squeeze installation this is located under usr local pnp4nagios var perfdata PNP4Nagios server This configuration specifies the path where the PNP4Nagios is path from www root located via the web server ei http localhost pnp4nagios Path to external The external command file is configured in nagios cfg via command file the variable command_file nagios cmd Timing Intervall Nagi
5. wi PIKKERTON ID The ID is the same as the serial number during delivery You can choose any ID which is then used to simplify each device s identification and description ie ID ID Dataroom4 or Rack5a It can be up to 12 characters long but for compatibility reasons no symbols or spaces are allowed As soon as Nagios lcinga is activated no ID may be used more than once Active Here you can see if the device is currently in the network Checkbox Only devices with an activated checkbox can generate configuration files for Nagios under Generate It is also possible to enter clear text commands under Command and then send them to the selected device using Send Command These commands go automatically to all devices where the checkbox has been activated Since the device s response time can take up to 30s when running on battery the latest device response can be retrieved manually at any time under Collect Answers Please see the relevant manuals for details Ch 10 Additional Information Enable Joining To allow new ZBS devices to log in all routers and the coordinator must be open Node Discover When a Node Discover is run all devices currently logged into the network report to the system Refresh Updates the device list 2013 pikkerton GmbH Page 28 95 m SCH e Se di DE na ersion 1 B Ch wi PIKKERTON Remove Offline Devices Deletes all devices from
6. 95 LabCon Handbook ao Ser E Version 1 14 bi gef a x wi PIKKERTON 7 1 2 Plugins Integration takes place in Nagios Icinga via plugins These are available for download after configuring ZBG 100 ch 7 2 and 6 3 2 7 1 3 Summary of the Service Groups LabCon provides various groups depending on the characteristics of the services actuators of the ZBS series The following groups have been established e Ambient Atmosphere climate Energy Metering energy acquisition Mains Analysis 230V Voltage analysis e Access Control e Battery However you can also create your own groups in LabCon The following table shows the CSE family in relation to their groups and depending on their sensors actuators Legend e 0 Optional d belongs to group e X does not belong to group 2013 pikkerton GmbH Page 45 95 LabCon Handbook ser Version 1 14 wt gef a a a a PIKKERTON Picture Name Description Ajo31eg 3u119339 81 349U3 sis jeuy SuIEIN 041005 SS322y eJeudsouny JU3IQUIY Measures the current voltage frequency performance and tasks oy Ability to switch loads o V De o x fm S ch SS Optional PIR motion eter detector A Optional temperature i measurements ZBS 111 Measures the current Smart Energy voltage frequency X Y Y X X Meter DIN Rail performance and tasks ZB5 112 Measures the current Smart Cable voltage frequency X
7. Content 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 2013 pikkerton GmbH Page 94 95 LabCon Handbook Version 1 14 12 5 2 7 3 The subfolder nagios content e labcon menu php PIKKERTON PHP script for menu integration of LabCon in Nagios insert to side php txt Includes an additional side php to integrate LabCon in Nagios 12 5 2 7 4 The subfolder scripts This folder contains the scripts that are needed to control the devices of the ZBS family via Nagios LabCon 2013 pikkerton GmbH Page 95 95
8. Version 1 14 0 gef m a a a PIKKERTON Nagios 3 x enables you to deactivate the export of environment variables in nagios cfg However these are absolutely necessary for the synchronous mode Therefore you must also set enable environment macros 1 in nagios cfg In addition you will be prompted to process performance data in nagios cfg Service perfdata command process service perfdata In Nagios 3 x it is quite useful to enable the processing of performance data for hosts Nagios 3 now checks the hosts regularly due to the modified hostcheck logic host perfdata command process host perfdata The referenced commands should now also publish Nagios These changes to the definitions in the file etc nagios3 commands cfg should now be adjusted 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 Note ePN embedded Perl Nagios can not start process perfdata pl Therefore the script is explicitly accessed via usr bin perl If ePN is not used or if Nagios 3 x is used you do not need to indicate usr bin perl In order to process SNMP Traps by Nagios a command file must be created Please enter the following settings check external commands 1 command check interval 1
9. 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 The sequence of symbolic links must be activated in the Icinga configuration file of the Apache2 server This is done by entering Options FollowSymLinks into lt Directory usr local icinga share the block of the file etc apache2 conf d icinga conf Here an excerpt from the customized file Directory usr local icinga share 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 de 2013 pikkerton GmbH Page 89 95 m SCH e Se di T ersion 1 n Be wi PIKKERTON Require valid user lt Directory gt The script icingaWebLabConSetup py in the directory usr local labcon icingaUtils generates the LabCon category and Cronks for the individual ZBG 100s If Icinga Web and LabCon have been installed according to the instructions given then the script icingaWebLabConSetup py can be executed without Arguments If not the source directory usually usr local labcon config
10. 2013 pikkerton GmbH Page 32 95 LabCon Handbook Version 1 14 2 Configure a Device to a secure network Add to Secure Network PIKKERTON 3 Reconfigure a coordinator into an encrypted network click on Encrypted Network 4 Wait for the device to log in The settings are now automatically saved on the device 5 To add further devices you must configure the Coordinator for the encrypted network Open Network Steps 2 4 must be repeated 2013 pikkerton GmbH Page 33 95 LabCon Handbook eg e a Version 1 14 Dan m a a a PIKKERTON 6 5 SNMP The LabCon scripts on the Nagios server and the ZBG 100 communicate via SNMP According to its terminology Nagios LabCon have the following meanings 1 First ZBG 100 collects sensor data and makes it available now becoming the SNMP Agent Moreover agents can send warning messages so called Traps to instantly inform the previously configured SNMP Manager 2 The LabCon scripts on the Nagios server Nagios itself and the pnp4nagos plugin represent the SNMP Manager This collects the information from the agent at regular intervals and processes them In addition the manager listens for incoming Traps Other LabCon managers can also be used to control ZBG These are introduced in ch 6 5 2 SNMP Manager The organization of the variables in SNMP is displayed as a tree structure Each node has its own number To retrieve a variable the path
11. 22 Figure 23 Figure 24 Figure 25 Figure 26 Figure 27 Figure 28 Figure 29 Figure 30 Figure 31 Figure 32 Figure 33 Figure 34 Figure 35 Figure 36 Figure 37 Figure 38 Figure 39 LabCon amp Intreface OvervieWw rrrnnnnnnnnnnnnnnnnnnnrnnnrnnnnnnnrnnnrnnnrnnnrnrnnnnnrnsnrnnnrrne 8 ZigBee OvervleW siia EEN eege ANN ee en 9 KE RE 11 ZBS 112 ME 12 vA 13 BSI 13 F AG ae e EEE EE EN adipe ls 14 PT A E E 15 EA KEE 15 MSI and TXT Interval Overview nne vens enrvvenneersvennneersevnnnenveevenens 18 Settings OVERVIEW Lunnan ege EA Eed 22 Settings Gateway IP Settings nnne 23 Settings Gateway Password Settings nuu snuersnensnnersnerrnsersneen 24 Settings Gateway SNMP Settings unnunnrenversvnnnnernenesennensren 25 Settings Gateway Lost Message Counter nnn annnerennnenenereennneen 25 Settings Gateway Reboot amp Save 26 Settings Phys devices Overview u nnnurnnaernnerennernnerrnvernneernversen 27 Settings Phys devices Commande 29 Settings Phys devices CSV Control Settings 30 Settings Phys devices Nagios Configuration nana anneer 31 iReasoning MIB Browser 36 MIB Browser Load MIBs Dialog rore eie rene eoru ornari ente vedde 37 Re UE 40 Information Block ZBS ME 41 Configuration Block be D 41 Control Block 2895 12 T 42 Webmin LOBI ice tette dann a demas e Rd daat te nrden iede 42 ZBG Device gt Nagios Timing 48 Settings Do
12. 43 7 1 Interface for Nagios lclnga nono nnnnnn enne nnne nn 44 7 1 1 Communication Model sess i ee an Seele voce La da E 44 puaunduaceem Pc H 45 7 1 3 Summary of the Service Groups 45 7 1 4 Timing End Devices gt Gateway gt Nagios Event basedl 48 palomas CAEN m 49 T2 TEE 49 7 2 2 Special Features of Work Limit and Load Umit eenen 50 7 2 3 Creating Nagios Configurations for DeviC8S ooooccccooocoocnnnnnnnnnncnnnononnnononannnnnnnnnnnnanoos 51 7 2 4 Creating and Configuring Groups 52 7 2 4 1 Adding O 54 7 2 4 2 Assigning Services to Groups 57 7 2 4 3 Configuration of the group members 57 7 2 4 4 Templates for Actuators seen en nnnnennhnsnnnnnn set nnn nass sensn nnn a an 58 EE WR ETC 7 2 4 4 2 Sending Emails 7 2 4 4 3 ZBS Device Actuators 1 255 unt EE 7 2 5 1 Air flow Management Hysterese Loop Circuit nennen eenseneenneenennverennnnnnn 62 7 2 5 2 Loop Control without Hvsteresls eene 63 7 2 5 3 Access Control Door Opener 63 7 2 6 Group RE TC 63 7 2 7 Installations in Nagios ekisenedriisos andene aanas ia sen anie tan Sii tae rirka 64 7 3 Virtual Devices a Ea EE aiea Arii 64 K Well 68 8 Indexof 00 EE eege 71 SHIRE 73 10 Additional Information 76 11 Appendix Software and License Update ENEE 77 12 Apendix Nagios Installation con adas 78 12 1 ReQulret SoftWare E 78 12 2 Initial Test certe te PE ER Eo eng EE p re le teen bete i Po Einen
13. Elements Figure 1 LabCon Intreface Overview ZBG 100 Gateway is the link to the outside world for devices such as sensors and actuators It collects all the data from the connected ZigBee devices and makes them available via SNMP This means that for the integration only one host in Nagios must be configured The resulting services on the host then display the individual functions sensors devices LabCon has multi host capability This means that the central installation of Nagios further systems and sites can be run O 2013 pikkerton GmbH Page 8 95 m SCH e Se di T ersion 1 n Be wi PIKKERTON 5 1 ZigBee Wireless Standard Zigbee is based on IEEE802 15 4 standards and acts as WLAN and Bluetooth in the so called ISM band 2 4 GHz The use is royalty free and available worldwide A theoretical maximum bandwidth of 250 kbit s is sufficient for sensing and managing applications With an optional 128 bit AES encryption and further security features it is sufficiently secured against various attacks The strengths of ZigBee lie heavily in the meshing and routing Thus the network set up is transparent and independent without affecting the user Additional infrastructure such as repeaters or separate routers are not necessary In the event of router failure the network will repair itself spacial expansion and wireless reception permitting New routes will be established automatically This mechanism m
14. LabCon Handbook e Ze e ate Version 1 14 bi u E wi PIKKERTON ZBS LED Control py Enables an LED to be flashed on the device ie ZBS 110 Parameter 1 ZBSID 2 LED number 0 1 3 Number of cycles of the LED On Off 4 Duration of activated LEDs in 100ms 5 Duration of inactivated LED in 100ms ZBS PWR Control py Switches ZBS 110 s relay Parameter 1 ZBSID 2 Status ON OFF ZBS PWR Cycle OFF py Switches the relay for a certain duration of time and then off ZBS 110 Parameter 1 ZBSID 2 Measures waiting period in seconds ZBS PWR Cycle ON py Turns off the relay for a certain duration of time and then on again ie ZBS 110 Parameter 1 ZBSID 2 Measures waiting period in seconds 2013 pikkerton GmbH Page 61 95 LabCon Handbook e Se di WI Version 1 14 A ele e PIKKERTON 7 2 5 Example 7 2 5 1 Air flow Management Hysterese Loop Circuit An example of regulation with hysteresis is a temperature dependent fan control The fan is connected to a ZBS 110 and the temperature is determined using a ZBS 121 multi sensor ZBS 110 s ID to which the fan is connected is zbs110 fan 40 C On e 30 C Off The temperature values are transmitted every 60 minutes TXT 3600s but every 10 minutes MSI 600s a threshold violation measurement is taken in order to save the battery power The sensor is found in the ambient atmosphere It is configured as follows Environmenta
15. Target Group This document is intended for system administrators integrating LabCon in Nagios 4 2 Criteria the ZBG 100 gateway must be accessible section 6 2 e Linux and the Bash shell experience 4 3 Definition of Symbols The attention symbol refers to actions which can cause damage to material or equipment The notice indicates necessary conditions for error free Ce operation It picks out important details makes the job easier and gives tips and advice on the optimal use of hardware and software 2013 pikkerton GmbH Page 7 95 LabCon Handbook e Se di W I Version 1 14 B Da a PIKKERTON 5 LabCon Overview LabCon is a wireless system for the convenient and efficient real time monitoring and control system of various parameters It is based primarily on the communication via SNMP so it is very easy to integrate with other existing monitoring systems such as HP OpenView Tivoli etc Peripheral Lp omen LZ E Emi d Es m m Tm EZ EZ ES Energy Meter Net Quality Analyzer 16A 32A LAN SNMP gt Server Systems N a gios UM e SEA Cp TEL IEEE 802 15 4 BEN Si l ZigBee ENGE Radio Data j j Multi Sensor Devices Transmission Personalized Door c f a Window Handhelds Contacts mm Pushbuttons D 2 Jj E Na Network Infrastructure
16. Y Y X X Meter performance and tasks o Temperature Y movement PIR passive ZBS 12x Infrared Multi sensor humidity d Pe le d d air pressure and brightness 2013 pikkerton GmbH Page 46 95 LabCon Handbook sen A a Version 1 14 B elt Ss B PIKKERTON Picture Name Description 328g B5 S 513 23 8 8 az E ai zE 3 t o 00 3 bd e P Pressing of button sends ZBS 130 messages X X X Handheld Blinking as possible d d feedback e Monitors 285 132 magnetic contacts Contact X X d d ae volume and glass monitoring breakage Integration connection ZBS 140 external of feedback O O O O Client specific sensors All unknown or recently registered ZigBee devices Non ZBS as e X X X which have not yet been identified Table 2 LabCon ZigBee Devices 2013 pikkerton GmbH Page 47 95 LabCon Handbook H Ze A Version 1 14 E ch a E a PIKKERTON 7 1 4 Timing End Devices Gateway Nagios Event based The following example refers to a ZBS 121 multi sensor which has a set temperature threshold of 24 C Ne o dd al TPC g J RS x e S a Ee EE ER NE EE n EE EE eR M DI SEE e S y S Se KE LG R E A ene Mn EE tt 18 ee d ete Service ok Service critical Service ok Figure 28 ZBG Device Nagios Timing Figure 28 shows a complete cycle assuming the state that a service lt Temper
17. a s Version 1 14 E Ss e a PIKKERTON There are three points under Settings 1 Gateway Here you can control the settings that affect the ZigBee gateway ei the IP address or host name 2 Nagios Nagios installations can vary depending on the Linux distributor In order for LabCon to work properly some archive locations must be known These paths can be chosen freely but must be considered when installing and configuring Nagios Ch 12 Apendix Nagios Installation 3 Phys Devices Here you can search other ZBS family units read their values as well as configure their thresholds and intervals 6 3 1 Settings Gateway You can manage all settings affecting the ZBG device IP Settings configures network settings IP Settings MAC Address FO AD 4E 00 86 D1 Interface ethO DHCP enable O IP Address Subnet Mask Gateway Address DNS Address Domain Dikkerton intern de Hostname NTP Server 192 168 8 1 Figure 12 Settings Gateway IP Settings The device can be uniquely identified once you have adjusted the hostname You must choose an IP address that allows the Nagios server to reach the ZBG 100 O 2013 pikkerton GmbH Page 23 95 LabCon Handbook Ten ze Version 1 14 tene u ar PIKKERTON gateway A device restart is not necessary as the settings are applied immediately by pressing the Apply button Your web password can be changed under Password Settings
18. default 28 seconds Then inquire through the router to which you are registered whether you have received any messages b there are a local events are active eg Pressing a key c a previously defined measurement interval MSI requests sensors and at least one threshold violation exists d a transmission interval of a previously defined transmission interval TXT forces the device to retrieve all local sensors and send the sensor data to the coordinator ZBS 121 130 132 140 are the devices used in LabCon System Battery operated devices are constantly monitored on your battery voltage If the 2013 pikkerton GmbH Page 10 95 LabCon Handbook H Ze ze te Version 1 14 bi Da e E wi PIKKERTON battery is empty it is shown early enough to change the battery before the unit is no longer available 5 2 Device Overview 5 2 1 ZigBee Gateway ZBG 100 The freely programmable ZigBee gateway ZBG 100 includes one GHz class ARM based CPU core with powerful peripherals such as Gigabit Ethernet an SD card slot and a USB port The USB port can be used for example as a memory for data logs or applications can use and a 2 4 GHz ZigBee coordinator module A 230V power supply is built in so that the ZBG 100 unit must only be plugged into a power supply and can be started immediately A web front end is available for a quick and easy start Through this web front all ZigBee devices can be managed easily and rel
19. homepage is open select Settings from the left margin to manage the settings Optionally this can also be changed via SNMP You are on host labcon gw 192 1 104 Home Settings Gateway Nagios Phys devices Update About J LABCON Welcome Following configurations settings and preparations can be made here please also follow this sequence 1 Gateway Settings Enter the gateway s network configuration here 2 Nagios Settings Enter the IP address and some paths to the Nagios server to allow easy integration of the generated configuration file into it 3 Node Settings amp Generate Nagios Config File Configure the basic behaviour of the connected sensors amp actuators Please allow the wireless network setting up automatically for a couple of minutes the routes have to get established and optimized for reliable communication This time depends on the number of used nodes as well as the possible topologies and distances to get bridged Please wait till every node has been discovered All your node configurations are transmitted from here directly right into the devices and stored there After this step you can generate the 1st Nagios Config File which should get transmitted to the Nagios server to allow communication between the Nagios server and this gateway new host for Nagios Have fun pikkerton GmbH 2012 Figure 11 Settings Overview 2013 pikkerton GmbH Page 22 95 LabCon Handbook ep
20. is specified from the root For example you can find the ZBG product name under the node 143601 44 1 23596 10 1 0 To make things easier there is the Management Information Base MIB which converts this numeric string into a name for the manager and vice versa Scalars always end on zero while tables always have an index ZBS family sensors are tabulated The index serves as your MAC address 1 A Skalar is a mathmatic size which is characterized solely by the indicated number value Consequently in Physics by Unit 2013 pikkerton GmbH Page 34 95 LabCon Handbook eg e a Version 1 14 bi Ba 2 E We B PIKKERTON 6 5 1 Authorization Management The ZBG 100 supports the protocols SNMPv1 SNMPv2c and SNMPv3 Unlike version 3 versions 1 and 2c are unencrypted 6 5 1 1 SNMPv1 and v2c This version is supported by most SNMP managers The user authentication is done via the so called community These are standard for reading public and for writing private These can be changed by preference ch 6 3 1 6 5 1 2 SNMPv3 SNMPv3 provides two security features 1 Password protected user authentication 2 Encryption of raw data in the data packet You can assign individual passwords for authentication and encryption These an be switched on independently of one another of SNMPv3 is to be used SNMP versions and 2c are switched off Cg If it is specified in the configuration that at least one secu
21. to the fixed groups described in ch 7 2 4 Creating and Configuring Groups many other custom groups can be created This allows for an improved functional overview The group name can be chosen freely so that a grouping by function location or use is possible O 2013 pikkerton GmbH Page 63 95 LabCon Handbook e Se di W I Version 1 14 E e a PIKKERTON 7 2 7 Installations in Nagios After all the services have been configured in the groups the scripts must be generated and downloaded The next button takes you to the Generation amp Download page meee wi 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 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 Figure 36 Generate amp Download Configurations The downloadable archive includes scripts and services offered for Nagios These must be then copied to the LABCON directory on the Nagios server 7 3 Virtual Devices ZBG 100 enables the creation of virtual sensors These sensors are the mathematical constructs of any number of physical and virtual sensors ie services The available mathematical functions are e Sum Sum Mean Mean Difference Dif
22. 0 ch 6 ZBG 100 Gateways Stand alone Operation a finding the devices b configuring the devices m Installing Nagios and Its components ch 12 Apendix Nagios Installation w Integrating in Nagios a downloading the configuration directly from the ZBG 100 b loading the scripts and customizing Nagios 4 Creating control loops a selecting the devices to be configured b creating groups c settings for sending emails d operating devices 5 Downloading the created configuration of control loops and providing scripts for Nagios 6 Nagios restart 2013 pikkerton GmbH Page 43 95 LabCon Handbook a8 e Version 1 14 B PIKKERTON 7 1 Interface for Nagios Icinga 7 1 1 Communication Model The following table shows the relationships between LabCon and Nagios in regard to the terms on the basis of two examples Nagios Icinga Host Device Service Sensor Admin Calculator communication via SNMP 4 communication via ZigBee 4 p Temperature Power ZBS 110 voltage frequency ZBG 100 Temperature ZBS 121 humidity movement Some devices also provide an alarm which immediately forwards the message via an SNMP trap to the Nagios Icinga host ie The transmission of recognized motions sensor readings showing exceeded thresholds or of keystrokes on the devices 2013 pikkerton GmbH Page 44
23. 1 30 MIB txt E PIKKERTON ZBS 1 32 MIB txt E PIKKERTON ZBS 1 40 MIB txt E 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 Figure 22 MIB Browser Load MIBs Dialog Register the IP address of the BG 100 under Address The Communities Ch 6 5 1 1 can then be changed in the dialog box Tools gt Options gt Agents 6 5 3 Traps When status changes have occurred in which a manager must be notified immediately ZBG 100 automatically will send Traps This could be due to exceeded alarm thresholds or even a device of ZBS family which has just re registered on ZBG Traps are also SNMPv3 encrypted and authenticated when sent however only if v3 has been previously enabled on the ZBG 100 configuration page O 2013 pikkerton GmbH Page 37 95 LabCon Handbook e Ze e ate Version 1 14 bi u E wi PIKKERTON 6 6 CSV Recording Pushing CSV Recording provides the ability to store all incoming readings via ZigBee The values are tabulated in a csv file which is located in the directory usr local labcon zbs logs These files are named according to the type and the MAC address of each ZigBee sensor For each log file there is a another containing the sensor data details This ends with the designation header csv The header file of a ZBS 121 zBs 121 0013a200408aleba header csv can look like this YEA
24. 110 2013 pikkerton GmbH Page 41 95 LabCon Handbook e og Version 1 14 B Dan ar PIKKERTON The third block is the control block and it includes all control options for the respective device For example ZBS 110 switch can be controlled here 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 Figure 26 Control Block ZBS 121 6 8 Webmin All configuration settings outside of the LabCon system can also be made via the web front end Webmin You can find this under https lt zbg_ip gt 10000 Login to Webmin You must enter a username and password to login to the Webmin server on 192 168 8 130 Username root Password ee ee eee O Remember login permanently Login Clear Figure 27 Webmin Login You can use the same username and password as for the login via SSH When delivered these are Username root Password rootroot O 2013 pikkerton GmbH Page 42 95 LabCon Handbook eg e a Version 1 14 bi Ba a E Ss B PIKKERTON 7 Operating under Nagios Icinga For optimum LabCon functionality in Nagios you must follow the instructions described in ch 12 This chapter deals exclusively with operating LabCon Points 1 3 are not considered here 1 Configuring the ZBG 10
25. 30 ZB5130HW0201 Activator Yes gt x Enable Joining 60s Remove Offline Devices Lost Message Counter update interval off Lost Message Counter reset 15 38 05 UTC Wed 14 11 2012 Figure 23 Device Overview Clicking on the MAC address of the desired device takes you to the page that lists the current values and where you can change settings and control the device The page uses ZBS 121 as an example The top information block includes the current sensor values as well as other information including the serial number hardware and firmware version etc In this block the ID can also be changed The ID appears on the summary page and in the group configuration The device is thus identified and is limited to 12 characters 2013 pikkerton GmbH Page 40 95 LabCon Handbook Version 1 14 ZBS Configuration H PIKKERTON MAC 0013a200407e7c42 PID ZBS 121 SN ZBS121006182 HW 0103 SW 03090316 ID MotionDetect Actual Values Brightness 124 lx Brightness Delta Olx Temperature 25 2 C Temperature Delta OK RelHumidity N A RelHumidity Delta N A AirPressure N A AirPressure Delta N A BatteryVoltage 3 85 V BatteryState OK Figure 24 Information Block ZBS 121 The configuration block immediately follows the information block and all limits and intervals can be configured here The grayed out fields are not fixed options of this device such as the ZBS 121 without air pressure In order for the change
26. 76843b e ID SR FAN R e Service IRMS current measurement e Wert 121 mA 2013 pikkerton GmbH Page 39 95 LabCon Handbook e og Version 1 14 B Dan ar PIKKERTON 6 7 Direct Control of Devices It is possible to directly read and control the ZigBee devices without the support of Nagios This can be done easily via the ZBG 100 configuration page You can find this either in the menu item Sensor Device in the LabCon Nagios menu or directly via the IP address and name of the ZBG 100 under Settings Phys Devices Home Physical Device Overview Settings tr MAC PID ID SN Configured Active LMC Select ZigBee Net P V AV AV AV AV AN N x Nagios Phys devices Bp 001322004076842d z8s 110 Test 110NQ ZBS110NQuali ves A 0 x Virt devices Ee B 0013220040767eb5 785 110 Lamp 110V2T106215 Yes A o0 x Update ve About BB 0013220040669b1a ZBS 110 Not Switch Kuehlschrank Yes gt 1 x B 0013220040767cf5 285 110 Lampe 110V2T106219 Yes Io x B 001322004066fd89 z85 110 Tests 285110000000 Yes A 0 x BB 00 20040669651 zes 110 Noswitching 285110000000 ves gt 0 x Bf 001322004076843b zes 110 110V2T106213 Lampi Yes gt x H 001320040767d81 zes 110 110v27106212 Lamp2 Yes gt x 9 0013220040767de9 ZBS 111 zbs111TESTER ZBS111Tester Yes Io x 0013a200407e7c42 ZBS 121 MotionDetect 285121006182 Yes A o0 D 0013a200407966a3 ZBS 121 Test 121RH 2BS121000000 Yes A7 x 0013a2004061b5e3 ZBS 1
27. Configuration of the group members The apply button takes you back to group menu 2013 pikkerton GmbH Page 55 95 LabCon Handbook eg e Version 1 14 a Dan uda B wi PIKKERTON Among others the following services are available Name Description BRI Brightness Specifies the brightness in Lux DBRI Delta BRI difference in brightness between the last and the current measurement TEM x Temperature in C Some devices have multiple temperature sensors DTEM Delta TEM temperature difference between the last and the current measurement HUM Relative humidity in percent DHUM Delta HUM humidity percentage point difference between the last and the current measurement PRES Air pressure in hPa DPRES Delta PRES Difference in air pressure between the last and the current measurement BAT Battery status OK LOW UBAT Battery voltage in V POW Relay status ON OFF FREQ Frequency in Hz VRMS Voltage in V IRMS Electricity in mA LOAD Performance in W WORK Consumption in kWh BUTTON Alert for keystrokes Table 3 ZBS Services Overview You can find further information regarding services in the information manuals for the respective devices 2013 pikkerton GmbH Page 56 95 LabCon Handbook ao Version 1 14 a Ss 2 e C wi PIKKERTON 7 2 4 2 Assigning Services to Groups Once a device has been highlighted un
28. Intervals in the Terminals All ZBS devices can be set to certain time intervals Wakeup every MSI cycle Wakeup every TXT cycle Get Sensor Data amp send Sensor Data Telegram no Check of all Sensor Send Sensor Data Data Telegram E Pry N violation or S recovery Figure 10 MSI and TXT Interval Overview MSI Measurement Interval The MSI is the length of the pause between two measurements Measurements usually mean less power consumption than sending wireless messages Therefore it is advisable to send a message only if it is really necessary TXT Transmit Interval The TXT is the interval between two packets with service readings 2013 pikkerton GmbH Page 18 95 LabCon Handbook 28 s a Version 1 14 Dan m a a a PIKKERTON 5 2 3 3 Timeliness of the Measured Values cyclic The ZigBee network works in relation to the data autonomously and so is completely asynchronous to Nagios or SNMP requests This is especially due to the battery operated devices These are usually in sleep mode and resume only after certain intervals MSI or TXT then take measurements and data transmissions to minimize the power consumption The data transferred over the TXT interval data is stored in a central data structure in order to answer SNMP requests quickly and without risk of timeouts The data requested by SNMP data may therefore have limited relevance and must be considered accordingl
29. LABCON Handbook LabCon Handbook Version 1 14 1 History PIKKERTON Version Date Changes Status V1 00 02 29 12 Developed Release V1 10 07 06 12 Various Modifications Release V1 11 29 08 12 Various Corrections Release Chapter 7 and 8 revision adjustment for LabCon Version 1 05 02 compatibility V1 12 23 11 12 Revision of Chapters Standalone lt gt System Release operations under Nagios V1 13 21 01 13 Chapter 12 revisions Release V1 14 08 04 13 An SW Version 2 01 01 adjustments Release Ch 6 3 1 Addition of alert communities Ch 6 3 2 Addition of warning ID Ch 6 3 2 CSV further definition additions Ch 6 4 3 additions Ch 6 6 CSV Push additions Ch 7 2 2 Added Ch 7 2 4 4 1 Flags adjustment Ch 7 3 newly generated Ch 12 4 extended configuration Ch 12 5 1 Addition of timing intervals 2013 pikkerton GmbH Page 2 95 LabCon Handbook a8 e Version 1 14 B PIKKERTON 2 Legal 2013 pikkerton GmbH All rights including translation into foreign languages are reserved No part of this publication may be reproduced in any form by printing photocopying or any other method or processed using electronic systems copied or distributed without the written permission of pikkerton GmbH The passing on and copying of this document use and communication of its contents are prohibited unless explicitly permitted Violators are liable fo
30. Last 24 05 C Min 19 10 C Max 31 52 C Average 23 35 C M Higher Threshold 27 8 C HITEM2 8 Lower Threshold 10 0 C LOTEM2 Figure 45 Temperature Curve via pnp4nagios Figure 45 shows a temperature profile done over a period of 4 hours The red line stands for an upper limit beyond which one or more alerts can be triggered or actions can be performed 2013 pikkerton GmbH Page 81 95 LabCon Handbook ao a Version 1 14 B PIKKERTON 12 4 Pnp4nagios Configuration The Apache module rewrite must be activated for pnp4nagios a2enmod rewrite The file htaccess needs to be set to the apache2 conf d pnp4nagios conf file AuthUserFile etc nagios3 htpasswd users Apache must then be restarted The LABCON configuration is stored under usr local labcon conf This must be created so that Nagios does not output any error notifications after configuration mkdir p usr local labcon config This path must be entered under etc nagios3 nagios cfg Now add cfg dir usr local labcon config The processing of performance data must also be activated in this file Please note that this directive is probably already in the configuration file default is O process performance data 1 The processing of performance data must be deactivated for all hosts and services which should not be processed define service process perf data 0 2013 pikkerton GmbH Page 82 95 LabCon Handbook ao a
31. PWR Cyc le KEREN EE AE det TEn EE aae 61 BS PWR Cycle ON Be EE 61 PPT 46 62 BT 46 Eeer 46 PS E 62 Eege 46 PPP NE 46 ZBS ENER ERR Hen 47 A repr 47 O 2013 pikkerton GmbH Page 75 95 LabCon Handbook ep Version 1 14 lt zbg hostname custom Config zip 10 Additional Information 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 Page 76 95 LabCon Handbook H Ze B a Version 1 14 E ne E B PIKKERTON 11 Appendix Software and License Update New updates can be made on the ZBG 100 configuration page via the link Updates First the new firmware files and the license files must be uploaded to the ZBG You can use the web front end You are on host ZBG Freigabetest LABCON Home WS buchsuchen Settings Update About pikkerton GmbH 2012 Figure 43 Upload Masks for Update Files After successfully uploading the file you will be prompted to restart ZBG 100 This is done under ZigBee Gateway gt Settings gt Gateway Reboot amp Uptime by clicking the box next to Reboot and then by confirming by clicking Apply 2013 pik
32. R MON DAY HOUR MIN SEC BRI lx TEM C BAT UBAT V The first four columns in the csv file are for the data time stamp which are followed by the brightness in Ix the temperature in C the battery state OK or LOW and the battery power in volts The identifiers of the sensor data is consistent with the Interface Control Document of the respective sensor This excerpt from the csv file shows the structure of the data 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 Here we see that the data is received every 10s The first record bears the time stamp 11 11 2012 14 05 27 Tc prevent the csv files from taking up all the space on the partition they are monitored by the Linux log rotation service The log rotation settings can be changed in the file etc logrotate d labcon csv log rotation or via the Webmin interface ch 6 8 These files can also be monitored with the CVS push service which checks adjustable intervals ch 6 3 2 p 27 and sends them to the set IP address if necessary The data is in this format lt MAC Adresse lt ID gt lt Service gt lt Zeitstempel gt lt Wert gt lt Einheit gt O 2013 pikkerton GmbH Page 38 95 LabCon Handbook H Ze B sen Version 1 14 E ch 5 B E PIKKERTON A current measurement can look like this 0013a2004076843b SR FAN R IRMS 2013 04 08 11 24 55 121 mA MAC Address 0013a20040
33. a Puede dts 80 Ip Esnhanrremeeeecee mmm 81 12 4 Pnp nagios CONTEO aa 82 12 5 Integration of Gateways in Nagios lcinga nono nacos 84 12 5 1 Preparatory Measures nennen nnne enne nnne nene nnne nnne sen nnne 84 12 5 2 Nagios Adjustments on the server side 86 12 5 2 1 LabCon ConfiguratiONS cccococonoooncnononcnoonnnonononononnnononnnnnnnnnnononnnonnnnncnonnnnnnenncnnnnnnnnnnos 86 12 5 2 2 ZBG Name ResolUtiOli icc inca caca cla vann eea edad 87 12 5 2 3 Menu Integration EE 88 12 5 2 4 SNMP Tr p SeEFVICO EE 91 12 5 2 5 Apache Configuration aas a einn ccassddenctaccoosuwdenrconsarstesssive ives e VET o EXE ande ENEE 92 2013 pikkerton GmbH Page 5 95 LabCon Handbook e og Version 1 14 E Dan ar PIKKERTON 12 5 2 6 Customization for Dnpdnaglos eene nnne enne 93 12 5 2 7 Content description of the archive zbg hostname custom config zip 94 125271 Thesubfolder config isnan naea e a aa aa naa aa aa 94 12 5 2 7 2 The subfolder TE 94 12 5 2 7 2 The s bfolder MIDS EE 94 5 27 Dag e TE EE 95 12 5 2 7 4 The subfolder scripts iieri innen hncsatdancsacevexsdencesaecsausencassocdacnis steckatdsnvsaneivedsbads 95 O 2013 pikkerton GmbH Page 6 95 LabCon Handbook 28 e Ser Version 1 14 B PIKKERTON 4 General This manual describes the integration of LabCon into a Nagios environment A Debian 6 0 Squeeze system platform has been selected for the installation of Nagios LabCon 4 1
34. ature gt is within the tolerance range lt 24 C exceeding this gt 24 C and returning to the initial tolerance range The green and red bar represents the state that LABCON displays at the respective points in time 1 The temperature exceeds 24 C This is however only measured by ZBS after the MSI interval expires and is sent wireless to the ZBG 2 ZBG in turn sends an SNMP trap ch 6 5 3 to the Trap Receiver ch 12 5 2 4 This forwards the message to Nagios where it is added onto a command stack The reception of the wireless packet to Nagios usually takes a second 3 Nagios Reaper processes the command executes the configured alarm scripts by LABCON and changes the status from OK to Critical usually 1 2 seconds If the temperature falls back to 24 C steps 1 to 3 are repeated 2013 pikkerton GmbH Page 48 95 LabCon Handbook 28 e Ser Version 1 14 B PIKKERTON 7 2 LabCon Configuration This chapter describes the automated creation of LABCON services and rules for Nagios The individual actuators sensors are sorted into groups after which control loops can be created and threshold values set When these limits are violated various scripts can be run individually or combined in sequence sending an email execute random scripts control of actuators setting or resetting of flags 7 2 1 Flags Flags are an easy way to store conditions for later analysis or conditions Any st
35. ay take a few minutes during both the initial network setup and the reorganization There are three different types of ZigBee devices Ors Q9 P eo id A ik A o of Pi n ee 22 ZigBee Coordinator p O ZigBee Router O ZigBee End Device Figure 2 ZigBee Overview O 2013 pikkerton GmbH Page 9 95 LabCon Handbook eg e a Version 1 14 bi Ba a E We B PIKKERTON 5 1 1 Coordinator The Coordinator is the center the so called master of the wireless network It includes two main functions a accessions of routers and end devices to the network including key management b gateway to the outside world The coordinator is able to communicate with any number of routers and up to 20 end devices Other end devices may require an additional router Both the coordinator and the routers require a permanent power supply ZBG 100 supplies the LabCon system 5 1 2 Router The router s network continues to span the geographic scope It saves notifications delivered to the connected end device in case they are in sleep mode and therefore unable to accept incoming notifications Devices with a permanent power supply are generally ideal as routers ie gadgets with energy saving functions or including a remote switch ZBS 110V2 111 112 are the devises used in LabCon system 5 1 3 End Device End devices are usually battery powered and are rarely active if a your configured sleep time expires
36. bcon nagios insert to side php txt has to be copied to the file usr share nagios3 htdocs side php Here is a abstract of the customized configuration file div class navbarsearch gt form method get action lt php echo cfg 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 e echo Exception abgefangen S e gt getMessage in gt O 2013 pikkerton GmbH Page 88 95 LabCon Handbook 28 s a Version 1 14 Dan m a a a PIKKERTON Icinga The menu integration into Icinga Classic is similar to the integration into Nagios You have to link up to 1abCon icinga ClassicMenu php In s usr local labcon icinga labCon icinga ClassicMenu php usr local icinga share labCon icinga ClassicMenu php In the file usr local icinga insert to menu htm txt program lines can be en tered like this These must be added to the file usr local icinga share menu html Here an excerpt from the customized file lt h2 gt Reporting lt h2 gt lt ul gt lt ul gt lt h2 gt LabCon lt h2 gt lt ul name labConHostMenu gt lt li class
37. by the LED flashing 3xgreen The device has logged in to the coordinator gateway successfully 3x red The unit has not found a coordinator gateway or can not log in Possible reasons for this connected encryption outside of the wireless range closed network etc The devices are configured so that this network login is cyclically repeated if the network scan was not successful In the case of battery operated devices this scan cycle will be extended only gradually to conserve battery For the initial pairing of devices it may be helpful to reset the devices by rebooting them The network scan will begin again and be immediately initiated For this press the key until the LED responds usually 5 10 seconds The respective LED color varies from device to device If you are unsure whether a device has been added to the wireless network or not you can send a message to the gateway with a mere touch of the button Whether the message has been delivered successfully is also indicated by e 1x green The message has been successfully delivered e 1xred The message has not been delivered successfully The device specifics are described in their respective manuals and in the CSE Manual 2013 pikkerton GmbH Page 17 95 LabCon Handbook e Se di Version 1 14 B Ba B a PIKKERTON 5 2 4 Timing of Devices This chapter provides an overview of the most important internal intervals 5 2 4 1 Internal Configurable
38. ces Before groups or control loops can be created you must determine which devices and services are to be configured For this purpose please select the desired devices With the button generate the basic configurations are created and then downloaded by clicking download Nagios Configuration Attention 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 Figure 29 Settings Download At this point the download will be useful only if the devices are to be used solely for displaying and storing the sensor data or if it is S the initial installation of LABCON in Nagios Otherwise the creation and configuration of groups and rules follows This is described further in section 7 2 Please see ch 7 2 7 Installations in Nagios for instructions on how to integrate devices When new devices are added to the network the configuration S must be recreated Old configurations for devices which are currently offline are only maintained if the checkbox has been activated 2013 pikkerton GmbH Page 51 95 LabCon Handbook Version 1 14 7 2 4 Creating and Configuring Groups a BE wa PIKKERTON The website for the configuration of each group is located in the LABCON menu Configuration on the Nagios page
39. contain spaces Virtual sensors are only monitored if configured as members of customized service groups Figure 38 Masks to Edit Virtual Sensor Settings e Virtual Device Name ID of physical sensors 2013 pikkerton GmbH Page 66 95 LabCon Handbook ao Ser Version 1 14 B y Das ar PIKKERTON Virtual Device Service Name Service name for sensors ei Temperature and battery status Upper Lower value threshold Once a threshold is breached an alert message is sent MSI time Time interval in which the measured value is re calculated Mathematical operation Mathematical function of all measured values under Virtual device services selected Sensor Type Filter for Host Device Virtual or physical device Host Device Here all configured sensors are listed with your ID Available services After selecting Host Devices Sensor Device all available measurements services are shown They can be added by double clicking on the selected readings Virtual device services selected Displays all measurements used to calculate this virtual sensor Measurement from virtual v and Physical p devices can be mixed 2013 pikkerton GmbH Page 67 95 LabCon Handbook 28 6s Ser a Version 1 14 Dan a a a a PIKKERTON 7 4 Monitoring As demonstrated in ch 12 3 pnp4nagios all LabCon sensor values are saved in a Round Robin database via the pnp4nagios plug in This data can be displayed usi
40. d values to be applied the data must be transferred to the device by hitting the Apply button This button is located at the bottom of the page Register settings Register New Value Current Value Description TXT Eesen TX Time in s 1 65000 default 60 MSI RENE 0 Measure interval in s 1 65000 O off HBEAT m o Heartbeat interval in s 1 65000 O off default O MOVE mo Quiescence time in s 0 6500 0 off MSENS s Sensitivity fr motion detection default 5 0 1000 lower means higher Threshold settings sensitivity signal gets noisy below 5 Threshold New Value Current Value Description LOBRI mo Minimum for brightness alert in Ix 0 2000 HIBRI 2000 Maximum for brightness alert in lx 0 2000 DBRI 0 Delta for brightness alert in Ix 0 2000 LOTEM ERE 0 0 d qm for the temperature sensor in C value with decimal point HITEM C m 50 0 a for the temperature sensor in C value with decimal point DTEM 0 0 Delta for temperature alert in K 0 0 50 0 LOHUM N A Minimum for humidity alert in 0 100 HIHUM N A Maximal for humidity alert in 0 100 DHUM N A Delta for humidity alert in 0 100 LOPRES N A Minimum for pressure alert in hPa 300 1100 HIPRES N A Maximum for pressure alert in hPa 300 1100 DPRES NA Delta for pressure alert in hPa 0 1100 Figure 25 Configuration Block ZBS
41. der host device all available services are shown then as available services figure 32 Double clicking on the desired service adds this to the group All of the group s active services can be found under device service selected 7 2 4 8 Configuration of the group members You can easily reach the configuration page of the group members by clicking on the icon under setup on the summery page Here you can set the actions for threshold violation and alerts ie press ZBS 130 Some services have two thresholds as in temperature These stand for a value corridor in which the sensor values are interpreted as good When exiting and re entering the corridor various actions are executed If multiple scripts are set for one limit they are processed consecutively from top to bottom 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 a gt TX Time in s 1 65000 default 60 s Heartbeat interval in s 1 65000 O off default 0 o s 785 112 Service CableConf_Work C Work Limit Script Parameter Active 6278 CE IO O Service CableConf_Load E Load Limit Script Parameter Active em AAA ie Figure 33 Configuring Group Members 2013 pikkerton GmbH Page 57 95 LabCon SE H Ze ze ee ser Version 1 14 a a ar PIKKERTON Each column allows for four different events to be edited
42. e ZigBee network times may vary You can speed up the process by triggering Node Discover ND A wireless message is then sent which forces all devices to log into the network If not all devices are shown the display can be updated by hitting Refresh Physical Device Overview MAC PID ID SN Configured Active LMC Select AV AV AV AV AV V N x o 0013a200407b5d4f ZBS 110 ConfRoom 110V2120676 Yes I 0 x 0013a200408cf950 ZBS 112 CableMeter01 112V10125235 Yes I 0 x GS 00132200408cf944 ZBS 112 CableMeter02 112V10125237 Yes CM o 0013a200408a1eba ZBS 121 MultiSensor1 ZBS121007469 Yes Mo 0013a200408alebc ZBS 121 Prod ZBS121007468 Yes 7A 0 0013a200408668ca ZBS 121 ProdWindow ZBS121234567 Yes I 1 x Enable Joining 60s Node Discover remove offline devices Lost message counter update interval Os Lost message counter reset 08 15 18 UTC Fri 02 11 2012 Figure 17 Settings Phys devices Overview MAC The ZigBee module has a specific MAC address located on the individual devices This allows each device to be clearly identified To get to the respective sensor s page click on the MAC address link found behind the address You can then find the current measured values adjust threshold values and intervals TXT and MSI as well as control the device ei relay or LED status change PID The PID is the relevant type of ZBS family 2013 pikkerton GmbH Page 27 95 LabCon Handbook e Se re W I Version 1 14 bi Da e E
43. eat packets which are set in low level configuration in ZBS devices These are largely switched off due to a massive battery saving program This allows for the next LMC interval value to be requested solely by the device It is important to note that data telegrams are also requested which in consequently cause additional power consumption Lost Message Counter teal Je Default The last message counter is turned off by entering 0 Reset C Last reset 08 15 18 UTC Fri 02 11 2012 Figure 15 Settings Gateway Lost Message Counter The last two points explain how to restart the entire ZBG or save and restore its configurations 2013 pikkerton GmbH Page 25 95 LabCon Handbook s e a Version 1 14 Bn a e IA a PIKKERTON Reboot amp Uptime Reboot Q Gateway uptime 3 days 0 users minutes Agent uptime 3 days 0 hour 57 minutes 23 seconds Save amp Restore Labcon Settings Download Backup Save amp Download Restore Durchsuchen Restore Figure 16 Settings Gateway Reboot amp Save O 2013 pikkerton GmbH Page 26 95 LabCon Handbook e Se di W I Version 1 14 E a e a PIKKERTON 6 3 2 Settings Phys devices This page is used to display and configure ZigBee devices found in the ZBS family After a re start of ZBG 100 the ZBS device will need some time to log into the ZigBee Gateway This may take up to several minutes Depending on the number of devices in th
44. ersion 1 05 02 you must load the file ConfigZipper py into the LabCon directory and create a Flag file directory 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 Page 86 95 LabCon SE e Ze ze e ap Ser Version 1 14 a wf wi PIKKERTON 12 5 2 2 ZBG Name Resolution To indisputably identify the individual ZBG 100 Gateway its hostname has to be posted to Nagios Server ch 6 3 This can be set up with two different paths This document describes the name resolution of the host file An alternative is the resolution on a DNS server To ensure that all services run correctly the name resolution and Ce reverse name resolution must be guaranteed An easier alternative however is to set the name resolution via the host file etc hosts You must assign the ZBG 100 IP address and hostname in the following notation lt IP Address gt lt Full Qualified Hostname gt lt Short Hostname gt 192 168 0 100 zbg 100 domain zbg 100 O 2013 pikkerton GmbH Page 87 95 LabCon Handbook ao ze Version 1 14 wt gef a a a a PIKKERTON 12 5 2 3 Menu Integration Nagios For the integration of LabCon in Nagios you must link the file 14bcon menu php to the Nagios server file side php In s usr local labcon nagios labcon menu php usr share nagios3 htdocs labcon menu php The code from usr local la
45. es and to then send them per TCP connection in clear text For each device a separate file is used The file name is also the MAC Address of the ZBS Device The recording of the sensor values will be discussed further in Section 6 6 The following settings can be made here Enable CSV Recording Activates back up saving the data in the CSV files Enable CSV Push Activates transmission of the data via TCP This option turns on the Enable CSV Recording field e IP The IP address to which the data is sent Port The TCP Port to which the data is sent e Rate Time interval in seconds in which the push service checks for new data 2013 pikkerton GmbH Page 30 95 LabCon Handbook H Ze B sen Version 1 14 Dan B 2 a a PIKKERTON Nagios Configuration Attention 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 Figure 20 Settings Phys devices Nagios Configuration Under Nagios Configuration you can create the basic configurations for Nagios The button Generate creates the archive zbg hostname custom config zip This archive contains all the configuration and script files that are needed for a LabCon installation in Nagios Icinga In addition the needed MIBs for a SNMP are also located in this zip file As show
46. f Minimum Min 2013 pikkerton GmbH Page 64 95 LabCon Handbook e og Version 1 14 E Dan ar PIKKERTON e Maximum Max Virtual sensors behave like physical sensors They have an interval in which the measured values are re calculated and in addition alert messages are sent when a violation of threshold values occurs Home Add a virtual device Settings Gateway Virtual device filter All DH ZigBee Net Virtual device name MAC Edit Remove Current_Sum Current 0000 Y X Nagios Phys devices Virt devices Update About Figure 37 Virtual Device Overview The virtual sensors can be created under the heading Setting gt Virt Devices gt Add Existing Sensors can be configured under Edit 2013 pikkerton GmbH Page 65 95 LabCon Handbook eG e Version 1 14 Bm E PIKKERTON Edit a virtual device On this page you can edit a virtual device Virtual device name cc Virtual device service nameSum Upper value threshold T Lower value threshold 5600 0 msie gt Virtual device unitma sid Subsumption operation sum zl Sensor Type Virtual device services selected Virtual device gt p WW WC H R_Current_F p WW WC D R_Current_F Host device p WW WC H L Current R p WW K Current RMS Add to Virtual Device Available services Add to Virtual Device Remove from Virtual Devi The virtual device name and virtual device service name must not
47. gg The password change affects only the web password The root password which for example is needed in ssh will not be altered Password Settings New Password 1 Retype new Password Please do not enter a password if you do not want to change it Figure 13 Settings Gateway Password Settings Under SNMP Settings you can manage communities and password settings Here you can also switch Traps on and off For safety reasons the three communities must differ from each other Currently only one trap destination is supported which you can also enter here O 2013 pikkerton GmbH Page 24 95 LabCon Handbook e og Version 1 14 B Dan ar PIKKERTON SNMP Settings SNMP Version ze gt SNMP Trap Version 2c v Read Community public Write Community Private Trap Community trap 53 SNMP Trap Address 0 0 0 0 SNMP V3 Encryption Key SNMP V3 Authentication General Traps Enable Coldstart Trap Enable O Download MIBs via ssh or WinSCP from usr local labcon agent_module mib Figure 14 Settings Gateway SNMP Settings A so called Lost Message Counter LMC counts seemingly lost wireless messages this is similar to the packet loss during a ping Normally there are no higher values The LMC is calculated internally by the system and is based on ZigBee internal event counters that are transferred These however are rarely sent ie Heartb
48. gure 6 ZBS 111 An automatic measurement is taken at approximately 14 000x per second This is then delivered to and integrated into an evaluation algorithm supported by DSP and Controller 2013 pikkerton GmbH Page 13 95 LabCon SE e Ze ze e ap Ser Version 1 14 a a ar PIKKERTON 5 2 2 2 ZigBee Multi sensor ZigBee multi sensors ZBS 12x are available in a variety of configurations Supported sensor types are currently Temperature Brightness e Air Pressure e Humidity e Motion Figure 7 ZBS 121 indoor Although the unit carries out measurements in narrow intervals a mere handful of rich uA a thousandths of a milliamperes is needed to ensure year round reliability and efficiency After each measurement all on board sensors must be turned off completely and the unit switched into deep sleep mode However it will continue to detect and report the exceeding of threshold values This approach combines the fastest response times with the longest battery life 2013 pikkerton GmbH Page 14 95 LabCon Handbook Ze a Sen Version 1 14 Beef B a a a PIKKERTON 5 2 2 3 Additional ZBS Devices The ZigBee hand held ZBS 130 has a button which when activated sends a wireless message to the coordinator Typical applications for this actuator are Entry Control Home Automation e Patient Emergency Call Figure 8 ZBS 130 The ZigBee contact monitoring ZBS 132 is used for monitori
49. iably The ZBG has two LEDs one blue and one red which can be addressed via the software LabCon uses this to indicate traffic on the ZigBee wireless link 2 gt E ZBG 100 gt Se 2 4 GHz Zigbee Gatene gt X Figure 3 ZBG 100 Both the USB port and the SD card slot can be used to expand the internal memory However you can also launch a Linux operating system from these interfaces Additional information is available in the data sheet You can find this under the following link http www pikkerton de zigbee ZBG 100 ZigBee Gateway html 2013 pikkerton GmbH Page 11 95 LabCon Handbook ser Version 1 14 m a PIKKERTON 5 2 2 ZigBee Sensors amp Actuators in the ZBS family This chapter lists the main equipment of the ZBS family Further information can be found under http www pikkerton de zigbee ZigBee html 5 2 2 1 Smart Energy Meter The following group of devices are used to measure and partially to switch currents e ZBS 110V2 e ZBS 111 ZBS 112 Figure 4 ZBS 112 Switchable devices such as ZBS 110 and ZBS 111 include the pikkerton SART technology These enhance the service life of the relay contacts 2013 pikkerton GmbH Page 12 95 LabCon Handbook Version 1 14 Figure 5 ZBS 110V2 The devices ZBS 110 ZBS 111 and ZBS 112 have the NQ Option This is a high precision measuring unit including voltage which detects and reports fluctuations and spikes Fi
50. ide the limit is red O 2013 pikkerton GmbH Page 69 95 LabCon Handbook ege Ser Version 1 14 B H PIKKERTON 09 06 12 21 41 30 07 12 11 36 Host dauertest Device ID 110 Halle ZBS 110 Service TEM2 30 Ee o mom Ud 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 Bl Lower Threshold 10 0 C LOTEM2 Figure 41 Displays Temperature Flow over a Period of 7 Weeks The transparent areas indicate that no values have been stored by pnp4nagios Possible causes for this include that Nagios service is not currently running or that ZBG is not accessible via LAN 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 00 Mon 12 00 Last 22 54 C Min 12 16 C Max 32 04 C Average 21 86 C M Higher Threshold 27 8 C HITEM2 B Lower Threshold 10 0 C LOTEM2 Figure 42 Displays Temperature Flow over a Period of 60h 2013 pikkerton GmbH Page 70 95 LabCon Handbook eg e Version 1 14 B PIKKERTON 8 Index of Figures Figure 1 Figure 2 Figure 3 Figure 4 Figure 5 Figure 6 Figure 7 Figure 8 Figure 9 Figure 10 Figure 11 Figure 12 Figure 13 Figure 14 Figure 15 Figure 16 Figure 17 Figure 18 Figure 19 Figure 20 Figure 21 Figure
51. in the ZBS Tamil 12 5 2 2 1 Smart Energy Mete 2 ii cack aai a aaa a RR RA TERES RENE aeo A E S 12 5 2 2 2 ZigBee Multi sensor ici cessit rne a YEN TRE VE RENE FR Ve geed 14 5 2 2 3 Additional ZBS DEVICES EE 15 5 2 3 Initial operation of the equipment and network design nnen 16 5 2 3 1 GALWAY E 16 5 23 2 E ul EE 17 5 24 TIMING of DEVICES atar line 18 5 2 4 1 Internal Configurable Intervals in the Terminals srrronnrrrrnnrrrnnnvrrnonnrrrnrnrrrnnnnnnnnnnnnn 18 5 2 3 3 Timeliness of the Measured Values cycle 19 6 ZBG 100 Gateways Stand alone Operation rernrrevnennnvvvnesnnnvnnnsennrrnnesnnnrnnsssnnnnnnnnnnnns 20 GR Bei Le E 20 EE EE 21 6 3 Setting the ZG 100 22 6 3 1 Settings Gateway cscccsecscsssccscsscscevscssesesceesenusevsscucnsuvenesvaveseseveuneveuavseceaaacceces 23 6 3 2 Settings Phys devices iienaa Ee nn con rennen nennen nnn nnns 27 6 4 SecU e 32 6 4 1 Admin Login https 32 6 4 2 Communication via SNMPV nennen nnn nn nn nennen nsns 32 6 4 3 ZigBee Wireless Security via AES nanne nennen nnne nnns 32 ECH TE 34 6 5 1 Authorization Management 35 65 11 SNMPVT and Ke 35 6 5 1 2 SNIMPV3 EE 35 6 5 2 SNMP Manage EE 35 6 5 3 NAPS EE 37 2013 pikkerton GmbH Page 4 95 LabCon Handbook 8 e ae Version 1 14 B 6 6 CSV Recording 7 PUSE memoreren ntt ennen 38 6 7 Direct Control of Devices ere vannnenenere eere vervnnnnnnnnnnn 40 6 8 Webmin entente a 42 7 Operating under Nagios Ica canina
52. ios 0 6 19 tar gz tar xzf pnp4nagios 0 6 19 tar gz cd pnp4nagios 0 6 19 configure tail n 26 pnp4nagios txt make all make fullinstall Gd pa 2013 pikkerton GmbH Page 79 95 LabCon Handbook Version 1 14 12 2 Initial Test PIKKERTON The website http localhost nagios will display the following frame after you have entered the password 2013 pikkerton GmbH Nagios Home Documentation Current Status Tactical Overview Map Hosts Services Host Groups 9 Summary Grid Service Groups 9 Summary Grid Figure 44 Nagios Men without LabCon Page 80 95 LabCon Handbook e Se di W I Version 1 14 5n Da a PIKKERTON 12 3 pnp4nagios This Nagios plugin allows you to analyze the performance data delivered by all Nagios plugins It then stores it automatically into RRD databases to display them RRD is the abbreviation for Round Robin Database and refers to the way the data is stored by RRDtool When creating a database a so called RRD file creates enough memory for a specified period of time After this period the database is not extended the file size is not increased but the oldest data is overwritten Host dauertest Service 110 Raum6 3 TEM2 4 Hours 20 07 12 9 51 20 07 12 13 51 Datasource Wert by Host dauertest Device ID 110 Raum6 3 ZBS 110 Service TEM2 10 00 10 20 10 40 11 00 11 20 11 40 12 00 12 20 12 40 13 00 13 20 13 40
53. kerton GmbH Page 77 95 LabCon Handbook Version 1 14 PIKKERTON 12 Apendix Nagios Installation This chapter describes the LABCON installation on Debian 6 0 Squeeze 12 1 Required Software The following packages are required apache 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 python libsnmp python All modules can be installed via apt get or aptitude Additionally some modules are still needed which are not included in the repository of Debian pysnmp pysnmp mibs pyasn pnp4nagios 2013 pikkerton GmbH Page 78 95 LabCon Handbook eG e Version 1 14 H Dan These are installed as follows wget http downloads sourceforge net project pysnmp pysnmp 4 2 3 pysnmp 4 2 3 tar gz tar xzf pysnmp 4 2 3 tar gz cd pysnmp 4 2 3 python setup py install ed s wget http downloads sourceforge net project pysnmp pysnmp mibs 0 1 4 pysnmp mibs 0 1 4 tar gz tar xzf pysnmp mibs 0 1 4 tar gz cd pysnmp mibs 0 1 4 python setup py install GO sx wget http downloads sourceforge net project pyasnl pyasnl 0 1 4 pyasnl 0 1 4 tar gz tar xzf pyasnl 0 1 4 tar gz cd pyasn1 0 1 4 python setup py install Gd 165 wget http downloads sourceforge net project pnp4nagios PNP 0 6 pnp4nag
54. l ID PID SN MAC Status ZBS121000000 ZBS 121 ZBS121000000 0013a200407e7b85 The interval to be measured in between the datagram The interval datagrams are sent in 361 Service ZBS121000000_TEM temperature limit Script Parameter Active FS 55120 on 9 e 1 Sensor Name Relay Switch on off cy Figure 34 Airflow Example 2013 pikkerton GmbH Page 62 95 m SCH e Se di T ae ersion 1 B Ch a PIKKERTON 7 2 5 2 Loop Control without Hysteresis The requirements are similar to the example Air flow management Hysteresis Control Loop excluding the hysteresis In this example the vents should now be running at a temperature of 40 C and they should be turned off if the temperature drops below this The configuration looks like this Service ZBS121000000_TEM temperature limit Script Parameter Active ZBS PWA ControLpy v 205110 fan on REESEN 205110 fan of Figure 35 Airflow Example without Hysterese 7 2 5 3 Access Control Door Opener If the user has been authorized he can access a door by By pressing the ZBS 130 ID zbs_mueller button The door opener is connected to a bell transformer which in turn is connected to a ZBS 111 ID tuer_buero For access authorization two flags are checked The first includes the authorization for the person and the second an access restriction of certain times 7 2 6 Group Settings In addition
55. must be specified with the Argument s lt directory gt and the target directory usually usr local icinga web specified with Argument d lt directory gt 2013 pikkerton GmbH Page 90 95 LabCon Handbook Ten ze Version 1 14 wt gef m a a a PIKKERTON 12 5 2 4 SNMP Trap Service You must register the Trap distributor with the SNMP service In order to do this please link the Trap distributor file in the SNMP directory cd usr share snmp In s usr local labcon labcon traphandler py Also the file etc snmp snmptrapd conf must now be created or extended as follows 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 traphandler py Before the SNMP service can be restarted you must set the option TRAPDRUN in the file etc default snmpd to yes and the service must be added to the start up routines insserv snmpd Now adjust the community named public to the Trap community sending the Traps to the sever This can be set via SNMP ch 6 5 3 Ce Traps are sent to port 162 UDP Make sure that your firewall is set to allow this 2013 pikkerton GmbH Page 91 95 LabCon Handbook a8 e a Version 1 14 E Ss w a PIKKERTON 12 5 2 5 Apache2 Configuration The LABCON configuration for Apache2 must be linked to
56. n in the Figure 20 this file can be downloaded easily via http or scp 2013 pikkerton GmbH Page 31 95 LabCon Handbook eg e Version 1 14 B PIKKERTON 6 4 Security 6 4 1 Admin Login https To access ZBG 100 s website enter the username and password During the state of delivery these are admin You find the password file pw inc in the root directory of the web server var www The connection to ZBG 100 s website can also be established via the https default port 443 with encrypted SSL 6 4 2 Communication via SNMP V3 Encrypted and authentisized SNMPv3 packets allow for communication between LabCon and ZBG 100 For more information please see Chapter 6 5 1 2 SNMPv3 6 4 3 ZigBee Wireless Security via AES The ZigBee wireless network can be encrypted via AES 128 Once the encryption has been activated in the ZigBee coordinator ZBG 100 only ZigBee routers and end devices with activated encryption and the same network key can be connected The encryption can be set via Settings ZigBee Net This page allows the coordinator to be set in two different modes Encrypted Encrypted Network and unencrypted Open Network communication Please note that the router and end devices can only show the operation mode in which they are currently To encrypt a wireless network please do the following 1 Choose a network key max 32 signs Hexadecimal without leading Ox eg 3ac56d
57. ng the same plug in Monitoring is possible via the LABCON side menu located on the Nagios page MEAT ZBG 100 d Atmnenhars Figure 39 Nagios Menu You can find an overview page either via the link Monitoring or via the specific group name Figure 40 shows the overview found under Monitoring 2013 pikkerton GmbH Page 68 95 LabCon Handbook e og Version 1 14 Das Ok D PIKKERTON Default Groups and System Modules Default Groups System Modules Ambient Atmosphere Energy Metering Battery du 9 Mains Analysis Access Control Customized Service Groups There are no customized service groups configured yet Figure 40 LabCon Monitoring Overview Page The following figure shows a temperature profile compiled over a duration of 7 weeks Pnp4nagios allows for easy zoom of time ranges These two temporal boundaries can be moved left and right by using the two arrows in either the bottom right or bottom left corner You can however also zoom using the mouse Place it over the desired starting value and hold down the right mouse button bringing it over to the desired end time Finally release the right mouse button The rightmost button restores the zoom to its default settings currently these are set to the last seven weeks When ZBS 110 receives a message the red line automatically indicates the upper limit This then runs LABCON scripts The period in which the temperature is outs
58. ng doors and windows Overall ZBS 132 can monitor up to three doors windows Figure 9 ZBS 132 2013 pikkerton GmbH Page 15 95 LabCon Handbook 28 s Version 1 14 a Ba 2 E We B PIKKERTON 5 2 3 Initial operation of the equipment and network design 5 2 3 1 Gateway Once the gateway is plugged in the wireless module operates independently of the boot OS It gives existing terminals or routers the option to join a wireless network By default the wireless traffic is unencrypted and the coordinator gateway configured without further restrictions Therefore the devices should now find each other automatically Wireless traffic is displayed using the two LEDs Here the red LED indicates when messages are received The blue LED shows when messages are sent from the gateway 2013 pikkerton GmbH Page 16 95 LabCon Handbook eg e a Version 1 14 bi Ba 2 E We B PIKKERTON 5 2 3 2 Terminals Depending on the terminal router the respective operating status is displayed on the device specific LEDs 2independent LEDs green orange e 1 multi color LED or 2 LEDs in a window plunger button green orange 1 RGB LED red green In the following both the orange and the red LED are collectively referred to as red After starting a router or terminal an automatic network scan is initiated which searches for complementing and open coordinators Success failure is indicated
59. of characters Check Flag py Actions can be enabled or disabled by means of flags This can for example be used when arming of an alarm system This script checks the flag with a sting of characters Parameter 1 Flag name 2 Default value for the flag if it is not yet initialized meaning if an other script has not already set or cleared it 1 Flag is set 0 Flag is not set 7 2 4 4 2 Sending Emails Send Mail py Sends email to recipient You must customize the script after the installation on the Nagios Ce server has concluded e Sender e SMTP Server and e Password O 2013 pikkerton GmbH Page 59 95 LabCon Handbook eg e Version 1 14 B PIKKERTON Must be specified Parameter 1 Email recipient 2 Subject text of the email 7 2 4 4 3 ZBS Device Actuators ZBS Buzzer py Controls the Piezo Buzzer This can be automatically and consecutively switched on and off Further information on the Piezo Buzzer are found in the relevant device s manual Parameter ID of the ZBS Number of cycles of the buzzer Sound Pause Pause Duration of the buzzer sound in 100ms Duration of the pause in 100 ms The tone frequency in Hz ZBS 130 ideally uses 2 4 kHz Um NE Example ZBS 130 Buttonl 5 10 20 2000 With the ID Button1 on ZBS the buzzer switches on for 1s and off for 2s consecutively 5 times The frequency is 2kHz 2013 pikkerton GmbH Page 60 95
60. ors the reach of all wireless devices 2013 pikkerton GmbH Page 53 95 LabCon Handbook e e Version 1 14 a e a a PIKKERTON 7 2 4 1 Adding groups With add groups can be added It opens the following screen Add service group On this page you can create yuor service group Host device ZBG 100 v PikkertonHOPl bi ZBG 100 p MotionDetect ZBG 100 p Lamp ZBG 100 p Lamp1 ZBG 100 p Activator ZBG 100 p Lamp6 dd pesten tee A21 O Fields marked with must be filled Figure 32 Service Groups First enter the name of the group This may consist only of the following characters AZ az e 0 9 2013 pikkerton GmbH Page 54 95 LabCon Handbook o e a Version 1 14 Dan m a a a PIKKERTON underscore _ The description of the group in Nagios however is not restricted Here you may also use spaces and special characters Under host device you find all devices already configured for Naggios according to ch 7 2 3 Creating Nagios Configurations for Devices You can also find the created virtual sensors After the hostname it is possible to see whether it is a virtual v or physical p sensor If a device is selected in this window you can see all services offered by this device under available service Actuators such as the switching of relays is configured elsewhere ch 7 2 4 3
61. os Icinga works with a basic interval from which all Length times are taken In a standard Nagios installation this interval is 60s This value is defined in nagios cfg of the variables interval length Finally the default setting and scripts can be regenerated and downloaded in Settings Phys Devices Nagios Configuration Erase Configuration Generate 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 Figure 47 Generating ZIP Files O 2013 pikkerton GmbH Page 85 95 LabCon SCH e Se di T e wn Version 1 a wf wi PIKKERTON 12 5 2 Nagios Adjustments on the server side Here you can find all settings regarding the integration of LABCON into Nagios 12 5 2 1 LabCon Configurations The files needed for the integration are now available for download on ZBG however you must first complete the configuration of ZBG 100 The file can be accessed by clicking on Download or directly via the following link http lt ip des ZBG gt tmp lt zbg hostname gt custom config zip You must first unzip the file copy its contents into usr local labcon make the Python scripts executable unzip lt zbg hostname gt custom config zip chmod atx py chmod atx py mv usr local labcon When using Software V
62. r all damages All rights reserved in the event of patent utility model or design Pikkerton GmbH is not liable for technical or editorial errors or omissions contained herein Furthermore they shall not be liable for any damages that are directly or indirectly attributable to the furnishing performance or use of this material Changes to the content herein is subject to change without notice The Information in this publication is given without responsibility for accuracy and completeness In par ticular it contains no such information to be guaranteed The user carries all risk aris ing from the use of this information Please note that all manual software and hardware names and trademarks of the respective companies are generally subject to trademark brand or patent protection pikkerton GmbH Kienhorststr 70 Fon 49 0 30 3300724 0 13403 Berlin Fax 49 0 30 3300724 24 Germany Website www pikkerton de 2013 pikkerton GmbH Page 3 95 LabCon Handbook 8 e ae i a a Version 1 14 Dan Ss a a PIKKERTON 3 Table of Contents ole ele 2 en 3 A A 4 EE DEE EE H 41 Target Group E H A T 7 4 3 Definition of Symbols is 7 5 EabCon e TEE 8 51 ZeBee Wireless Standard E 9 ee A e eidele EE 10 e D Me nd EE 10 513 ENA DEVICE riannee eene teert entente wateren etten tante 10 5 2 Device Overvieuw REENEN 11 5 2 1 ZigBee Gateway ZBG 100 eenn 11 5 2 2 ZigBee Sensors amp Actuators
63. ring of characters can be stored in this flag The file name corresponds to the global flag name and these can be manually controlled via the website script external applications or time based ie a CRON job At the same time they provide a simple interface to the outside world or other applications Flags are used primarily either to stop running or to continue running the various processes running scripts on threshold violation They can not however be used to branch off further Within the script set Flag py a flag with any given name and content can be set If at this point when the script Check Flag py has expired the content of each script does not correspond with the given condition the running of the scripts will be stopped immediately O 2013 pikkerton GmbH Page 49 95 LabCon Handbook 28 s a Version 1 14 a s e i a B PIKKERTON 7 2 2 Special Features of Work Limit and Load Limit An additional drop down menu aids you when configuring limits for load limit and work limit Here the given choices e MSG When exceeding the limit just one trap message is sent off Upon exceeding the limit the ZBS immediately turns off the relay and sends a trap message This disables self switch off To reactivate you must set a the limit again 2013 pikkerton GmbH Page 50 95 LabCon Handbook e Se di BI Version 1 14 bi u e wi PIKKERTON 7 2 3 Creating Nagios Configurations for Devi
64. rity feature automatically 6 5 2 SNMP Manager The company iReasoning offers the SNMP Manager MIB Browser as a free version This is Java based so it can be used on Windows Mac OS Linux or other Unix platforms Among other things this version has the following features SNMP Walk Get Set Tabular MIB view Trap Receiver Transmitter SNMP v1 and v2c can resolve up to 10 MIBs The paid version has more features such as SNMPv3 2013 pikkerton GmbH Page 35 95 LabCon Handbook e Se di a Version 1 14 A ev e PIKKERTON There are also many other managers HP OpenView and Net SNMP being the best known This manual only briefly touches on iReasoning s MIB Browser After the first start up you will see 4 iReasoning MIB Browser File Edit Operations Tools Bookmarks Help Address 192 168 8 103 v Advanced om 1 3 e Operations Get Net Go ET MIBs E Result Table MIB Tree Name OID Figure 21 iReasoning MIB Browser Now load MIBs onto the browser from ZBG 100 You can find these in the archive lt zbg hostname custom config zip Chapter 6 3 2 pg 31 explains how to create and download these The MIB text files can then be loaded via the menu File gt Load MIBs 2013 pikkerton GmbH Page 36 95 LabCon Handbook H Ze B sen Version 1 14 B Dan Da B PIKKERTON Look In mib y 63 29 2 Es B E PIKKERTON MIB txt E PIKKERTON ZBS
65. the directory conf d of Apache2 ed etc apache2 conf d In s usr local labcon apache2 labcon conf 2013 pikkerton GmbH Page 92 95 LabCon Handbook ao Version 1 14 a Ss 2 e a Da PIKKERTON 12 5 2 6 Customization for pnp4nagios In order for the graphs to be displayed correctly all files found under usr local labcon pnp4nagios share templates must be linked to a php4nagios sub directory 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 2013 pikkerton GmbH Page 93 95 LabCon SCH e Se di T e wn Version 1 a wf wi PIKKERTON 12 5 2 7 Content description of the archive lt zbg_hostname gt _custom_config zip Description Includes basic files for the integration of LabCon into Nagios Download http lt ip des ZBG gt nagiosfiles lt zbg hostname gt custom config zip 12 5 2 7 1 The subfolder config This folder contains the LABCON configuration or Nagios for all enabled ZBS family devices 12 5 2 7 2 The subfolder icinga Content e labCon icinga ClassicMenu php PHP Skript for the menu integration of LabCon in Icinga insert to menu htm txt Contains additions for menu html needed for the integration of LabCon in Icinga 12 5 2 7 2 The subfolder mibs Contains further ZBG 100 Gateway MIBs Management Information Base and the devices registered to it
66. the list which are marked as offline Default By activating the default setting sends a defaults notification and restores all highlighted devices back to their default settings You can see which settings are affected by in the respective ICD Command Send Command Collect answers Clear output Figure 18 Settings Phys devices Command Send Command Sends the command recorded in the right text field to all selected devices Collect Answers Collects all responses from the devices The responses are the last received data from the devices It may Ce depending on your network settings take up to 30 seconds until the requested information is received Clear Output Clears output window of all responses 2013 pikkerton GmbH Page 29 95 LabCon Handbook ser Version 1 14 wt gef a a a a PIKKERTON 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 Figure 19 Settings Phys devices CSV Control Settings CSV Control settings ZBG 100 provides the ability to store all incoming wireless readings as CSV fil
67. wnload zere neee sidene norte e dree dee 51 BET NIGEL neee seni eaten netbe elected 52 Service GrOUps eee 53 Service GrOUPS cae Et 54 Configuring Group Members 57 Airflow Example rrrrrrrrononnnnnnrnrvnnnnsonnnnnnnnrvnvnnssnnnnsnnnnnrnnnnsssnnnnnnnnnnrnnnnsssnnnnnnne 62 Airflow Example without Hvsterese o non nnnnnnnnns 63 Generate amp Download Configurations sess 64 Virtual Device Overview rsanstrrivseoreduseen skeelers Dt pe o pa Fuspap Cui aun oa lacra Fed 65 Masks to Edit Virtual Sensor Settihgs lisse eere obruo tas Dese scusa 66 Nagios Menlo Em REO ND ERA I IS RN ET tes 68 2013 pikkerton GmbH Page 71 95 LabCon Handbook ao a Version 1 14 B Figure 40 LabCon Monitoring Overview Dage nnne 69 Figure 41 Displays Temperature Flow over a Period of 7 Weeks 70 Figure 42 Displays Temperature Flow over a Period of GOh 70 Figure 43 Upload Masks for Update File S onno eenneneneeeeneenennenenennnenn 77 Figure 44 Nagios Men without LabCon esses nennen 80 Figure 45 Temperature Curve via pnp4nagios esee 81 Figure 46 Nagios Settings in LabCon ENEE 84 Figure EE ler 85 2013 pikkerton GmbH Page 72 95 LabCon Handbook Version 1 14 9 Index A C Check Flag py 04 AAA ERE Clear e e insnet Collect Answers A configuration block
68. y The timeliness of the data can be easily adjusted for devices with permanent power supply via TXT closer intervals Alarm messages can also be set see next section and then transferred directly 2013 pikkerton GmbH Page 19 95 LabCon Handbook H Ze A Ser Version 1 14 Dan m a a a PIKKERTON 6 ZBG 100 Gateways Stand alone Operation 6 1 Criteria The operation is web based The operation of the front end has been tested with the following browsers respective current versions Firefox Chrome e Internet Explorer Ce The browsers must have Javascript DOM installed and activated 2013 pikkerton GmbH Page 20 95 LabCon Handbook Version 1 14 6 2 Delivery Status ZBG 100 is delivered with the following configuration 2013 pikkerton GmbH IP 192 168 0 100 Subnet 255 2552550 Gateway 192 168 0 1 Hostname ZBG 100 root Password rootroot Web User admin admin Web Password SNMP v1 und v2c Authentifizierung Read Community public Write Community private SNMP v3 Authentifizierung Passwort rootroot Process md5 Status off SNMP v3 Verschl sselung Password rootroot Process sha Status ert Table 1 ZBG 100 State of delivery PIKKERTON Page 21 95 LabCon Handbook Version 1 14 IKKERTON 6 3 Setting the ZBG 100 The web interface of ZBG 100 allows you to make all necessary adjustments Once ZBG 10 s

Download Pdf Manuals

Related Search

Related Contents

  NCN5192NG Evaluation Board User`s Manual      OKI MB280  Lightolier Lighting Systems Silhouette SE User's Manual  MAJORD`HOME - Epitech Innovative Project    SSL Sigma Installation Guide  Largo Largo Tunnel  

Copyright © All rights reserved. Failed to retrieve file