last edited June 8, 2001

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

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. You may call up this URL to view the associated GUI client:

Terra GUI at: http://www.terra-bytes.com/snw2/client_percent.html

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.