You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

DebugMode_readme.txt 2.2KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152
  1. Both SNFServer and SNFClient can be run in a debugging mode which
  2. produces additional output. In order to run these programs in debug
  3. mode you can rename them so that "debug" or "Debug" is in their name,
  4. or you can call them in a sub directory so that the path to the
  5. program conains "debug" or "Debug".
  6. SNFDebugClient --
  7. The SNFClient debug mode will display the entire XCI session for each
  8. call. This is a good way to see how XCI is used if you want to explore
  9. communicating with the SNFServer directly from your programs.
  10. SNFDebugServer --
  11. The SNFServer debug mode will display a thread status report each
  12. second along with the usual running statistics line. The thread status
  13. report will show all active theads, what they are doing (generally),
  14. and whether they are running or have stopped. If a thread stops due to
  15. an unhandeled exception then information about that exception will be
  16. displayed in the status report.
  17. The snf-server control script can be used to run the server in debug
  18. mode and capture it's output in a file called debug.log (in directory
  19. /var/log/snf-server by default). Please see the Debugging section of
  20. INSTALL in the top-level directory of the distribution for the
  21. procedure and further details.
  22. 20080325 -- At this time there are a few systems that are reporting an
  23. intermittent bug where SNFServer will either stop answering requests
  24. or it will stop reporting telemetry. When this happens there are no
  25. errors reported in logs, no exceptions thrown, no corrupted programs,
  26. nothing unusual at all --which is, of course, the most unusual thing
  27. of all. The program continues to run -- it's just not listening (or
  28. talking).
  29. On all but a handfull of systems SNFServer runs reliably for hundreds
  30. of days at a time without stopping until told to do so... This
  31. includes our lab computers... We hate mysteries -- the thread status
  32. report is designed to help us learn something about this bug since we
  33. are not yet able to reproduce it.
  34. To run SNFServer in debug mode, use the procedure in the INSTALL file
  35. (or you can launch it your own way -- the goal is to capture stdout
  36. and errout to a file called debug.log so that we can, hopefully, learn
  37. something).
  38. If you are not experiencing the bug then please run SNFServer in the
  39. normal way.
  40. Thanks
  41. _M