[ViewVC] Contents 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 (21 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.
#	Content
1	i-scream central monitoring system - ihost README
2	http://www.i-scream.org.uk
3
4	$Id: README,v 1.3 2003/03/03 14:28:54 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
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
24	make
25
26	Then install as root;
27
28	make install
29
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 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
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.