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.