2007-01-15
Added in Unnoc 1.0.7

Barracuda SPAM Firewall

	1. Introduction
	2. Module Installation
	3. Configuration
	4. Examples

1. Introduction

Unnoc has limited support for the Barracuda SPAM Firewall.  It will
connect to a Barracuda SPAM Firewall and will collect and graph the
following items:

	System Load
	Average Message Latency
	Mail/Log Storage
	Firmware Storage
	CPU Temperature
	System Fan Speed
	CPU Fan Speed

	Blocked Emails per hour/day
	Viruses per hour/day
	Quarantined Emails per hour/day
	Tagged emails per hour/day
	Allowed emails per hour/day


This is basically the exact same information that you would receive on
the front page of the HTTP interface of the barracuda, however, this
will consolidate the statistics to one location so that you do not have
to stay logged into the Barracuda to see this information.  It will also
graph it in the normal Unnoc way, to where you will see up to 1 year of
statistics.

Statistic collection is done through the stats.cgi interface.  The
current known location for this is

	http://servername:8000/cgi-bin/stats.cgi 

however it is configurable with http_url and http_port configuration 
options in the unnoc.conf file.

Unnoc has been tested against:

	Barracuda SPAM Firewall 300


2. Module Installation

The following Perl Modules are required for Barracuda SPAM Firewall
support:

	XML::Parser
	IO::Socket

Download and install these from your distribution or from CPAN.

3. Configuration

Configuration is done with the 'barracuda-spamfirewall' type

	host {
		hostname = barracuda1
		type = barracuda-spamfirewall
	}

If you specify a community, then it will also check the console stats of
the barracuda itself (Disk Usage, Load Average, Uptime, Network Traffic,
etc) just like any ordinary linux server, like this:

	host {
		hostname = barracuda1
		type = barracuda-spamfirewall
		community = public
	}

Other options:

	temp_units

		Either 'c' or 'f'

		C is for celsius
		F is for Fahrenheit
	
	http_url
		
		The URL location of the statis.cgi file.
		Default: '/cgi-bin/stats.cgi'
	
	http_port

		The port number for the stats.cgi file.
		Default: 8000


You can also specify the normal HTTP group options, description and updown as well
	

4. Examples

	This example will use console statistic checking (SNMP), and
	will use a separate port (8081) for stats.cgi.  It will also
	display the temperature units in Fahrenheit, instead of Celsius.

	(first, enable SNMP for the unnoc host)

	host {
		hostname = barracuda1
		type = barracuda-spamfirewall
		community = public
		http_port = 8081
		temp_units = F
	}



vim:tw=72:wm=1