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