[ViewVC] Annotation of: i-scream/projects/cms/source/ihost/README

i-scream central monitoring system - ihost README
http://www.i-scream.org.uk

$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
-------------------------

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
make

Then install as root;

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 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;

  --prefix=PREFIX

For more documentation on the installation process, please read the
INSTALL document.

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.

Problems?
---------

Please send all questions, problems, and bugs to dev@i-scream.org.uk. We
will do our best to help.

Thank-you for using i-scream software.
Revision:	1.4
Committed:	Sat Mar 29 18:05:07 2003 UTC (22 years, 7 months ago) by tdb
Branch:	MAIN
CVS Tags:	IHOST_1_5_5, IHOST_1_5_4
Changes since 1.3:	+12 -7 lines
Log Message:	ihost now makes use of an external copy of libukcprog. This is available as a seperate download. All files updated accordingly to make this version 1.5.4.
#	User	Rev	Content
1	tdb	1.1	i-scream central monitoring system - ihost README
2			http://www.i-scream.org.uk
3
4	tdb	1.4	$Id: README,v 1.3 2003/03/03 14:28:54 tdb Exp $
5	tdb	1.3
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	tdb	1.4	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	tdb	1.1	After downloading and extracting ihost, configure and build as follows;
22
23			./configure
24			make
25
26			Then install as root;
27
28			make install
29
30	tdb	1.2	You may wish to use one of the following configure options to change
31	tdb	1.1	aspects of this process;
32
33	tdb	1.3	--with-libstatgrab-prefix=PATH
34	tdb	1.4	--with-libukcprog-prefix=PATH
35	tdb	1.1	--with-pid-file=FILE
36	tdb	1.3	--with-log-file=FILE
37	tdb	1.1	--with-max-udp-size=SIZE
38
39	tdb	1.4	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	tdb	1.1
46			There are, of course, the usual GNU-style configure options;
47
48			--prefix=PREFIX
49
50			For more documentation on the installation process, please read the
51			INSTALL document.
52
53			Running ihost
54			-------------
55
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.
59
60			Problems?
61			---------
62
63			Please send all questions, problems, and bugs to dev@i-scream.org.uk. We
64			will do our best to help.
65
66			Thank-you for using i-scream software.