Please note that the following notes apply to the MySQL database version of the collection library.
This page does not apply to any telemetry data collected since the end of January-2013.

Telemetry Web Applications

There are two applications that provide user interface to old MySQL telemetry data.

  • The exporter web application is the primary means of accessing telemetry data. It exports segments of sample streams from a selected measure or telemeter over a selected time interval. The results can be downloaded to the user's desktop.
  • There was previously a monitor web application that displayed graphs of live data as it was being collected. This is no longer available.

Telemetry Web Services

There are three web services intended to provide a software interface to the old MySQL telemetry data.

  • services/gaps - This service finds temporal gaps in a sample stream.
  • services/samples - This service retrieves samples.
  • services/times - This service finds time intervals when the value of a certain measure satisfies a certain constraint.

Notes about the web server (Mar-2013):
  • the web pages are stored on telemetry.lbto.org in /var/lib/tomcat5/webapps/ROOT
  • there are two other directories there, test and new that probably can be deleted
  • the old database-related collection documentation has been saved at /var/lib/tomcat5/webapps/ROOT/collection-doc-r16

Collection API

The collection API provides a software interface for registering telemeters with the data store and sending samples to it. It is implemented as a C++ shared library. The user's manual provides more information for the database version of the collection API.

Troubleshooting

Exporter

  • The log files for the Apache web server are on telweb.lbto.org in /etc/httpd/logs (see specifically the error_log )
  • The tomcat log file is on telemetry.lbto.org in /usr/share/tomcat5/logs/catalina.out

To restart the web server and tomcat for the exporter, go to telweb.lbto.org as root and type:

  service tomcat5 stop
  service httpd stop
  service tomcat5 start
  service httpd start 

Subsystems

Go to the TCS logs/events to see complaints about telemetry. The subsystems will complain if they get backed up.

MCS GUI (available from the TCSGUI) shows a telemetry counter - should be updating if everything's OK.


The currently supported platforms are the following.

  • Linux 2.6.18 or newer running Firefox 3.0.
  • Mac OS X 10.6 or running Safari 4.
  • Windows XP Professional SP 2 or newer running Internet explorer 7 or newer.
  • Windows XP Professional SP 2 or newer running Firefox 3 or newer.

The exporter tool does not work on the following platforms.

  • Mac OS X 10.5 running any browser.
  • Mac OS X 10.6 running Firefox. (I suspect that the tester of this platform did not have java configured correctly.)
  • Linux running Firefox 3.5

-- TonyEdgin - 22 Mar 2012
Topic revision: r13 - 08 May 2014, KelleeSummers
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback