| 1 | tdb | 1.1 | i-scream central monitoring system - ihost README | 
 
 
 
 
 | 2 |  |  | http://www.i-scream.org.uk | 
 
 
 
 
 | 3 |  |  |  | 
 
 
 
 
 
 
 
 | 4 | tdb | 1.3 | $Id: README,v 1.2 2002/06/01 19:44:10 tdb Exp $ | 
 
 
 
 
 | 5 |  |  |  | 
 
 
 
 
 | 6 |  |  | Description | 
 
 
 
 
 | 7 |  |  | ----------- | 
 
 
 
 
 | 8 |  |  |  | 
 
 
 
 
 | 9 |  |  | ihost is a host for the i-scream central monitoring system. It's task | 
 
 
 
 
 | 10 |  |  | is to collect information about the machine it runs on and report it | 
 
 
 
 
 | 11 |  |  | to the server for monitoring. It makes use of the external libstatgrab | 
 
 
 
 
 | 12 |  |  | library for collecting this information. | 
 
 
 
 
 
 
 
 | 13 | tdb | 1.1 |  | 
 
 
 
 
 | 14 |  |  | Building and Installation | 
 
 
 
 
 | 15 |  |  | ------------------------- | 
 
 
 
 
 | 16 |  |  |  | 
 
 
 
 
 | 17 |  |  | After downloading and extracting ihost, configure and build as follows; | 
 
 
 
 
 | 18 |  |  |  | 
 
 
 
 
 | 19 |  |  | ./configure | 
 
 
 
 
 | 20 |  |  | make | 
 
 
 
 
 | 21 |  |  |  | 
 
 
 
 
 | 22 |  |  | Then install as root; | 
 
 
 
 
 | 23 |  |  |  | 
 
 
 
 
 | 24 |  |  | make install | 
 
 
 
 
 | 25 |  |  |  | 
 
 
 
 
 
 
 
 | 26 | tdb | 1.2 | You may wish to use one of the following configure options to change | 
 
 
 
 
 
 
 
 | 27 | tdb | 1.1 | aspects of this process; | 
 
 
 
 
 | 28 |  |  |  | 
 
 
 
 
 
 
 
 | 29 | tdb | 1.3 | --with-libstatgrab-prefix=PATH | 
 
 
 
 
 
 
 
 | 30 | tdb | 1.1 | --with-pid-file=FILE | 
 
 
 
 
 
 
 
 | 31 | tdb | 1.3 | --with-log-file=FILE | 
 
 
 
 
 
 
 
 | 32 | tdb | 1.1 | --with-max-udp-size=SIZE | 
 
 
 
 
 | 33 |  |  |  | 
 
 
 
 
 
 
 
 | 34 | tdb | 1.3 | The first allows you to specify the prefix to the libstatgrab library | 
 
 
 
 
 | 35 |  |  | if it's not in a standard place. The next two give you the option of | 
 
 
 
 
 | 36 |  |  | changing the location of the PID file, and changing the location of the | 
 
 
 
 
 | 37 |  |  | log file. The last option allows you to change the maximum size of the | 
 
 
 
 
 | 38 |  |  | UDP packets ihost sends to the server, although you shouldn't need to | 
 
 
 
 
 | 39 |  |  | change this in normal circumstances. | 
 
 
 
 
 
 
 
 | 40 | tdb | 1.1 |  | 
 
 
 
 
 | 41 |  |  | There are, of course, the usual GNU-style configure options; | 
 
 
 
 
 | 42 |  |  |  | 
 
 
 
 
 | 43 |  |  | --prefix=PREFIX | 
 
 
 
 
 | 44 |  |  |  | 
 
 
 
 
 | 45 |  |  | For more documentation on the installation process, please read the | 
 
 
 
 
 | 46 |  |  | INSTALL document. | 
 
 
 
 
 | 47 |  |  |  | 
 
 
 
 
 | 48 |  |  | Running ihost | 
 
 
 
 
 | 49 |  |  | ------------- | 
 
 
 
 
 | 50 |  |  |  | 
 
 
 
 
 | 51 |  |  | Running ihost with the -h flag will provide a list of options. You will | 
 
 
 
 
 | 52 |  |  | need to know the address and port number of your i-scream server's filter | 
 
 
 
 
 | 53 |  |  | manager. These details should be given on the command line to ihost. | 
 
 
 
 
 | 54 |  |  |  | 
 
 
 
 
 | 55 |  |  | Problems? | 
 
 
 
 
 | 56 |  |  | --------- | 
 
 
 
 
 | 57 |  |  |  | 
 
 
 
 
 | 58 |  |  | Please send all questions, problems, and bugs to dev@i-scream.org.uk. We | 
 
 
 
 
 | 59 |  |  | will do our best to help. | 
 
 
 
 
 | 60 |  |  |  | 
 
 
 
 
 | 61 |  |  | Thank-you for using i-scream software. |