Documentation » History » Version 14
chin-yeh, 09/13/2010 09:03 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 | Define a contact who should be contacted in the event of a problem. A event could be warning, critical, recovery, unknown and etc. |
||
| 90 | |||
| 91 | [[Add Contact|Click here]] for the guide. |
||
| 92 | |||
| 93 | 1 | chin-yeh | h2. Housekeeping |