Documentation » History » Version 18
chin-yeh, 09/29/2011 03:07 PM
1 | 3 | chin-yeh | {{toc}} |
---|---|---|---|
2 | 2 | chin-yeh | |
3 | 12 | chin-yeh | h1. User Manual |
4 | 1 | chin-yeh | |
5 | 18 | chin-yeh | For *development* environment only. |
6 | 1 | chin-yeh | |
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. |