• Table of contents
• User Manual
  • Test email account for notification
  • Hierarchy of Nagios Configuration Files
  • Notification Method
  • Installation
    • Prerequisites
    • Install Nagios Core and Nagios Plugins
    • Install Addons
    • Install NRPE - optional
  • Configuration
  • Administration
    • Add Host
    • Assign Service to Host
    • Add Contact
    • Adjust Check Interval

User Manual¶

For development environment only.

This documentation consists of 3 parts:

• Installation - How to install Nagios
• Configuration - How to configure Nagios
• Administration - How to administer Nagios

Test email account for notification¶

Nagios Admin User:
Please DO NOT connect Google Talk using this account

Username: ecosway.nagios@gmail.com
Password: ecosway.nagiosgm

Warning User:

Username: ecosway.nagios.warning@gmail.com
Password: ecosway.nagios.warninggm

Critical User:

Username: ecosway.nagios.critical@gmail.com
Password: ecosway.nagios.criticalgm

Hierarchy of Nagios Configuration Files¶

• Configuration Files - Development

Notification Method¶

The Nagios supports the following notification method:

• E-Mail
• SMS (requires GSM modem)
• Instant Message (supports XMPP based only, e.g. Google Talk)

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

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.

Install Nagios Core and Nagios Plugins¶

Refer to the Nagios Quickstart Installation Guides section of Nagios Core in the Nagios - Documentation for the installation steps.

Install Addons¶

See Nagios - Addons.

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 Nagios - Documentation for the installation steps.

Configuration¶

One should obtain the pre-configured nagios conf files from the repository.

1. obtain the latest release version and the file usually pack and compress as prod.etc.tgz
2. login as nagios user
3. create a temp folder to store the file
   

   nagios$ mkdir temp_etc
   

4. cd to the temp folder
   

   nagios$ cd temp_etc
   

5. copy the latest release configuration file
   

   [nagios temp_etc]$ cp prod.etc.tgz .
   

6. extract the file
   

   [nagios temp_etc]$ tar -xvzf prod.etc.tgz
   

7. backup the existing configuration folder
   

   [nagios temp_etc]$ cp -R /usr/local/nagios/etc /usr/local/nagios/etc.bak
   

8. copy the new configuration folder, etc to /usr/local/nagios/libexec
   

   [nagios temp_etc]$ cp -R etc /usr/local/nagios/libexec
   

Administration¶

Describes how to administer Nagios such as add monitoring host/services.

Add Host¶

Define a physical server, workstation, device which resides on your network.

Click here for the guide.

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.

Click here for the guide.

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.

Click here for the guide.

Adjust Check Interval¶

Adjust the check interval for particular services.

Click here for the guide.