README for the larrd hack to produce dynamic graphs
---------------------------------------------------

First and foremost, you'll need to be pretty familiar
with Big Brother from http://bb4.com and larrd from
http://larrd.packetpushers.com. Next you should feel
comfortable modifying Bourne shell scripts, as that's
almost entirely what Big Brother and larrd are composed
of (larrd uses perl too, but you shouldn't need to
change any of those scripts).

The larrd-html.sh script needs a little work. It has a
case-esac loop where it figures out whether to generate
a link to a dynamic PNG. It counts on the fact that the
regular "larrd-graph.sh" in $BBEXT/larrd has been run
before. This means that there's graphs for the host in
$BBHOME/www/graphs. If larrd-html.sh finds the graphs
for the host in question, it generates the dynamic link.

In order to scan the $BBHOME/rrd directory for rrd's on
the host in question, instead of using the graphs, will
now be easy, since you can use wildcards in case-esac 
loops/contructs. I'll have this done soon, but if
someone wants to beat me to it, go ahead. It will be
much cleaner than depending on prebuilt graphs on the
graphs directory.

This has only been used with the apache web server, and
I don't know how other web servers pass arguments to 
scripts, so you're on your own there. If you're using 
apache, and you've got a cgi-bin called "cgi-bin", this
should work pretty easily.

Extra BB tests:
---------------
Included are client tests for memory and cpu usage. The 
larrd scripts that collect data for and generate graphs
(on the BBDISPLAY) for memory and swap rely on the memory 
test being run on the BB clients. Put "mem cpuuse" in the
BBEXT variable in $BBHOME/runbb.sh to run the scripts on
the clients (assuming, of course, that you put the scripts
themselves in the $BBHOME/ext directory first). The cpuuse
and "mem" columns will automatically show up on the 
BBDISPLAY host.

Where to put the scripts:
-------------------------
The scripts in the "cgi-bin" subdirectory should go in your
webserver's cgi-bin. The scripts in "client-tests" should
go in $BBHOME/ext on your BB clients. The scripts in "larrd"
should go in $BBHOME/ext/larrd.

That's all I can think of right now, don't feel bashful about
sending questions to nate@campin.net if I didn't explain
anything well enough.

Even better, send it to the larrd mailing list,
larrd@packetpushers.com, as I'm subcribed to it.

Nate Campi