This is the graphing stuff for the backup system.  This will only work
if you are using dump for your backups, and requires that you have
gnuplot installed on your system somewhere.

The graphs and associated data will be stored in a directory of your
choice (see the installation instructions below).  There will be 3
subdirectories which store 3 versions of the data:

    Current		data about backups in the database now.
    Merged		all the data we've ever collected.
    Recent		last 31 days of data from Merged.

To view all of the graphs in a particular group, cd to that 
directory and run "gnuplot *.gp" or something like that.

Each of these directories contains the following graphs.  Gnuplot
scripts are named *.gp, postscript output from gnuplot suitable for
printing are named *.ps.

    runsize-rank-level0		Run size (kb) in rank order for level 0 runs.
    runsize-rank-level2		ditto, level 2
    runsize-rank-level9		ditto, level 9
    runsize-rank-lines		Run size (kb) in rank order, 3 levels
				plotted against each other
				independantly with lines.  
    runsize-rank		Run size (kb) of 3 levels, color
				coded, in rank order.
    runsize-runid		Run size in run ID order (ordered
				chronologically, color coded levels). 
    runtime-rank		Run time (hours) in rank order (color
				coded levels).
    runtime-runid		Run time (hours) in run ID order,
				color coded.
    uses-tape			Plot of tape uses by tape ID.
    HOST+FS.size-date		Plot of backup sizes by time (seconds,
				sigh) for host HOST, filesystem
				FILESYSTEM (with _ replacing /).

INSTALLATION

1. You'll need to create a directory to put the graphs in.  I suggest
   calling it "backup-graph", stick it in the same file system that
   the backup database is for convenience.  I'll call it GRAPH in
   these instructions.

   Create 3 subdirectories named Current, Merged and Recent. Set all
   with group BACKUP and group write permissions.

2. The data collection program, getdata, will be installed as part of
   the normal backup system.  You need to copy the Makefile, Do-* 
   and mkgr into the GRAPH directory.

3. Edit GRAPH/Makefile and change BDIR to point at the location of the
   backup programs, and GRAPH to point at GRAPH.

4. Some of the stuff is geared specifically toward a system using level 
   0, 2 and 9 backups.  If you do your backups differently, you'll
   have to mess with the Makefile accordingly.

5. The "print" option in the Makefile uses some home grown software -
   you'll have to adjust it for your site.  I've included
   merge-ps-files.  

That should be that.  Running "make current merged recent" in the
GRAPH directory should update the raw data files in each subdirectory
and recreate the gnuplot and postscript graphs.

You might want to set up a crontab entry to run "make current merged
recent" on a daily basis, if for no other reason than to keep the data
in Merged up to date.  Merged contains a complete listing of all of
the data gathered so far.  If you don't run "make current merged"
often enough, backups will timeout without being listed in the
database, and you'll have gaps in your graphs.
