last edited June 25, 2012
ewagent Installation HOWTO
This document contains a simple set of instructions to get ewagent installed
and running. These instructions assume you have the latest SeisNetWatch
package installed. Most of the files refered to in these instructions can
be found in the directory 'agents/bin.Solaris' (for Solaris OS) or 'agents/bin.NT'
(for Windows NT OS).
NOTE that this installation will send a data stream to an NSI
server at ISTI.com. If you do not wish to use our server as a test, then
change the StaticGetEventChannel, DynamicEventChannel and StaticEventChannel
parameters in the ewagent.d file to reflect your site's NSI server's event
channel port numbers:
-
For SOLARIS only: Switch user to root ("su root") and copy the file
'SeisNetWatch/agents/bin.Solaris/libstdc++.so.2.10.0' to '/usr/local/lib'
-
Copy the 'ewagent' (or 'ewagent.exe') exectuable file to your Earthworm
'bin' directory
-
Copy the files 'ewagent.desc' and 'ewagent_terra.d' to your Earthworm 'param'
directory
-
Edit the example 'ewagent_terra.d' file and change ONLY the following parameters:
-
WaveRing - name of your Wave Ring
-
ModuleName - name of your module for this agent
-
AgentName - a one word unique agent description (NO SPACES)
-
Installation - a one word description of your installation (NO SPACES)
-
Region - a one word description of your region (NO SPACES)
-
DynamicEventChannel (optional) - the IIOP value for the "DynAgentEventService"
entry of your NSI server's 'orb.config' file (if you do not wish to use
the ISTI NSI server)
-
StaticEventChannel (optional) - the IIOP value for the "StatAgentEventService"
entry of your NSI server's 'orb.config' file (if you do not wish to use
the ISTI NSI server)
-
StaticGetEventChannel (optional) - the IIOP value for the "CaRequestEventService"
entry of your NSI server's 'orb.config' file (if you do not wish to use
the ISTI NSI server)
-
Edit the 'earthworm.d' file and put in the ModuleName you chose above.
Make sure the number for the module is unique to your module set.
-
For SOLARIS only: Edit the Solaris environment file for your Earthworm
installation and add in the LD_LIBRARY_PATH for /usr/local/lib. This is
usually the file named ew_sol_sparc.cmd in the params directory.
(The ewagent executable for NT is statically linked and this step is not
necessary.) Then source the file you just edited: source ew_sol_sparc.cmd
-
Run the program with a command line like this: ewagent ewagent_terra.d
Under Solaris, you can append the '&' symbol to run the program
in the background. Under Windows NT, insert "start " before the beginning
of the command to have it run in its own console window.
-
If your 'ewagent_terra.d' file was configured for our NSI server, please
send us an email to let us know about the data stream.
Note: To configure a new SeisNetWatch NSI server to receive data
only from one or more ewagent programs, its 'stationsFileName' should point
to an empty file (no predefined stations), and its 'ruleset.ini' file should
contain definitions of "Secs Since Last Packet" and "Secs of Latency" for
various channels. A sample 'ruleset_ewagent.ini'
file can be found in the 'docs/examples' directory of the SeisNetWatch'
distribution.
Copyright 2012, Instrumental Software Technologies, Inc.