--- projects/cms/source/ihost/README 2002/06/01 19:44:10 1.2 +++ projects/cms/source/ihost/README 2003/03/03 14:28:54 1.3 @@ -1,8 +1,16 @@ 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.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 ------------------------- @@ -18,12 +26,17 @@ 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 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 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; @@ -38,10 +51,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? ---------