Project

General

Profile

Documentation » History » Version 17

chin-yeh, 09/15/2010 03:14 PM

1 3 chin-yeh
{{toc}}
2 2 chin-yeh
3 12 chin-yeh
h1. User Manual
4 1 chin-yeh
5
The official documentation.
6
7 17 chin-yeh
This documentation consists of 3 parts:
8
* [[Documentation#Installation|Installation]] - _How to_ install @Nagios@
9
* [[Documentation#Configuration|Configuration]] - _How to_ configure @Nagios@
10
* [[Documentation#Administration|Administration]] - _How to_ administer @Nagios@
11
12 1 chin-yeh
h2. Installation
13 3 chin-yeh
14 14 chin-yeh
This installation involves 3 parts which are:
15
* Nagios Core and Plugins - the core of the nagios and the plugins provided by Nagios
16
* Nagios Addons - the third party addons
17
* NRPE addon - to monitor local resources on remote machine
18
19
20 3 chin-yeh
h3. Prerequisites
21
22 1 chin-yeh
Requires:
23 14 chin-yeh
* must have *root* access for both local and remote machines
24 3 chin-yeh
* Apache HTTP installed and configured
25
* PHP module installed and configured
26
* GCC compiler
27
28
You can install the above missing components using *yum* or *up2date*.
29 1 chin-yeh
30 4 chin-yeh
h3. Install Nagios Core and Nagios Plugins
31
32
Refer to the *Nagios Quickstart Installation Guides* section of *Nagios Core* in the document#6 for the installation steps.
33
34 6 chin-yeh
h3. Install Addons
35
36
See [[Nagios - Addons]].
37
38 4 chin-yeh
h3. Install NRPE - optional
39
40
Install this add-on only if there is a need to execute *Nagios Plugins* on remote *nix machines.
41 5 chin-yeh
42 4 chin-yeh
Refer to the *NRPE* in the document#6 for the installation steps.
43
44
45 1 chin-yeh
h2. Configuration
46
47 7 chin-yeh
One should obtain the pre-configured nagios conf files from the repository.
48
49 8 chin-yeh
# obtain the latest release version and the file usually pack and compress as @prod.etc.tgz@
50
# login as @nagios@ user
51
# create a temp folder to store the file
52
<pre>
53
nagios$ mkdir temp_etc
54
</pre>
55
# @cd@ to the temp folder
56
<pre>
57
nagios$ cd temp_etc
58
</pre>
59 9 chin-yeh
# copy the latest release configuration file
60
<pre>
61
[nagios temp_etc]$ cp prod.etc.tgz .
62
</pre>
63 8 chin-yeh
# extract the file
64 1 chin-yeh
<pre>
65 9 chin-yeh
[nagios temp_etc]$ tar -xvzf prod.etc.tgz
66 8 chin-yeh
</pre>
67 10 chin-yeh
# backup the existing configuration folder
68 1 chin-yeh
<pre>
69 10 chin-yeh
[nagios temp_etc]$ cp -R /usr/local/nagios/etc /usr/local/nagios/etc.bak
70
</pre>
71
# copy the new configuration folder, *@etc@* to @/usr/local/nagios/libexec@
72
<pre>
73
[nagios temp_etc]$ cp -R etc /usr/local/nagios/libexec
74 8 chin-yeh
</pre>
75
76 1 chin-yeh
h2. Administration
77
78 11 chin-yeh
Describes how to administer @Nagios@ such as add monitoring host/services.
79
80
h3. Add Host
81
82
Define a physical server, workstation, device which resides on your network.
83
84
[[Add Host|Click here]] for the guide.
85
86 13 chin-yeh
h3. Assign Service to Host
87 11 chin-yeh
88
Define a service which runs on a host. A service could be HTTP, number of logged in user in a physical server and etc.
89
90 13 chin-yeh
[[Assign Service to Host|Click here]] for the guide.
91 11 chin-yeh
92
h3. Add Contact
93
94 16 chin-yeh
Define a contact who should be contacted in the event of a problem. The possible events included warning, critical, recovery, unknown and etc.
95 11 chin-yeh
96 1 chin-yeh
[[Add Contact|Click here]] for the guide.
97 16 chin-yeh
98
h3. Adjust Check Interval
99
100
Adjust the check interval for particular services.
101
102
[[Adjust Check Interval|Click here]] for the guide.