i-scream central monitoring system - ihost README
http://www.i-scream.org.uk

$Id: README,v 1.3 2003/03/03 14:28:54 tdb Exp $

Description
-----------

ihost is a host for the i-scream central monitoring system. It's task
is to collect information about the machine it runs on and report it
to the server for monitoring. It makes use of the external libstatgrab
library for collecting this information.

Building and Installation
-------------------------

After downloading and extracting ihost, configure and build as follows;

./configure
make

Then install as root;

make install

You may wish to use one of the following configure options to change
aspects of this process;

  --with-libstatgrab-prefix=PATH
  --with-pid-file=FILE
  --with-log-file=FILE
  --with-max-udp-size=SIZE

The first allows you to specify the prefix to the libstatgrab library
if it's not in a standard place. The next two give you the option of
changing the location of the PID file, and changing the location of the
log file. The last option allows you to change the maximum size of the
UDP packets ihost sends to the server, although you shouldn't need to
change this in normal circumstances.

There are, of course, the usual GNU-style configure options;

  --prefix=PREFIX

For more documentation on the installation process, please read the
INSTALL document.

Running ihost
-------------

Running ihost with the -h flag will provide a list of options. You will
need to know the address and port number of your i-scream server's filter
manager. These details should be given on the command line to ihost.

Problems?
---------

Please send all questions, problems, and bugs to dev@i-scream.org.uk. We
will do our best to help.

Thank-you for using i-scream software.
