ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/i-scream/projects/cms/source/ihost/README
(Generate patch)

Comparing projects/cms/source/ihost/README (file contents):
Revision 1.2 by tdb, Sat Jun 1 19:44:10 2002 UTC vs.
Revision 1.4 by tdb, Sat Mar 29 18:05:07 2003 UTC

# Line 3 | Line 3 | http://www.i-scream.org.uk
3  
4   $Id$
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 +
14   Building and Installation
15   -------------------------
16  
17 + First download and install libstatgrab and libukcprog. These two
18 + libraries are used by ihost, and other i-scream packages. They should
19 + be available from the same place as ihost.
20 +
21   After downloading and extracting ihost, configure and build as follows;
22  
23   ./configure
# Line 18 | Line 30 | make install
30   You may wish to use one of the following configure options to change
31   aspects of this process;
32  
33 +  --with-libstatgrab-prefix=PATH
34 +  --with-libukcprog-prefix=PATH
35    --with-pid-file=FILE
36 +  --with-log-file=FILE
37    --with-max-udp-size=SIZE
38  
39 < The first allows you to specify the location of the PID file. The second
40 < allows you to specify the maximum UDP packet size, although you shouldn't
41 < need to change this in normal circumstances.
39 > The first two allow you to specify the prefix to the libstatgrab and
40 > libukcprog libraries if they're not in a standard place. The next two
41 > give you the option of changing the location of the PID file, and
42 > changing the location of the log file. The last option allows you to
43 > change the maximum size of the UDP packets ihost sends to the server,
44 > although you shouldn't need to change this in normal circumstances.
45  
46   There are, of course, the usual GNU-style configure options;
47  
# Line 38 | Line 56 | Running ihost
56   Running ihost with the -h flag will provide a list of options. You will
57   need to know the address and port number of your i-scream server's filter
58   manager. These details should be given on the command line to ihost.
41
42 You may wish to run ihost as a daemon, and the ihostchk.sh script helps
43 to ensure it's kept running. Alter the details at the top of this script
44 and add it to your crontab.
59  
60   Problems?
61   ---------

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines