SNW ReftekAgent

ISTI's ReftekAgent provides a monitoring solution for RefTek RT130's being fed through an rtpd server. It allows RT130's many status parameters to be sent to a SNW server to be evaluated.

reftekagent.d - configuration file

This agent uses an Earthworm style .d file that has the following setable parameters:

• ModuleName - The name of the module in the earthworm.d file. (REQUIRED)
• RTPDaddr - The IP address of the rtpd server. (REQUIRED)
• RTPDport - The IP port of the rtpd server. (optional, defaults to 2543)
• LoggingLevel - Set to 1 if the earthworm logging is desired. (optional)
• RingName - The ring in which to inject heartbeats.
• SCNLfile - The reftek.sncl file used by reftek2ew. This maps the unit number to a network and station code (REQUIRED).
• PollInterval - The interval in seconds between polling for the various reftek commands.
• AgentName - The name of the reftek agent. This must be unique in an installation.
• Region - The location of where the reftek agent is running.
• Installation - The installation of where the reftek agent is running.
• StaticGetEventChannel - The CORBA iiop string for the Static parameter retrieval (not used yet).
• DynamicEventChannel - The CORBA iiop string for the Dynamic parameter sending (REQUIRED).
• StaticEventChannel - The CORBA iiop string for the Static parameter sending (REQUIRED).

Here is an example reftekagent.d file:

                 ModuleName     MOD_REFAGENT
                 RTPDaddr       130.118.43.52
                 RPTDport       2543
                 LoggingLevel   1
                 RingName       HYPO_RING
                 SNCLfile       reftek.scnl

                
                 PollInterval   600
                 AgentName      ReftekAgentEW
                 Region         NoCal
                 Installation   USGS-Menlo
                
StaticGetEventChannel iiop://130.118.43.38:10201/DefaultEventChannel
DynamicEventChannel iiop://130.118.43.38:10202/DefaultEventChannel
StaticEventChannel iiop://130.118.43.38:10203/DefaultEventChannel
                
                 DebugLogDir            /ebird/isti/log
		# 0=off, 1=stderr, 2=file
                 DebugMode              0	
                 DebugLevel             0
                DPTIMEOUT   500

Parameters output by the ReftekAgent

• Reftek Time of Poll - The time of the start of the poll for this unit.
• Reftek Unavailable - If the RT130 does not respond, this is set to a value of 1.
• Reftek Unit Number- The HEX value of the unit number (serial number) of the unit.
• Reftek, Secs Since Last Available - This is the number of seconds since the unit was reachable by the agent.
• Reftek Input Volts - The voltage for the Input of the RefTek.
• Reftek Backup Volts - The backup voltage of the RefTek.
• Reftek Temperature Celsius - The internal temperature of the RefTek.
• Reftek Unit Status observed at - The time at which the Unit's Status command was requested (SS US command).
• Reftek GPS Clock Status observed at - The time at which the Clock Status command was requested (SS XC command).
• Reftek GPS Status - L for Locked or U for Unlocked.
• Reftek GPS Mode - GPS mode, C for continuous or D for duty cycle.
• Reftek GPS On - Set to Y if the GPS is on at time of request.
• Reftek GPS Secs Since Last Lock - The number of seconds since the GPS clock last locked.
• Reftek GPS Latitude - The GPS derived latitude.
• Reftek GPS Longitude - The GPS derived longitude.
• Reftek GPS Elevation in meters - The GPS derived elevation.
• Reftek GPS Satellites Used - The number of Satellite Vehicles used by the GPS clock.
• Reftek Acquisition Status observed at - The time at which the SS AQ command was issued (ram state).
• Reftek RAM Available Kb - The ram available in Kilobytes.
• Reftek RAM Total Kb - The total ram in Kilobytes.
• Reftek RAM Used Kb - The ram used by the RT130, in Kilobytes.
• Reftek Acquisition Active - Set to 1 if the acquisition is active.
• Reftek Version Status observed at - The time at which the SS VS command was sent to get the CPU version.
• Reftek CPU Version - The CPU firmware version.
• Reftek Disk Status observed at - The time at which the SS DK command was sent.
• Reftek Disk 1 Megs Total - The Disk 1 total size in Megabytes.
• Reftek Disk 1 Megs Used - The Disk 1 used size in Megabytes.
• Reftek Disk 1 Megs Available - The Disk 1 available size in Megabytes.
• Reftek Disk Wrap Enabled - If the disk wrap was enabled this is set to 1.