modules/monitor/README.TXT

MONITOR

OVERVIEW

This small module interfaces with RRDTOOL to create a simple
network / server monitoring system.

It gathers data on a regular basis through the use of snmpget()
and stores it in round-robin databases.  This data can then be
graphed in a variety of ways.

SYSTEM REQUIREMENTS

To run this moddule you will need:
	A working drupal installation of at least version 4.7
		using MySQL
	RRDTool - http://oss.oetiker.ch/rrdtool/
	PHP's SNMP extensions
	

INSTALLATION

Install RRDTOOL and note where the binary is located (usually
either /usr/bin/rrdtool or /usr/local/bin/rrdtool).

Install the MySQL tables for the module in the usual way:
	mysql -u drupal -pdrupal drupal < monitor.mysql

Edit the monitor.module script to make sure the path to
rrdtool is correct - in future this will be a configuration
item but it isn't yet.

Enable the module in the admin system

* NOTE ON CRON *
Cron should be running every 5 minutes for this module to
be able to reliably obtain the data it needs for the graphing.

CONFIGURATION

All the configuration of monitor is done through admin/settings/monitor

In there you can add server and SNMP OID values as monitors, map
two together as mappings, and place those mappings onto graphs, which
in turn you can group together into pages.
1	MONITOR
2
3	OVERVIEW
4
5	This small module interfaces with RRDTOOL to create a simple
6	network / server monitoring system.
7
8	It gathers data on a regular basis through the use of snmpget()
9	and stores it in round-robin databases. This data can then be
10	graphed in a variety of ways.
11
12	SYSTEM REQUIREMENTS
13
14	To run this moddule you will need:
15	A working drupal installation of at least version 4.7
16	using MySQL
17	RRDTool - http://oss.oetiker.ch/rrdtool/
18	PHP's SNMP extensions
19
20
21	INSTALLATION
22
23	Install RRDTOOL and note where the binary is located (usually
24	either /usr/bin/rrdtool or /usr/local/bin/rrdtool).
25
26	Install the MySQL tables for the module in the usual way:
27	mysql -u drupal -pdrupal drupal < monitor.mysql
28
29	Edit the monitor.module script to make sure the path to
30	rrdtool is correct - in future this will be a configuration
31	item but it isn't yet.
32
33	Enable the module in the admin system
34
35	* NOTE ON CRON *
36	Cron should be running every 5 minutes for this module to
37	be able to reliably obtain the data it needs for the graphing.
38
39	CONFIGURATION
40
41	All the configuration of monitor is done through admin/settings/monitor
42
43	In there you can add server and SNMP OID values as monitors, map
44	two together as mappings, and place those mappings onto graphs, which
45	in turn you can group together into pages.