Changes between Version 17 and Version 18 of FAQ

Timestamp:

03/30/11 22:07:32 (2 years ago)

Author:

mickem

Comment:

--

FAQ

@@ -1 @@
-humm...
+[[TracNav(TracNav/TOCDoc)]]
+[[PageOutline]]
+= Problems =
+== 1. I am having problems where do I start? ==
+  NSCP has a built-in "test and debug" mode that you can activate with the following command
+  {{{
+nsclient++ /test
+  }}}
+  What this does is two things. 
+    1. it starts the deamon as "usual" with the same configuration and such.
+    2. it enables debug logging and logs to the console.
+  This makes it quite easy to see what is going on and why things go wrong. .
+
+== 2. Failed to open performance counters ==
+ * The first thing to check is the version if you are using an old version (pre 0.3.x) upgrade!
+ * Second thing to check are your performance counters working?
+   Sometimes the performance counters end up broken end need to be rebuilt
+   See forum post: TODO topic - 78 here for details or Microsoft KB: [http://support.microsoft.com/kb/300956] essentially you need to use the "lodctr /R" command.
+
+== 3. Bind failed ==
+ * Usually this is due to running more then once instance of NSClient++ or possibly running another program that uses the same port.
+  - Make sure you don't have any other instance NSCLient++ started.
+  - Check if the port is in use (netstat -a look for LISTENING)
+
+== 4. "EvenlogBuffer? is too small ==
+ * This is because you have one or more entries in your eventlog which are larger then the "default buffer size of 64k". The best way to fix this is to increase the buffer used.
+{{{
+[EventLog]
+buffer_size=128000
+}}}
+
+NOTE: You should add it to the ini file by yourself.
+
+There are hundreds of options not in the ini file (all covered in the docs though). 
+The default ini is more a "common ones" and not a complete set.
+
+the ini file that comes with the installation does not contain this variable by default.
+
+
+== 5. How do I properly escape spaces in strings ==
+When you need to put spaces in a string you do the following:
+ * nagios:
+   - As usual you can do it anyway you like but I prefer: check_nrpe ... 'this is a string'
+ * NSClient++ (inject, alias, external, etc...)
+   - The parser is badly written so the only option is:
+{{{
+CHeckSomething "this is a string"
+CheckEventLog "filter-message=substr:Hello World"
+}}}
+   - '''Not''' for instance: 
+{{{
+filter-message="substr:Hello World"
+filter-message=substr:"Hello World"
+}}}
+
+== 6. How do I properly escape $ in strings ==
+From:
+ * nagios:
+   - $$ (you use two $ signs)
+ * from NSClient++
+   - $ (you do not need to escape them at all)
+
+== 7. System Tray does not work ==
+=== Older WIndows ===
+If you are using "older windows" (ie. XP and below) you can use the "old" sytray module like so:
+{{{
+[modules]
+SysTray.dll
+}}}
+and then run:
+{{{
+NSClient++ -noboot SysTray install
+}}}
+=== "modern" windows ===
+If you are using "modern" windows ie. vista, 2k3, 2k8, etc etc there is no "session 0" (or there is but you do not see it by default) so they sytray (which ends up on session 0) wont be visible by your session 1 (or above). Thus I started work on a new "modern implementation" this comes in the form of a shared session (based on shared memory and mutexes).
+'''But since this is rather new it is very experimental''' so use it with care!
+To enable shared session do the following:
+{{{
+[modules]
+; SysTray.dll <--- NOTICE THE COMMENT
+
+[Settings]
+shared_session=1
+}}}