Contraseña

Nagios – Intro To Nagios V-Shell
The Industry Standard in IT Infrastructure Monitoring
Purpose
This document describes how to install and setup the Nagios V-Shell or “Visual” Shell for Nagios Core and Nagios XI installations.

Target Audience
This document is intended for use by Nagios XI and Nagios Core Administrators, and assumes that Nagios Core is installed on the target system.Overview
The Nagios V-Shell is a web interface written in PHP that is designed to render as valid XHTML and be fully styled and formatted using CSS classes, while maintaining the power of Nagios Core for issuing system and node commands.

Before Installing:
V-Shell requires apache and php 5.x already installed in the system, as well as php-cli if it's not already there. You will need to know thelocation of Apache configuration directory where your nagios.conf file is located, as well as the htpasswd.users file that contains your Nagios Core authorizations. V-Shell takes advantage of the Alternative PHP Cache system (APC), which is of particular importance if you are managing a large installation. For information about APC and installation instructions seehttp://php.net/manual/en/book.apc.php. For distribution installs, see below: RHEL/CentOS/Fedora: Ubuntu/Debian: yum install php-pecl-apc sudo apt-get install php-apc

The defaults configurations are appropriate for a Nagios install from source on CentOS / RHEL. You will need to modify the contents of the config/vshell.conf file in order for V-Shell to work on any Nagios install that is not from source. It may be necessary tomodify your apache configuration file before running the install script. Modify the contents of the config/apache_vshell.conf file to match the directory structure of your distribution and Nagios installation. Do this before running the install script. Use a text editor to modify this file as needed, then copy this file to the same directory as your nagios.conf or apache configuration file.Nagios Enterprises, LLC P.O. Box 8154 Saint Paul, MN 55108 USA

US: 1-888-NAGIOS-1 Int'l: +1 651-204-9102 Fax: +1 651-204-9103

Web: www.nagios.com Email: sales@nagios.com

Page 1
Copyright © 2011 Nagios Enterprises, LLC Revision 1.0 – September, 2011

Nagios – Intro To Nagios V-Shell
Installation
Download and untar the latest V-Shell tarball from:http://assets.nagios.com/downloads/exchange/nagiosvshell/vshell.tar.gz To download the latest code from Subversion (unstable) https://nagios.svn.sourceforge.net/svnroot/nagios/nagiosvshell/trunk Run the following with root permissions: cd /tmp wget http://assets.nagios.com/downloads/exchange/nagiosvshell/vshell.tar.gz tar zxf vshell.tar.gz cd vshell chmod +x install.php (modify the files in the config directory to match you installation)Verify or Modify the following two lines in install.php to match your desired installation (lines 10-15) define('TARGETDIR',"/usr/local/vshell"); define('APACHECONF',"/etc/httpd/conf.d"); ./install.php #located in the root vshell directory where the web files are stored After running this script, be sure to verify the location of the files specified in the /etc/vshell.conf file, as well as thelocation of the htpasswd.users file that is specified by your apache configuration. These will be required in order for VShell to run correctly. For problems or support, use the V-Shell forum at the following address: http://support.nagios.com/forum/viewforum.php?f=19 Once the install script has run and the web server has been restarted, the V-Shell interface should be accessible from the followingaddress: http:///vshell Use your Nagios authentication credentials to log in.

Getting Started
Nagios V-Shell gets authorization information from the existing Nagios htpasswd.users file, as well as the cgi.cfg file for Nagios Core. V-Shell currently doesn't support true user-level account access the way Nagios Core does, but this feature will be included in future versions. V-Shell maintains...