# $Id: INSTALL,v 2.7 2004/09/07 16:47:28 petef Exp $

This is master source.  You need distrib and msrc0 to get started.

You might have to install op first.  The multi-config version from
ksb@sa.fedex.com would be better.  You _must_ have a recent mkcmd
library (check ident on time/tz.m is greater than version 8.2):
	$ ident  /usr/local/lib/mkcmd/time/tz.m
	$Id: INSTALL,v 2.7 2004/09/07 16:47:28 petef Exp $

There should be an API key there, but I never imagined that
Sun would ignore the seconds parameter the gettimeofday(2).


Check any config params in machine.h (look for TUNE_).


To install the startup for this we need to Customize the rrd.m4
file for each new host (or class).

The spell is coded in m4 and run via distrib's @file@ expansion
to fill in the correct disks to monitor.  To add a new host add
a new matching expression for SHORTHOST, remember that we've
changed quotes to +,@ to protect the shell singles in the script.

To add a new class I'd use the "SERVICE" macro, maybe.

We need to install the "vxfs" service op rules:
	/usr/msrc/local/lib/op/service/vxfs.cf

Which contains (presently, at least):
	vxstat		/usr/sbin/vxstat $* ;
			uid=0
			users=.*
			dir=/


To push this to the new server install the defualt target and
use mk on this file to make it so:
	mk -dhost -mPounce INSTALL

Here are the markers that uses:
	$Pounce(*): %b -mRrd -d%s %f && %b -mRestart -d%s %f
	$Rrd(*): ssh %s -l root -n . /usr/local/lib/distrib/local.defs \\&\\& mk -mInstall -dlink /usr/src/local/libexec/rrdisk/rrd 
	$Restart(*): ssh %s -l root -n . /usr/local/lib/distrib/local.defs \\&\\& /etc/init.d/rrd stop \\&\\& /etc/init.d/rrd start \\>/dev/null 2\\>\\&1

And to catch errors:
	$Pounce: : 'we need a -d$HOST on the %b command line' && ${false-false}

N.B.: is the timezone in /etc/default/init is wrong this program will
output data skewed from the system clock (by even hours or half hours).

--
ksb