--- projects/cms/source/ihost/README 2002/05/30 16:31:32 1.1 +++ 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.1 2002/05/30 16:31:32 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 ------------------------- @@ -15,15 +23,20 @@ Then install as root; make install -You may which to use one of the following configure options to change +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 which 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 cron. Problems? ---------