
RSS4NAGIOS 1.0
--------------


Introduction
------------
This is another implementation of RSS for Nagios. The main difference
is that this works via Nagios' notification methods (so there is no 
constant polling of status) and is contact specific (so only information
requested for a contact will be shown). Basically, anything that would have 
been sent as an email will be an RSS item.

Acknowledgements will also be displayed, along with author and comment.

This is largely based on rss-notifications, by ssugar, published on 
Nagios Exchange (http://www.nagiosexchange.org).



Requirements
------------
Requires Nagios 2+ (uses environment variables). Nagios must be setup 
with authenticated CGIs.

Requires perl modules XML::RSS, CGI, CGI::Carp. Available from CPAN.

Requires an RSS reader that support HTTP authentication (Firefox 1.5+
will work).



Installation
------------
By default, data is held in /var/log/nagios/rss. Make sure this
directory exists and is writeable by nagios user. 

Each contact will have their own rss file in the data directory. 
Although this can be anywhere, it is best left out of the webserver
tree, so only the CGI can access it.

There are 3 files: 
  - /etc/nagios/rss.cfg. Create this based on rss.cfg.in
  - /usr/lib/nagios/plugins/rss-multiuser, this is the notification script. It updates the users
	RSS file
  - /usr/lib/nagios/cgi/rss.cgi. This is your CGI script. You can use any RSS reader
	to read. Requires basic HTTP authentication.

Note: When copying these files, it is left to you to set appropriate permissions

The Nagios configuration needs to be amended as such:

define command {
        command_name service-notify-by-rss
        command_line /usr/lib/nagios/plugins/rss-multiuser
}

For each contact, add service-notify-by-rss as one of their notification
commands. For example:

define contact {
        contact_name    admin
        alias           admin
        service_notification_period     24x7
        host_notification_period        24x7
        service_notification_options    w,c,r,u
        host_notification_options       n
        email   	admin@altinity.com
        host_notification_commands      host-notify-by-email
        service_notification_commands   service-notify-by-email,service-notify-by-rss
}

To access the RSS feed, goto: 

http://server/nagios/cgi-bin/rss.cgi

You will be requested to login.

You could setup the RSS feed to be unauthenticated - simply put the rss directory into
a public area that the webserver can see. Obviously, there will be no security.



Support
-------
If you have any questions, please send to nagios-users@lists.sourceforge.net.
The authors of this software usually monitor this mailing list. However, there 
is no guaranteed support time for this software.

If you wish to have commercial support, please see http://altinity.com



Authors and licence
-------------------
This has been created by Altinity Limited and is released under the GPL v2.


