Nagios V-Shell is a PHP web interface to Nagios Core that is designed to be lightweight, easy to install and use, and customizable. As of v1.7, V-Shell now has gettext support for internationalization.

Version 1.9 has now been overhauled for substantial performance increases. Recommended to use with PHP's APC caching. See INSTALL.txt for more details.

First of all, create software. It was perfect for what we were trying to do, but in doing so, I found a bug. When you associate a user to a specific service instead of all services (by associating it with a host), the first service is dropped off the list. In data/NagiosUser.php in the build_authorized_objects function, services section, there are 2 instances where the object's authHosts array is checked for existence. In both cases, the existence is checked and if it does not exist, then you allocate the array, but the data that you've found is never added to that array. The else case needs to be removed and done every time so that all associated services are added.

I use Nagios to monitor my own servers (and clientsâ€™ servers and my employersâ€™ servers, too) and I just gave the new Nagios V-Shell a test-run.

I donâ€™t actually care much about the fact that itâ€™s written in PHP and generates valid XHTML. I am rather interested in the fact that it doesnâ€™t use frames. My hopes are that the interface works nicely on BlackBerries and other smartphones. â€“ Yes, there are frontends which were designed with small screens in mind, but they are either too focused on iPhones or Android with heavy use of JavaScript, or lack some important features such as the ability to acknowledge host or service states etc.

I have yet to test the V-Shell with multiple users, or other users than â€œnagiosadminâ€â€¦ but this is the bottom line for today:

* Installation is very easy and straight forward
* V-Shell works fairly well on the BlackBerry â€“ slow, but easy to use and intuitive; the views and controls are very close to the original Nagios Core web interface
* Two things werenâ€™t working well in the beginning, but I managed to fix themâ€¦

Host icons

I use host icons. Theyâ€™re mainly just pleasing to the eye in the HTML parts of the web interface, but very useful when you look at the status map. I maintain my own set of icon files in the Nagios Core web interface, but unfortunately the V-Shell doesnâ€™t automatically link the host icons to that location (whereas it relies on the Core interface for service and host commands). My solution is:

1. Remove the logos that shipped with V-Shell: rm -rf /usr/local/vshell/views/images/logos
2. Create a symbolic link to the Core logos folder: cd /usr/local/vshell/views/images ; ln -s /usr/local/nagios/share/images/logos
3. Append the following lines in the vshell_apache.conf files right before the line that says

### for the logos
Options +FollowSymLinks

I also made NagiosGrapher work with V-Shell. Read the rest of the story here: http://ten-fingers-and-a-brain.com/2011/02/trying-out-the-nagios-v-shell/