On startup, ewgapagent reads the configuration file named on the command line. The ewgapagent feeds parametric data about trace_buf packets it observes in the specfied wave_ring to a SeisNetWatch NSI server. The ewgapagent only sends information when it finds a gap. The ewgapagent does not have a heartbeat, yet!
As always, the configuraton file contains comments:
Command names may be typed in the control file exactly as shown in this document (case of the command is irrelevant).# marks the line as a comment (example: # This is a comment).
# This is the ewgapagent.d that accompanies the ewgapagent for SeisNetWatch. # SeisNetWatch is an open source product created by ISTI (all rights reserved). # SeisNetWatch may be used freely by any Academic Institution or the USGS. # For more information on this product contact us. # Earthworm setup details ModuleName MOD_EWGAPAGENT LoggingLevel 1 # 0 for off, 1 for on RingName WAVE_RING UseNumericIPs 1 # 1 for CORBRA BOA to use numeric IPs # instead of host names (needed if # local host name is not in DNS) # agent specific info # agent name should be unique (no whitespace for any of the next 3 values!) AgentName TestAgentEW1 Region NewYork Installation ISTI
# Usage Level is needed if not running a csagent...almost # every installation should have this set to Full which for # the initial setup is 4 UsageLevel 4 # Exclude any channels from gap analysis that start # with EH in this example....because these are # triggered here. ExcludeChannels EH # The CORBA event channels used for the NSI # these should point to the host where the NSI is running StaticGetEventChannel iiop://terra-bytes.com:10011/DefaultEventChannel DynamicEventChannel iiop://terra-bytes.com:10012/DefaultEventChannel StaticEventChannel iiop://terra-bytes.com:10013/DefaultEventChannel # the following are only used for debugging DebugLogDir /home/rtem/tnw/log # log directory DebugMode 0 # 0=off, 1=stderr, 2=file DebugLevel 0 # 1-3 (3 most verbose)
Earthworm system setup: ModuleName required RingName required LoggingLevel required AgentName required Region required Installation required ExcludeChannels optional SeisNetWatch Communications: StaticGetEventChannel optional StaticEventChannel optional DynamicEventChannel optional UsageLevel optional UseNumericIPs optional SeisNetWatch Debugging: DebugLogDir optional DebugLevel optional DebugMode optional DPTimeout optional
command arg1 processed by function
AgentName name Earthworm setup
This is the unique name for this agent. No other agents in system should share this name.Default: none, required option USGS: AgentName Caltech_k2ew_monitor
DebugLogDir directory_name Earthworm setup
This is used only for ewgapagent debugging and is separate from Earthworm logging. It should only be used to debug the ewgapagent process. If the DebugMode is set to 2, then the debug log is built using the AgentName.log.Default: none, optional Example: DebugLogDir /some/directory/log
DebugLevel level Earthworm setup
This parameter sets the verbosity of ewgapagent debugging messages. This is used only for ewgapagent debugging and is separate from Earthworm logging. This is the verbosity level of logging from 0 to 3, with 3 being the most verbose.Default: 0, optional Example: DebugLevel 3
DebugMode mode Earthworm setup
This parameter sets output of ewgapagent debugging messages. This is used only for ewgapagent debugging and is separate from Earthworm logging. A value of 0 turns off ewgapagent debugging, a value of 1 spews the messages to stderr, and a value of 2 sends the messages to a log file named AgentName.logDefault: 0, optional Example: DebugMode 0
DPTimeout Useconds DP thread
This parameter sets time delay in micro seconds between each DP message being sent. The default value is 500 and this should not be tampered with unless you have experience with the event channel mechanism of CORBA.Default: 0, optional Example: DebugMode 0
DynamicEventChannel iiop_string DP thread
This is the IIOP specification for the CORBA event channel used to send dynamic parameter responses to the SeisNetWatch NSI server. This should be set to the same value as the one configured for the NSI server (see the value for "DynAgentEventService" in the 'orb.config' file in the NSI server's 'conf' directory).Default: none, optional Example: DynamicEventChannel iiop://nsi.gps.caltech.edu:10022/DefaultEventChannel
ExcludeChannels CC DP thread
This parameter defines any channels that first 1 or 2 or 3 chars start with the characters indicated. The default value is no exclusion (all channels). This is most useful to exclude triggered channels from the gap analysis. For example, say all of the EH channels are triggered and you only care about monitoring BH_ channels, then ExcludeChannels should be set to EH.Default: optional Example: ExcludeChannels EH
Installation name Earthworm setup
This is reported by the ewgapagent and is simply informative to the end user as to where this agent is reporting from. Installation is defined as the group running the ewgapagent.Default: none, required option USGS: Installation CalTech
LoggingLevel switch Earthworm Setup
Sets the on-off switch for writing a log file to disk. If switch is 0, no log file will be written. If switch is 1, ewgapagent will write a daily log file(s) called ewgapagent.log_yymmdd where xx is ewgapagent's module id (set with "ModuleName" command) and yymmdd is the current UTC date (ex: 960123) on the system clock. The file(s) will be written in the EW_LOG directory (environment variable).Default: none
ModuleName mod_id Earthworm setup
Sets the module id for labeling all outgoing messages. mod_id is a character string (valid strings are listed in 'earthworm.d') that relates (in 'earthworm.d') to a unique single-byte number.Default: none USGS: ModuleName MOD_EWAGENT
Region name Earthworm setup
This is reported by the ewgapagent and is simply informative to the end user as to where this agent is reporting from. Region is intended to define a number of installations.Default: none, required option USGS: Region SouthernCalif
RingName ring Earthworm setup
This is the ring into which the waveforms and messages are sent.Default: none, required option USGS: RingName WAVE_RING
StaticEventChannel iiop_string DP thread
This is the IIOP specification for the CORBA event channel used to send static parameter responses to the SeisNetWatch NSI server. This should be set to the same value as the one configured for the NSI server (see the value for "StatAgentEventService" in the 'orb.config' file in the NSI server's 'conf' directory).
This event channel is not currently used by the ewgapagent.Default: none, optional Example: StaticEventChannel iiop://nsi.gps.caltech.edu:10023/DefaultEventChannel
StaticGetEventChannel iiop_string DP thread
This is the IIOP specification for the CORBA event channel used to listen for static parameter queries from the SeisNetWatch NSI server. This should be set to the same value as the one configured for the NSI server (see the value for "CaRequestEventService" in the 'orb.config' file in the NSI server's 'conf' directory).Default: none, optional Example: StaticGetEventChannel iiop://nsi.gps.caltech.edu:10021/DefaultEventChannel
UsageLevel level Earthworm setup
SeisNetWatch expects at least one of its agents to establish the "usage level" for any given station, which can be used to indicate the mode of the station's acquisition software. This NSI definable parameter is a numeric value. For the USGS installation, set the UsageLevel to 1. For the other SeisNetWatch installations (where the 'csagent' is being used), this command should be omitted.Default: none, optional USGS: UsageLevel 1
UseNumericIPs switch Earthworm setup
When 'UseNumericIPs' is set to 1, the ORBacus CORBA implementation is prevented from attempting to use the canonical name of the local host when connecting to the event channels. On machines whose names are not resolvable via DNS, having 'UseNumericIPs' set to 1 prevents a 'COMM_FAILURE' exception error from occurring.Default: 1 USGS: UseNumericIPs 1
The ewgapagent does not have .desc file because it does not issue a heartbeat as yet. It will run forever or until the Earthworm system is stopped/restarted.