Module: nagvis Branch: master Commit: cb36c0688914e8449b25561ca9b7df5384bd0fb3 URL: http://nagvis.git.sourceforge.net/git/gitweb.cgi?p=nagvis/nagvis;a=commit;h=cb36c0688914e8449b25561ca9b7df5384bd0fb3
Author: LaMi <[email protected]> Date: Wed Feb 17 22:35:02 2010 +0100 Updated manuall install docs with 1.5 specific details --- docs/en_US/installation_instructions.html | 56 ++++++++++++++++++++--------- 1 files changed, 39 insertions(+), 17 deletions(-) diff --git a/docs/en_US/installation_instructions.html b/docs/en_US/installation_instructions.html index 12de35f..10bab52 100644 --- a/docs/en_US/installation_instructions.html +++ b/docs/en_US/installation_instructions.html @@ -20,17 +20,24 @@ <pre>tar xvzf nagvis-1.5.x.tar.gz</pre> <h2> STEP 3: Move the unpacked NagVis directory </h2> - Place the NagVis directory tree into your Nagios share Folder. - With standard Nagios path this is /usr/local/nagios/share. - <pre>mv nagvis /usr/local/nagios/share</pre> - You should see the directories <code>etc</code>, <code>nagvis</code> and <code>wui</code> - <pre>ls -l /usr/local/nagios/share/nagvis</pre> + <p>Place the NagVis directory tree somewhere on your system. For most case + <code>/usr/local/nagvis</code> is the best place.</p> + <pre>mv nagvis /usr/local/nagvis</pre> + + <p>You should see the following directory listing:</p> + <pre># ls -l /usr/local/nagvis +etc +LICENCE +README +share +var +</pre> <font style="color:red">DON'T move any files or folders inside the NagVis directory (in fact you can move, but in this case you have to change/add some parameters and values in the main config file - if everything is left untouched it should run "out of the box" without changes in the configuration files)</font> <h2> STEP 4: Configure NagVis</h2> Move to new NagVis directory - <pre>cd /usr/local/nagios/share/nagvis</pre> + <pre>cd /usr/local/nagvis</pre> An example main configuration file can be found in <code>etc/nagvis.ini.php-sample</code>. If you like to change some settings, copy this example to <code>etc/nagvis.ini.php</code>. @@ -42,6 +49,17 @@ For information about the possible values have a look at <a href="nagvis_config_format_description.html">Main Config Format Description</a>. + <h2> STEP 4: Configure webserver</h2> + <p>Since NagVis 1.5 it is neccessary to configure the webserver to be able + to use NagVis. You will find a sample configuration file in <code>etc/apache2-nagvis.conf-sample</code>. + + <p>Simply copy the file to the <code>conf.d</code> directory of your webserver. For example this is <code>/etc/apache2/conf.d</code.</p> + <pre>cp etc/apache2-nagvis.conf-sample /etc/apache2/conf.d/apache2-nagvis.conf</pre> + <p>Now you need to open that file and edit it to fit your needs. It is important + to replace the macros <code>@NAGVIS_WEB@</code> and <code>@NAGVIS_PATH@</code>.</p> + <p>In this example you need to replace <code>@NAGVIS_WEB@</code> with <code>/nagvis</code> + and <code>@NAGVIS_PATH@</code> with <code>/usr/local/nagvis/share</code>. + <h2> STEP 5: Permissions </h2> <font style="color:red">This is very important for a neatly working installation.</font> First check which unix user account is used to run your webserver (in my case it is <code>wwwrun</code>). If you don't know which user the webserver is running then have a look at the webservers configuration. In case of apache you can do this by the following command:<br><br> @@ -52,21 +70,25 @@ Set the permissions to your NagVis directory (in my case the paths are like this): <pre> -chown wwwrun:www /usr/local/nagios/share/nagvis -R -chmod 664 /usr/local/nagios/share/nagvis/etc/nagvis.ini.php -chmod 775 /usr/local/nagios/share/nagvis/nagvis/images/maps -chmod 664 /usr/local/nagios/share/nagvis/nagvis/images/maps/* -chmod 775 /usr/local/nagios/share/nagvis/etc/maps -chmod 664 /usr/local/nagios/share/nagvis/etc/maps/* -chmod 775 /usr/local/nagios/share/nagvis/var -chmod 664 /usr/local/nagios/share/nagvis/var/*</pre> - +chown wwwrun:www /usr/local/nagvis -R +chmod 664 /usr/local/nagvis/etc/nagvis.ini.php +chmod 775 /usr/local/nagvis/etc/maps +chmod 664 /usr/local/nagvis/etc/maps/* +chmod 775 /usr/local/nagvis/etc/automaps +chmod 664 /usr/local/nagvis/etc/automaps/* +chmod 775 /usr/local/nagvis/share/userfiles/images/maps +chmod 664 /usr/local/nagvis/share/userfiles/images/maps/* +chmod 775 /usr/local/nagvis/var +chmod 664 /usr/local/nagvis/var/*</pre> +chmod 775 /usr/local/nagvis/var/tmpl/cache +chmod 664 /usr/local/nagvis/var/tmpl/cache/*</pre> + It's possible to set even lower permissions on the files but for most setups the example should be fine. Only change them if you know what you are doing! <h2> STEP 6: The graphical config tool (WUI) </h2> NagVis has an included web based config tool called WUI. If you want to use it use your browser to open the page: - <pre>http://<nagiosserver>/<path-to-nagvis>/config.php</pre> + <pre>http://<nagiosserver>/<path-to-nagvis>/frontend/wui/index.php</pre> Hint: If you have some script or popup blockers, disable them for the WUI. @@ -81,7 +103,7 @@ chmod 664 /usr/local/nagios/share/nagvis/var/*</pre> <h2> STEP 7: View the maps </h2> You should now be able to view your defined maps in your browser: - <pre> http://<nagiosserver>/<path-to-nagvis>/index.php?map=<mapname></pre> + <pre> http://<nagiosserver>/<path-to-nagvis>/frontend/nagvis-js/?mod=Map&show=<mapname></pre> Have fun and please report bugs! </body> ------------------------------------------------------------------------------ Download Intel® Parallel Studio Eval Try the new software tools for yourself. Speed compiling, find bugs proactively, and fine-tune applications for parallel performance. See why Intel Parallel Studio got high marks during beta. http://p.sf.net/sfu/intel-sw-dev _______________________________________________ Nagvis-checkins mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/nagvis-checkins
