[op5-users] Guide to installing Nagvis on Nija

[Johannes Dagemark]

Sweet!

Thanks for the instruction Mike

Cheers
Johannes

Mike wrote:
> HI All
>
> as I've been looking at installing Nagvis on Ninja I thought I would list
> the process here in case anyone else wanted to do it
>
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> ==Setup==
>
> This install assumes Ninja and Merlin are already installed, some paths may
> need to be adjusted for your own setup
>
> ===Suggested paths===
>
> ######
> 	Nagios root = /usr/local/nagios
> 	Nagvis install directory = /usr/local/nagios/etc/addons
> ######
>
> ==Preinstall checklist==
>
> Nagvis requires the following software to be installed
>
> ######
> 	php 5.2
> 	php5-gd
> 	php5-gettext
> 	php5-mysql
> 	php5-mbstring
> 	php5-session
> 	php5-xml
> 	graphviz
>
> ######
>
> ==How to install==
>
> Unpack the archive to the webroot you require and rename
>
> ######
> 	tar xvzf nagvis-1.4*.tar.gz /usr/local/nagios/etc/addons
> 	cd /usr/local/nagios/etc/addons
> 	mv nagvis-1.4 nagvis
> 	cd nagvis
>
> ######
>
> change perms for nagvis directory
>
>
> ######
> 	chown -R nagios:nagios nagvis
>
> 	cp /usr/local/nagios/etc/addons/nagvis/etc/nagvis.ini.php-sample
> /usr/local/nagios/etc/addons/nagvis/etc/nagvis.ini.php
>
> ######
>
> create httpd conf file for nagvis and link it to Nagios's htpasswd file
>
> ######
> 	vi /etc/httpd/conf.d/nagvis.conf
>
>
> 	Alias /nagvis "/usr/local/nagios/etc/addons/nagvis"
> 	<Directory "/usr/local/nagios/etc/addons/nagvis">
> 		Order allow,deny
> 		Allow from all
> 		DirectoryIndex index.php
> 		AuthName "Nagvis Access Required"
> 		AuthType Basic
> 		AuthUserFile /usr/local/nagios/etc/htpasswd.users
> 		Require valid-user
> 		Options None
> 		AllowOverride None
> 	</Directory>
>
> ######
>
> create symlink to nagvis config file in nagios etc (just to make editing it
> easier)
>
> ######
> 	cd /usr/local/nagios/etc/
> 	ln -s /usr/local/nagios/etc/addons/nagvis/etc/nagvis.ini.php .
>
> ######
>
> edit the nagvis config file
>
> ######
>
> 	vi /usr/local/nagios/etc/addons/nagvis/etc/nagvis.ini.php
>
> ######
>
> enter these values (change to match your merlin DB setup
>
> ######
> set paths
> 	; Path definitions
> 	[paths]
> 	; absolute physical NagVis path
> 	base="/usr/local/nagios/etc/addons/nagvis/"
> 	; absolute html NagVis path
> 	htmlbase="/nagvis
>         ; absolute html NagVis cgi path
>         htmlcgi="/ninja/index.php"
>
> ;default values to get maps to link back to Ninja
>
>         ; target for the icon links
>         urltarget="new"
>         ; URL template for host object links
>         hosturl="[htmlcgi]/status/host/[host_name]"
>         ; URL template for hostgroup object links
>         hostgroupurl="[htmlcgi]/status/hostgroup/[hostgroup_name]"
>         ; URL template for service object links
>
> serviceurl="[htmlcgi]/extinfo/details/service/[host_name]?service=[service_d
> escription]"
>         ; URL template for servicegroup object links
>
> servicegroupurl="[htmlcgi]/status/servicegroup/[servicegroup_name]?style=det
> ail"
>
> ; default backend (id of the default backend)
> 	backend="merlinmy_1"
>
> 	; in this example the ID of the Backend is "merlinmy_1" you can define
> another ID.
> 	[backend_merlinmy_1]
> 	; type of backend - MUST be set
> 	backendtype="merlinmy"
> 	; hostname for Merlin db
> 	dbhost="localhost"
> 	; portname for Merlin db
> 	dbport=3306
> 	; database name for Merlin db
> 	dbname="merlin"
> 	; username for Merlin db
> 	dbuser="merlin"
> 	; password for Merlin db
> 	dbpass="XXXXX"
> 	; maximum delay of the Merlin Database in seconds
> 	maxtimewithoutupdate=180
> 	; path to the cgi-bin of this backend
> 	htmlcgi="/ninja/index.php"
>
> hash out all entries for
> 	;[backend_ndomy_1]
> 	;[backend_ndo2fs_1]
>
> ######
>
>
> check file perms for nagvis
>
> ######
> 	chmod 664 /usr/local/nagios/etc/addons/nagvis/etc/nagvis.ini.php
> 	chmod 775 /usr/local/nagios/etc/addons/nagvis/nagvis/images/maps
> 	chmod 664 /usr/local/nagios/etc/addons/nagvis/nagvis/images/maps/*
> 	chmod 777 /usr/local/nagios/etc/addons/nagvis/etc/maps
> 	chmod 666 /usr/local/nagios/etc/addons/nagvis/etc/maps/*
> 	chmod 777 /usr/local/nagios/etc/addons/nagvis/var
> 	chmod 664 /usr/local/nagios/etc/addons/nagvis/var/*
>
> ######
>
> Edit Ninja's config
>
> ######
> 	vi /usr/local/nagios/etc/addons/ninja/application/config/config.php
>
>
> 	/**
> 	 * Do we use NagVis?
> 	 * If path differs from the one below but still installed
> 	 * you could simply change it.
> 	 */
> 	$config['nagvis_real_path'] = '/usr/local/nagios/etc/addons/nagvis/';
> 	if (is_dir($config['nagvis_real_path'])) {
> 		$config['nagvis_path'] = '/usr/local/nagios/etc/addons/nagvis';
> 	} else {
> 		$config['nagvis_path'] = false;
> 	}
>
> ######
>
> restart httpd
>
> ######
> 	service httpd restart
>
> ######
>
> if you don't care about securing nagvis change the http.conf
>
>
> ######
> 	vi /etc/httpd/conf.d/nagvis.conf
>
> 	Alias /nagvis "/usr/local/nagios/etc/addons/nagvis"
> 	<Directory "/usr/local/nagios/etc/addons/nagvis">
> 		Order allow,deny
> 		Allow from all
> 		DirectoryIndex index.php
> 		AllowOverride All
> 	</Directory>
>
>
> 	vi /usr/local/nagios/etc/addons/nagvis/.htaccess
>
> 	SetEnv REMOTE_USER admin
>
> ######
>
> now nagvis should be working in your ninja instance and you can also browse
> to nagvis via
>
> ######
> http://IP ADDRESS/nagvis
> ######
>
> cheers
>
> Mike
> _______________________________________________
> op5-users mailing list
> op5-users at lists.op5.com
> http://lists.op5.com/mailman/listinfo/op5-users
>   


-- 
Johannes Dagemark
CTO / VP Engineering
________________________________________

op5 AB
Första Långgatan 19
SE-413 27 Gothenburg
cell: +46 733-70 90 24
fax:  +46 31-774 04 32
Email: jd at op5.com
http://www.op5.com/