Documentation » History » Revision 17
Revision 16 (chin-yeh, 09/13/2010 09:48 AM) → Revision 17/19 (chin-yeh, 09/15/2010 03:14 PM)
{{toc}}
h1. User Manual
The official documentation.
This documentation consists of 3 parts:
* [[Documentation#Installation|Installation]] - _How to_ install @Nagios@
* [[Documentation#Configuration|Configuration]] - _How to_ configure @Nagios@
* [[Documentation#Administration|Administration]] - _How to_ administer @Nagios@
h2. Installation
This installation involves 3 parts which are:
* Nagios Core and Plugins - the core of the nagios and the plugins provided by Nagios
* Nagios Addons - the third party addons
* NRPE addon - to monitor local resources on remote machine
h3. Prerequisites
Requires:
* must have *root* access for both local and remote machines
* Apache HTTP installed and configured
* PHP module installed and configured
* GCC compiler
You can install the above missing components using *yum* or *up2date*.
h3. Install Nagios Core and Nagios Plugins
Refer to the *Nagios Quickstart Installation Guides* section of *Nagios Core* in the document#6 for the installation steps.
h3. Install Addons
See [[Nagios - Addons]].
h3. Install NRPE - optional
Install this add-on only if there is a need to execute *Nagios Plugins* on remote *nix machines.
Refer to the *NRPE* in the document#6 for the installation steps.
h2. Configuration
One should obtain the pre-configured nagios conf files from the repository.
# obtain the latest release version and the file usually pack and compress as @prod.etc.tgz@
# login as @nagios@ user
# create a temp folder to store the file
<pre>
nagios$ mkdir temp_etc
</pre>
# @cd@ to the temp folder
<pre>
nagios$ cd temp_etc
</pre>
# copy the latest release configuration file
<pre>
[nagios temp_etc]$ cp prod.etc.tgz .
</pre>
# extract the file
<pre>
[nagios temp_etc]$ tar -xvzf prod.etc.tgz
</pre>
# backup the existing configuration folder
<pre>
[nagios temp_etc]$ cp -R /usr/local/nagios/etc /usr/local/nagios/etc.bak
</pre>
# copy the new configuration folder, *@etc@* to @/usr/local/nagios/libexec@
<pre>
[nagios temp_etc]$ cp -R etc /usr/local/nagios/libexec
</pre>
h2. Administration
Describes how to administer @Nagios@ such as add monitoring host/services.
h3. Add Host
Define a physical server, workstation, device which resides on your network.
[[Add Host|Click here]] for the guide.
h3. Assign Service to Host
Define a service which runs on a host. A service could be HTTP, number of logged in user in a physical server and etc.
[[Assign Service to Host|Click here]] for the guide.
h3. Add Contact
Define a contact who should be contacted in the event of a problem. The possible events included warning, critical, recovery, unknown and etc.
[[Add Contact|Click here]] for the guide.
h3. Adjust Check Interval
Adjust the check interval for particular services.
[[Adjust Check Interval|Click here]] for the guide.