Project

General

Profile

Documentation » History » Revision 16

Revision 15 (chin-yeh, 09/13/2010 09:41 AM) → Revision 16/19 (chin-yeh, 09/13/2010 09:48 AM)

{{toc}} 

 h1. User Manual 

 The official documentation. 

 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 A event could be 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.