Changes between Version 8 and Version 9 of doc/usage/nagios

Timestamp:

08/11/08 12:33:23 (5 years ago)

Author:

mickem

Comment:

--

doc/usage/nagios

@@ -184 +184 @@
 
 === NSClient++ configuration ===
-... TODO ...
+Configuring NRPE is a bit more involved but not overly so.
+The first thing you need to do to get things working is add the NRPEListener module.
+{{{
+[modules]
+...
+NRPEListener.dll
+...
+}}}
+If you have not already done so (above) you also need to set which computers are allowed to query the agent.
+This is set either under the [Settings] section (globally) or under the [NRPE] section (locally). If you when you configured NSClient above set this globally you are already set to go. If not the key you need to change is the allowed_hosts. There is no password for NRPE.
+ - allowed_hosts = A list of addresses that is allowed to ask questions (ie. your nagios ip).
+The result should look like this (assuming your nagios server ip address is 10.0.0.2):
+{{{
+[Settings]
+allowed_hosts=10.0.0.2
+}}}
+'''After this restart the service.'''
+{{{
+nsclient++ /stop
+nsclient++ /start
+... or ...
+net stop nsclientpp
+net start nsclientpp
+}}}
+
+
+Now feel free to try the command line agent again and hopefully things should work out perfectly.
+Run the following command from your nagios server.
+{{{
+./check_nrpe -H 10.0.0.1
+I (0.3.3.19 2008-07-02) seem to be doing fine...
+}}}
+
+=== Finding and solving problems ===
+A good way to find and solve problems is to run nsclient++ in "test" mode this is done by stopping the service and starting it in "test" mode.
+{{{
+nsclient++ /stop
+nsclient++ /test
+... test mode ... (quite with: exit)
+nsclient++ /start
+}}}
+When in test mode you will get a lot of interesting log messages when things are happening so it is fairly simple to figure out what is wrong.
+
+=== NSClient++ configuration (revisited) ===
+As we said before it is a bit more involved to configure NRPE and yet thus far it has actually been simpler?
+This is because we have not configured things yet NRPE has a few more keys and I shall go over the most important once here:
+ - use_ssl Boolean
+   If this is 1 (true) we will use SSL encryption when communicating. '''Notice''' this flag has to be the same on both ends or you will end up with strange errors. The flag is set on check_nrpe with the -n option (if you use -n no SSL will be used).
+ - allow_arguments
+   Since arguments can be potentially dangerous (it allows your users to controll the execution) there is a flag (which defaults to off) to enable arguments. So if you plan on control NSClient++ from the nagios end you need to enable this. '''But be warned this is a security issue you need to think about'''. If you do not want to allow arguments you can instead configure all checks in the NSC.ini file and just execute the aliases from nagios.
+ - allow_nasty_meta_chars
+   This flag allows arguments to contain "dangerous" characters such as redirection and pipe (<>|) and makes things a tad more dangerous. But if you decide to use arguments you most likely want to use this flag as well. '''But again this is a security risk'''
+
+=== using from the command line (revisited) ===
+Now that we have the agent up and running (if not probably want to go back over the previous sections to get it up and running before reading on) what can we do with it?. From here on we will assume you have allow arguments and metchars enabled since it makes it simpler to try things out.
+As we stated before check_nrpe is a lot more powerful then the "old" check_nt and there is a lot of built in commands as well as a lot of external once you can use. The built in once are listed below.
+[[ListTagged(check)]]
+Lets start with a simple one [CheckCPU] and see how to use it.
+
+If we check the docs for it it has an example like so:
+{{{
+checkCPU warn=80 crit=90 time=20m time=10s time=4
+CPU Load ok.|'20m average'=11%;80;90; '10s average'=7%;80;90; '4 average'=10%;80;90;
+}}}
+Now this is a "NSCLient++ /test mode command" so it is not usable in it self for you instead you need to change it slightly.
+The first word is the command and the rest are arguments.
+check_nrpe has two options for settings commands (-c) and arguments (-a) and is used like so:
+{{{
+check_nrpe ... -c <command> [-a <argument> <argument> <argument>]
+}}}
+in this case (CheckCPU) this translates to:
+{{{
+check_nrpe ... -c CheckCPU -a <the argument list as-is>
+check_nrpe ... -c CheckCPU -a warn=80 crit=90 time=20m time=10s time=4
+CPU Load ok.|'20m average'=11%;80;90; '10s average'=7%;80;90; '4 average'=10%;80;90;
+}}}
+And that is as hard as it gets all you need to do is figure out which arguments you want to use for the command and stack them all in a long line.
 
 === nagios configuration ===