CoffeeSaint

CoffeeSaint is a software application designed as a Nagios status viewer. Developed in Java, CoffeeSaint is compatible with all platforms and has been tested on Linux and Windows XP. It supports Nagios versions 1, 2 and 3, and allows you to view the status from a Nagios server via a fullscreen GUI.

There are different ways to access the status, depending on your preferred mode of operation. The first method involves invoking the status from a file, which works if you can reach the Nagios status-file via NFS or the local filesystem. In this case, you will need to replace '/var/cache/nagios3/status.dat' with the file configured in the nagios.cfg with the status_file-statement. Once you have done this, use the following command:

java -jar CoffeeSaint.jar --file /var/cache/nagios3/status.dat --interval 30 --image --version 3 --nrows 10

This will give you up to 9 status views at a time.

The second method involves accessing the status via an URL, which requires you to make the Nagios status-file available via a webserver. To achieve this, use the following command:

java -jar CoffeeSaint.jar --url --interval 30 --image --nrows 12

In this case, you will need to create an ln -s /var/cache/nagios3/status.dat /var/www/htdocs symbolic link to access the status.

The third method involves accessing the status via a network connection. To do this, use the following command, replacing 'keetweej.vanheusden.com' with the host-address of your Nagios server, and '33333' with the appropriate port number:

java -jar CoffeeSaint.jar --host keetweej.vanheusden.com --port 33333 --interval 30 --image --nrows 12

The interval is in seconds, and '--image' selects one or more webcams to view in the background (can be omitted to get a green/gray (depends on state) background). '--version' selects the Nagios version; this can be either 1, 2 or 3. '--nrows 10' will make the program show at least 9 statusses.

It's also possible to configure your Nagios server for status via a network connection. You will need to add the following line to /etc/inetd.conf:

33333 stream tcp nowait root /usr/sbin/tcpd /bin/cat /var/cache/nagios3/status.dat

Then, restart inetd (on Debian that can be accomplished with: /etc/init.d/openbsd-inetd restart). This configures inetd to serve the Nagios status on port 33333.

When the application is loading the current status, a blue block is displayed in the upper-right corner. If there was a problem loading the status, a red block will appear. The values in the row at the top tell you the number of critical-, warning-, ok-, up-, down-, unreachable-, and pending-statusses.

To view a complete list of options, invoke the following command:

java -jar CoffeeSaint.jar --help