$Id: INSTALL 43 2006-02-04 14:39:43Z dewitge $
MySQL Activity Report
----------------------------------------------------------------------

RPM based i386 systems
----------------------
If you've got an i386 and RPM based system such as RedHat, Suse or Fedora
linux, you can install the binary rpm if it's available from 
http://www.sos.be/mysqlard/ using your distributions graphical installer or
by issueing : rpm -ihv mysqlard-X.X-X.i386.rpm

If you want the mysqlard daemon to start at boot time, you can issue the
"chkconfig --level 345 mysqlard on" if chkconfig is installed. Make sure
that the mysql daemon starts before mysqlard.

RPM based system
----------------
If you've got a non i386 RPM based system you can rebuild the source RPM with:
rpmbuild --rebuild mysqlard-X.X-X.src.rpm
or you can build the RPM for your architecture from the tar.gz file with:
rpmbuild -ta mysqlard-X.X.X.tar.gz

Tarball install
---------------
If you want to install from the tarball source you'll have to use the usual
(in Open Source Sofware that is ;-) ) configure, make, make install cycle.

The usual configure options are available, but the important ones are:
--bindir=DIR     : where the helper scripts will be installed
--sbindir=DIR    : where the daemon binary will be installed
--datadir=DIR    : the default directory where the rrd and graph files will be
                   created, the sample php scripts and daemon init script will
                   end up there too
--sysconfdir=DIR : where the config file will be installed

If you installed rrdtool and/or MySQL in a non default location you can use
these configure options to specify the base path of your installations:
--with-rrd=PATH  : set the full path to your rrdtool installation
--with-mysql=PATH: set the full path to your mysql installation

the configure command used in the RPM (and the preferred config) is:
./configure --prefix=/usr --sysconfdir=/etc --datadir=/var/lib

If the prerequisites are met you can build the package with:
make

and install with:
make install

If you want the mysqlard daemon to start at boot time you should include the
mysqlard.server script in your rc system. Make sure you start it after the
MySQL server is started. The daemon needs a running MySQL daemon to start, but
can cope with a MySQL server that goes down and returns.

Don't forget to check the sample scripts (cron and php) in --datadir before you
start writing your own.

Report bugs to <gert.dewit@sos.be>.