Summary

If a Laserfiche program is not responding or has stopped unexpectedly, Laserfiche Technical Support may request that you generate dump files for troubleshooting purposes. Use the ProcDump command-line utility from Windows Sysinternals to monitor and create a memory dump file for:

• Processes that stop responding.
• Processes that consume 100% CPU on a single processor computer, 50 percent CPU on a dual processor computer, 25 percent CPU on a quad processor computer, and so on.
• Processes that crash or quit unexpectedly.

More Information

Download ProcDump from the Windows Sysinternals Web site at http://technet.microsoft.com/en-us/sysinternals/dd996900.

To generate a memory dump when Laserfiche is hanging

While the Laserfiche program is hanging, open a command prompt or PowerShell window and run ProcDump on the hanging program. See the following examples.

• c:\temp\procdump LF.exe c:\temp\minidumps\
• c:\temp\procdump -ma LF.exe c:\temp\minidumps

In each of the above examples, ProcDump will immediately attach to the LF.exe process and create a memory dump in the C:\temp\minidumps\ folder. The -ma parameter writes a full dump instead of a minidump. If there are multiple instances of LF.exe currently running, you can substitute "LF.exe" with the process ID of the hanging process. Use Windows Task Manager to view process IDs for running processes.

To generate a memory dump when Laserfiche crashes

Open a command prompt or PowerShell window and run ProcDump in monitoring mode.

• If Laserfiche is not currently running, see the following examples:
  • c:\temp\procdump -e -x C:\temp\minidumps\ "C:\Program Files\Laserfiche\Client\LF.exe"
  • c:\temp\procdump -ma -e -x C:\temp\minidumps\ "C:\Program Files\Laserfiche\Client\LF.exe"

  In the above examples, the -x parameter tells ProcDump to launch the Laserfiche Client. The -e parameter tells ProcDump to continuously monitor this instance of the Laserfiche Client and to generate a dump file if there is an unhandled exception (crash). While ProcDump is monitoring the process, attempt to reproduce the crash.

• If Laserfiche is already running, see the following examples:
  • c:\temp\procdump -e lfs.exe C:\temp\minidumps\
  • c:\temp\procdump -ma -e lfs.exe C:\temp\minidumps\

  In these examples, ProcDump monitors a currently running Laserfiche Server instance and generates a dump file if there is an unhandled exception (crash). While ProcDump is monitoring the process, attempt to reproduce the crash. You can substitute lfs.exe with the process ID of the running Laserfiche Server instance. Use Windows Task Manager to view process IDs for running processes.