User Tools

Site Tools


watcher:watcher

SatSCADA Watcher Service

The SatSCADA Watcher Service is a windows service used to import data into the SatSCADA Cloud. It uses a watched folder, and will upload .CSV and .DBD files to the SatSCADA server.

The Watcher can be installed on the SCADA host computer or on any Windows PC within the customers network.

Watcher Service Software Download

Contact Bentek Systems Support to obtain the version you should be using.

The SatSCADA Watcher software is licensed to the customer by Bentek Systems for use with SatSCADA and SAT100/SAT110 Airtime Subscription.

Install

  1. If you have previously installed the Watcher then first uninstall it.
  2. Download the zip file from the location given to you by customer support.
  3. Unzip the file inside the c:/satscada folder 1).
  4. Set preferences by following the instructions in the Set Preferences section. As a minimum you need to set the username and password that Bentek gave you, and a watched folder path.
  5. Double click watcherInstall.bat to install and start the Watcher windows service.
  6. From the Windows Task Manager verify the SatSCADA Watcher windows service has started.
  7. View the log file to see the activity of the Watcher.

Uninstall

  1. Double click watcherUninstall.bat to stop and uninstall the Watcher windows service.
  2. From the Windows Task Manager verify the SatSCADA Watcher windows service has been removed.
  3. Delete c:/satscada if that is the folder you used for the install.

Stop/Start/Restart

From the Windows Task Manager you can stop, start, and restart the SatSCADA Watcher windows service as you would with any other windows service.

A restart is necessary whenever any configuration parameters are changed, either in the watcher.properties or log4j2.xml files.

Logs

There are a number of logs kept in c:/satscada/watcher/logs. These are time stamped and roll over when the size limit is reached. The current log has the .log extension and can be opened with any text editor. The older logs are archived in .gz format and need to be opened with a tool like 7zip.

Parameters controlling log file generation are in c:/satscada/watcher/log4j2.xml. The following table has the key parameters you might be interested in modifying. The other parameters normally do not need to be changed but if you are interested the detailed format specification of this XML file is at Log4j 2 User Guide.

If you change these you need to restart the SatSCADA Watcher service using the windows task manager.

Element Attribute Description
SizeBasedTriggeringPolicy size Maximum size of a log file (10 MB is recommended).
DefaultRolloverStrategy max Maximum number of log files to retain.
Logger level Trace level. Can be: trace, debug, into, warn, error, fatal, off. Trace provides the most output and off the least. (trace is recommended).

Set Preferences

Configuration parameters are set in the c:/satscada/watcher/watcher.properties file using a text editor. If you change these you need to restart the SatSCADA Watcher service using the windows task manager.

Property Description
tagdata.username Used to authenticate with the satscada server. Provided to you by Bentek.
tagdata.password Encrypted password used to authenticate with the satscada server. The enctryped and unenctryped password will be provided to you by Bentek.
watched.folder The folder monitored by the Watcher. This folder will have three sub-folders: input, archived and error. Files to upload should be placed in “input”.
tagdata.url URL of the import web service on the satscada server. Normally never changed.
1)
If you use another folder name you will need to update the .bat and .xml files
watcher/watcher.txt · Last modified: 2015/06/16 15:12 by jmoore