Project

General

Profile

Documentation » History » Version 16

chin-yeh, 09/13/2010 09:48 AM

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