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

$Id: README,v 1.6 2003/09/26 21:22:44 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
-------------------------

First download and install libstatgrab and libukcprog. These two
libraries are used by ihost, and other i-scream packages. They should
be available from the same place as ihost.

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-libukcprog-prefix=PATH
  --with-pid-file=FILE
  --with-log-file=FILE
  --with-max-udp-size=SIZE

The first two allow you to specify the prefix to the libstatgrab and
libukcprog libraries if they're 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 let us know if you have any problems - support@i-scream.org.

If you find a bug, help us to fix it by sending details to
bugs@i-scream.org. If you have a patch, please send it too.

Thank-you for using i-scream software.
