Setting Up The Web Interface


Notes

In these instructions I will assume that you are running the Apache web server on your machine. If you are using some other web server, you'll have to make changes where appropriate. I am also assuming that you used the /usr/local/nagios as the installation prefix.

Sample Configuration

A sample Apache config file snippet is created when you run the configure script - you can find the sample config file (named httpd.conf) in the sample-config/ subdirectory of the Nagios distribution. You will need to add the contents of this file to your Apache configuration files before you can access the Nagios web interface. The instructions found below detail how to manually add the appropriate configuration entries to Apache2.

Configure Aliases and Directory Options For The Web Interface

First you'll need to create appropriate entries for the Nagios web interface (HTML and CGIs) in your web server config file. Add the following snippet to /etc/apache2/sites-available/default.

ScriptAlias /nagios/cgi-bin /usr/local/nagios/sbin

<Directory "/usr/local/nagios/sbin">
	Options ExecCGI
	AllowOverride None
	Order allow,deny
	Allow from all
	AuthName "Nagios Access"
	AuthType Basic
	AuthUserFile /usr/local/nagios/etc/htpasswd.users
	Require valid-user
</Directory>

Alias /nagios /usr/local/nagios/share

<Directory "/usr/local/nagios/share">
	Options Indexes MultiViews FollowSymLinks
	AllowOverride None
	Order allow,deny
	Allow from all
	AuthName "Nagios Access"
	AuthType Basic
	AuthUserFile /usr/local/nagios/etc/htpasswd.users
	Require valid-user
</Directory>


Then create a link, /usr/local/nagios/share/cgi-bin to the /usr/local/nagios/sbin.

ln -s /usr/local/nagios/sbin /usr/local/nagios/share/cgi-bin


Note: The default Nagios installation expects to find the HTML files and CGIs at http://yourmachine/nagios/ and http://yourmachine/nagios/cgi-bin/, respectively. These locations can be changed using the --with-htmurl and --with-cgiurl options in the configure script.

Important! If you are installing Nagios on a multi-user system, you may want use CGIWrap to provide additional security between the CGIs and the external command file. If you decide to use CGIWrap, the ScriptAlias you'll end up using will most likely be different from that mentioned above. More information on doing this can be found here.

Restart The Web Server

Once you've finished editing the Apache configuration file, you'll need to restart the web server with a command like this...

/etc/rc.d/init.d/apache2 restart


Configure Web Authentication

Once you have installed the web interface properly, you'll need to specify who can access the Nagios web interface. Follow these instructions to do this.

htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin


Verify Your Changes

Don't forget to check and see if the changes you made to Apache work. You should be able to point your web browser at http://yourmachine/nagios/ and get the web interface for Nagios. The CGIs may not display any information, but this will be remedied once you configure everything and start Nagios.

CategoryAuditing
There are no comments on this page.
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki