Service Monitoring System

{{toc}}

h1. User Manual

For *development* environment only.

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. Test email account for notification

Nagios Admin User:

_Please *DO NOT* connect Google Talk using this account_

<pre>

Username: ecosway.nagios@gmail.com

Password: ecosway.nagiosgm

</pre>

Warning User:

<pre>

Username: ecosway.nagios.warning@gmail.com

Password: ecosway.nagios.warninggm

</pre>

Critical User:

<pre>

Username: ecosway.nagios.critical@gmail.com

Password: ecosway.nagios.criticalgm

</pre>

h2. Hierarchy of Nagios Configuration Files 

* [[Configuration Files - Development]]

h2. 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_)

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.