octopussy for Debian
====================

rsyslog Configuration
---------------------

Octopussy for Debian does not enable UDP/TCP network ports in 
/etc/rsyslog.conf (this differs from the upstream Debian packaging).

The following changes must be made to /etc/rsyslog.conf receive syslog from 
other servers:

# provides UDP syslog reception
$ModLoad imudp
$UDPServerRun 514

# provides TCP syslog reception
$ModLoad imtcp
$InputTCPServerRun 514

In addition high precision timestamps are required; these can be enabled
by commenting out:

#
# Use traditional timestamp format.
# To enable high precision timestamps, comment out the following line.
#
#$ActionFileDefaultTemplate RSYSLOG_TraditionalFileFormat


syslog-ng Configuration
-----------------------

Octopussy can also be used with syslog-ng; an example configuration file
for syslog-ng can be found in /usr/share/doc/octopussy/syslog-ng.conf.


mysql Configuration
-------------------

Octopussy uses a mysql database for storing alert data.  This can be 
automatically setup during installation using dbconfig-common.  However
if you wish  to install the octopussy database on an alternative server
you can find an example script to setup the octopussy database, user and
schema in /usr/share/doc/octopussy/OCTOPUSSY.sql.

Once you have created the mysql schema manually, you will need to 
create /etc/octopussy/conf/db.xml using the template that can be found 
in /usr/share/doc/octopussy/db.xml and then restart octopussy to complete 
the installation.


Open Flash Chart
----------------

Octopussy makes use of Open Flash Chart, a flash based charting plugin. 
This is not currently packaged for Debian and has been removed from the
Debian distribution to comply with DFSG.

However it can be re-enabled by downloading v2 from:

 http://teethgrinder.co.uk/open-flash-chart-2

and installing to /usr/share/octopussy/open-free-chart.swf.

OFC report type can then be re-enabled by editing 
/usr/share/octopussy/INC/octo_selector_graphtype.inc.

Note that you can still generate array and RRD style reports.

 -- James Page <james.page@ubuntu.com>  Wed, 03 Aug 2011 12:41:11 +0100
