
RSS4NAGIOS 1.1
--------------


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.

This works for either service or host notifications.

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 supports 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/lib64/nagios/plugins/rss-multiuser, this is the notification script. It updates the users'
	RSS file
  - /usr/lib64/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 notify-by-rss
        command_line /usr/lib64/nagios/plugins/rss-multiuser
}

For each contact, add 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,notify-by-rss
        service_notification_commands   service-notify-by-email,notify-by-rss
}

Note: the same command can be used for service or host notifications. The RSS 
data will be formatted accordingly.

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.



Changelog
---------

1.1 28th July 2006
   Added support for host notifications
1.0 7th July 2006
   Initial release
