jfr-masters/code/frontends/plots:
README
coruc.sh
custom.py
fan.dat
nsconfig.py
nsutil.py
plots.conf
plots.py


This directory contains the first bits of code that I wrote to plot
time series. It uses rrdtool to do all of the plotting, which means that
it has to build round-robin databases (RRDs) for each host and each property.

coruc.sh
	RRDtool must be installed

	Contains rrdtool commands to build a RRD to contain data collected
	from coreopsis.cs.uky.edu for number of logged in sessions. I used
	scripts like this early on to build RRDs. Of course, I generated the
	scripts automatically.

custom.py:
	depends on pymysql and nsutil.py

	I wrote this one before I wrote the nsconfig.py config file parser.
	I embed configuration information directly in the top of the file.
	I wrote this program to be used as a CGI script. The program builds
	graphs of one property for several hosts.

nsconfig.py:

	nsconfig.py defines several functions necessary for reading
	configuration files (like mktxt.conf).

nsutil.py:
	depends on pymysql and rrdtool Python packages.
	rrdtool must be installed.

	nsutil.py defines many functions useful for working with the NodeScape
	back-end. 

fan.dat:

	Fan speed information from one of our cluster nodes. A list of 
	<Unix epoch, rpm> pairs.

plots.py:
	depends on pymysql and rrdtool Python packages.
	depends on nsutil.py and nsconfig.py

	Reads an nsconfig.py configuration file and retrieves and then graphs
	computer-health data for all hosts and all stats on those hosts. The
	hosts and stats must be specified in the configuration file. It
	generates png plots for all properties and generates HTML pages for
	all hosts and all properties. This code is terrible, but it works.

plots.conf:

	This file is an examle configuration for plots.py. You'll want to
	substitute your own machines, properties, and database login info.
	
