The Industry Standard in IT Infrastructure Monitoring

Purpose
This document describes how to install and take initial setup steps for the Nagios Mobile interface.
Target Audience
This document is intended for use by Nagios Administrators who wish to have access to a mobile Nagios interface for touch-screen or
mobile devices.
Prerequisites
php 5.1 or greater
Nagios ore already installed
The install script assumes a source install of Nagios! so if the installation is from a package manager such as yum or apt! you"ll
need to identify the locations of the following Nagios files#
status.dat
ob$ects.cache
cgi.cfg
nagios.cmd
htpasswd.users %default authentication file for Nagios ore.
&or larger installations! you can install the package php-apc or php-pear-apc to cache your status data for faster page load
times.
'f using apc! be sure to add apc.enabled=1 to your php.ini file! then restart apache to enable it.
Downloading and Unpacking
(ownload the Nagios Mobile tarball#
cd /tmp
wget http://assets.nagios.com/downloads/exchange/nagiosmobile/nagiosmobile.tar.gz
tar zxf nagiosmobile.tar.gz
cd nagiosmobile
The Nagios Mobile installer script is written to work with a )vanilla* source install of Nagios ore on a +,-./ent01 system. 'f your
system meets these specifications you can simply run the ISTA!!.php file! and the installer will indicate if anything is missing.
0therwise! see the sections below to verify that your file locations are correct.
"erifying the Apache Authentication #ile
0pen the nagios$o%ile&apache.conf file with a te2t editor and verify that the directory location of your htpasswd.users file matches
your installation. &or source installs of Nagios ore! the default file is#
AuthUserFile /usr/local/nagios/etc/htpasswd.users
&or agios 'I installs! use the following directory location#
AuthUserFile /usr/local/nagiosxi/etc/htpasswd.users
Page (
opyright 3 4511
Nagios -nterprises! ..
+evision 1.5 6 1eptember! 4517
Installing agios Mo%ile
agios )nterprises* !!+ US, (-----A.I/S-( 0e%, www.nagios.co$
P./. 1o2 -(34
Saint Paul* M 33(5-
USA
Int6l, 7( 83(-954-:(59 )$ail, sales;nagios.co$
#a2, 7( 83(-954-:(5<
"erify agios #ile !ocations
'f your Nagios installation is installed from a package manager such as yum or apt! or you"ve moved files such as status.dat or
ob$ects.cache to a different file location! you"ll need to update the include.inc.php file to match the correct file locations. 8ou will also
need to update these locations if you are using a +am (isk as you no doubt changed those directories.
//////////////////FI! "#A$I"%&: !'I$ $(!&! $" )A$#( *"U+ %A,I"& I%&$AA$I"%//////
////////////////////////////////////////////////////////////////////////////////////
-&$A$U&.FI! = //usr/local/nagios/var/status.dat/0
-#"))A%'.FI! = //usr/local/nagios/var/rw/nagios.cmd/0
-#,I.FI! = //usr/local/nagios/etc/cgi.cfg/0
-"12!#$&.FI! = //usr/local/nagios/var/objects.cache/0
-1A&!.U+ = 3/nagiosmobile30
-$$ = 300 //$ime to li4e for cached data parsed from status and ob5ects file
-U&!+ = 330 //6ou can hard7code the 3nagiosadmin3 user if 6ou don3t want an6 authentication: NOT
RECOEN!E!""
"erify Target Directory and Apache +onfiguration Directory
9y default Nagios Mobile will be installed to /usr/local/nagiosmobile. 'f you want a different target directory for the installer! update the
ISTA!!.php file#
//target director6 where nagiosmobile3s web files will be stored
define83$A+,!$'I+39//usr/local/nagiosmobile/:0
'f your installation is not on a ent01 / +,-. distribution! then you"ll also need to update the file location for your apache
configurations directory.
//target director6 where 6our current apache configuration director6 is located
define83A;A#(!#"%F39//etc/htt#d/conf.d/:0
//default for ubuntu/debian installs
//define83A;A#(!#"%F39//etc/apache</conf.d/:0
=un The Installer
./I%&$A.php
'f all goes well! the installation script should output the following#
=root>'!?@A nagiosmobileB- ./I%&$A.php
#op6ing apache configuration file...
#reating web director6...
#op6ing files...
#leaning up...
+estarting apache...
&topping httpd: = "C B
&tarting httpd: = "C B
#hecDing for file locations...
&cript #ompleteE
'f any of the re:uired files were not found! a N0T'- message will be displayed as to what files are still missing.
Accessing agios Mo%ile
0nce the install script is complete! you can access the Nagios Mobile interface by the following address in a browser#
http://FA''+!&&G/nagiosmobile
Page 9
opyright 3 4511
Nagios -nterprises! ..
+evision 1.5 6 1eptember! 4517
Installing agios Mo%ile
agios )nterprises* !!+ US, (-----A.I/S-( 0e%, www.nagios.co$
P./. 1o2 -(34
Saint Paul* M 33(5-
USA
Int6l, 7( 83(-954-:(59 )$ail, sales;nagios.co$
#a2, 7( 83(-954-:(5<
Page <
opyright 3 4511
Nagios -nterprises! ..
+evision 1.5 6 1eptember! 4517
Installing agios Mo%ile
agios )nterprises* !!+ US, (-----A.I/S-( 0e%, www.nagios.co$
P./. 1o2 -(34
Saint Paul* M 33(5-
USA
Int6l, 7( 83(-954-:(59 )$ail, sales;nagios.co$
#a2, 7( 83(-954-:(5<