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

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748
  1. Both SNFServer.exe and SNFClient.exe can be run in a debugging mode which
  2. produces additional output. In order to run these programs in debug mode
  3. you can rename them so that "debug" or "Debug" is in their name, or you
  4. can call them in a sub directory so that the path to the program conains
  5. "debug" or "Debug".
  6. SNFDebugClient.exe --
  7. The SNFClient.exe 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.exe --
  11. The SNFServer.exe 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), and
  14. whether they are running or have stopped. If a thread stops due to an
  15. unhandeled exception then information about that exception will be
  16. displayed in the status report.
  17. There is a special version of the control script that will run the server
  18. in debug mode and capture it's output in a file called debuglog.
  19. 20080325 -- At this time there are a few systems that are reporting an
  20. intermittent bug where SNFServer will either stop answering requests or
  21. it will stop reporting telemetry. When this happens there are no errors
  22. reported in logs, no exceptions thrown, no corrupted programs, nothing
  23. unusual at all --which is, of course, the most unusual thing of all. The
  24. program continues to run -- it's just not listening (or talking).
  25. On all but a handfull of systems SNFServer runs reliably for hundreds of
  26. days at a time without stopping until told to do so... This includes our
  27. lab computers... We hate mysteries -- the thread status report is designed
  28. to help us learn something about this bug since we are not yet able to
  29. reproduce it.
  30. To run SNFServer in debug mode, create a copy of SNFServer.exe named
  31. SNFDebugServer.exe and use the debugsnfctrl script to launch it (or you
  32. can launch it your own way -- the goal is to capture stdout and errout to
  33. a file called debuglog so that we can, hopefully, learn something).
  34. If you are not experiencing the bug then please run SNFServer.exe in the
  35. normal way.
  36. Thanks
  37. _M