INSTALL for Spackle v0.3
Copyright 2002-3 Jeremy Weatherford, see COPYING for details

Installation instructions for Spackle v0.3...

Requirements:
 - PHP 4.x support in the webserver
 - PostgreSQL running, and pgsql extension in PHP
 - support for MySQL coming soon...
 - RRDtool (http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/)
 - lynx, sed, awk, bash, other misc tools very likely to
   be found on any Linux box.
 - nc (netcat) can be found on rpmfind.net, or floating around the net

Quick install:
as root...
 # adduser spackle
 # mkdir -p /home/spackle/public_html/rrd
 # chown -R spackle /home/spackle/public_html
 # chown apache /home/spackle/public_html/rrd (or whatever Apache runs as)
 # su - spackle

as spackle...
 $ cd ~
 $ tar -xzf spackle-0.3.tgz
 $ cp -R spackle-0.3/html/* ~/public_html  (or wherever)

 - create a new Postgres or MySQL database
 - edit spackle.conf, enter database information (be sure to pick DB type)
 - go to http://localhost/spackle  (or wherever it was installed)
 - enter the default username and password for administrator access
 -  user: 'admin', password: 'potrzebie'
 - Click 'List clients' and click 'admin' to change the password.

To get started by monitoring the webserver...
 - Click 'List targets' and click 'Click to load default...' to load
   some useful targets from html/targets.default.
 - Click 'List clients' and click your webserver's host name, and
   change the password.
 - Modify client/spackle.sh's configuration section, and run it to
   test.  If successful, it shouldn't produce any output.
 - Run client/spackle.sh from spackle's crontab every 5 minutes.

To add other machines to monitor...
 - Add a new client with the new machine's hostname for its user name.
 - Copy client/spackle.sh to the new machine, and update its config
   section if needed.
 - Test it once, then begin running it every 5 minutes from a user's 
   crontab.  (no need to run as root)

In order to make your graphs accessible to the public...
 - Add a new client named 'anonymous', any password (unused), and set
   its perms to at least 'graph'.  If you want your config public,
   include 'view' in his perms.

Additional information
 - client/spackle.sh and client/spackle-root.sh expect to be
   installed in /home/spackle/client.  If they aren't, you'll need to
   edit the top of both files.

More details here eventually... if you have any questions about
installation, please contact xidus@xidus.net for prompt assistance.

Please see 'README' for more info.