--- projects/cms/source/ihost/README 2002/06/01 19:44:10 1.2 +++ projects/cms/source/ihost/README 2003/03/29 18:05:07 1.4 @@ -1,11 +1,23 @@ i-scream central monitoring system - ihost README http://www.i-scream.org.uk -$Id: README,v 1.2 2002/06/01 19:44:10 tdb Exp $ +$Id: README,v 1.4 2003/03/29 18:05:07 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 @@ -18,12 +30,18 @@ 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 allows you to specify the location of the PID file. The second -allows you to specify the maximum UDP packet size, although you shouldn't -need to change this in normal circumstances. +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; @@ -38,10 +56,6 @@ 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. - -You may wish to run ihost as a daemon, and the ihostchk.sh script helps -to ensure it's kept running. Alter the details at the top of this script -and add it to your crontab. Problems? ---------