--- projects/cms/source/ihost/README 2002/06/01 19:44:10 1.2 +++ projects/cms/source/ihost/README 2003/05/20 13:57:47 1.5 @@ -1,11 +1,23 @@ i-scream central monitoring system - ihost README -http://www.i-scream.org.uk +http://www.i-scream.org -$Id: README,v 1.2 2002/06/01 19:44:10 tdb Exp $ +$Id: README,v 1.5 2003/05/20 13:57:47 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; @@ -39,14 +57,10 @@ Running ihost with the -h flag will provide a list of 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? --------- -Please send all questions, problems, and bugs to dev@i-scream.org.uk. We +Please send all questions, problems, and bugs to dev@i-scream.org. We will do our best to help. Thank-you for using i-scream software.