Translations of this page:

Osmius

Osmius agent for Sequoia EM01B
Agent name: osm_ag_SEQEM01B Agent code: SEQEM01B
Subject: User manual agente de Osmius para sensor Sequoia EM01B
Date: 12/02/2010 Revision date:

General Information

This agent can monitor several parameters of un sensor Sequoia EM01B. It has been checked with a real sensor. However, we recommend checking its functionality before implanting it in a production environment.

The Sequoia EM01B agent has been developed using functionalities and enhancements of Osmius framework and ACE libraries, so it is necessary to install the ACE libraries for the proper deployment and operation of the Osmius Sequoia EM01B. See chapter: installation.

The SEQEM01B agent provides up to four basic events with configuration parameters to allow scaling of a very simple way. Events have been selected by the Research and Development Osmius Team as the most interesting for this first development.

All events are remote, so not intrusive. Monitoring is done through the network connection, by this reason you have to provide some connection information to connect to internal web server of the sensor. Check the Sequoia web site.

OBSERVATION: Due to the limited capacity of the web server is recommended to set monitoring intervals not too low. Has been reported cases in which the sensor web server is not able to accommodate several simultaneous requests and then it returns truncated text.

Sequoia EM01B Instance

As a general rule each Osmius agent can monitor one instance type. If you are not familiar with these concepts check out the glossary. Each instance is individually defined in the configuration file (if you want further information go to agents and instances); depending on agent type is the instance type and depending on instance is the connection info.

CONNECTION_INFO

The connection information or connection_info is data that the agent needs to know to connect to the instance. (See more about the connection_info)

In this Sequoia EM01B Osmius agent the connection_info prototype would be:

CONNECTION_INFO= -i IP_SENSOR[ -p PORT]

Replace the following:

  • IP_SENSOR: IP direction of Sequoia EM01B sensor.
  • PUERTO: port of the Sequoia EM01B sensor internal web server.

Examples:

CONECTION_INFO = -i 192.168.34.213
CONECTION_INFO = -i 80.58.12.134 -p 92

OBSERVATION: default http port is 80, if you don't set any.

TYPE

The type defines the instance type to be monitored. Every declared instance must be associated with a type as you can see here

In this Sequoia EM01B sensor agent:

TYPE= SEQEM01B

Event summary table for Sequoia EM01B

Here is briefly the capabilities of this agent, further down on this page each event is described in more detail.

EVENT DESCRIPTION c w a tseconds Extra parameters / Remarks
AVAILABL Sensor availability 1 0 0 60 Silent mode ( -s) recommmended
EM01BTEM Sensor Temperature 0 25 30 300 [-U “C” ó “F”] We will set the desired measurement units ºC or ºF
EM01BHUM Relative Humidity percentage 0 25 45 300 None
EM01BLUX Illumination measured in lux 0 50 80 300 None

Sequoia EM01B Agent Events

AVAILABL

This AVAILABL events check if we can connect to Sequoia EM01B sensor.

Return values:

VALUE MEANING
-1 Error
0 No Connection
1 Connection OK

Recommended parameters:

Comparison type Inverse. The lower value the higher severity (-c 1)
Monitoring interval 1 seconds – 1 hour –> depends on instance importance
Warning threshold 0
Alert threshold 0

Parameter setting example:

AVAILABL = -t 30 -c 1 -w 0 -a 0 -T "Sensor 21A"

Remarks: None

EM01BTEM

This EM01BTEM event returns the temperature data of the sensor.

Extra parameters:
This event need an extra parameter :

PARAMETER MEANING Mandatory
-U “C” ó “F” - measurement units of the temperature Celsius(C) or Faranheit(F) . No. This agent returns the temperature in the default measurement units of the sensor

Return values:

VALUE MEANING
-1 Error
X Integer temperature

Recommended parameters:

Comparison type Direct or Inverse. The higher/lower value higher/lower severity (-c 0 ó 1)
Monitoring interval 1 second – 1 hour –> depends on instance importance
Warning threshold X
Alert threshold Y

Parameter setting example:

EM01BTEM = -t 3 -c 0 -w 21 -a 24 -U "C" - T "Temperature of E21"

Remarks: None

EM01BHUM

This EM01BHUM event returns Relative Humidity percentage data of the sensor.

Return values:

VALUE MEANING
-1 Error
0 - 100 % of Relative Humidity

Recommended parameters:

Comparison type Direct or Inverse. The higher/lower value higher/lower severity (-c 0 ó 1)
Monitoring interval 1 seconds – 1 hour –> depends on instance importance
Warning threshold X
Alert threshold Y

Parameter setting example:

EM01BHUM = -t 60 -c 1 -w 45 -a 30 -T "Humidity of E21"

Remarks: None

EM01BLUX

This EM01BLUX event returns Illumination data (measured in lux) of the sensor.

Return values:

VALUE MEANING
-1 Error
X Number of lux

Recommended parameters:

Comparison type Direct or Inverse. The higher/lower value higher/lower severity (-c 0 ó 1)
Monitoring interval 1 second – 1 hour –> depends on instance importance
Warning threshold X
Alert threshold Y

Parameter setting example:

EM01BLUX = -t 60 -c 0 -w 50 -a 80 -T "Illumination of E21"

Remarks: http://es.wikipedia.org/wiki/Lux

Prerequisites of the Sequoia EM01B

In order to compile, this agent requires a set of prerequisites, which are generic to compile any Osmius agent, you can see these prerequisites.

Makefiles and Compiling Sequoia EM01B sensor agent

  • Make Project Creator (MPC) is used by Osmius, so creating Makefiles is a trivial task. If you want to learn more about MPC and Osmius check out the section of Makefiles on Osmius.
  • In this Sequoia Em01B sensor agent you can generate Makefile in this way:

From the agent directory using console or terminal.

Para Linux:

$ACE_ROOT/bin/mpc.pl -type make osm_ag_sequoia_em01b.mpc

Para HP-UX / Solaris:

$ACE_ROOT/bin/mpc.pl -type gnuace osm_ag_sequoia_em01b.mpc

Para Windows con Visual C 8:

%ACE_ROOT%\bin\mpc.pl -type vc8 osm_ag_sequoia_em01b.mpc
  • Now that you have created the Makefile, agent compiling is extremely simple.

Para Linux:

make -f Makefile.Osm_Ag_Sequoia_Em01b_Osmius

Para HP-UX:

gmake -f Makefile.Osm_Ag_Sequoia_Em01b_Osmius

Para Windows:

Double click over Osm_Ag_Sequoia_Em01b_Osmius.vcproj In the solution configuration select Release. Click on Rebuild to compile.

Binaries are automatically installed in the bin directory of OSM_ROOT base directory.

Running the agent

Sequoia EM01B agent has the same running features of the other Osmius agents. You can check it out int he section Start and Stop Agents.

To run the agent without Osmius web console:

osm_ag_SEQEM01B[.exe]1) -c osm_ag_SEQEM01B.ini -m MASTERAG -p 1950 -d [>> osm_ag_seqem01b.log]2)

Running in standalone mode

Sequoia EM01B osmius agent, like the others Osmius agents, allows the execution in standalone mode. This option may be particularly useful when developing a new agent or to perform specific agent tests.

Basically you have to add a new value, called SNDCMD, to Osmius agent configuration file agente de Osmius para Sequoia EM01B (osm_ag_SEQEM01B.ini) as shown here.

Then you must run the agent setting Master Agent communications port to zero, for example:

osm_ag_SEQEM01B[.exe] -c osm_ag_SEQEM01B.ini -m 00000000 -p 0 -d

Tests list

Test performed to agent de Osmius para Sequoia EM01B.

Date: 26/11/2008
Test Result Remarks
Creating an instance with all its events in silent mode OK N/A
Creating an instance with all its events with custom text OK N/A
Creating an instance with all its events but no custom text OK N/A
Declaración de 3 instancias con todos sus eventos a 5 seconds y mantenerlo
running for 48 hours
OK Without memory leaks
Declare 2 instances, cause a disconnect and then reconnectX we only test with one sensor
Declare 1 instance and test each event OK Don't work in solaris
Elimination of general parameter and check unbootable OK N/A
Elimination of instance CONN_INFO and check unbootable OK N/A
1) In windwos system is .exe
2) Optional, to store agent messages in a file
 
en/agentes/seqem01b.txt · Last modified: 2012/12/12 08:07 by osmius
 
Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki